CS 280 Spring 2008

Assignment 6 – Branching (along with using an existing class)

100 points

Assigned: 02/20/2008

Due: 02/27/2008 at the start of class

Pre-Lab (Do Before Lab): Bring materials – a USB for a take home copy. Plan out your GUI, tasks, objects, and events needed for program. Download, unzip and familiarize yourself with the Die Class that I’m providing. Plan out how you will solve the problem.

Main Assignment:

You are writing a program for playing Craps (one aspect of – there are actually lots of different kinds of bets in Craps). Rules are included below. We are still a little bit away from being able to do the full job, so pay attention to what I’m asking for. Also note that you will need to gain an understanding of the provided Die class. The provided class will be in a zip file on Blackboard, along with documentation for the class. A quick introduction is included below. See my simple sample interface below – But don’t let that constrain your creativity. Use it to help understand what I see as the inputs and outputs. The paper version of this assignment shows a couple of screen shots from different points running my program. The version on my www site shows 5 screen shots from various points. We definitely want to control what the user can do at any given time (mostly by enabling and disabling buttons and jTextFields). Details are given below. You should create buttons to

1. Start a new player – will enable sign in

2. Play – will “validate” starting bankroll and if valid will enable playing and betting

3. Bet (“Go” in my interface) – will “validate” bet, and if valid will roll and display dice, and determine if player wins, loses, or if winning/losing is not determined yet (see rules below)

4. Ok (or Continue) – will continue game when game is not won or lost yet (see rules below)

5. Exit – quits the game

· You’re just beginning at setting up GUIs. Don’t worry too much about making the interface nice.

· But, if you plan on working with 5.5 or higher version of the IDE, ask me about using layouts, panels, java version, etc so that your program will work with 5.0. (Java version needs to be 1.5, NOT 1.6).

Hand in:

Compressed (zipped) folder with your entire project containing all files related to the project AND my entire project that I’m providing you, submitted to Blackboard.

Name your zip file so that it identifies you as well as the assignment (e.g. yourlastname assignment 6.zip). This is required for this assignment!!!!

Print out of your code (mine not needed)

Craps Rules (“most interesting variation”):

First Roll

· 7 or 11 wins

· 2,3, or 12 loses

· Anything else – becomes “point” – the new target

After that

· 7 – loses

· Point – wins

· Anything else – keep rolling – aiming for the same point (point doesn’t change!)

Any questions, please ask!!! Even if you’ve played different variations, the above is what we’re playing here.
In this assignment, when “keep rolling” - since we haven’t covered looping – we’ll rely on the user clicking a button to keep rolling.

Control:

This game is not well suited to “Event-Driven” programming because most of the things a user could do would be “wrong” at a given point of time. We definitely want to control what the user can do at any given time mostly by enabling and disabling buttons and jTextFields. Details:

Exit button is always enabled in case of need to exit immediately (below whenever it say only …, it actually also means Exit)
At start-up only the New Player button is enabled
After New Player is selected, only Player Name and Starting Bankroll text fields and New Player and Play button are enabled. Results and current game info should be cleared, however.
After Play is selected,

if an invalid starting bankroll (below minimum bet) is entered, nothing should change about what is enabled.
Otherwise, only Bet text box and Go and New Player buttons are enabled. (New Player in case, player wants to back out before betting).

After Go is selected,

If an invalid bet (below minimum bet or above player’s current balance), nothing should change about what is enabled.
Otherwise, what is enabled depends on whether the game is over or not (see rules)

If the game is over, only the Bet text field and the Go and New Player buttons are enabled (the player can either play another game or let somebody else play)
If the game is not over, only the Ok (continue) button is enabled (no bailing in the middle of the game)

After Ok is selected,

What is enabled depends on whether the game is over or not (see rules)

If the game is over, only the Bet text field and the Go and New Player buttons are enabled (the player can either play another game or let somebody else play)
If the game is not over, only the Ok (continue) button is enabled (no bailing in the middle of the game)

Provided Class:

Die – data includes the current showing value and the number of sides on the die (always 6 in Craps (but there are other kinds of dice)). Methods include:

Constants – that you will probably not need
Instance variables – that are encapsulated – you cannot directly access
Random number generation static variable – you do not directly access
3 constructors – default, number of sides, and number of sides and initial value
Appropriate “get” inspector methods to obtain current value and number of sides
The set method that is provided is private – you need to go through more controlled methods to roll the dice
getRoll – rolls the die, returning the value – recommended
roll – rolls the die, returning the die – not as convenient as getRoll
equals –tells whether two Dies have the same contents
toString – returns a String representing the Die

Miscellaneous:

· Please set the name of the project to something other than the default name (JavaApplication1, …).

· Add your name to mine in the jlabel at the top of the GUI form OR on the Title Bar.

· The minimum bet is $5.00. Use a symbolic constant (final) for this.

· The maximum bet is the player’s current balance.

· The minimum starting bankroll is the minimum bet. There is no maximum.

· Display dice rolls as they occur in a jTextArea. If a game lasts several rolls, we should be able to see all of the rolls (see my sample interface).

· Inform the user when they have won or lost with a dialog box. Also, update totals – number of games played, number of wins, number of losses, current balance, and change (difference) from their starting bankroll.

· If the user enters letters into their bet or their starting bankroll, parseDouble will crash – no worries – we won’t deal with this until we cover exceptions.

To access Classes that are not built-in AND not in the same project as your code (i.e. Die), you need to do two things:

First, in the top left explorer pane, right click on “Libraries” under your project, and choose “Add Project”, then navigate to the other (my) project and select that and click on “Add Project JAR Files” button.
Make sure you include the import statement. In this case, it should be

Import dice.*;

MAKE SURE YOUR PROGRAM WORKS! (i.e. gets correct results, controls what is displayed/enabled).
Put YOUR NAME, date (IDE should put in for you), e-mail address and purpose of the program in comments at the beginning of the program. The purpose should be what the program should do, not the learning goals.
Indent to show any structure of the program (The IDE usually does this well if you don’t go back and change things)

o You MUST include some comments that explain your program in order to get full credit.

Sample Interface:

Starting up: