Here are the steps to get the files for this project after logging in on acad/bill.

Transcription

1 CSC 243, Java Programming, Spring 2014, Dr. Dale Parson Assignment 4, implementing undo, redo & initial GUI layout ASSIGNMENT due by 11:59 PM on Saturday April 19 via gmake turnitin ASSIGNMENT 5 (see page 5) is due by end of May 3 via gmake turnitin Here are the steps to get the files for this project after logging in on acad/bill. cd $HOME/JavaLang cp ~parson/javalang/perquack4.problem.zip perquack4.problem.zip unzip perquack4.problem.zip cd./perquack4 This project consists of implementing the layout of a Graphical User Interface (GUI) for playing Perquacky, Perwhacky, or other subclasses of IPerquacky. All of your work will go into file PerquackyFrame.java, where class PerquackyFrame is a subclass of javax.swing.jframe. Assignment 5 will follow up by adding event handlers and making this a fully functioning game. I have posted Javadoc at I have added various query methods to IPerquacky that your code will need to use to figure out certain details of laying our your GUI, including valid word lengths (do NOT assume 3 through 10), the maximum number of words of a given length allowed (do NOT assume / hard code 5), the various point thresholds, and the number of players. The penalty for hard coding values such a 3, 10, 5, or similar values that you can query from IPerquacky will be 10% of the project. Our goal is to make this GUI as flexible as possible in supporting any class derived from IPerquacky. Study the Javadoc for IPerquacky to figure out the query methods for laying out your GUI, and for obtaining the state of a game to display. I will NOT accept late submission for this assignment. I need to post my solution to assignment 4 on the morning of April 20 so students can get started on assignment 5. Any assignment that comes in after I post the solution to assignment 4 at about 8 AM on the 20 th will be worth 0%. A. Lay out JFrame-derived class PerquackyFrame by completing STUDENT code in PerquackyFrame.java. You can do this step on your own laptop or PC, or you can do it on acad/bill from on campus. You need to install some software if you are using your own machine. That installation is part of the assignment. We will not spend class time on actually doing this, but if you have problems, we can resolve them during office hours. A0: Run gmake clean test on acad/bill before copying any files to your remote PC / laptop to make sure that everything is intact. Do that again at the end, after you copy files back onto acad / bill for turning in. You can develop and test this entire assignment on acad/bill by using Xming and enabling putty X11 to localhost:0 if you want to. You are NOT required to use a PC or laptop. You can run gmake test to test previous assignments and gmake testgui to test your GUI if running on acad/bill with Xming. A1: If your machine runs Windows or Linux 1, go to and download and install the JDK for your operating system. The java compiler should already be installed on Mac / OSX machines. A2: After completing installation, bring up a terminal. On Windows this is the Command Prompt window under the Accessories program entry. Try typing the following commands to see whether you can access the javac compiler and java JVM from the command prompt. All of our building and testing takes place from a command window. You can ignore my cd commands below for the moment. All Programs -> Accessories -> Command Prompt 1 If you decide to test on bill, get an XMing terminal server from (PC only), run it, and enabled X11 tunneling on putty to localhost:0. On Mac use ssh to log in as you usually do, with X in the ssh command line. We will discuss this approach in class. 1

2 C:\>z: Z:\JavaLang\perquack4>cd \JavaLang\perquack4 Z:\JavaLang\perquack4>javac -version javac Z:\JavaLang\perquack4>java -version java version "1.7.0" Java(TM) SE Runtime Environment (build b147) Java HotSpot(TM) 64-Bit Server VM (build 21.0-b17, mixed mode) If that does not work, you will need to update your System Path variable on Windows. Follow the links from Control Panel -> System -> Advanced System Settings -> Environment Variables -> System variables -> Path and add the path to the FOLDER (directory) that houses the javac.exe file at the end of the System Path, preceded by a semicolon like this: ;PATHTOFOLDERCONTAININGJAVAC. A3. After you have performed all of STEPS A & B including testing on bill/acad, you need to download the entire directory onto your machine. Run gmake clean before you do that to remove compiled files and test output files. Then use either WinSCP available at or the FileZilla client from to manage file downloads from bill to your machine and later upload. BE CAREFUL NOT TO OVER-WRITE YOUR MOST RECENT WORK BY COPYING IN THE WRONG DIRECTION! After you have the entire perquack4 directory on your machine, you can cd into that directory, compile files and run tests as follows. These examples use my directory location for perquack4. C:\>z: Z:\JavaLang\perquack4> cd \JavaLang\perquack4 Z:\JavaLang\perquack4> buildwindows.bat Z:\JavaLang\perquack4> runwindows.bat On Mac, Linux and Solaris (bill) you can run bash x./buildunix.sh and bash x./rununix.sh instead. 2

