• L’estructura bàsica de l’aplicació seria: tool -> logic-api -> logic-impl -> dao-api -> dao-impl.
  On:
  • tool -> capa de presentacio.
  • logic-api -> interfície de la capa de domini.
  • logic-impl -> implementació de la interfície de domini.
  • dao-api -> interfície de la capa de dades.
  • dao-impl -> implementació de la interfície de dades.
• Servei de connexió opcional:
  • public-api -> logic-api.

2. Estructura d’arxius:

 3. Estructura Java (packages):

• El Template (sempre HTML) defineix l’interfície.
  Han de ser XML vàlids i verdaderament són plantilles XHTML.
  L’atribut rsf:id identifica el component per al Producer.
• El Producer (java o XML) defineix la vista, omple la plantilla (el Template) amb informació dinàmica i gestiona la navegació.
  Defineix únicament una vista establint un ViewID.
  Ha d’implementar el ViewComponentProducer per poder veure els rsf:id.
  Es defineix la pàgina principal implementant DefaultView.
  Per poder controlar la navegació POST (submit) ha d’implementar NavigationCaseReporter.
  Per poder rebre atributs a través del mètode GET ha d’implementar ViewParamsReporter.
• ViewParams defineix els atributs que es passen entre vistes (mètodes GET).
  Estén SimpleViewParameters.
  S’hauria d’utilitzar quan s’han de transmetre dades d’una vista a una altra.
  Pot ser utilitzar en múltiples pàgines.
• El Backing Bean processa les accions (mètodes POST).
  Bean amb mètodes que s’ocupen de les accions i propietats públiques.
  No té dependencies RSF.
  Pot interactuar amb la capa de domini.
  Creat i destruït en el cicle de requesta per defecte.
• A requestContext es defineixen quins són els Producers i els Backing Beans.
  També anomenat RSAC (Request Scope Application Context).
  Està escrit com un arxiu de definició de Spring estàndard.
  Només inclou un subgrup de la funcionalitat per defecte per incrementar la velocitat.
  La localització d’aquest arxiu està definit a web.xml.
• A applicationContext es defineix l’àmbit dels Backing Beans de l’aplicació i gestiona a través d’Spring la configuració dels RSF de l’aplicació.
  Està escrit com un arxiu de definició de Spring estàndard.
  La localització d’aquest arxiu està definit a web.xml.
• La Logic Layer representa la resta de l’apliació (capa de domini i de dades).
• El model és el tipus de dada bàsica també anomenada POJO.

Els arxius marcats en verd són els que s’expliquen en qualsevol tutorial de hibernate que es pugui trobar a la xarxa.

En el nostre cas SocialBookmarksItem.java seria el POJO on estarien els valors que defineixen un item (un bookmark), amb els seus getters i setters. 
A SocialBookmarksItem.hbm.xml s’especifica el nom de la taula a la BBDD i els camps que tindrà (hauria de seguir la lògica de SocialBookmarksItem.java).
Per acabar a hibernate.cfg.xml s’indiquen els recusos que s’han de carregar: <mapping resource=”org/sakaiproject/socialbookmarks/dao/hbm/SocialBookmarksItem.hbm.xml” /> en el nostre cas.

Ara bé, els arxius marcats en vermell no s’expliquen a cap tutorial i fan la funció següent:

spring-hibernate.xml: s’ha d’incloure el mateix que ha hibernate.cfg.xml. <mapping resource=…. />

AddItemProducer.java: aquest arxiu parla més sobre què s’ha de fer quan s’insereix un nou item (bookmark). M’ha donat problemes ja que en aquest arxiu s’utilitzen directament els noms dels atributs definits al POJO SocialBookmarksItem.java en forma d’String (p.ex. “#{itemsBean.newItem.hidden}”, on hidden és un atribut del POJO).

Dit això, em posaré mans a la feina i descriuré una mica com és que m’agradaria que quedés al final el projecte. En quant a taules, una cosa semblant a aquesta:

D’aquesta manera mitjançant el id d’usuari de sakai podrem saber quins bookmarks té guardats aquest i, a més, quants usuaris tenen guardat un mateix bookmark.

Finalment m’ha calgut editar una línia d’un arxiu anomenat pom.xml que està a l’arrel del projecte. A part d’això, l’Eclipse es queixa de que no sap resoldre imports, però m’han dit que s’arregla al .classplath, continuaré investigant.

Marc!! Estic pendent encara de que m’enviïs la informació que em vas dir sobre bookmarks socials!!

Adjunto una captura de pantalla per anar fent boca.

Problema rera problema sembla indiscutible que haig d’utlitzar la versió del sakai “cafe/branches/2-5-x”, ja que sinó no puc ni començar a provar una nova eina a la qual he anomenat socialbookmarks, perquè només executar-la dóna errors.

Finalment sembla que podré utilitzar la versió 5.5.26 del tomcat i tot.

Tot va anar bé fins que vaig haver d’executar l’ordre “mvn install”, ja que van començar a sortir errors i parlant amb en Aaron Zeckoski vaig entendre que jo havia agafat el codi font de la branca “trunk” tal i com posa a la guia, quan el que hauria d’haver fet es agafar la versió estable de “cafe/tags/2-5-0″.

Bé, marxa enrera mig procés i em surt un altre problema, quan arrenco el tomcat també surten errors i ara no puc ni fer funcionar la pàgina del sakai en local. Després de refer el procés diverses vegades i en diferents ordinadors, vaig acabar enviant un mail a la l’adreça de desenvolupadors del sakai demanant ajuda. Vaig obtenir la resposata de que sakai 2.5.0 i tomcat 5.5.26 no són compatibles, que desenvolupés sobre la versió del sakai 2.5.x o cambiés la versió del tomcat a la 5.5.25. Vaig canviar la versió del tomcat i ara ja funciona bé i ja he pogut veure com s’integra la nova eina al sakai (amb errors).

Enllaços i recursos per al desenvolupador: http://bugs.sakaiproject.org/confluence/display/BOOT/Developer+links+and+resources.

Alguns d’ells:
Portal de col·laboració al Sakai: https://collab.sakaiproject.org/portal.
Sakai Confluence: http://bugs.sakaiproject.org/confluence/.
JIRA: http://bugs.sakaiproject.org/jira/.

A més, explica com integrar l’Eclipse amb el Sakai, el que facilita molt la tasca del programador.