UQ Students should read the Disclaimer & Warning

Note: This page dates from 2005, and is kept for historical purposes.

COMP2500 – Programming in the Large – Assignment Four

Criteria and Results
Average class result		—
Adherence to code format rules (0-4) (including quantity and quality of comments)
no violation of code format rules/comments	4
a number of problems with code format rules/comments	2	3½ ✔
work with little or no academic merit	0
Quality of code (0-4)
code that is correct, clear and succint	4	4 ✔
code with small number of minor problems	3
code that is clearly incorrect, too complex or hard to understand	1
work with little or no academic merit	0
Quality of design (0-6)
design that is elegant and meets assignment design requirements	6
design with minor flaws	4	5 ✔
design with minor flaws, but meets assignment design requirements	2
work with little or no academic merit	0
Our testing of ItemTracking.java (0-4)
no errors detected	4	4 ✔
one or two minor problems detected	3
substantial number of problems detected	1
work with little or no academic merit	0
Total Possible Marks	15	16½/18

Submitted Code

                            Inheritence Hierachy
 
                                LibraryItem
                                     |
               ______________________|______________________
               |                                           |
               |                                           |
           Stealable                                   Borrowable
               |                                           |
      _________|_________                     _____________|______________
      |                 |                     |            |             |
      |                 |                     |            |             |
ReferenceItem      VisualMedium          LibraryBook   AtDeskItem    Periodical

 

