Spring Jcr Extension

Everything is content Spring JCR (JSR170) Salvatore Incandela Spring Framework Meeting 31 Ottobre 2009

Agenda • Introduzione ai Content Repository. • Java Content Repository API. • Repository Model. • Esempio pratico. • Vantaggi Spring JCR. • Links.

Introduzine ai content repository Caratteristiche di File system e database ●Versioning ●Controllo accessi ●Classifcazione contenuti ●Monitoraggio eventi ●Ricerche testuali

Java Content Repository API Con API proprietarie

Java Content Repository API Con JCR

Java Content Repository API Why JCR 170? Swappability API semplici Più di 800 vendor sul Standard API mercato Riduzione costi

Java Content Repository API •Level 1 • Traversing tree • Getting value of properties • Namespace remapping (transient) • Export to XML • Query by Xpath

Java Content Repository API • Level 2 • Adding, removing items • Writing to properties • Persistent namespace changes • Import from XML • Assigning node types to nodes

Java Content Repository API •Transactions (JTA) •Versioning •Observation (events) •Locking •SQL syntax for queries

Java Content Repository API

Repository model Il content model è costituito da più workspace, ognuno di essi contiene un albero composto da più item (nodi o property). Nodo : one parent more child Property: one parent no child

Repository model Navigazione dell'albero Percorso xpath Absolute : /a/b/c Relative: ../../b/c UUID

Repository model Nodo ●Ogni nodo ha un primary type ● jcr:primaryType ●Più mixing types, opzionali contenuti nella proprietà jcr:mixingTypes ● mix:versionable ● mix:lockable ● mix:referencable ●Possono avere fratelli uguali ● /nodo/nodofglio[2]

Repository model Tipi di nodo Un content repository deve supportare il tipo nt:base Può inoltre supportare dei tipi opzionali –nt:unstructured –nt:hierarchyNode (sottotipi: nt:fle,nt:folder) –nt:resource –nt:version, nt:versionHistory –nt:query

Repository model NodeTypeName mix:lockable Supertypes [] Tipi di nodo IsMixin true HasOrderableChildNodes false NodeTypeName PrimaryItemName nt:file null Supertypes PropertyDefinition nt:hierarchyNode Name jcr:lockOwner IsMixin RequiredType STRING false ValueConstraints [] HasOrderableChildNodes DefaultValues null false AutoCreated false PrimaryItemName Mandatory false OnParentVersion IGNORE jcr:content Protected true ChildNodeDefinition Multiple false Name jcr:content PropertyDefinition RequiredPrimaryTypes [nt:base] Name jcr:lockIsDeep DefaultPrimaryType null RequiredType BOOLEAN AutoCreatefalse ValueConstraints [] Mandatory true DefaultValues null AutoCreatefalse OnParentVersion COPY Mandatory false Protected false OnParentVersion IGNORE SameNameSiblings false Protectedtrue Multiple false

Repository model Proprietà – LONG, DATE, STRING, DOUBLE, BOOLEAN – PATH: percorso nel workspace – REFERENCE: contiene l'UUID del nodo (mix:referenceable) – NAME: nome del tipo di nodo Impostare un valore null ad una property equivale ad eliminarla

Repository model Namespace Il nome di una property come in xml può essere preceduto da un prefsso (namespace): ●jcr (eg. jcr:primaryNode) ●nt – per i tipi di nodi (es. nt:version) ●mix – per i mixing types (es. mix:versionable) ●xml – per la compatibilità con xml

Esempi Eseguire una query Workspace workspace = session.getWorkspace(); Node node = session.getRootNode(); workspace.getNamespaceRegistry().registerNamespace("pnx", "http://pronetics.jcrexample/1.0"); QueryManager queryManager = workspace.getQueryManager(); Query query = queryManager.createQuery("//pnx:rubrica/pnx:contact[@pnx:name='christian')]", Query.XPATH); QueryResult queryResult = query.execute(); NodeIterator nodeIterator = queryResult.getNodes(); Esportare File file = new File("backup.xml"); FileOutputStream fileOutputStream = new FileOutputStream(file); session.exportSystemView("/pnx:rubrica", fileOutputStream, false, false); Importare File file = new File("backup.xml"); FileInputStream fileInputStream = new FileInputStream(file); session.importXML("/", fileInputStream, ImportUUIDBehavior.IMPORT_UUID_CREATE_NEW);

