159.352 Assignment 2:
In this assignment you will create a Java/JavaScript implementation of Black Jack game following the specification below.
Part 1: Server [12 marks]
1. In NetBeans, create a Java Web Application assignment2_server_
2. In this project, create a package nz.ac.massey.cs.webtech.s_
3. Develop a game engine that uses the following http services. The game engine is to be implemented in one or multiple servlets providing the services described in the table below. The user will play the game with the computer i.e. the dealer. Each side is dealt 2 cards, and they take turns (user first) to decide whether to hit (deal one more card) or stand (stop receiving card). Given a hand the user has at most two options to choose when making a move; hit or stand. When it is the dealer’s turn, the computer’s action is predetermined; hit when the value of dealer’s cards is 17 or less, otherwise stand. The hand which reaches 21 or gets closest to it wins. At the end of the game display the winner, and allow the user reset and start a new game.
Game state is to be maintained in a session. Your server will use a standard 52 card deck and maintain the state of user’s hand and the computer’s hand. There are no bets involved (i.e. no money to keep track of). Game state (player hands, whoseTurn, winner, etc) is stored in a servlet session. This should also work if the user disables cookies in the browser.
4. The server needs to maintain the number of games played and percentage of games won by the users for as long as the server has been running. This game stats should be persistent so it can stored in a file (stats.xml, stats.json) or in a database. It is to be updated and displayed with every game played.
URL (all URLs are relative w.r.t. root URL, such as localhost:8080
Method
Meaning
Normal response
Error response
jack/start
post
create a new game, deal 2 cards to user facing up. Deal 2 cards to computer; one facing up and one facing down. Increment number of games played (game stats)
a new game / session is created.
Card deck is shuffled. whoseTurn session variable set to user.
jack/move/hit
post
Deal one card to the user.
On the server, the user’s hand is updated.
400 Bad Request
If it is not the user’s turn or user’s hand is already bust (user hand greater than 21)
404 Not Found If there is not active game
jack/move/stand
post
User’s hand is finalized. Deal computer’s hand.
whoseTurn changes to computer.
On the server, the computer’s entire hand is
404 Not Found If there is not active game
updated based on the predetermined rule: Add new card to the computer’s hand value as long as the value of the computer’s hand is 17 or below.
jack/state
get
get the current state of user’s and computer’s hand
the respective content type is application/json representing the hands of the user and the computer
404 Not Found If there is not active game
jack/won
post
When it is user’s turn the game is still in play, and so the winner is “none”
Determine the winner only when it is the computer’s turn (ref to whoseTurn).
If the session variable
content type is text/plain, value is one line: “user” , “computer”, “draw” or “none”
404 Not Found If there is not active game
recording the winner changes from “none” to “user” then increment the number of games won by user (game stats). This ensures game stats winning count is updated at most once for every game played.
jack/possiblemoves
get
the content type is text/plain, possible user moves available (example: hit, stand). Note user cannot hit when the hand is greater than 21.
404 Not Found If there is not active game
jack/stats
get
the content type is text/plain, showing number of games played, and user win percentage.
Part 2 – Tests [7 marks]
In NetBeans, create a Java Application assignment2_test_
Note: To run these tests, you will need absolute URLs for the respective services, in particular, there must be a fixed port. Try to use localhost:8080. If for some reason this is not possible, specify the root URL in a static final variable in each test class. Example:
public class ServiceTests {
public static final String SERVER_URL = “http://localhost:8084”; …
}
Part 3 – User Interface [7 marks]
1. In the server project assignment2_server_
2. blackjack.jsp uses only the services specified in part 1 to play the game.
3. You have freedom to design the user interface, you can use either the textual or
graphical game interface.
4. The client must ensure that only valid moves are sent to the server, you can use
javascript and the possiblemoves servlet to validate input.
Part 4 – Deployment [4 marks]
After you have finished developing and testing, deploy your web application in a docker container and host it on Heroku cloud.
Notes
Here is an online back jack game you can use to familiarize yourself with the rules of the game.
https://games.washingtonpost.com/games/blackjack
Interaction between client and server is based on the services specified in the table. To get started with part 1, you can use an http client like postman or curl.
Deliverables
A README file containing instructions needed to run your web application. In your README file make sure to put down the URL of your web application hosted on Heroku.
Dockerfile and necessary files to run your web application in Docker.
Upload the zipped netbeans projects to stream. Both projects (for part 1 and part 2) can be zipped into one file, please name this file assignment2-