Be sure to add comments
The java files in the book have some comments in the margins in a kind of "hand written font". However they don't have actual Java-style comments such as:// Instantiate a BeerExpert object, and iterate through all of // the beers that match the color selected by the user. For each // one, generate some HTML and write it to the output file.Add a reasonable number of such comments to the .java files for your clone application so that it is clear to your instructor and your TA that you know what the code is doing.
DO NOT just transcribe the "handwritten" comments in the textbook verbatim. Read those comments the first time you go through the code, but as you make the "clone" application, try to avoid reading them; instead, write comments in your own words based on your understanding of what the code is doing. (You can use those "handwritten" comments as a general guide for how much commenting is needed, and at what level of detail.)
In addition to these comments, be sure to have a comment at the top of each file similar to the following one that I wrote when testing out the assignment:
// BeerExpert.java // "Head First Servlets and JSP", 1st Edition, p. 82, O'Reilly (2004). // Transcribed by Phillip T. Conrad for CISC474, 02/25/2005 // // "Model" part of a beer advisory system based on the // Model-View-Controller design pattern.Note that this comment contains:
The same rules goes equally for you .java and for your .xml, .html and .jsp files; put similar comments at or near the top of all the files in your projects.
Submitting your work To submit your work, you'll need to do five things:
That is, if your strauss username is foobar, put a link on your http://udel.edu/~foobar/cisc474/index.html page called "H03 page" that goes directly to your http://jaguar.cis.udel.edu:xxxx/yyyyyyy/form.html or whatever.. the first page that a user should access in your application. This is worth 10 points of your grade for this homework assignment.
Outline of Grading Rubric (more specific items may be added later)
Item | points |
Correctness (does the code work) [If your Resin server is not up, you will lose all of these points. You may earn back some of them if you get your Resin server up later]. |
30 |
Java and JSP coding style (comments, efficiency, etc.) | 10 |
Comments in code | 10 |
Following MVC design pattern | 20 |
README.txt file explanation | 10 |
Following instructions (10 points of this is for the link on your copland/strauss cisc474 page back to your H03 start page.) | 20 |
Total | 100 |