Overview

The purpose of this assignment is to give you some practice with the process of implementing a class from a specification and testing whether your implementation conforms to the specification.

For this assignment you will implement one class, called WirelessPrinter, that models some aspects of the behavior of a simple wireless printer. In particular, this class keeps track of the number of pages printed and the ink level in the printer, in addition to a few other things.

Specification

The specification for this assignment includes this pdf along with any official clarifications posted on Piazza.

There are three public constants:

public static final int PAGES_PER_CARTRIDGE = 1000; public static final int TRAY_CAPACITY = 500; public static final double NEW_CARTRIDGE_INK_LEVEL = 1.0;

There are two public constructors:

public WirelessPrinter()

Constructs a Printer that has a cartridge that is 50% full, which means the ink level is at 0.5.

public WirelessPrinter(double ink, int paper)

Constructs a Printer that has the given amount of ink and the given number of sheets of papers. The initial ink level must be between 0.0 and 1.0 and the initial paper count must be between 0 and 500, inclusive.

There are also a number of public methods, see the API.

Wheres the main() method??

There isnt one! Like most Java classes, this isnt a complete program and you cant run it by itself. Its just a single class, that is, the definition for a type of object that might be part of a larger system. To try out your class, you can write a test class with a main method such the example below.

Sample usage

A good way to think about the specification is to try to write some simple test cases and think about what behavior you expect to see. Here are a few examples:

public class WirelessPrinterTest {

public static void main(String[] args) {

WirelessPrinter printer = new WirelessPrinter(1.0, 500);

// turn it on and check its state

printer.turnOn();

System.out.println(printer.isOn()); // expected true

System.out.println(printer.isConnected()); // expected true

System.out.println(printer.getPaperLevel()); // expected 100(%)

System.out.println(printer.getInkLevel()); // expected 1.0

// try print printer.print(50);

System.out.println(printer.getPaperLevel()); // expected 90

System.out.println(printer.getInkLevel()); // expected 0.95

System.out.println(printer.getTotalPagesPrinted()); //expected 50 System.out.println(printer.getTotalPaperUsed()); // expected 50

// try print more pages than what is left in the tray printer.print(500); // out of paper

System.out.println(printer.getPaperLevel()); // expected 0

System.out.println(printer.getInkLevel()); // expected 0.5

System.out.println(printer.getTotalPagesPrinted());//expected 500

System.out.println(printer.getTotalPaperUsed()); // expected 500

// try loadPaper method printer.loadPaper(1000);

System.out.println(printer.getPaperLevelExact()); // expected 500

// try replace the cartridge printer.replaceCartridge();

System.out.println(printer.getInkLevel()); // expected 1.0

// try disconnect method printer.disconnect(); // network goes off printer.print(50);

System.out.println(printer.getPaperLevelExact()); // expected 500

System.out.println(printer.getInkLevel()); // expected 1.0

}

}

There is also a SpecChecker (see below) that will perform a lot of functional tests, but when you are developing and debugging your code at first youll always want to have some simple test cases of your own as in the main method above.

Suggestions for getting started

Smart developers dont try to write all the code and then try to find dozens of errors all at once; they work incrementally and test every new feature as its written. Here is a rough guide for how an experienced coder might go about creating a class such as this one:

1. Be sure understand the basics of defining a class as in Sections 3.1 3.3 of the text and as practiced in Lab 2.

1. Create a new, empty project and add a package called hw1.

2. Create the WirelessPrinter class in the hw1 package and put in stubs for all the required methods and constructors. For methods that are required to return a value, just put in a dummy return statement that returns zero or false.

3. Download the specchecker, import it into your project as you did in labs 1 and 2, and run it. There will be lots of error messages appearing in the console output, since you havent actually implemented the methods yet. Always start reading from the top. All you really want to check at this point is whether you have a missing or extra public method, if the method declarations are incorrect, or if something is really wrong like the class having the incorrect name or package. Any such errors will appear first in the output and will usually say Class does not conform to specification.

4. Look at each method. Mentally classify it as either an accessor (returns some information without modifying the object) or a mutator (modifies the object, usually returning void). The accessors will give you a lot of hints about what instance variables you need.

5. Before you write code for a method, always write a simple usage example or test case, similar to the main method shown above. This will make sure you understand what the code is really supposed to do, and it will give later you a way to check whether you did it correctly. Of course, if you are really not sure what a method is supposed to do, bring up your question for discussion on Piazza!

6. ^{You might start with loading and getting the paper level. Look at} getPaperLevelExact(). Its an accessor that returns the exact count of the sheets of paper in the tray. That information has to be stored somehow within the WirelessPrinter object, which tells you that you probably need an instance variable to represent the sheet count. Then loadPaper() is also simple to write. Note there is a requirement that the number of papers in the tray cannot surpass its capacity. You can do this easily using min to select the smaller of two values, for example

int paperLeft = Math.min(paperLeft + pages, TRAY_CAPACITY);

7. For the print() method, it should do nothing if the printer is not connected to the network. You can achieve it by placing the following statement at the top of your print() method.

