Java Assignment Objectives and Task

Assignment Objectives

To demonstrate your ability and understanding in the following tasks:

1.To design and implement a simple class.

2.To write a test program to create instances of your class and demonstrate its behaviour.

3.To collect output from the test program runs, and comment on it.

4.To conform to Java coding conventions, including documentation style comments.

You must create a general design for a class. Design, implement, test and document this class. You will need to make some assumptions and design decisions about the class. Ensure the class documentation makes the purpose and constraints of you class clear. You should strive to write your class so that it is potentially useful in other applications.

Add your own observations at the beginning or end of the output files. For example, were the test outcomes as expected?

The report should be about 200-400 words with your reflections about your class, test program and results. You should comment on any assumptions that you made, and where improvements could be made to the design or implementation.  

Pass (50 - 59): You have produced a class with appropriate fields, a constructor, and some modifier and accessor methods. There is a javadoc header describing the class. A test program creates an instance of the class and uses some methods. The code is suitably formatted, syntactically correct, and the test program executes, and output has been recorded.

Merit (60 - 69): Criteria for a Pass have been met. In addition, all standard naming and coding conventions have been met. There has been consideration of class design, which is evidenced by javadoc comments, programmer comments, or the report. There is an appropriate level of documentation throughout the class. All constructors and methods have been used in the test program. The report gives an insight into the design and implementation decisions.

Distinction (70+): Criteria for a Merit have been met. In addition, code style and documentation is to a professional standard. The class design is appropriate for the given scenario.  Implementation is (almost) all correct and maintains the integrity of attributes where appropriate. The test program thoroughly exercises the methods and exposes any limitations, in addition to using an ArrayList.

Design, implement, and test ONE of the classes described below or specify your own. The class descriptions are deliberately vague in places. For your chosen class, you should use Javadoc comments to specify its purpose, properties and scope making appropriate assumptions where necessary. Additional note: To receive higher marks, in your test class you should aim to sensibly utilise an ArrayList, an overridden equals method, and the Scanner / PrintWriter for I/O.

Your Task

Classes marked with (60) or (80) are simpler than others and therefore can achieve at best those respective marks. You are strongly advised to attempt a (80) or (100) level class. Your tutor will indicate the level of complexity of any class you specify and you MUST get your tutors permission. You CANNOT use any class that has been discussed or provided to you during this module.

An address has a house number, a street name, a town, county and postcode. This class should return the full address formatted appropriately.

An email address is made up of a real name, a user id and domain, e.g. Peter Jones <[email protected]>. The class should return a correctly formatted email address.

Models a 24 hour clock, which stores a time as hours and minutes. The time can be advanced. The client can retrieve the hours and minutes.

A film DVD has a film title, duration, and category (e.g. U, PG, 15A). The DVD can be rented and returned.

A robot has a (x, y) coordinate location. It can turn 90 degrees and move forward by some amount. It can go ‘home’ to its origin.

A cinema booking can be for a number of adults and children. The child’s ticket price is half of the adult. The cost of the booking can be retrieved.

A taxi journey has a start location and a destination. There is an estimated duration of journey and distance. The class should work out the fare based on a formula using the duration and distance (you can make up a suitable formula).

A monitor can be used for a variety of purposes: heart beat, temperature, blood pressure. A monitor has a minimum and maximum value. If the current reading goes out of the expected range then an alarm is set.

A product in a shop has a particular quantity in stock. The is a minimum stock level, and when this is reached it indicates that the product needs to be reordered. Each item has a suggested reorder amount.

These indicators will be used as a basis for the assessment mark and will form your feedback.

·The class header documentation clearly describes the purpose of your class

·Javadoc comments have been provided for each method and constructor

·Javadoc param and return tags have been used appropriately

·You have complied with standard Java conventions for identifier names and indentation (40%) Design and Implementation of the class.

·Choose suitable fields, with appropriate data types

·Declare a default constructor, which appropriately initialises fields

·Declare a custom constructor, which appropriately initialises fields

·Standard setter and getter methods have been provided as appropriate

·A suitable toString method provides a textual representation of the current state

·Other logical methods have been correctly specified and implemented

·Internal validation within methods has been considered where applicable

·Appropriate use of access modifiers (e.g. private, public) to encapsulate data (20%) Test program and output.

·The test program uses each constructor

·The test program calls each method at least once

·The test program thoroughly exercises your class

·The output file(s) show the outcome of test runs with your observations (20%) Correctness and Quality as evidenced by the overall submission.

·Your class broadly meets the given specification

·The code is syntactically and logically correct

·Your class or test program shows technical flair/creativity

·Your report gives an insight into your design and implementation decision

Please note: Your overall mark may be capped at 60 or 80 depending on the level of complexity of the class you have attempted to design and implement.