3 Running buildwindows.bat gives the following output on success. If you have compilation errors, you will see those. Typing runwindows.bat runs PerquackyFrame.main, displaying the window appearing at the end of this document. C4: Your actual code changes go into the STUDENT section of PerquackyFrame.java. C5: When your display is roughly the same as mine at the end of this document (you may dress it up if you like), copy all files back onto bill (including the generated data_do_not_lose_this_file.txt) and run gmake clean test to ensure that you have not broken any of the non-gui parts. Then run gmake javadoc and make sure that the little bit of javadoc that you have added appears OK without warnings. Finally, run gmake turnitin on bill/acad by the deadline as before. Have fun, and May the Force be with You. OPTIONAL 2% BONUS CREDITS I am collecting data for a summer assessment that determines the associations between a) project start date, b) length of work sessions, c) time of day of work sessions, and d) conflicting schedule pressures, and student success on projects as measured by grades and grade improvements. You can earn half of these bonus points (1% additional for the project) by permitting me to collect file sizes, time stamps, time of change, and duration of work session. My automatic script uses a simple ls l command to list directory contents, and it keeps backup copies of your source files to determine amount of code changed per session. The log data goes to my account to keep your account from running out of file space. You need to include data_do_not_lose_this_file.txt in your directory on bill if you build and test remotely. If you do not want to participate, run gmake optout to shut off data collection, and also notify me my using the subject line opt out. I will not collect your data, and if you have already turned some in, I will remove the files. You can earn an additional 1% bonus point by completing a survey in file survey.txt in the project directory. Please fully replace each ****** field with a number. To get this 1% you must also allow data collection for the previous 1%. This survey is not useful without the auto-collected log data. Thus, the total possible points for a project is 102%. The collected data in no way affects your grade, other than by contribution of bonus points. My assessment outlined in the first paragraph of this section could show an association between number of CSC courses that assign you big projects on the same week and the rate of problems encountered completing an assignment. I am looking for ways to improve success rates on projects in future semesters, and I need to collect data in survey.txt and by automatic data collection before I can analyze these data. This is not secret data mining, and I have no time or intention of analyzing the data until this summer. Again, if you wish to opt out of this optional part of assignments, there is no penalty. There are Mac/OSX screen shots of my initial game layout and of a game on progress on the next page. You need to query the IPerquacky object passed as a constructor parameter to PerquackyFrame to get the state to display. I wrote helper method PerquackyFrame.updateDisplay to prompt the game object and set the contents of the various widgets using settext(). Note my color scheme (the color PDF file of this assignment is on the course page) and the enlarged font. You can lay the GUI out according to your own tastes, but everything must be clearly there in approximately the following layout. We will discuss all of this in class. 3

4 The following call pops up an error message. Please read the Javadoc for class JOptionPane. This is how you must report errors and warnings; px is an Exception (e.g., PerquackyException) object in this example. JOptionPane.showMessageDialog(null, "Game exception: " + px.getmessage(), "Error", JOptionPane.ERROR_MESSAGE); 4

5 ASSIGNMENT 5: Make it work! Assignment 5 is due by the end of May 3 via gmake turnitin. You can continue to use my PerquackyFrame.java solution to assignment 4 as a starting point for assignment 5 if you want, although I encourage you to use your own assignment 4 result and just keep working on it. You need to make the game playable, the GUI intuitive, and you need to use a Timer to limit each player s turn to 3 minutes. Use./runparsonunix.sh or runparsonwindows.bat to play my game. Matching my game is the minimum required result. I will grant up to 25% bonus points for interesting features added to PerquackyFrame.java, at my discretion, depending on the quality of the enhancement. Also you can create a new game subclass with novel rules that work with the GUI. IF YOU GO FOR ANY BONUS POINTS, ADD FILE README.txt in your directory and describe the bonus features. Their use should be intuitive. PerquackyFrame.java as handed out: 1 // perquack4/perquackyframe 2 // CSC 243 Java Programming Spring // JFrame-derived class for CSC 243 assignment 4, spring package perquack4 ; 6 import java.awt.* ; 7 import java.awt.event.* ; 8 import javax.swing.* ; 9 import java.util.list ; 10 import java.util.linkedlist ; /** 13 This JFrame-derived class provides a GUI so players can play a 14 game derived from interface IPerquacky. IPerquacky 16 **/ 17 public class PerquackyFrame extends JFrame { 18 private final static int secondsperplayer = 180 ; 19 private int secondsremaining = secondsperplayer; 20 private IPerquacky thegame ; 21 private final int wordlenmin ; 22 private final int wordlenmax ; 23 private final int wordlimitperlength ; 24 private JTextField txtword ; 25 private JLabel lbldice ; 26 private JButton btnnext = new JButton("Next player"); 27 private JLabel lbltimer = new JLabel("" + secondsperplayer, 28 JLabel.CENTER); 29 private Font myfont ; 30 private JLabel [] name ; 31 private JLabel [] score ; 32 private JLabel [][] words ; // [num-of-one-len][num-of-different-lens] 33 private Timer timer ; 34 /** 35 * Construct a top-level JFrame for playing game. 36 game is the newly constructed game in which to begin play. 37 **/ 38 public PerquackyFrame(IPerquacky game) { 39 // STUDENT WORK STARTS HERE: 40 // REPLACE THE FOLLOWING FIELD ASSIGNMENTS. 41 // I am doing this to get past the compiler errors. 42 // Do not hard code values if you can ask the game for the value! 5