public void print(int pages) {

if (!isConnected())

return; // do nothing

// the rest of the code goes here

Additional notes

1. You do NOT need conditional statements (if statements) or loops for this assignment (except for the print() method, for which how if should be used has been given above). We will start covering conditional statements later next week or in week 5, and you wont be penalized if you use them, but you would just be making things more complicated. (If you have done some programming before and are tempted to use a bunch of if-statements, make it a challenge for yourself write simpler code without them.)

1. If you need to find the smaller or larger of two, just use the methods min() or Math.max(). As an example,

int x = Math.min(3, 4); // now x is 3

1. To round to the nearest integer, use round() Note: one little gotcha with Math.round is that it returns a type of integer value called a long, so you generally have to cast it to convert to the int type to use it in your code. It would look like this:

int x = (int) Math.round(y);

1. You may want to use also floor()to get the largest int that is less than or equal to a given double value. It would look like this:

int x = (int) Math.floor(y);

2. Do not add any additional public methods. (You can add your own methods if you feel compelled to do so, but they must be declared private.) Do not create any additional Java classes.

The SpecChecker

You can find the SpecChecker online; see the Piazza Homework post for the link. Import and run the SpecChecker just as you practiced in Labs 1 and 2. It will run a number of functional tests and then bring up a dialog offering to create a zip file to submit. Remember that error messages will appear in the console output. There are many test cases so there may be an overwhelming number of error messages. Always start reading the errors at the top and make incremental corrections in the code to fix them. When you are happy with your results, click Yes at the dialog to create the zip file. See the document SpecChecker HOWTO, which can be found in the Piazza pinned messages.

More about grading

This is a regular assignment so we are going to read your code. Your score will be based partly (about a third) on the speccheckers functional tests and partly on the graders assessment of the quality of your code. This means you can get partial credit even if you have errors, and it also means that even if you pass all the specchecker tests you can still lose points. Are you doing things in a simple and direct way that makes sense? Are you defining redundant instance variables? Some specific criteria that are important for this assignment are:

• Use instance variables only for the permanent state of the object, use local variables for temporary calculations within methods.

o You will lose points for having lots of unnecessary instance variables o All instance variables should be private.

• Accessor methods should not modify instance variables.

See the Style and documentation section below for additional guidelines.

Style and documentation

Roughly 15% of the points will be for documentation and code style. Here are some general requirements and guidelines:

• Each class, method, constructor and instance variable, whether public or private, must have a meaningful and complete Javadoc comment. Class javadoc must include the

@author tag, and method javadoc must include @param and @return tags as appropriate. o Try to state what each method does in your own words, but there is no rule against copying and pasting the descriptions from this document or from the posted javadoc.

• Run the javadoc tool and see what your documentation looks like! You do not have to turn in the generated html, but at least it provides some satisfaction 🙂

• All variable names must be meaningful (i.e., named for the value they store). Your code should not be producing console output. You may add println statements when debugging, but you need to remove them before submitting the code. Use the defined constants PAGES_PER_CARTRIDGE, TRAY_CAPACITY, NEW_CARTRIDGE_INK_LEVEL.

• Internal (//-style) comments are normally used inside of method bodies to explain how something works, while the Javadoc comments explain what a method does. (A good rule of thumb is: if you had to think for a few minutes to figure out how something works, you should probably include a comment explaining how it works.) o Internal comments always precede the code they describe and are indented to the same level. In a simple homework like this one, as long as your code is straightforward and you use meaningful variable names, your code will probably not need many internal comments.

• Use a consistent style for indentation and formatting.
  • Note that you can set up Eclipse with the formatting style you prefer and then use Ctrl-Shift-F to format your code. To play with the formatting preferences, go to Window->Preferences->Java>Code Style->Formatter and click the New button to create your own profile for formatting.

If you have questions

For questions, please see the Piazza Q & A pages and click on the folder assignment1. If you dont find your question answered, then create a new post with your question. Try to state the question or topic clearly in the title of your post, and attach the tag assignment1. But remember, do not post any source code for the classes that are to be turned in. It is fine to post source code for general Java examples that are not being turned in. (In the Piazza editor, use the button labeled pre to have Java code formatted the way you typed it.)

If you have a question that absolutely cannot be asked without showing part of your source code, make the post private so that only the instructors and TAs can see it. Be sure you have stated a specific question; vague requests of the form read all my code and tell me whats wrong with it will generally be ignored.

Of course, the instructors and TAs are always available to help you. See the Office Hours section of the syllabus to find a time that is convenient for you. We do our best to answer every question carefully, short of actually writing your code for you, but it would be unfair for the staff to fully review your assignment in detail before it is turned in.

Any posts from the instructors on Piazza that are labeled Official Clarification are considered to be part of the spec, and you may lose points if you ignore them. Such posts will always be placed in the Announcements section of the course page in addition to the Q&A page. (We promise that no official clarifications will be posted within 24 hours of the due date.)

What to turn in

Note: You will need to complete the Academic Dishonesty policy questionnaire, found on the Homework page on Canvas, before the submission link will be visible to you.

Please submit, on Canvas, the zip file that is created by the SpecChecker. The file will be named

SUBMIT_THIS_hw1.zip. and it will be located in the directory you selected when you ran the

SpecChecker. It should contain one directory, hw1, which in turn contains one file,

WirelessPrinter.java. Please LOOK at the file you upload and make sure it is the right one!

Submit the zip file to Canvas using the Assignment 1 submission link and verify that your submission was successful. If you are not sure how to do this, see the document Assignment Submission HOWTO which can be found in the Piazza pinned messages.

We recommend that you submit the zip file as created by the specchecker. If necessary for some reason, you can create a zip file yourself. The zip file must contain the directory hw1, which in turn should contain the file WirelessPrinter.java. You can accomplish this by zipping up the src directory of your project. The file must be a zip file, so be sure you are using the Windows or Mac zip utility, and NOT a third-party installation of WinRAR, 7-zip, or Winzip.