Esempio pratico Considerato l'albero in fgura

Esempio pratico Autenticazione al repository //Get repository Repository repository = (Repository) ctx.lookup("myrepo"); //Get Credentials Credentials credentials = new SimpleCredentials("MyName", "MyPassword".toCharArray()); //Get Session Session mySession = repository.login(credentials, "MyWorkSpace"); Traversal access di una property Node root = mySession.getRootNode(); Node myNode = root.getNode("a/e"); //mySession.getNodeByUUID("123456789") Property property = myNode.getProperty("k"); Value value = property.getValue(); double myDouble = value.getDouble();

Esempio pratico Proviamo a creare un nodo Session mySession; Node root = mySession.getRootNode(); Node myNode = root.getNode("a/e"); myNode.addNode("Y"); session.save(); Per eliminare una property Session mySession; Node root = mySession.getRootNode(); Node myNode = root.getNode("a/e"); myNode.setProperty("p", (Value) null); session.save();

Esempio pratico Inserimento e stampa property Repository r = new TransientRepository(); Session session = r.login(new SimpleCredentials("pippo", "pluto".toCharArray())); try { Workspace workspace = session.getWorkspace(); Node node = session.getRootNode(); workspace.getNamespaceRegistry().registerNamespace("pnx", "http://pronetics.jcrexample/1.0"); Node rubrica = node.addNode("pnx:rubrica"); Node contact = rubrica.addNode("pnx:contact"); contact.setProperty("pnx:name", "christian"); contact.setProperty("pnx:tel", "000000"); contact.setProperty("pnx:category", new String[] { "professional", "metal" }); // IMPORTANTE session.save(); rubrica = node.getNode("pnx:rubrica"); node.getProperty("pnxs:rubrica/pnx:contact[1]/pnx:name"); NodeIterator nodeIterator = node.getNodes(); while (nodeIterator.hasNext()) { Node cnt = nodeIterator.nextNode(); PropertyIterator propertyIterator = cnt.getProperties(); while (propertyIterator.hasNext()) { Property property = propertyIterator.nextProperty(); LOG.info("Property name: {} property value: {}", property.getName(), property.getValue()); } } } finally { session.logout(); }

Session Factory L'interfaccia SessionFactory descrive come ottenere una session, agisce come wrapper del javax.jcr.Repository. Per ottenere una sessionFactory abbiamo bisogno del repository bean e delle credenziali: <bean id="jcrSessionFactory" class="org.springframework.extensions.jcr.JcrSessionFactory"> <property name="repository" ref="repository"/> <property name="credentials"> <bean class="javax.jcr.SimpleCredentials"> <constructor-arg index="0" value="bogus"/> <constructor-arg index="1" value="pass"/> </bean> </property> </bean> JcrSessionFactory permette inoltre la registrazione di namespaces, agiungere listener per ulteriori informazioni fare riferimento ai javadoc.

Namespace registration Per effettuare la registrazione di namespaces custom basta semplicemente passarli come property, la key rappresenta il prefsso e il valore rappresenta il namespace: <bean id="sessionFactory" class="org.springframework.extensions.jcr.JcrSessionFactory"> ... <property name="namespaces"> <props> <prop key="foo">http://bar.com/jcr</prop> <prop key="hocus">http://pocus.com/jcr</prop> </props> </property> </bean> Modalità di registrazione: ●ForceNamespacesRegistration ●KeepNewNamespaces ●skipExistingNamespaces

Event listeners La registrazione dei listener permette di identifcare il path del nodo ascoltato, o una espressione regolare <bean id="sessionFactory" class="org.springframework.extensions.jcr.JcrSessionFactory"> ... <property name="eventListeners"> <list> <bean class="org.springframework.extensions.jcr.EventListenerDefinition"> <property name="listener"> <bean class="org.springframework.extensions.examples.jcr.DummyEventListener"/> </property> <property name="absPath" value="/rootNode/someFolder/someLeaf"/> </bean> </list> </property> </property>

NodeTypeDefinition La registrazione dei tipi di nodo è tipica del CR che stiamo usando, in questo caso JackRabbit: <bean id="jackrabbitSessionFactory" class="org.springframework.extensions.jcr.jackrabbit.JackrabbitSessionFactory"> ... <property name="nodeDefinitions"> <list> <value>classpath:/nodeTypes/wikiTypes.cnd</value> <value>classpath:/nodeTypes/clientATypes.cnd</value> </list> </property> </bean>

Esempio SpringJcr Inserimento e stampa property //Repository r = new TransientRepository(); //Session session = r.login(new SimpleCredentials("pippo", "pluto".toCharArray())); //try { Workspace workspace = session.getWorkspace(); Node node = session.getRootNode(); //workspace.getNamespaceRegistry().registerNamespace("pnx", "http://pronetics.jcrexample/1.0"); Node rubrica = node.addNode("pnx:rubrica"); Node contact = rubrica.addNode("pnx:contact"); contact.setProperty("pnx:name", "christian"); contact.setProperty("pnx:tel", "000000"); contact.setProperty("pnx:category", new String[] { "professional", "metal" }); // IMPORTANTE session.save(); rubrica = node.getNode("pnx:rubrica"); node.getProperty("pnxs:rubrica/pnx:contact[1]/pnx:name"); NodeIterator nodeIterator = node.getNodes(); while (nodeIterator.hasNext()) { Node cnt = nodeIterator.nextNode(); PropertyIterator propertyIterator = cnt.getProperties(); while (propertyIterator.hasNext()) { Property property = propertyIterator.nextProperty(); LOG.info("Property name: {} property value: {}", property.getName(), property.getValue()); } } //} finally { // session.logout(); //}

JcrTemplate e JcrCallback La maggior parte del lavoro con JCR viene svolta dal Jcrtemplate stesso. Il template richiede una sessionFactory e può essere confgurato in modo da creare nuove sessioni on demand o riusarle. <bean id="jcrTemplate" class="org.springframework.extensions.jcr.JcrTemplate"> <property name="sessionFactory" ref="sessionFactory"/> <property name="allowCreate" value="true"/> </bean> JcrTemplate contiene molte delle funzioni di javax.jcr.Session e javax.jcr.query.Query. Nel caso in cui queste non siano suffcienti interviene JcrCallback che opera direttamente con la sessione. JcrCallback è thread-safe, apre e chiude sessioni. public void saveSmth() { template.execute(new JcrCallback() { public Object doInJcr(Session session) throws RepositoryException { Node root = session.getRootNode(); log.info("starting from root node " + root); Node sample = root.addNode("sample node"); sample.setProperty("sample property", "bla bla"); log.info("saved property " + sample); session.save(); return null; } }); }

DAO senza callback E' possibile utilizzare JcrDaoSupport analogamente a JdbcDaoSupport. public class ProductDaoImpl extends JcrDaoSupport { public void saveSmth() throws DataAccessException, MyException { Session session = getSession(); try { Node root = session.getRootNode(); log.info("starting from root node " + root); Node sample = root.addNode("sample node"); sample.setProperty("sample property", "bla bla"); log.info("saved property " + sample); session.save(); return null; } catch (RepositoryException ex) { throw convertJcrAccessException(ex); } } }

Finish Q/A

Link utili JSR-170 http://www.jcp.org/en/jsr/detail?id=170 Jackrabbit http://jackrabbit.apache.org/ Versione html della specifca http://www.day.com/specs/jcr/1.0/ Spring JCR http://se-jcr.sourceforge.net/ Author www.twitter.com/sincandela salvatoreincandela.blogspot.com www.linkedin.com/in/salvatoreincandela

http://salvatoreincandela.blogspot.com	162
http://pronetics.wordpress.com	80
http://www.pro-netics.com	39
http://www.slideshare.net	15
http://translate.googleusercontent.com	1

Spring Jcr Extension

by Salvatore Incandela on Nov 02, 2009

Accessibility

Categories

Tags

Upload Details

Usage Rights

5 Embeds 297

Statistics

Spring Jcr Extension — Presentation Transcript