ITI0011:harjutus 10 - Redigeerimiste ajalugu

Ago: /* Lisaosa (0.5p) */

2016-03-20T12:55:58Z

Lisaosa (0.5p)

Ago: /* Lisaosa (0.5p) */

2016-03-20T12:54:13Z

Lisaosa (0.5p)

Ago: /* Lisaosa (0.5p) */

2016-03-20T12:50:23Z

Lisaosa (0.5p)

Ago: /* Lisaosa (0.5p) */

2016-03-20T12:49:04Z

Lisaosa (0.5p)

Ago: /* Lisaosa (0.5p) */

2016-03-20T12:42:32Z

Lisaosa (0.5p)

Ago: /* Lisaosa (0.5p) */

2016-03-19T06:08:16Z

Lisaosa (0.5p)

Ago: /* Lisaosa (0.5p) */

2016-03-19T06:08:01Z

Lisaosa (0.5p)

Ago – 18. märts 2016, kell 10:01

2016-03-18T10:01:21Z

Ago – 17. märts 2016, kell 12:03

2016-03-17T12:03:02Z

Ago: /* Mall */

2016-03-16T15:08:46Z

Mall

←Vanem redaktsioon		Redaktsioon: 20. märts 2016, kell 12:55
488. rida:		488. rida:

	Te '''ei pea looma''' uut klassi BrokenPackageProvider (või kui siis vaid testimiseks). Automaattestimise käigus kasutatakse meie loodud objekte seal.		Te '''ei pea looma''' uut klassi BrokenPackageProvider (või kui siis vaid testimiseks). Automaattestimise käigus kasutatakse meie loodud objekte seal.
		+
		+	=== Testimine ===

	Lisaosa testides on üks suur test (miljoni objektiga). See test lisab 1000000 pakki teie providerisse. Ajalimiit on 10 sekundit. Selle lahendamiseks peaks kasutama näiteks <code>TreeSet</code> (https://docs.oracle.com/javase/8/docs/api/java/util/TreeSet.html) andmestruktuuri pakkide hoidmiseks. Kõik muud variandid (kui üritate pidevalt sortida jms) jäävad liiga aeglaseks.		Lisaosa testides on üks suur test (miljoni objektiga). See test lisab 1000000 pakki teie providerisse. Ajalimiit on 10 sekundit. Selle lahendamiseks peaks kasutama näiteks <code>TreeSet</code> (https://docs.oracle.com/javase/8/docs/api/java/util/TreeSet.html) andmestruktuuri pakkide hoidmiseks. Kõik muud variandid (kui üritate pidevalt sortida jms) jäävad liiga aeglaseks.

←Vanem redaktsioon		Redaktsioon: 20. märts 2016, kell 12:54
488. rida:		488. rida:

	Te '''ei pea looma''' uut klassi BrokenPackageProvider (või kui siis vaid testimiseks). Automaattestimise käigus kasutatakse meie loodud objekte seal.		Te '''ei pea looma''' uut klassi BrokenPackageProvider (või kui siis vaid testimiseks). Automaattestimise käigus kasutatakse meie loodud objekte seal.
		+
		+	Lisaosa testides on üks suur test (miljoni objektiga). See test lisab 1000000 pakki teie providerisse. Ajalimiit on 10 sekundit. Selle lahendamiseks peaks kasutama näiteks <code>TreeSet</code> (https://docs.oracle.com/javase/8/docs/api/java/util/TreeSet.html) andmestruktuuri pakkide hoidmiseks. Kõik muud variandid (kui üritate pidevalt sortida jms) jäävad liiga aeglaseks.

	=== Koodinäide ===		=== Koodinäide ===

@@ 482. rida: / 482. rida: @@
 Pakid, mis filtrist läbi ei lähe (<code>isValid</code> tagastab <code>false</code>) pannakse teie OrderedPackageProvider objekti poolt teise PackageProviderisse, mis on määratud <code>setBrokenPackageProvider</code> meetodiga. Kui sellist broken package providerit pole lisatud, siis mittekorrektsed pakid lihtsalt kaovad ära.
-Mis tuleb teha:
+'''Mis tuleb teha''':
 * kirjutate klassi <code>OrderedPackageFilter</code> mis implementeerib <code>PackageFilter</code> liidest.
 * loodud klassi <code>isValid</code> meetod peab tagastab true, kui etteantud pakk rahuldab kõiki eelpool mainitud tingimusi. Muul juhul tagastab false.
 * <code>OrderedPackageProvider</code> klassis peate <code>addPackage</code> meetodis kontrollima, et kui objektile on määratud filter (uue instantsi puhul on filter vaikimisi <code>null</code>, seda saab määrata eraldi, vt all koodinäide), siis kontrollite filtri <code>isValid</code> meetodi tagastust. Kui <code>isValid</code> tagastab <code>true</code>, lisate paki oma pakkide nimekirja (nii, nagu te tegite seda põhiosas ilma filtrita). Kui <code>isValid</code> tagastab <code>false</code>, lisate paki brokenPackageProvider objekti (kuna see realiseerib samamoodi <code>PackageProvider</code> liidest, on tal meetod <code>addPackage</code> - seda peategi kasutama). Kui <code>brokenPackageProvider</code> on <code>null</code> (ehk objekti pole määratud teie OrderedPackageProvider'ile), siis pakki ei lisata kuhugi.
 === Koodinäide ===

←Vanem redaktsioon		Redaktsioon: 20. märts 2016, kell 12:49
481. rida:		481. rida:

	Pakid, mis filtrist läbi ei lähe (<code>isValid</code> tagastab <code>false</code>) pannakse teie OrderedPackageProvider objekti poolt teise PackageProviderisse, mis on määratud <code>setBrokenPackageProvider</code> meetodiga. Kui sellist broken package providerit pole lisatud, siis mittekorrektsed pakid lihtsalt kaovad ära.		Pakid, mis filtrist läbi ei lähe (<code>isValid</code> tagastab <code>false</code>) pannakse teie OrderedPackageProvider objekti poolt teise PackageProviderisse, mis on määratud <code>setBrokenPackageProvider</code> meetodiga. Kui sellist broken package providerit pole lisatud, siis mittekorrektsed pakid lihtsalt kaovad ära.
		+
		+	Mis tuleb teha:
		+	* kirjutate klassi <code>OrderedPackageFilter</code> mis implementeerib <code>PackageFilter</code> liidest.
		+	* loodud klassi <code>isValid</code> meetod peab tagastab true, kui etteantud pakk rahuldab kõiki eelpool mainitud tingimusi. Muul juhul tagastab false.
		+	* <code>OrderedPackageProvider</code> klassis peate <code>addPackage</code> meetodis kontrollima, et kui objektile on määratud filter (uue instantsi puhul on filter vaikimisi <code>null</code>, seda saab määrata eraldi, vt all koodinäide), siis kontrollite filtri <code>isValid</code> meetodi tagastust. Kui <code>isValid</code> tagastab <code>true</code>, lisate paki oma pakkide nimekirja (nii, nagu te tegite seda põhiosas ilma filtrita). Kui <code>isValid</code> tagastab <code>false</code>, lisate paki brokenPackageProvider objekti (kuna see realiseerib samamoodi <code>PackageProvider</code> liidest, on tal meetod <code>addPackage</code> - seda peategi kasutama). Kui <code>brokenPackageProvider</code> on <code>null</code> (ehk objekti pole määratud teie OrderedPackageProvider'ile), siis pakki ei lisata kuhugi.

	=== Koodinäide ===		=== Koodinäide ===

←Vanem redaktsioon		Redaktsioon: 20. märts 2016, kell 12:42
481. rida:		481. rida:

	Pakid, mis filtrist läbi ei lähe (<code>isValid</code> tagastab <code>false</code>) pannakse teie OrderedPackageProvider objekti poolt teise PackageProviderisse, mis on määratud <code>setBrokenPackageProvider</code> meetodiga. Kui sellist broken package providerit pole lisatud, siis mittekorrektsed pakid lihtsalt kaovad ära.		Pakid, mis filtrist läbi ei lähe (<code>isValid</code> tagastab <code>false</code>) pannakse teie OrderedPackageProvider objekti poolt teise PackageProviderisse, mis on määratud <code>setBrokenPackageProvider</code> meetodiga. Kui sellist broken package providerit pole lisatud, siis mittekorrektsed pakid lihtsalt kaovad ära.
		+
		+	=== Koodinäide ===
		+
		+	Filtri testimiseks (eeldus on, et OrderedPackageFilter on realiseeritud):
		+
		+	<source lang="java">
		+	PackageProvider packageProvider = new OrderedPackageProvider();
		+	// let's confirm that the list is empty:
		+	System.out.println(packageProvider.getPackages().size());
		+
		+	// bad package - empty package number, no customers
		+	Package badPackage = new Package("", 10, 10);
		+
		+	// as by default there is no filter, this package is added:
		+	packageProvider.addPackage(badPackage);
		+	// let's confirm that there is one element:
		+	System.out.println(packageProvider.getPackages().size());
		+
		+	// create your own package filter instance
		+	PackageFilter orderedPackageFilter = new OrderedPackageFilter();
		+	// let's add this filter to provider:
		+	packageProvider.setPackageFilter(orderedPackageFilter);
		+
		+	// another bad package
		+	badPackage = new Package("", 0, 0); // very bad
		+	packageProvider.addPackage(badPackage);
		+	// this package should not go the the list, therefore the size should be 1:
		+	System.out.println(packageProvider.getPackages().size());
		+
		+	// we can validate packages directly in filter also:
		+	System.out.println(orderedPackageFilter.isValid(badPackage)); // false
		+
		+	badPackage = new PremiumPackage(0, "PAKKK", 1, 2);
		+	System.out.println(orderedPackageFilter.isValid(badPackage)); // false
		+
		+	// let's create some valid packages too
		+	Customer c1 = new Customer(10, "mati", "metsas");
		+	Customer c2 = new Customer(11, "kati", "kaugel");
		+
		+	badPackage = new PremiumPackage(1, "PAKKK", 1, 2);
		+	badPackage.setSender(c1);
		+	badPackage.setReceiver(c2);
		+	System.out.println(orderedPackageFilter.isValid(badPackage)); // true
		+
		+	Customer c3 = new Customer(10, "mati", "metsas"); // same data as c1
		+	badPackage = new PremiumPackage(1, "Must have", 10, 11);
		+	badPackage.setSender(c1);
		+	badPackage.setReceiver(c3);
		+	System.out.println(orderedPackageFilter.isValid(badPackage)); // false
		+
		+	// we can remove the filter also
		+	packageProvider.setPackageFilter(null);
		+	badPackage = new PremiumPackage(0, "pakk matile", 11, 0);
		+	// no sender/receiver
		+
		+	// now everything should be added, again
		+	packageProvider.addPackage(badPackage);
		+	System.out.println(packageProvider.getPackages().size());
		+	</source>
		+
		+	Oodatav väljund:
		+	<pre>
		+	0
		+	1
		+	1
		+	false
		+	false
		+	true
		+	false
		+	2
		+	</pre>
		+
		+	Broken package provider'i testimiseks on järgmine kood. Tähelepanu tuleb pöörata sellele, et see kood automaatselt käima ei lähe. Kuna BrokenPackageProvider (mida selles koodis on kasutatud) ei ole tegelikult selle ülesande osa, siis ei ole selle koodi siin ka välja toodud. Mõte on selles, et te saate sinna määrata ükskõik millise PackageProvider interface'i implementeeriva klassi. Seega põhimõtteliselt võite sinna ette anda ka oma OrderedPackageProvideri.
		+
		+	See kood tuleks panna eelmise koodi lõppu (kuna kasutab samu muutujaid jms):
		+	<source lang="java">
		+	// let's try brokenPackageProvider
		+	// we have creates a new class BrokenPackageProvider
		+	// which is just an implementation of PackageProvider.
		+	// NOTE! you don't have to create BrokenPackageProvider
		+	// and don't need to upload it.
		+	// to run this test, just create class:
		+	// class BrokenPackageProvider implements PackageProvider
		+	// and implement just addPackage and getPackages methods
		+	PackageProvider broken = new BrokenPackageProvider();
		+	packageProvider.setBrokenPackageProvider(broken);
		+	// let's add the filter again
		+	packageProvider.setPackageFilter(orderedPackageFilter);
		+
		+	System.out.println("Test broken package provider");
		+	// we should start with 0
		+	System.out.println("broken provider: " + broken.getPackages().size());
		+	// the main provider is here:
		+	System.out.println("main provider: " + packageProvider.getPackages().size());
		+
		+	System.out.println("adding \"broken\" package");
		+	packageProvider.addPackage(badPackage);
		+
		+	// broken package provider should have one package in it:
		+	System.out.println("broken provider: " + broken.getPackages().size());
		+	// the main provider should remain where it was
		+	System.out.println("main provider: " + packageProvider.getPackages().size());
		+	</source>
		+
		+	Oodatav väljund:
		+	<pre>
		+	Test broken package provider
		+	broken provider: 0
		+	main provider: 2
		+	adding "broken" package
		+	broken provider: 1
		+	main provider: 2
		+	</pre>

@@ 469. rida: / 469. rida: @@
 == 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. Klassi nimi peab olema <code>OrderedPackageFilter</code.
+Sageli satub pakiringlusesse pakke, mis ei vasta ettevõtte poolt ettekirjuatud nõudmistele. Implementeerida PackageFilter alusel PackageProviderisse sisendfilter, mis kontrollib pakkide valiidsust. Klassi nimi peab olema <code>OrderedPackageFilter</code>.
 Kõik pakid peavad vastama tingimustele:
 * Receiver, sender ei ole tühi, receiveril on nimi (mitte tühi sõne).

@@ 469. rida: / 469. rida: @@
 == 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.
+Sageli satub pakiringlusesse pakke, mis ei vasta ettevõtte poolt ettekirjuatud nõudmistele. Implementeerida PackageFilter alusel PackageProviderisse sisendfilter, mis kontrollib pakkide valiidsust. Klassi nimi peab olema <code>OrderedPackageFilter</code.
 Kõik pakid peavad vastama tingimustele:
-* Receiver, sender ei ole tühi, receiveril on nimi (mitte tühistring).
+* Receiver, sender ei ole tühi, receiveril on nimi (mitte tühi sõne).
 * 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.
-Viimase punkti realiseerimiseks peab filter teadma pakkide nimekirja. Selleks tuleb luua konstruktor, mis saab ette PackageProvider instantsi ja sealtkaudu saate kätte nimekirja ja saate seda kontrollida.
+Pakid, mis filtrist läbi ei lähe (<code>isValid</code> tagastab <code>false</code>) pannakse teie OrderedPackageProvider objekti poolt teise PackageProviderisse, mis on määratud <code>setBrokenPackageProvider</code> meetodiga. Kui sellist broken package providerit pole lisatud, siis mittekorrektsed pakid lihtsalt kaovad ära.

@@ 301. rida: / 301. rida: @@
       */
      PackageFilter getPackageFilter();
      /**
@@ 342. rida: / 358. rida: @@
       */
      boolean isValid(Package p);
+}

@@ 11. rida: / 11. rida: @@
 * Kui kaks <code>PremiumPackage</code> tüüpi pakki omavad sama prioriteeti, siis tuleb arvestada klientide '''summaarset prioriteeti''' (<code>receiver.priority + sender.priority</code>). 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.
@@ 357. rida: / 358. rida: @@
 === Koodinäide ===
 <source lang="java">
@@ 467. rida: / 470. rida: @@
 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)
+* PackageProvideris ei tohi olla 2 korda sama pakki (paki andmed peavad erinema, kaasa arvatud klientide andmed)
-<!--
+Viimase punkti realiseerimiseks peab filter teadma pakkide nimekirja. Selleks tuleb luua konstruktor, mis saab ette PackageProvider instantsi ja sealtkaudu saate kätte nimekirja ja saate seda kontrollida.

@@ 337. rida: / 337. rida: @@
       * Validate package information.
+      *
       * @return Whether the package information is correct.
       */
-     boolean isValid();
+     boolean isValid(Package p);
      /**