incubator-graffito-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From clomb...@apache.org
Subject svn commit: r469401 - in /incubator/graffito/trunk: jcr/jcr-mapping/xdocs/ jcr/jcr-mapping/xdocs/api/ jcr/jcr-mapping/xdocs/simple-strategies/ site/xdocs/
Date Tue, 31 Oct 2006 07:50:49 GMT
Author: clombart
Date: Mon Oct 30 23:50:48 2006
New Revision: 469401

URL: http://svn.apache.org/viewvc?view=rev&rev=469401
Log:
review jcr mapping xdocs

Modified:
    incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/api-intro.xml
    incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/basic-operations.xml
    incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/locking.xml
    incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/versionning.xml
    incubator/graffito/trunk/jcr/jcr-mapping/xdocs/engine-introduction.xml
    incubator/graffito/trunk/jcr/jcr-mapping/xdocs/index.xml
    incubator/graffito/trunk/jcr/jcr-mapping/xdocs/navigation.xml
    incubator/graffito/trunk/jcr/jcr-mapping/xdocs/simple-strategies/introduction-strategies.xml
    incubator/graffito/trunk/site/xdocs/deploy.xml

Modified: incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/api-intro.xml
URL: http://svn.apache.org/viewvc/incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/api-intro.xml?view=diff&rev=469401&r1=469400&r2=469401
==============================================================================
--- incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/api-intro.xml (original)
+++ incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/api-intro.xml Mon Oct 30 23:50:48 2006
@@ -28,7 +28,7 @@
 				 <ul>
 					 <li>Manage the object life cycle (insert, update, delete, retrieve).</li>
 					<li>Search single object or collections with criteria.</li>
-					<li>Manage version (check int, check out, create a new version, show history).</li>

+					<li>Manage versions (check int, check out, create a new version, show history).</li>

 					<li>Lock objects.</li>
 				</ul>
 				</p>

Modified: incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/basic-operations.xml
URL: http://svn.apache.org/viewvc/incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/basic-operations.xml?view=diff&rev=469401&r1=469400&r2=469401
==============================================================================
--- incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/basic-operations.xml (original)
+++ incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/basic-operations.xml Mon Oct 30 23:50:48
2006
@@ -23,7 +23,7 @@
 	<body>
 		<section name="The Basic Operations">
 			<p>
-				When you have <a href="../engine-setup.html">create a new Persistence Manager</a>
in you application, you can use this component to insert, update, delete and retrieve objects.
The class 'Folder' used in the following sections should be associated to a class-descriptor
defined in the  mapping descriptor.
+				When you have <a href="../engine-setup.html">create a new Persistence Manager</a>
in your application, you can use this component to insert, update, delete and retrieve objects.
The class 'Folder' used in the following sections should be associated to a class-descriptor
defined in the  mapping descriptor.
 			</p> 
 			<p>
 				This page describes only the main Persistence Manager methods. You can see the javadoc
to get more information on the API.
@@ -76,4 +76,4 @@
 
 		</section>
 	</body>
-</document>
+</document>
\ No newline at end of file

Modified: incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/locking.xml
URL: http://svn.apache.org/viewvc/incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/locking.xml?view=diff&rev=469401&r1=469400&r2=469401
==============================================================================
--- incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/locking.xml (original)
+++ incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/locking.xml Mon Oct 30 23:50:48 2006
@@ -30,7 +30,7 @@
 					Following the Jcr specification, it is possible to lock nodes and their children (see
section 8.4).
 					You can see on this page the OCM API used to lock on the object level. 
 					In order to lock an object, its matching node has to implement the jcr mixin type "mix:lockable".
