Zadání úloh do pøedmìtu pa165

Úloha è. 1 - katalog produktù (JDBC)

S vyu¾itím JDBC implementujte jednoduchý katalog produktù. V archivu pa165.tar.gz naleznete rozhraní Product, Group a Catalog. Implementujte tøídy cz.muni.fi.pa165.catalog.jdbc.ProductImpl, cz.muni.fi.pa165.catalog.jdbc.GroupImpl a cz.muni.fi.pa165.catalog.jdbc.CatalogImpl, které budou tato rozhraní implementovat. Tøída cz.muni.fi.pa165.catalog.jdbc.CatalogImpl bude mít bezparametrický konstruktor a URL databáze získá jako system property 'cz.muni.fi.pa165.catalog.jdbcUrl', jméno u¾ivatele bude v property 'cz.muni.fi.pa165.catalog.jdbcUser' a heslo bude v property 'cz.muni.fi.pa165.catalog.jdbcPassword' (viz System.getProperty(String). Pøi vytváøení instance katalogu nezapomeòte vytvoøit tabulky v databázi! Jako JDBC driver pou¾ijte org.hsqldb.jdbcDriver.

Zadání bude je¹tì trochu upøesnìno!

FAQ

• Q: Do kdy má být úloha odevzdána?

  A: Na vypracování máte ètrnáct dní, tj. pro skupiny 3 (pondìlí 16:00) a 4 (pondìlí 18:00) je deadline 25.10. a pro skupiny 1 (støeda 14:00) a 2 (støeda 16:00) je deadline 27.10. Ale zaènìte úlohu øe¹it u¾ nyní, abyste se mohli na pøípadné nejasnosti zeptat ve cvièení 18.10. resp 20.10. Na tìchto cvièeních Vám také mohou být udìleny rady a pokyny, jak danou úlohu správnì øe¹it.

• Q: Jak si mám vylo¾it upozornìní "zadání bude je¹tì trochu upøesnìno", které je u¾ od pondìlí na konci zadání?

  A: Pokud nìkdo upozorní na nejasnost, bude zadání upøesnìno.

• Q: Trochu mì zará¾í pou¾ití tøídy List jako návratový typ u metod GetChildGroups a getProducts. Radìji bych pou¾il Map (kvùli pou¾ití oid jako klíèe).

  A: Máte pravdu, ¾e by se jako návratový typ dal teoreticky pou¾ít Map. Ale vìt¹inou se to tak nedìlá. Vhodnìj¹í je pou¾ít obecnou kolekci (Collection) a v pøípadì potøeby do rozhraní (v na¹em pøípadì Group) doplnit metodu, která nalezne a vrátí objekt s daným klíèem. Práce s objekty typu Map je obecnì komplikovanìj¹í (zkuste porovnat kód nutný k vypsání v¹ech objektù v kolekci typu List a v kolekci typu Map). Kdy¾ budete chtít se seznamem objektù dále pracovat, nebo jej pøedat dál, je mnohem pravdìpodobnìj¹í, ¾e se vám bude hodit typ Collection (pøípadnì List nebo Set). Pravidlo èíslo jedna, kterého byste se v¾dy mìli dr¾et, zní: "Udìlej to tak nejjednodu¹eji, jak jen to jde."

  Poznámka: V na¹em pøípadì jsme místo typu Collection pou¾ili typ List, proto¾e jako druhou úlohu budete mo¾ná øe¹it nìjaké rozhraní pro tento katalog, a potom se vám s uspoøádanou kolekcí bude pracovat lépe, ne¾ s kolekcí neuspoøádanou.

• Q: Vy asi budete testovat správnost úloh automaticky podle daných rozhraní, tak nevím, jestli to mohu/nemohu pro sebe zmìnit.

  A: ¬ádné zmìny zadaných rozhraní provádìt nemù¾ete!

• Q: Jakým zpùsobem se má zakládat úplnì první skupina (která nemá ¾ádnou parentGroup)?

  A: Zalo¾íte ji v okam¾iku vytvoøení katalogu.

• Q: Co vracet v metodì getRootGroup() kdy¾ bude koøenových skupin více? Mám pøi zakládání koøenové skupiny (viz pøedchozí bod) hlídat aby se to nestalo?

  A: Koøenová skupina bude v¾dy pouze jedna.

• Q: Co kdy¾ zavolám metodu newGroup(...) nebo newProduct(...) s parametrem parentGroup s hodnotou null.

  A: Metoda vyvolá výjimku NullPointerException.

• Q: Metody getChildGroups() a getProducts() jsou v GroupImpl vzhledem k absenci dal¹ích metod evidentnì urèeny k tomu, aby vracely originální seznamy patøièných objektù a umo¾nily tak úpravy a ru¹ení svázaných objektù. Nebylo by v rámci zapouzdøení lep¹í vracet pouze read-only List (Collections.unmodifiableList(...)) a pøidat do rozhraní Group metody pro jejich zmìny?

  A: Samozøejmì se pøedpokládá, ¾e vrácený seznam bude read-only. Pøidávání podskupin a produktù øe¹í metody newGroup(...) a newProduct(...), odebírání a pøesouvání skupin a produktù není pro jednoduchost vy¾adováno. Úpravy objektù se øe¹í pøímým voláním metod daného objektu. (Tìmto otázkám se budeme vìnovat ve cvièení 18.10. resp 20.10.)

• Q: Jakým zpùsobem má fungovat napøíklad metoda CatalogImpl.newProduct(Group, String, double)? Na vstupu mám objekt implementující rozhraní Group, do kterého mám pøidat novì vytvoøený produkt, ale rozhraní Group nemá ¾ádné metody, které by to umo¾òovaly. A zmìnit ho nesmím. Analogická situace je u metody newGroup().

  A: Rozhraní Group neposkytuje metody pro pøidávání a odebíraní podskupin a produktù zcela úmyslnì kvùli dodr¾ení principu zapouzdøení. Mo¾ností, jak Vá¹ problém vyøe¹it je více, ale standardní øe¹ení vypadá zhruba takto:

  public void newProduct(Group parentGroup,...) {
     if (!parentGroup instanceof GroupImpl) {
         throw new IllegalArgumentException("Parameter parentGroup is not from this catalog.");
     }
     else {
        GroupImpl parent = (GroupImpl) parentGroup;
        ...
     }
  } 
  

• Q: To je sice øe¹ení, které je pou¾itelné ve ¹kolní úloze o 10 tøídách, ale obecnì to vhodný pøístup urèitì není. Dopisovat "if" blok pri ka¾dém pøidání tøídy implementující rozhraní Group je pøece nesmysl. Na metodách napø. Group.addSubGroup(Group) a Group.addProduct(Product) nevidím nic, co by naru¹ovalo princip zapouzdøení.

  A: Dekompozice byla schválnì udìlaná tak, aby za v¹echny zmìny ve struktuøe katalogu bylo odpovìdné rozhraní Catalog (jde o standardní vzor). Pøidáním veøejné metody Group.addSubGroup(Group) a Group.addProduct(Product) do rozhraní Group dáváte u¾ivateli mo¾nost zcela obejít metodu newProduct a newGroup u rozhraní Catalog a pøidat tam úplnì cizí objekt, který si vytvoøí nìkde bokem. Navíc zbyteènì zaplevelujete veøejné rozhraní metodami, které by buï u¾ivatel tohoto rozhraní nemìl vùbec pou¾ívat (pak tam nemají co dìlat), a nebo nutíte implemenntátora dodr¾et tato rozhraní a implementovat pøíslu¹né metody, i kdy¾ by chtìl implementaci provést zcela odli¹ným zpùsobem. Uvìdomte si, ¾e byste u veøejného rozhraní nemìl nic vìdìt o vnitøní struktuøe objektu, který mù¾e být napø. pouhou skoøápkou nebo proxy objektem a který tak vùbec uvnitø seznam produktù a skupin vùbec nemusí mít!

  Co se týèe Va¹í pøipomínky k pøidávání pøíkazu if, pak podotýkám, ¾e ten by tam musel být stejnì, nebo» byste stejnì musel kvùli zaji¹tìní konzistence ovìøit, jestli Vám tam nìkdo nepøedává jako parametr skupinu z jiného katalogu. A dal¹í pøíkaz if byste musel pøidat do Group.addSubGroup(Group) a Group.addProduct(Product), abyste o¹etøil pøípad, kdy by Vám tam nìkdo opìt dával objekt z cizího katalogu.

Úloha è. 2 - WWW rozhraní pro katalog produktù

Vytvoøte www rozhraní pro katalog produktù z první úlohy. Z pedagogických dùvodù nepou¾ívejte Struts ani jiný rámec, MVC pattern pou¾ít mù¾ete (je silnì doporuèen).

Pro øe¹ení druhé úlohy upravte svoji implementaci katalogu z úlohy první tak, aby nenavazovala spojení s databází ve vlastní re¾ii (podle nastavení systémové property 'cz.muni.fi.pa165.catalog.jdbcUrl'), ale vyu¾ila zdroje dat (DataSource) poskytovaného webovým kontejnerem prostøednictvím JNDI (viz informace poskytnuté na cvièení). Tento zdroj bude mít název 'jdbc/CatalogDB'. Jak nakonfigurovat datové zdroje v prostøedí kontejneru Tomcat naleznete na adrese http://jakarta.apache.org/tomcat/tomcat-5.0-doc/jndi-datasource-examples-howto.html.