6 43 thegame = null ; // REPLACE THIS LINE! 44 wordlenmin = 0 ; // REPLACE THIS LINE! 45 wordlenmax = 0 ; // REPLACE THIS LINE! 46 wordlimitperlength = 0 ; // REPLACE THIS LINE! // STUDENT WORK ENDS HERE for the constructor. 50 // You can also add private helper methods and nested 51 // helper classes outside this constructor as needed. 52 // You can add new (non-static) fields into the object 53 // if you feel you need them. 54 setsize(800, 600); 55 settitle(game.getgamename()); 56 setlocationrelativeto(null); 57 setdefaultcloseoperation(jframe.exit_on_close); 58 setvisible(true); 59 } 60 /** 61 * Validate command line arguments, then construct and play 62 * a game of IPerquacky to completion. Command line usage is 63 * java perquack4.perquackyframe IPerquackyCLASS dictionaryfilename seed players * where there must be 2 or more players. 65 **/ 66 public static void main(string [] args) { 67 // DO NOT CHANGE THE MAIN METHOD! 68 String usage = 69 "java perquack4.perquackyframe IPerquackyCLASS dictionaryfilename seed players..."; 70 if (args.length < 5) { 71 System.err.println(usage); 72 System.exit(1); 73 } 74 List<String> players = new LinkedList<String>(); 75 for (int i = 3 ; i < args.length ; i++) { 76 players.add(args[i]); 77 } 78 try { 79 // Load class args[0] from the file 80 // system and run its 3-param cons. 81 Class <? extends 82 IPerquacky> puzzleclass 83 = Class.forName(args[0]). 84 assubclass(iperquacky.class); 85 Class<?> [] consparams = new Class<?> [3]; 86 consparams[0] = String.class ; // constructor's param type 87 consparams[1] = Long.class ; // constructor's param type 88 consparams[2] = List.class ; // constructor's param type 89 // NOTE: consargs[2] must be a List<String> 90 Object [] consargs = new Object [3]; 91 consargs[0] = args[1]; 92 consargs[1] = new Long(args[2]) ; 93 consargs[2] = players; 94 java.lang.reflect.constructor<? 95 extends IPerquacky> newcons = 96 puzzleclass.getconstructor(consparams); 97 IPerquacky game = (IPerquacky) 98 newcons.newinstance(consargs); 6

7 99 PerquackyFrame frame = new PerquackyFrame(game); 100 } catch (java.lang.classnotfoundexception cnx) { 101 System.err.println("Class not found: " + args[0] ": " + cnx.getmessage()); 103 // cnx.printstacktrace(); // DEBUG comment me out 104 System.exit(3); 105 } catch (java.lang.classcastexception ccx) { 106 System.err.println("Class does not inherit from IPerquacky: " args[0] ": " + ccx.getmessage()); 109 System.exit(3); 110 } catch (java.lang.nosuchmethodexception nnx) { 111 System.err.println("Class constructor not found: " + args[0] ": " + nnx.getmessage()); 113 System.exit(3); 114 } catch (java.lang.instantiationexception inx) { 115 System.err.println("Class constructor error: " + args[0] ": " + inx.getmessage()); 117 System.exit(3); 118 } catch (java.lang.illegalaccessexception anx) { 119 System.err.println("Class constructor access error: " + args[0] ": " + anx.getmessage()); 121 System.exit(3); 122 } catch (java.lang.reflect.invocationtargetexception vnx) { 123 System.err.println("Class constructor call error: " + args[0] ": " + vnx.getmessage()); 125 System.exit(3); 126 } 127 } 128 } 7