Desáté cvičení

1. Desáté cvičení • Java Core API • Java Collection Framework • JavaDoc

2. Java Core API • množství již hotových tříd dodávaných společně s distribucí Javy. • v balících začínající java. • garantováno, že se budou i v dalších verzích Javy, chovají se stejně na všech prostředích • v balících začínající javax. • …nemá smysl vymýšlet, co již jednou někdo naimplemetoval a odladil Java cv10

3. Java Core API http://java.sun.com/j2se/1.4.2/docs/api/index.html Java cv10

4. Java Core API • Nejdůležitější balíky • java.lang – základní základy javy • java.math – matematické operace • java.net – síťová komunikace • java.util – utility, zejména kolekce • java.awt – grafické rozhraní • javax.swing – pokročilé grafické rizhraní • javax.xml – zpracování XML Java cv10

5. Java Collection Framework Java cv10

6. Java Collection Framework • Kolekce – objekt, který představuje sadu objektů (podobně jako pole) • Collection Framework – způsob jak standardně nakládat s kolekcemi objektů • Rozhraní • Algoritmy • Implmentace • Třídy v balíku java.util • detailní informace o JCF http://java.sun.com/j2se/1.4.2/docs/guide/collections/ Java cv10

7. Java Collection Framework - rozhraní • Přes rozhraní se standardně pracuje s kolekcemi • Rozhraní definuje vlastnosti kolekce • Collection – kolekce objektů • Set – množina • List - sekvence • Map – páry klíč - hodnota • Vlastní implementace je až podružná • určuje například rychlost provádění určitých operaci s kolekcí Java cv10

8. Java Collection Framework - rozhraní Java cv10

9. Java Collection Framework - algoritmy • Collection • add(Object o), contains(Object o), remove (Object o) • iterator() • toArray() • Map • put(Object key, Object value), get(Object key), containsKey(Object key), containsValue(Object value) • keySet() • Iterator • hasNext(), next() • Comparator • compare(Object o1, Object o2) Java cv10

10. Java Collection Framework – další algoritmy • Třída Collections • sort(List l) • sort(List l, Comparator c) • binarySearch(List l, Object o) • binarySearch(List l, Object o, Comparator c) • reverse(List l) • shuffle(List l) • min(Collection c) • max(Collection c) Java cv10

11. Java Collection Framework - třídy • Různé způsoby implementace • Pomocí hashovací funkce • Pomocí stromu • Pomocí spojového seznamu • Pomocí pole Java cv10

12. JavaDoc Java cv10

13. JavaDoc • Standardní způsob dokumentace zdrojového kódu • Ze speciálních komentářů v kódu se vygenerují HTML stránky popisující třídy, metody, položky • Unifikovaná dokumentace všech Java tříd • Spuštění programem javadoc • Př: javadoc –d .\doc cz.sks.evidencecd Java cv10

14. JavaDoc umístění komentářů • Vždy o řádek výš než dokumentovaná entita • dokumentace tříd • dokumentace metod • dokumentace polí • Př.: /** * Interface pro uloziste. * @since 29.4.2005 */ publicinterface Uloziste{ /** * Ulozi celou evidenci do uloziste. * @param evid objekt evidence, ktera bude ulozena * @throws IOException pokud se ulozeni nepovede */ publicvoid store(EvidenceCD evid) throws IOException ; } Java cv10

15. JavaDoc tagy • Dva typy • block – musí začínat „@“ na nové řádce • inline – {@tag-name}, kdekoli v popisu • Nejpoužívanější: • @author – tvůrce kódu • @since – datum vzniku • @version - verze • @deprecated – informace, že tato třída/metoda je zastaralá a neměla by se dále používat • @param – popis parametru metody • @return – popis návratové hodnoty • @throws – popis příčiny vzniku výjimky • @see – odkaz na jinou třídu/metodu/položku • {@link} – odkaz na jinou třídu/metodu/položku Java cv10

16. JavaDoc příklady • javadoc -d \home\html -sourcepath \home\src -subpackagesjava-exclude java.net:java.lang • Projde všechny podbalíky balíku java v adresáři \home\src kromě balíků java.net, java.lang a jejich podbalíků • javadoc -d C:\home\html -sourcepath C:\home\src cz.sks.pokusy • Vytvoří dokumentaci pro balík cz.sks.pokusy, který se nachází v adresáři c:\home\src Java cv10

17. JavaDoc referenční příručka http://java.sun.com/j2se/1.4.2/docs/tooldocs/windows/javadoc.html Java cv10