AtDeskItem.java
View the JavaDoc
/* * Author: Ned Martin #40529927 * * Creation Date: 17-AUG-2003 * * Copyright: Ned Martin * * Description: Assignment 4 for COMP2500 * * Tab Stops: Eight spaces */ /** * Container for at-desk items. Implements isLost function. * @author Ned Martin 40529927 * @version FINAL 17-OCT-2003 */ public class AtDeskItem extends Borrowable { /** * Construct a library item given its call number and cost * Type is A - at-desk item */ public AtDeskItem ( String id, // call number int val // item cost ) { super(id, val); } /** * Has the library item been lost * @return true if the library item is lost */ public boolean isLost() { return (availability >= 3); } // end of file }

Availability.java
View the JavaDoc
/* * Author: Ned Martin #40529927 * * Creation Date: 17-AUG-2003 * * Copyright: Ned Martin * * Description: Assignment 4 for COMP2500 * * Tab Stops: Eight spaces */ /** * Interface providing library item availability function. * @author Ned Martin 40529927 * @version FINAL 17-OCT-2003 */ public interface Availability { /** * Set availability of library item. */ public void setAvailability ( String avail // if item is available or not (Y/N) ); // end of file }

Borrowable.java
View the JavaDoc
/* * Author: Ned Martin #40529927 * * Creation Date: 17-AUG-2003 * * Copyright: Ned Martin * * Description: Assignment 4 for COMP2500 * * Tab Stops: Eight spaces */ /** * Abstract container for borrowable library items * * @author Ned Martin 40529927 * @version FINAL 17-OCT-2003 */ abstract public class Borrowable extends LibraryItem implements Availability { /** * Constant fine for late items. */ public int BOOK_FINE = 50; /** * days since item borrowed */ protected int availability; /** * Construct a borrowable library item given its call number and cost. * * Only called by subclasses. */ public Borrowable ( String id, // call number int val // item cost ) { super(id, val); } /** * What is the replacement cost of the library item to the library * @return the integer replacement cost of the library item */ public int getReplacementCost() { return getCost()-BOOK_FINE; } /** * Set how many days since item was borrowed. */ public void setAvailability ( String itemAvail // days since item borrowed ) { availability = Integer.parseInt(itemAvail); } // end of file }

ItemTracking.java
View the JavaDoc
/* * Author: Ned Martin #40529927 * * Creation Date: 17-AUG-2003 * * Copyright: Ned Martin * * Description: Assignment 4 for COMP2500 * * Tab Stops: Eight spaces */ import java.io.*; // Provides standard IO import java.util.*; // Provides StringTokenizer /** * This item tracking program reads in a number of library items where each item * description contains a call number, item cost, usage value, item type, and an * availability value. The usage value is how often the item is used. The * availability value is dependent on the type of the library item. The output * is two sorted lists: the first is a list of items currently in the library or * on-loan, but not lost and the second is a sorted list of missing library * items, the replacement cost of the item to the library; and the overall cost * of the missing items. * * @author Ned Martin 40529927 * @version FINAL 17-OCT-2003 */ public class ItemTracking { /** * Linked list to hold library items. */ public static LibraryItemList libraryItems = new LibraryItemList(); /** * Run read and print methods. */ public static void main(String[] args) { read(); // read input print(); // print output } /** * Read from standard input. */ private static void read() { String line; // holds input line try { // Capture input from stdin BufferedReader in = new BufferedReader(new InputStreamReader(System.in)); // capture line while ((line = in.readLine()) != null) { try { // send line to parser parse(line); } catch (NumberFormatException e) { System.err.println("Invalid "+ "Input\n"+e); System.exit(1); } } } catch (IOException e) { System.err.println("IO Exception: Check input\n"+e); System.exit(1); } } /** * Parse input. * * Accept a line, parses it, determines type of book, * create a new LibraryList object, insert data into it, add object to * linked list in a sorted manner, and set usage and availability * information */ private static void parse ( String line // input line to parse ) { // create new string tokenizer StringTokenizer st = new StringTokenizer(line); int i = 0, // counter itemCost = 0, // cost of item itemUsage = 0; // item usage figure String type = "", // type of item token = "", // parsed token callNo = "", // item call number itemType = "", // type of item itemAvail = "-0"; // item availability // library item LibraryItem libraryItem = null; while (st.hasMoreTokens()) // more tokens exist { token = st.nextToken(); switch (i) { case 0: // Call No callNo = token; break; case 1: // Cost itemCost = Integer.parseInt(token); break; case 2: // Usage itemUsage = Integer.parseInt(token); break; case 3: // Type libraryItem = returnType(token, callNo, itemCost, libraryItem); break; case 4: // Availability itemAvail = token; break; } i++; } try { // add library item to linked list libraryItems.insert(libraryItem); } catch (DuplicateExc e) { System.err.println("Duplicate Exception\n"+e); System.exit(1); } // set item usage libraryItem.setUsage(itemUsage); // cast library item to availability item and set availability Availability avLib = null; avLib = (Availability)libraryItem; avLib.setAvailability(itemAvail); } /** * Parse item type and create library items based on type * @return object depending on type of library item */ private static LibraryItem returnType ( String type, // R, B, A, P, V String callNo, // call number int itemCost, // item cost LibraryItem libraryItem // null library item ) { if (type.equals("R")) //return "Reference Item"; { return libraryItem = new ReferenceItem(callNo,itemCost); } if (type.equals("B")) //return "Book"; { return libraryItem = new LibraryBook(callNo,itemCost); } if (type.equals("A")) //return "At desk item"; { return libraryItem = new AtDeskItem(callNo,itemCost); } if (type.equals("P")) //return "Periodical"; { return libraryItem = new Periodical(callNo,itemCost); } if (type.equals("V")) //return "Visual Medium"; { return libraryItem = new VisualMedium(callNo,itemCost); } // this never happens but makes compiler very happy return libraryItem; } /** * Print item information. */ private static void print () { LibraryItem res = null; // library item int totalReplacementCost = 0; // replacement cost try { // located items System.out.println("Located Items:"); libraryItems.resetIterator(); while (libraryItems.hasNext()) // more nodes exist { res = libraryItems.next(); if (!res.isLost()) // item is not lost { System.out.println(res.getCallNumber()+ " "+res.getUsage()); } } // missing items System.out.println("Missing Items:"); libraryItems.resetIterator(); while (libraryItems.hasNext()) // more nodes exist { res = libraryItems.next(); if (res.isLost()) // item is lost { totalReplacementCost += res.getReplacementCost(); System.out.println(res.getCallNumber()+ " "+res.getReplacementCost()); } } // total replacement cost System.out.println("Total replacement cost: "+ totalReplacementCost); } catch (NoSuchElementExc e) { System.err.println("Exception\n"+e); e.printStackTrace(); System.exit(1); } } // end of file }

LibraryBook.java
View the JavaDoc
/* * Author: Ned Martin #40529927 * * Creation Date: 17-AUG-2003 * * Copyright: Ned Martin * * Description: Assignment 4 for COMP2500 * * Tab Stops: Eight spaces */ /** * Container for book items. Implements isLost and getReplacementCost functions. * @author Ned Martin 40529927 * @version FINAL 17-OCT-2003 */ public class LibraryBook extends Borrowable { /** * Construct a library item given its call number and cost. * Type is B - book */ public LibraryBook ( String id, // call number int val // item cost ) { super(id, val); } /** * Has the library item been lost. * @return true if the library item is lost */ public boolean isLost() { return (availability >= 28); } /** * What is the replacement cost of the library item to the library. * @return the integer replacement cost of the library item */ public int getReplacementCost() { return getCost() - (getCost()/2); } // end of file }

Periodical.java
View the JavaDoc
/* * Author: Ned Martin #40529927 * * Creation Date: 17-AUG-2003 * * Copyright: Ned Martin * * Description: Assignment 4 for COMP2500 * * Tab Stops: Eight spaces */ /** * Container for periodical items. Implements isLost function. * @author Ned Martin 40529927 * @version FINAL 17-OCT-2003 */ public class Periodical extends Borrowable { /** A library item is an abstarct class that stores the call number of a library item, the cost of that item and the usage of that item. @author Anthony MacDonald @version 1.0 26/09/2003 */ /** * Construct a library item given its call number and cost. * Type is P - periodical item */ public Periodical ( String id, // call number int val // item cost ) { super(id, val); } /** * Has the library item been lost. * @return true if the library item is lost */ public boolean isLost() { return (availability >= 7); } // end of file }

ReferenceItem.java
View the JavaDoc
/* * Author: Ned Martin #40529927 * * Creation Date: 17-AUG-2003 * * Copyright: Ned Martin * * Description: Assignment 4 for COMP2500 * * Tab Stops: Eight spaces */ /** * Container for reference items. Implements getReplacementCost function. * @author Ned Martin 40529927 * @version FINAL 17-OCT-2003 */ public class ReferenceItem extends Stealable { /** * Construct a library item given its call number and cost. * Type is R - reference item */ public ReferenceItem ( String id, // call number int val // item cost ) { super(id, val); } /** * What is the replacement cost of the library item to the library. * @return the integer replacement cost of the library item */ public int getReplacementCost() { return getCost(); } // end of file }

Stealable.java
View the JavaDoc
/* * Author: Ned Martin #40529927 * * Creation Date: 17-AUG-2003 * * Copyright: Ned Martin * * Description: Assignment 4 for COMP2500 * * Tab Stops: Eight spaces */ /** * Abstract container for non-borrowable library items. * * @author Ned Martin 40529927 * @version FINAL 17-OCT-2003 */ abstract public class Stealable extends LibraryItem implements Availability { private String availability; // if item is available or not /** * Construct a non-borrowable library item given its call number and * cost. * * Only called by subclasses. */ public Stealable ( String id, // call number int val // item cost ) { super(id, val); } /** * Has the library item been lost. * @return true if the library item is lost */ public boolean isLost() { // Y or N for on-shelf or off-shelf (lost) return (getAvailability().equals("N")); } /** * Set whether item is on-shelf or off-shelf (lost). * * Either Y/N */ public void setAvailability ( String avail // if item is available or not Y/N ) { availability = avail; } /** * Return availability * @return String Y if item available or N if item not available */ private String getAvailability() { return availability; } // end of file }

VisualMedium.java
View the JavaDoc
/* * Author: Ned Martin #40529927 * * Creation Date: 17-AUG-2003 * * Copyright: Ned Martin * * Description: Assignment 4 for COMP2500 * * Tab Stops: Eight spaces */ /** * Container for visual-medium items. Implements getReplacementCost function. * @author Ned Martin 40529927 * @version FINAL 17-OCT-2003 */ public class VisualMedium extends Stealable { /** * Construct a library item given its call number and cost. * Type is V - visual-medium item */ public VisualMedium ( String id, // call number int val // item cost ) { super(id, val); } /** * What is the replacement cost of the library item to the library. * @return the integer replacement cost of the library item */ public int getReplacementCost() { return 2*getCost(); } // end of file }

Code © Copyright 2003 Ned Martin

12-Nov-2003