-					You can be specify this node type in the class descriptor like the following example
: 
+					It is possible to specify this node type in the class descriptor : 
 				</p>	
 				<source><![CDATA[ 					
 <class-descriptor className="org.apache.portals.graffito.jcr.testmodel.A"
@@ -109,4 +109,4 @@
 		
 		</section>
 	</body>
-</document>
+</document>
\ No newline at end of file

Modified: incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/versionning.xml
URL: http://svn.apache.org/viewvc/incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/versionning.xml?view=diff&rev=469401&r1=469400&r2=469401
==============================================================================
--- incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/versionning.xml (original)
+++ incubator/graffito/trunk/jcr/jcr-mapping/xdocs/api/versionning.xml Mon Oct 30 23:50:48
2006
@@ -38,10 +38,19 @@
 					Later, we would like to add more advanced versionning support like version compare,
replace, revert, ...
 				</p>
 				<p>
-					Each versionned object has to be mapped to a
-					mix:versionable JCR node. Later, it will be possible
-					to add versioning support to any kind of objects.
-				</p>
+					Each versionned object has to be mapped to a mix:versionable JCR node. 
+					It is possible to specify this node type in the class descriptor : 
+				</p>	
+				<source><![CDATA[ 					
+<class-descriptor className="org.apache.portals.graffito.jcr.testmodel.A"
+		          jcrNodeType="nt:unstructured" jcrMixinTypes="mix:versionable" >
+		          
+		          
+		          <!-- Add here field, bean and collection desctipors -->
+		          
+		          
+</class-descriptor>							
+				]]></source>
 			</subsection>
 			<subsection name="Check in - Check out">
 				<source>

Modified: incubator/graffito/trunk/jcr/jcr-mapping/xdocs/engine-introduction.xml
URL: http://svn.apache.org/viewvc/incubator/graffito/trunk/jcr/jcr-mapping/xdocs/engine-introduction.xml?view=diff&rev=469401&r1=469400&r2=469401
==============================================================================
--- incubator/graffito/trunk/jcr/jcr-mapping/xdocs/engine-introduction.xml (original)
+++ incubator/graffito/trunk/jcr/jcr-mapping/xdocs/engine-introduction.xml Mon Oct 30 23:50:48
2006
@@ -38,7 +38,10 @@
 						<li>Simple fields : primitive data types and simple objects (String, Long, Double,
...) . Those fields are mapped into JCR properties. </li>
 						<li>Bean fields : One class can contain an 1..1 association to another bean.
In this case, the attribute is a custom object. Those fields are mapped into JCR nodes. </li>
 						<li>Collection fields : One class can contain an 1..n association to a collection
of beans (or Map). Those fields are mapped into a collection of JCR nodes. </li>
-						<li>Reference field : One good example to understand the "reference" type is
the Folder concept. A folder "B" can have an attribute called "parentFolder" which is a simple
field pointing to the parent folder "A" . Of course, in a JCR repository, it is a nonsense
for persist this "parentFolder" attribute into a "B" subnode. Another interesting example
are links made between cms objects (folders, documents, ...).</li>
+						<li>Reference field : One good example to understand the "reference" type is
the Folder concept. 
+						A folder "B" can have an attribute called "parentFolder" which is a simple field pointing
to the parent folder "A" . 
+						Of course, in a JCR repository, it is a nonsense for persist this "parentFolder" attribute
into a "B" subnode. 
+						Another interesting example are references between cms objects (folders, documents,
...).</li>
 					</ol>
 				</p>
 				<p>

Modified: incubator/graffito/trunk/jcr/jcr-mapping/xdocs/index.xml
URL: http://svn.apache.org/viewvc/incubator/graffito/trunk/jcr/jcr-mapping/xdocs/index.xml?view=diff&rev=469401&r1=469400&r2=469401
==============================================================================
--- incubator/graffito/trunk/jcr/jcr-mapping/xdocs/index.xml (original)
+++ incubator/graffito/trunk/jcr/jcr-mapping/xdocs/index.xml Mon Oct 30 23:50:48 2006
@@ -34,8 +34,8 @@
 				<p>A couple of month ago, we have decided to create a new object mapping framework
for different reasons : </p>
 				<ul>
 					<li>Sometimes it is very convenient to be able to just access the JCR nodes and
properties directly from your presentation-layer for very simple things (mostly generic display).
When a lot of "business logic" are involved, the JCR API can be too low level and real business
objects (pojo) are more appreciate in a such case.</li>				
-				
-					<li>ORM tools like OBJ or Hibernate are not appropriate for content oriented application.</li>
+					<li>The OCM framework provides more abstraction on the technologies used to persist
your content. The different application layers are less dependent on the JCR API.</li>
			
+					<li>ORM tools like OJB or Hibernate are not appropriate for content oriented application.</li>
 				</ul>	
 				
 			</subsection>

Modified: incubator/graffito/trunk/jcr/jcr-mapping/xdocs/navigation.xml
URL: http://svn.apache.org/viewvc/incubator/graffito/trunk/jcr/jcr-mapping/xdocs/navigation.xml?view=diff&rev=469401&r1=469400&r2=469401
==============================================================================
--- incubator/graffito/trunk/jcr/jcr-mapping/xdocs/navigation.xml (original)
+++ incubator/graffito/trunk/jcr/jcr-mapping/xdocs/navigation.xml Mon Oct 30 23:50:48 2006
@@ -48,7 +48,7 @@
 			<item name="Locking" href="api/locking.html" collapse="true"/>
 		</menu>
 		
-		<menu name="Mapping Stategies">			
+		<menu name="Basic Mapping Stategies">			
 			<item name="Introduction" href="simple-strategies/introduction-strategies.html"/>
 			<item name="Mapping Atomic Fields" href="simple-strategies/atomic-strategy.html"/>
		
 			<item name="Mapping Bean Fields" href="simple-strategies/bean-strategy.html"/>	
	
@@ -68,4 +68,4 @@
 		
 		
 	</body>
-</project>
+</project>
\ No newline at end of file

Modified: incubator/graffito/trunk/jcr/jcr-mapping/xdocs/simple-strategies/introduction-strategies.xml
URL: http://svn.apache.org/viewvc/incubator/graffito/trunk/jcr/jcr-mapping/xdocs/simple-strategies/introduction-strategies.xml?view=diff&rev=469401&r1=469400&r2=469401
==============================================================================
--- incubator/graffito/trunk/jcr/jcr-mapping/xdocs/simple-strategies/introduction-strategies.xml
(original)
+++ incubator/graffito/trunk/jcr/jcr-mapping/xdocs/simple-strategies/introduction-strategies.xml
Mon Oct 30 23:50:48 2006
@@ -84,8 +84,8 @@
 			
 			
 			<subsection name="The Class descriptor">
-				<p>When you decide to map a bean class, you have to create a new class descriptor
entry in the Persistence Manager descriptor file.</p>			
-				<p>Here are the class-descriptors required to map the classes Page, PageInfo and
Paragraph :</p>
+				<p>When you decide to map a bean class, you have to create a new class descriptor
entry in the Persistence Manager descriptor file.			
+				   Here are the class-descriptors required to map the classes Page, PageInfo and Paragraph
:</p>
 			<source><![CDATA[ 				
 <class-descriptor className="org.apache.portals.graffito.jcr.testmodel.Page" jcrNodeType="graffito:page">
 	<field-descriptor fieldName="path" path="true" />
@@ -106,7 +106,8 @@
 			]]></source>
 								
 			<p>
-				We will explain in more details each descriptors in the following sections (<a href="atomic-strategy.html">Mapping
Atomic Fields</a>,<a href="bean-strategy.html">Mapping Bean Fields</a> and
<a href="collection-strategy.html">Mapping Collection Fields</a>. If the page
is stored on the path "/mysite/mypage1" and contains 2 paragraphs, here is the resulting jcr
structure :
+				We will explain in more details each descriptors in the following sections (<a href="atomic-strategy.html">Mapping
Atomic Fields</a>,<a href="bean-strategy.html">Mapping Bean Fields</a> and
<a href="collection-strategy.html">Mapping Collection Fields</a>). 
+				Here is the resulting JCR structure if the page is stored on the path "/mysite/mypage1"
and contains 2 paragraphs :
 			</p>
 			<p>
 			<source><![CDATA[ 
@@ -121,7 +122,7 @@
 			graffito:text = ""This is the content of para2"
 			]]></source>		  
 			</p>	
-			<p>It is possible to have another kind of jcr structure by using other mapping strategies.
You can see the section "Advance Mapping strategies" to get more information on that.</p>
+			<p>It is possible to have another kind of jcr structure by using other mapping strategies.
See the section <a href="advanced-strategies/introduction-strategies.html">Advanced
Mapping strategies</a> to get more information on that.</p>
 			
 			
 
@@ -133,10 +134,12 @@
 </class-descriptor>
 				]]></source>
 
-				<p>This class descriptor maps the class "org.apache.portals.graffito.jcr.testmodel.Paragraph"
to the JCR type "nt:unstructured". Each field-descriptors maps one bean attribute to a JCR
property. You can find more information on the field-descriptors in the page <a href="atomic-strategy.html">Mapping
Atomic fields</a>. 
+				<p>This class descriptor maps the class "org.apache.portals.graffito.jcr.testmodel.Paragraph"
to the JCR type "nt:unstructured". Each field-descriptor maps one bean attribute to a JCR
property. You can find more information on the field-descriptors in the page <a href="atomic-strategy.html">Mapping
Atomic fields</a>. 
 				</p>	
 				<p>
-					It is also possible to map a bean class to a specific JCR node type. The following class-descriptor
map the class "org.apache.portals.graffito.jcr.testmodel.Paragraph" to the node type "graffito:paragraph".

+					It is also possible to map a bean class to a specific JCR node type by specifying the
desired type in the attribute jcrNodeType. 
+					The following class-descriptor map the class "org.apache.portals.graffito.jcr.testmodel.Paragraph"
to the node type "graffito:paragraph".
+						
 				</p>
 				<source><![CDATA[ 				
 <class-descriptor className="org.apache.portals.graffito.jcr.testmodel.Paragraph" jcrNodeType="graffito:paragraph">
@@ -167,7 +170,7 @@
 			</subsection>
 			<subsection name ="The path Field">
 				<p>
-				Each mapped class contains a mandatory field called the "path field". It simply contains
the JCR path  associated to the object.	
+				Each mapped class contains a mandatory field called the "path field". It contains the
JCR path  associated to the object.	
 				For example, the following descriptor specify the bean field "myPath" as the path field.
		
 				</p>
 				<source><![CDATA[ 

Modified: incubator/graffito/trunk/site/xdocs/deploy.xml
URL: http://svn.apache.org/viewvc/incubator/graffito/trunk/site/xdocs/deploy.xml?view=diff&rev=469401&r1=469400&r2=469401
==============================================================================
--- incubator/graffito/trunk/site/xdocs/deploy.xml (original)
+++ incubator/graffito/trunk/site/xdocs/deploy.xml Mon Oct 30 23:50:48 2006
@@ -32,7 +32,7 @@
 <subsection name="Get the Jetspeed 2.0 distribution">
 <ul>
   <li>Get and install Jetspeed 2.0 . The official 2.0 distribution can be found  <a
href="http://portals.apache.org/jetspeed-2/download.html">here</a>.
-      This distribution contains Tomcat and the Jetspeed 2 demo application. Don't use the
lastest Jetspeed code from SVN.
+      This distribution contains Tomcat and the Jetspeed 2 demo application. You can also
use the lastest Jetspeed code from SVN.
    </li>
   <li>If you want to change the database, read carefully the instructions found in
the Jetspeed 2.0 distribution. 
       Check if your database is supported on <a href="supported-db.html">this page</a>.</li>
@@ -43,7 +43,8 @@
 <subsection name='Deploy Graffito'>
 	<ul>
 	      <li>Build  Graffito. See <a href="build.html">Build all Graffito subprojects
page</a>.</li>
-	      <li>Execute <code>maven allDeploy</code> from the Graffito root
directory.</li>
+	      <li>To deploy into the official Jetspeed 2.0 distribution, execute <code>maven
allDeploy</code> from the Graffito root directory.</li>
+	      <li>To deploy into the Jetspeed head, execute <code>maven allDeployHead</code>
from the Graffito root directory.</li>
 	</ul>
 </subsection>
 <subsection name='Start Jetpseed on Tomcat'>



Mime
View raw message