ITI0011:harjutus 10
Üldine
Ülesande kaitsmised: 16. - 18. märts
Kaust gitis: EX10
Ülesanne
Tundmatu logistikakeskus on sattunud seni nägemata probleemi otsa, nimelt tuli firma omanikelt idee luua priotiseeritud pakisüsteemi, mis saadab pakke vastavalt logistikakekuse poolt määratud järjekorrale. Idee oli määratud parendama tähtsate klientide rahololu transporditeenusega. Paraku on süsteem ööpäevaringselt töös ning ümberkirjutamine on antud fintantstingimustes võimatu. Firma peaarhitekti poolt tuli ettepanek laiendada süsteemi standardpakke ja vahetada iga logistikakeskuse väljastusautomaadi PackageProvider uue vastu nii, et oleks täidetud järgmised tingimused:
- Väljastusautomaat eelistab alati
PremiumPackagetüüpi pakke PremiumPackagepakkidest tuleb eelistada kõrgema prioriteediga (suuremapriorityväärtusega pakk)- Kui kaks
PremiumPackagetüüpi pakki omavad sama prioriteeti, siis tuleb arvestada klientide summaarset prioriteeti (receiver.priority + sender.priority). Identsete prioriteetidega pakke ei järjestata (vahet pole, kumb enne väljastatakse) - Tavaliste pakkide puhul arvestada ainult klientide summaarset prioriteeti.
Ülesande jaoks on kaasa antud mõned java-failid (vaata allpool Mall sektsioonist). Interface'e muuta ei tohi. Klasse võite täiendada, aga olemasolev funktsionaalsus peab säilima.
Ülesande jaoks peate looma:
PremiumPackageklassi, mis laiendabPackageklassi ja lisab eelnimetatud funktsionaalsuse. Klassis peavad olemaint getPriority()jasetPriority(int)meetodid.OrderedPackageProviderklassi, mis implementeeribPackageProviderliidest (interface) ja täidab eelnimetatud tingimused.
Mall
Package.java <source lang="java"> /**
* Package class. */
public class Package {
/**
* Package number printed on page.
*/
protected String packageNumber;
/**
* Package width in cm.
*/
protected int width;
/**
* Package height in cm.
*/
protected int height;
/**
* Package sender.
*/
protected Customer sender;
/**
* Package receiver.
*/
protected Customer receiver;
/**
* Get receiver.
*
* @return Receiver customer
*/
public Customer getReceiver() {
return receiver;
}
/**
* Package cunstroctor without arguments.
*/
public Package() {
}
/**
* Package constructor.
*
* @param packageNumber Package number printed on package
* @param width Package width in cm
* @param height Package height in cm
*/
public Package(String packageNumber, int width, int height) {
this.packageNumber = packageNumber;
this.width = width;
this.height = height;
}
/**
* Set receiver.
*
* @param receiver Receiver customer
*/
public void setReceiver(Customer receiver) {
this.receiver = receiver;
}
/**
* Get sender.
*
* @return Sender customer
*/
public Customer getSender() {
return sender;
}
/**
* Set sender.
*
* @param sender Sender customer
*/
public void setSender(Customer sender) {
this.sender = sender;
}
/**
* Get package number.
*
* @return Package number
*/
public String getPackageNumber() {
return packageNumber;
}
/**
* Set package number
*
* @param packageNumber Package number
*/
public void setPackageNumber(String packageNumber) {
this.packageNumber = packageNumber;
}
/**
* Get package height.
*
* @return Package height
*/
public int getHeight() {
return height;
}
/**
* Set package height.
*
* @param height Package height.
*/
public void setHeight(int height) {
this.height = height;
}
/**
* Get package width.
*
* @return Package width.
*/
public int getWidth() {
return width;
}
/**
* Get package width.
*
* @param width Package width.
*/
public void setWidth(int width) {
this.width = width;
}
}
</source>
Customer.java <source lang="java"> /**
* Customer class. */
public class Customer {
/**
* Customer priority.
* 0 < priority < 1000
*/
private int priority;
/**
* Customer name.
*/
private String name;
/**
* Customer address.
*/
private String address;
/**
* Customer constructor without arguments.
*/
public Customer() {
}
/**
* Customer constructor.
*
* @param priority Customer prority
* @param name Customer name
* @param address Customer address
*/
public Customer(int priority, String name, String address) {
this.priority = priority;
this.name = name;
this.address = address;
}
/**
* Get customer address.
*
* @return Customer address
*/
public String getAddress() {
return address;
}
/**
* Set customer address.
*
* @param address Customer address
*/
public void setAddress(String address) {
this.address = address;
}
/**
* Get customer name.
*
* @return Customer name
*/
public String getName() {
return name;
}
/**
* Set customer name.
*
* @param name Customer name
*/
public void setName(String name) {
this.name = name;
}
/**
* Get customer priority.
*
* @return Customer priority
*/
public int getPriority() {
return priority;
}
/**
* Set customer priority
*
* @param priority Customer priority
*/
public void setPriority(int priority) {
this.priority = priority;
}
}
</source>
PackageProvider.java <source lang="java"> import java.util.List;
/**
* PackageProvider interface. */
public interface PackageProvider {
/**
* Get next package in the queue.
*
* @return Next package
*/
Package getNextPackage();
/**
* Add new package to queue.
*
* @param packageToAdd A new package to add
*/
void addPackage(Package packageToAdd);
/**
* Returns whether the provider hax next package or not.
*
* @return next package exists
*/
boolean hasNextPackage();
/**
* Set package filter to queue.
*
* @param packageFilter PackageFilter
*/
void setPackageFilter(PackageFilter packageFilter);
/**
* Get package filter.
*
* @return packageFilter
*/
PackageFilter getPackageFilter();
/**
* Get packages as list (not ordered).
*
* @return Package list
*/
List<Package> getPackages();
/**
* Get all sender packages (not ordered).
*
* @param customer Sender customer
* @return Ordered list of sender packages
*/
List<Package> findAllPackagesBySender(Customer customer);
/**
* Get all reciever packages (not ordered).
*
* @param customer Receiver customer
* @return Ordered list of receiver packages
*/
List<Package> findAllPackagesByReceiver(Customer customer);
}
</source>
PackageFilter.java <source lang="java"> /**
* Package filtering interface. */
public interface PackageFilter {
/**
* Validate package information.
*
* @param p Package to validate.
* @return Whether the package information is correct.
*/
boolean isValid(Package p);
/**
* Get broken package provider.
* Broken package provider includes all
*
* @return BrokenPackageProvider
*/
PackageProvider getBrokenPackageProvider();
}
</source>
Põhiosa jaoks te ei pea PackageFilter implementatsiooni (ehk siis klassi, mis implementeerib filtrit) looma. Aga get ja set meetodid peavad ikka töötama.
Koodinäide
<source lang="java"> OrderedPackageProvider pp = new OrderedPackageProvider();
Customer c1 = new Customer(12, "kati", "põdra"); Customer c2 = new Customer(10, "mati", "metsa"); Customer c3 = new Customer(12, "vati", "villa"); // notation in the name: // s: priority of the sender, r: priority of the receiver Package p1 = new Package("p (s:12 r:10)", 100, 100); p1.setSender(c1); p1.setReceiver(c2); Package p2 = new Package("p (s:10 r:12)", 100, 120); p2.setSender(c2); p2.setReceiver(c1); // notation in the name: // pp priority s: priority of the sender, r: priority of the receiver PremiumPackage pp1 = new PremiumPackage(10, "pp 10 (s:12 r:10)", 100, 100); PremiumPackage pp2 = new PremiumPackage(10, "pp 10 (s:12 r:12)", 100, 100); PremiumPackage pp3 = new PremiumPackage(12, "pp 12 (s:12 r:12)", 100, 100);
pp1.setSender(c1); pp1.setReceiver(c2);
pp2.setSender(c1); pp2.setReceiver(c3);
pp3.setSender(c1); pp3.setReceiver(c3);
pp.addPackage(p1); pp.addPackage(p2); pp.addPackage(pp2); pp.addPackage(pp1); pp.addPackage(pp3); // we use lambda expression pp.getPackages().forEach(p -> System.out.println(p.getPackageNumber())); // if Package.toString is implemented to print out package number, we could use: // pp.getPackages().forEach(System.out::println);
// the above is the same as: /* for (Package p : pp.getPackages()) {
System.out.println(p.getPackageNumber());
}
- /
// take the next (first) package pp.getNextPackage(); // 4 remains: System.out.println(pp.getPackages().size()); pp.getPackages().forEach(p -> System.out.println(p.getPackageNumber()));
// add a new package PremiumPackage pp4 = new PremiumPackage(13, "pp 13 (s:12 r:12)", 100, 100); pp4.setSender(c1); pp4.setReceiver(c3); pp.addPackage(pp4); System.out.println("After adding a new one:"); pp.getPackages().forEach(p -> System.out.println(p.getPackageNumber()));
// take 4 more packages pp.getNextPackage(); pp.getNextPackage(); pp.getNextPackage(); pp.getNextPackage();
// do we have more? System.out.println(pp.hasNextPackage()); // do we? System.out.println(pp.getNextPackage()); // ok
// do we still have more? System.out.println(pp.hasNextPackage()); // NO! System.out.println(pp.getNextPackage()); // no more -> null </source>
Väljund:
pp 12 (s:12 r:12) pp 10 (s:12 r:12) pp 10 (s:12 r:10) p (s:12 r:10) p (s:10 r:12) 4 pp 10 (s:12 r:12) pp 10 (s:12 r:10) p (s:12 r:10) p (s:10 r:12) After adding a new one: pp 13 (s:12 r:12) pp 10 (s:12 r:12) pp 10 (s:12 r:10) p (s:12 r:10) p (s:10 r:12) true p (s:10 r:12) false null
Lisaosa (0.5p)
Sageli satub pakiringlusesse pakke, mis ei vasta ettevõtte poolt ettekirjuatud nõudmistele. Implementeerida PackageFilter alusel PackageProviderisse sisendfilter, mis kontrollib pakkide valiidsust. Kõik pakid peavad vastama tingimustele:
- Receiver, sender ei ole tühi, receiveril on nimi (mitte tühistring).
- Receiver, sender aadress ei ole tühi
- Receiver, sender priority on suurem kui 0 ja väiksem kui 1000
- Kõrgus ja laius on rangelt 0-st suuremad ja rangelt 1000-st väiksemad
- Receiver ei ühti senderiga (kliendi andmed peavad erinema)
PremiumPackage puhul:
- Priority rangelt suurem kui 0 ja rangelt väiksem kui 1000.
- PackageProvideris ei tohi olla 2 korda sama pakki (paki andmed peavad erinema)