You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jackrabbit.apache.org by bu...@apache.org on 2012/12/31 13:40:59 UTC
svn commit: r844404 [15/17] - in /websites/staging/jackrabbit/trunk/content:
./ JCR/ JCR/a-simple-ocm-project-with-maven-eclipse.data/
JCR/concurrency-control.data/ JCR/deployment-models.data/
JCR/how-jackrabbit-works.data/ JCR/how-to-map-associations-...
Added: websites/staging/jackrabbit/trunk/content/JCR/object-content-mapping.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/object-content-mapping.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/object-content-mapping.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,159 @@
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+ <TITLE>Object Content Mapping</TITLE>
+ <LINK type="text/css" rel="stylesheet" href="http://jackrabbit.apache.org/style/site.css">
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY>
+ <DIV id="page">
+ <DIV id="header">
+ <P id="jcr"><A href="http://jackrabbit.apache.org/"><IMG src="http://jackrabbit.apache.org/style/jlogo.gif" alt="Apache Jackrabbit" height="100" width="336"></A></P>
+ <P id="asf"><A href="http://www.apache.org/"><IMG src="http://jackrabbit.apache.org/style/asf-logo.gif" alt="Apache Software Foundation" height="100" width="387"></A></P>
+ </DIV>
+ <DIV id="body">
+ <DIV id="navigation">
+ <UL>
+ <LI>Apache Jackrabbit
+ <UL>
+ <LI><A href="welcome-to-apache-jackrabbit.html" title="Welcome to Apache Jackrabbit">Welcome</A></LI>
+ <LI><A href="downloads.html" title="Downloads">Downloads</A></LI>
+ <LI><A href="articles.html" title="Articles">Articles</A></LI>
+ <LI><A href="frequently-asked-questions.html" title="Frequently Asked Questions">FAQ</A></LI>
+ <LI><A href="http://wiki.apache.org/jackrabbit/FrontPage" class="external-link">Jackrabbit Wiki</A></LI>
+ <LI><A href="jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</A></LI>
+ </UL>
+ </LI>
+ <LI>Documentation
+ <UL>
+ <LI><A href="getting-started-with-apache-jackrabbit.html" title="Getting Started with Apache Jackrabbit">Getting Started</A></LI>
+ <LI><A href="standalone-server.html" title="Standalone Server">Standalone Server</A></LI>
+ <LI><A href="jackrabbit-components.html" title="Jackrabbit Components">Jackrabbit Components</A></LI>
+ <LI><A href="first-hops.html" title="First Hops">First Hops</A></LI>
+ <LI><A href="jcr-api.html" title="JCR & API">JCR & API</A></LI>
+ <LI><A href="jackrabbit-architecture.html" title="Jackrabbit Architecture">Jackrabbit Architecture</A></LI>
+ <LI><A href="deployment-models.html" title="Deployment Models">Deployment Models</A></LI>
+ <LI><A href="jackrabbit-configuration.html" title="Jackrabbit Configuration">Jackrabbit Configuration</A></LI>
+ <LI><A href="node-types.html" title="Node Types">Node Types</A></LI>
+ <LI><A href="" title="Object Content Mapping">Object Content Mapping</A></LI>
+ </UL>
+ </LI>
+ <LI>Development
+ <UL>
+ <LI><A href="jackrabbit-team.html" title="Jackrabbit Team">Jackrabbit Team</A></LI>
+ <LI><A href="jackrabbit-roadmap.html" title="Jackrabbit Roadmap">Jackrabbit Roadmap</A></LI>
+ <LI><A href="building-jackrabbit.html" title="Building Jackrabbit">Building Jackrabbit</A></LI>
+ <LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI>
+ <LI><A href="issue-tracker.html" title="Issue Tracker">Issue Tracker</A></LI>
+ <LI><A href="source-repository.html" title="Source Repository">Source Repository</A></LI>
+ <LI><A href="continuous-integration.html" title="Continuous Integration">Continuous Integration</A></LI>
+ <LI><A href="website.html" title="Website">Website</A></LI>
+ <LI><A href="creating-releases.html" title="Creating Releases">Creating Releases</A></LI>
+ <LI><A href="supporting-software-attribution.html" title="Supporting software attribution">Attribution</A></LI>
+ </UL>
+ </LI>
+ <LI>Apache Software Foundation
+ <UL>
+ <LI><A href="http://www.apache.org/foundation/how-it-works.html" class="external-link">Introduction</A></LI>
+ <LI><A href="http://www.apache.org/foundation/sponsorship.html" class="external-link">Sponsorship</A></LI>
+ <LI><A href="http://www.apache.org/foundation/thanks.html" class="external-link">Current Sponsors</A></LI>
+ </UL>
+ </LI>
+</UL>
+ </DIV>
+ <DIV id="content">
+ <H1>Object Content Mapping</H1>
+ <DIV class="panelMacro"><TABLE class="warningMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/forbidden.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B>Warning</B><BR>The Jackrabbit OCM documentation is still in progress. We advise you also to review <A href="http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-ocm/src/test/" class="external-link">the unit tests</A>to get an overview on current OCM features.</TD></TR></TABLE></DIV>
+
+<P>Latest stable Jackrabbit OCM is version 2.0.0, see <A href="downloads.html#Downloads-ocm">downloads page</A></P>
+
+<UL>
+ <LI><A href="object-content-manager.html" title="Object Content Manager">Object Content Manager</A>
+ <UL>
+ <LI><A href="basic-ocm-operations.html" title="Basic OCM operations">Basic OCM operations</A></LI>
+ <LI><A href="ocm-search.html" title="OCM Search">OCM Search</A></LI>
+ <LI><A href="ocm-version-management.html" title="OCM Version Management">OCM Version Management</A></LI>
+ <LI><A href="ocm-locking.html" title="OCM Locking">OCM Locking</A></LI>
+ </UL>
+ </LI>
+ <LI>Tutorials
+ <UL>
+ <LI><A href="5-with-jackrabbit-ocm.html" title="5' with Jackrabbit OCM">5' with Jackrabbit OCM</A></LI>
+ <LI><A href="a-simple-ocm-project-with-maven-eclipse.html" title="A simple OCM project with Maven & Eclipse">A simple OCM project with Maven & Eclipse</A></LI>
+ <LI><A href="how-to-map-associations-between-objects.html" title="How to map associations between objects">How to map associations between objects</A></LI>
+ </UL>
+ </LI>
+ <LI><A href="mapping-stategies.html" title="Mapping Stategies">Mapping Stategies</A> (obsolete doc)
+ <UL>
+ <LI><A href="mapping-atomic-fields.html" title="Mapping Atomic Fields">Mapping Atomic Fields</A> (obsolete doc)</LI>
+ <LI><A href="mapping-bean-fields.html" title="Mapping Bean Fields">Mapping Bean Fields</A> (obsolete doc)</LI>
+ <LI><A href="mapping-collection-fields.html" title="Mapping Collection Fields">Mapping Collection Fields</A> (obsolete doc)</LI>
+ <LI><A href="advanced-mapping-strategies.html" title="Advanced Mapping Strategies">Advanced Mapping Strategies</A> (obsolete doc)</LI>
+ </UL>
+ </LI>
+</UL>
+
+
+<P>Jackrabbit OCM is a framework used to persist java objects (pojos) in a JCR repository including association, inheritance, polymorphism, composition, and the Java collections framework. It offers also features like version support, object locking and express queries with Java-based criteria, as well as with JCR query languages.</P>
+
+<P>In order to easily support the JCR specification, any content application managing an high level object model can use this framework. For example, a classic Forum application contains objects like "Forum", "Topic" and "Post". Now, the data objects (pojo) can be managed by our JCR mapping tools in order to persist them into a JCR compliant repository.</P>
+
+<H2><A name="ObjectContentMapping-Whyanocm%3F"></A>Why an ocm?</H2>
+
+<P>The object content mapping framework was created for the following 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 such cases.</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>
+
+
+<H2><A name="ObjectContentMapping-Prerequisite"></A>Prerequisite</H2>
+
+<P>Before using this OCM framework, you should review the JCR specification and implementations like Apache Jackrabbit.</P>
+ </DIV>
+ <DIV id="end"></DIV>
+ </DIV>
+ <DIV id="footer">
+ <P>
+ © 2004-2010 The Apache Software Foundation.
+ - <A href="http://jackrabbit.apache.org/privacy-policy.html">Privacy Policy</A> -
+ [<A href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=75348">edit this page</A>]
+ <BR>
+ Apache Jackrabbit, Jackrabbit, Apache, the Apache feather logo, and the Apache
+ Jackrabbit project logo are trademarks of The Apache Software Foundation.
+ </P>
+ </DIV>
+ </DIV>
+<!-- JCR- 1315: Add Google Analytics to Jackrabbit web site -->
+<SCRIPT type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</SCRIPT>
+<SCRIPT type="text/javascript">
+var pageTracker = _gat._getTracker("UA-837900-2");
+pageTracker._initData();
+pageTracker._trackPageview();
+</SCRIPT>
+ </BODY>
+</HTML>
Added: websites/staging/jackrabbit/trunk/content/JCR/ocm-locking.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/ocm-locking.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/ocm-locking.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,176 @@
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+ <TITLE>OCM Locking</TITLE>
+ <LINK type="text/css" rel="stylesheet" href="http://jackrabbit.apache.org/style/site.css">
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY>
+ <DIV id="page">
+ <DIV id="header">
+ <P id="jcr"><A href="http://jackrabbit.apache.org/"><IMG src="http://jackrabbit.apache.org/style/jlogo.gif" alt="Apache Jackrabbit" height="100" width="336"></A></P>
+ <P id="asf"><A href="http://www.apache.org/"><IMG src="http://jackrabbit.apache.org/style/asf-logo.gif" alt="Apache Software Foundation" height="100" width="387"></A></P>
+ </DIV>
+ <DIV id="body">
+ <DIV id="navigation">
+ <UL>
+ <LI>Apache Jackrabbit
+ <UL>
+ <LI><A href="welcome-to-apache-jackrabbit.html" title="Welcome to Apache Jackrabbit">Welcome</A></LI>
+ <LI><A href="downloads.html" title="Downloads">Downloads</A></LI>
+ <LI><A href="frequently-asked-questions.html" title="Frequently Asked Questions">FAQ</A></LI>
+ <LI><A href="http://wiki.apache.org/jackrabbit/FrontPage" class="external-link">Jackrabbit Wiki</A></LI>
+ <LI><A href="jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</A></LI>
+ </UL>
+ </LI>
+ <LI>Documentation
+ <UL>
+ <LI><A href="getting-started-with-apache-jackrabbit.html" title="Getting Started with Apache Jackrabbit">Getting Started</A></LI>
+ <LI><A href="standalone-server.html" title="Standalone Server">Standalone Server</A></LI>
+ <LI><A href="jackrabbit-components.html" title="Jackrabbit Components">Jackrabbit Components</A></LI>
+ <LI><A href="first-hops.html" title="First Hops">First Hops</A></LI>
+ <LI><A href="jcr-api.html" title="JCR & API">JCR & API</A></LI>
+ <LI><A href="jackrabbit-architecture.html" title="Jackrabbit Architecture">Jackrabbit Architecture</A></LI>
+ <LI><A href="deployment-models.html" title="Deployment Models">Deployment Models</A></LI>
+ <LI><A href="jackrabbit-configuration.html" title="Jackrabbit Configuration">Jackrabbit Configuration</A></LI>
+ <LI><A href="node-types.html" title="Node Types">Node Types</A></LI>
+ <LI><A href="object-content-mapping.html" title="Object Content Mapping">Object Content Mapping</A></LI>
+ </UL>
+ </LI>
+ <LI>Development
+ <UL>
+ <LI><A href="jackrabbit-team.html" title="Jackrabbit Team">Jackrabbit Team</A></LI>
+ <LI><A href="jackrabbit-roadmap.html" title="Jackrabbit Roadmap">Jackrabbit Roadmap</A></LI>
+ <LI><A href="building-jackrabbit.html" title="Building Jackrabbit">Building Jackrabbit</A></LI>
+ <LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI>
+ <LI><A href="issue-tracker.html" title="Issue Tracker">Issue Tracker</A></LI>
+ <LI><A href="source-repository.html" title="Source Repository">Source Repository</A></LI>
+ <LI><A href="continuous-integration.html" title="Continuous Integration">Continuous Integration</A></LI>
+ <LI><A href="website.html" title="Website">Website</A></LI>
+ <LI><A href="creating-releases.html" title="Creating Releases">Creating Releases</A></LI>
+ <LI><A href="supporting-software-attribution.html" title="Supporting software attribution">Attribution</A></LI>
+ </UL>
+ </LI>
+ <LI>Apache Software Foundation
+ <UL>
+ <LI><A href="http://www.apache.org/foundation/how-it-works.html" class="external-link">Introduction</A></LI>
+ <LI><A href="http://www.apache.org/foundation/sponsorship.html" class="external-link">Sponsorship</A></LI>
+ <LI><A href="http://www.apache.org/foundation/thanks.html" class="external-link">Current Sponsors</A></LI>
+ </UL>
+ </LI>
+</UL>
+ </DIV>
+ <DIV id="content">
+ <H1>OCM Locking</H1>
+ <P>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". It is possible to specify this node type in the class descriptor:</P>
+
+<H2><A name="OCMLocking-Abasicexample"></A>A basic example</H2>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+<SPAN class="code-comment">// --------------------------------------------------------------------------------
+</SPAN><SPAN class="code-comment">// Create and store an object graph in the repository
+</SPAN><SPAN class="code-comment">// --------------------------------------------------------------------------------
+</SPAN>A a = <SPAN class="code-keyword">new</SPAN> A();
+a.setPath(<SPAN class="code-quote">"/test"</SPAN>);
+a.setA1(<SPAN class="code-quote">"a1"</SPAN>);
+a.setA2(<SPAN class="code-quote">"a2"</SPAN>);
+B b = <SPAN class="code-keyword">new</SPAN> B();
+b.setB1(<SPAN class="code-quote">"b1"</SPAN>);
+b.setB2(<SPAN class="code-quote">"b2"</SPAN>);
+a.setB(b);
+
+C c1 = <SPAN class="code-keyword">new</SPAN> C();
+c1.setId(<SPAN class="code-quote">"first"</SPAN>);
+c1.setName(<SPAN class="code-quote">"First Element"</SPAN>);
+C c2 = <SPAN class="code-keyword">new</SPAN> C();
+c2.setId(<SPAN class="code-quote">"second"</SPAN>);
+c2.setName(<SPAN class="code-quote">"Second Element"</SPAN>);
+
+C c3 = <SPAN class="code-keyword">new</SPAN> C();
+c3.setId(<SPAN class="code-quote">"third"</SPAN>);
+c3.setName(<SPAN class="code-quote">"Third Element"</SPAN>);
+
+Collection collection = <SPAN class="code-keyword">new</SPAN> ArrayList();
+collection.add(c1);
+collection.add(c2);
+collection.add(c3);
+
+a.setCollection(collection);
+
+ocm.insert(a);
+ocm.save();
+
+
+<SPAN class="code-comment">// --------------------------------------------------------------------------------
+</SPAN><SPAN class="code-comment">// Check <SPAN class="code-keyword">if</SPAN> the object is not locked
+</SPAN><SPAN class="code-comment">// --------------------------------------------------------------------------------
+</SPAN><SPAN class="code-keyword">if</SPAN> (ocm.isLocked(<SPAN class="code-quote">"/test"</SPAN>))
+{
+ <SPAN class="code-object">System</SPAN>.out.println(<SPAN class="code-quote">"Error : The object is locked- humm ??"</SPAN>);
+}
+
+<SPAN class="code-comment">// --------------------------------------------------------------------------------
+</SPAN><SPAN class="code-comment">// Lock the object
+</SPAN><SPAN class="code-comment">// --------------------------------------------------------------------------------
+</SPAN><SPAN class="code-object">String</SPAN> lockToken = ocm.lock(<SPAN class="code-quote">"/test"</SPAN>, <SPAN class="code-keyword">true</SPAN>, <SPAN class="code-keyword">false</SPAN>);
+
+<SPAN class="code-comment">// --------------------------------------------------------------------------------
+</SPAN><SPAN class="code-comment">// Check <SPAN class="code-keyword">if</SPAN> the object is not locked
+</SPAN><SPAN class="code-comment">// --------------------------------------------------------------------------------
+</SPAN><SPAN class="code-keyword">if</SPAN> (! ocm.isLocked(<SPAN class="code-quote">"/test"</SPAN>))
+{
+ <SPAN class="code-object">System</SPAN>.out.println(<SPAN class="code-quote">"Error : The object is not locked- humm ??"</SPAN>);
+}
+
+<SPAN class="code-comment">// --------------------------------------------------------------------------------
+</SPAN><SPAN class="code-comment">// Unlock the object
+</SPAN><SPAN class="code-comment">// --------------------------------------------------------------------------------
+</SPAN>ocm.unlock(<SPAN class="code-quote">"/test"</SPAN>, lockToken);
+</PRE>
+</DIV></DIV>
+ </DIV>
+ <DIV id="end"></DIV>
+ </DIV>
+ <DIV id="footer">
+ <P>
+ © 2004-2010 The Apache Software Foundation.
+ - <A href="http://jackrabbit.apache.org/privacy-policy.html">Privacy Policy</A> -
+ [<A href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=75353">edit this page</A>]
+ <BR>
+ Apache Jackrabbit, Jackrabbit, Apache, the Apache feather logo, and the Apache
+ Jackrabbit project logo are trademarks of The Apache Software Foundation.
+ </P>
+ </DIV>
+ </DIV>
+<!-- JCR- 1315: Add Google Analytics to Jackrabbit web site -->
+<SCRIPT type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</SCRIPT>
+<SCRIPT type="text/javascript">
+var pageTracker = _gat._getTracker("UA-837900-2");
+pageTracker._initData();
+pageTracker._trackPageview();
+</SCRIPT>
+ </BODY>
+</HTML>
Added: websites/staging/jackrabbit/trunk/content/JCR/ocm-search.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/ocm-search.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/ocm-search.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,161 @@
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+ <TITLE>OCM Search</TITLE>
+ <LINK type="text/css" rel="stylesheet" href="http://jackrabbit.apache.org/style/site.css">
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY>
+ <DIV id="page">
+ <DIV id="header">
+ <P id="jcr"><A href="http://jackrabbit.apache.org/"><IMG src="http://jackrabbit.apache.org/style/jlogo.gif" alt="Apache Jackrabbit" height="100" width="336"></A></P>
+ <P id="asf"><A href="http://www.apache.org/"><IMG src="http://jackrabbit.apache.org/style/asf-logo.gif" alt="Apache Software Foundation" height="100" width="387"></A></P>
+ </DIV>
+ <DIV id="body">
+ <DIV id="navigation">
+ <UL>
+ <LI>Apache Jackrabbit
+ <UL>
+ <LI><A href="welcome-to-apache-jackrabbit.html" title="Welcome to Apache Jackrabbit">Welcome</A></LI>
+ <LI><A href="downloads.html" title="Downloads">Downloads</A></LI>
+ <LI><A href="frequently-asked-questions.html" title="Frequently Asked Questions">FAQ</A></LI>
+ <LI><A href="http://wiki.apache.org/jackrabbit/FrontPage" class="external-link">Jackrabbit Wiki</A></LI>
+ <LI><A href="jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</A></LI>
+ </UL>
+ </LI>
+ <LI>Documentation
+ <UL>
+ <LI><A href="getting-started-with-apache-jackrabbit.html" title="Getting Started with Apache Jackrabbit">Getting Started</A></LI>
+ <LI><A href="standalone-server.html" title="Standalone Server">Standalone Server</A></LI>
+ <LI><A href="jackrabbit-components.html" title="Jackrabbit Components">Jackrabbit Components</A></LI>
+ <LI><A href="first-hops.html" title="First Hops">First Hops</A></LI>
+ <LI><A href="jcr-api.html" title="JCR & API">JCR & API</A></LI>
+ <LI><A href="jackrabbit-architecture.html" title="Jackrabbit Architecture">Jackrabbit Architecture</A></LI>
+ <LI><A href="deployment-models.html" title="Deployment Models">Deployment Models</A></LI>
+ <LI><A href="jackrabbit-configuration.html" title="Jackrabbit Configuration">Jackrabbit Configuration</A></LI>
+ <LI><A href="node-types.html" title="Node Types">Node Types</A></LI>
+ <LI><A href="object-content-mapping.html" title="Object Content Mapping">Object Content Mapping</A></LI>
+ </UL>
+ </LI>
+ <LI>Development
+ <UL>
+ <LI><A href="jackrabbit-team.html" title="Jackrabbit Team">Jackrabbit Team</A></LI>
+ <LI><A href="jackrabbit-roadmap.html" title="Jackrabbit Roadmap">Jackrabbit Roadmap</A></LI>
+ <LI><A href="building-jackrabbit.html" title="Building Jackrabbit">Building Jackrabbit</A></LI>
+ <LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI>
+ <LI><A href="issue-tracker.html" title="Issue Tracker">Issue Tracker</A></LI>
+ <LI><A href="source-repository.html" title="Source Repository">Source Repository</A></LI>
+ <LI><A href="continuous-integration.html" title="Continuous Integration">Continuous Integration</A></LI>
+ <LI><A href="website.html" title="Website">Website</A></LI>
+ <LI><A href="creating-releases.html" title="Creating Releases">Creating Releases</A></LI>
+ <LI><A href="supporting-software-attribution.html" title="Supporting software attribution">Attribution</A></LI>
+ </UL>
+ </LI>
+ <LI>Apache Software Foundation
+ <UL>
+ <LI><A href="http://www.apache.org/foundation/how-it-works.html" class="external-link">Introduction</A></LI>
+ <LI><A href="http://www.apache.org/foundation/sponsorship.html" class="external-link">Sponsorship</A></LI>
+ <LI><A href="http://www.apache.org/foundation/thanks.html" class="external-link">Current Sponsors</A></LI>
+ </UL>
+ </LI>
+</UL>
+ </DIV>
+ <DIV id="content">
+ <H1>OCM Search</H1>
+
+<H2><A name="OCMSearch-Searchingasingleobject"></A>Searching a single object</H2>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+QueryManager queryManager = ocm.getQueryManager();
+
+<SPAN class="code-comment">// Build the search filter
+</SPAN>Filter filter = queryManager.createFilter(Paragraph.class);
+filter.addEqualTo(<SPAN class="code-quote">"text"</SPAN>, <SPAN class="code-quote">"Para 1"</SPAN>); <SPAN class="code-comment">// Text is an attribute in the class Paragraph
+</SPAN>
+<SPAN class="code-comment">// Build the query
+</SPAN>Query query = queryManager.createQuery(filter);
+Paragraph paragraph = (Paragraph) ocm.getObject(query);
+</PRE>
+</DIV></DIV>
+
+<H2><A name="OCMSearch-Searchingacollection"></A>Searching a collection</H2>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+QueryManager queryManager = ocm.getQueryManager();
+Filter filter = queryManager.createFilter(Paragraph.class);
+filter.setScope(<SPAN class="code-quote">"/test/node1<SPAN class="code-comment">//"</SPAN>);
+</SPAN>Query query = queryManager.createQuery(filter);
+Collection result = ocm.getObjects(query);
+</PRE>
+</DIV></DIV>
+
+<H2><A name="OCMSearch-Searchingwithaniterator"></A>Searching with an iterator</H2>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+QueryManager queryManager = ocm.getQueryManager();
+Filter filter = queryManager.createFilter(Paragraph.class);
+filter.setScope(<SPAN class="code-quote">"/test/node1<SPAN class="code-comment">//"</SPAN>);
+</SPAN>Query query = queryManager.createQuery(filter);
+Iterator iterator = ocm.getObjectIterator(query);
+</PRE>
+</DIV></DIV>
+
+<H2><A name="OCMSearch-Removeobjectsbasedonaquery"></A>Remove objects based on a query</H2>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+QueryManager queryManager = ocm.getQueryManager();
+Filter filter = queryManager.createFilter(Paragraph.class);
+filter.setScope(<SPAN class="code-quote">"/test/node1<SPAN class="code-comment">//"</SPAN>);
+</SPAN>Query query = queryManager.createQuery(filter);
+ocm.remove(query);
+</PRE>
+</DIV></DIV>
+ </DIV>
+ <DIV id="end"></DIV>
+ </DIV>
+ <DIV id="footer">
+ <P>
+ © 2004-2010 The Apache Software Foundation.
+ - <A href="http://jackrabbit.apache.org/privacy-policy.html">Privacy Policy</A> -
+ [<A href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=75350">edit this page</A>]
+ <BR>
+ Apache Jackrabbit, Jackrabbit, Apache, the Apache feather logo, and the Apache
+ Jackrabbit project logo are trademarks of The Apache Software Foundation.
+ </P>
+ </DIV>
+ </DIV>
+<!-- JCR- 1315: Add Google Analytics to Jackrabbit web site -->
+<SCRIPT type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</SCRIPT>
+<SCRIPT type="text/javascript">
+var pageTracker = _gat._getTracker("UA-837900-2");
+pageTracker._initData();
+pageTracker._trackPageview();
+</SCRIPT>
+ </BODY>
+</HTML>
Added: websites/staging/jackrabbit/trunk/content/JCR/ocm-version-management.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/ocm-version-management.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/ocm-version-management.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,223 @@
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+ <TITLE>OCM Version Management</TITLE>
+ <LINK type="text/css" rel="stylesheet" href="http://jackrabbit.apache.org/style/site.css">
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY>
+ <DIV id="page">
+ <DIV id="header">
+ <P id="jcr"><A href="http://jackrabbit.apache.org/"><IMG src="http://jackrabbit.apache.org/style/jlogo.gif" alt="Apache Jackrabbit" height="100" width="336"></A></P>
+ <P id="asf"><A href="http://www.apache.org/"><IMG src="http://jackrabbit.apache.org/style/asf-logo.gif" alt="Apache Software Foundation" height="100" width="387"></A></P>
+ </DIV>
+ <DIV id="body">
+ <DIV id="navigation">
+ <UL>
+ <LI>Apache Jackrabbit
+ <UL>
+ <LI><A href="welcome-to-apache-jackrabbit.html" title="Welcome to Apache Jackrabbit">Welcome</A></LI>
+ <LI><A href="downloads.html" title="Downloads">Downloads</A></LI>
+ <LI><A href="frequently-asked-questions.html" title="Frequently Asked Questions">FAQ</A></LI>
+ <LI><A href="http://wiki.apache.org/jackrabbit/FrontPage" class="external-link">Jackrabbit Wiki</A></LI>
+ <LI><A href="jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</A></LI>
+ </UL>
+ </LI>
+ <LI>Documentation
+ <UL>
+ <LI><A href="getting-started-with-apache-jackrabbit.html" title="Getting Started with Apache Jackrabbit">Getting Started</A></LI>
+ <LI><A href="standalone-server.html" title="Standalone Server">Standalone Server</A></LI>
+ <LI><A href="jackrabbit-components.html" title="Jackrabbit Components">Jackrabbit Components</A></LI>
+ <LI><A href="first-hops.html" title="First Hops">First Hops</A></LI>
+ <LI><A href="jcr-api.html" title="JCR & API">JCR & API</A></LI>
+ <LI><A href="jackrabbit-architecture.html" title="Jackrabbit Architecture">Jackrabbit Architecture</A></LI>
+ <LI><A href="deployment-models.html" title="Deployment Models">Deployment Models</A></LI>
+ <LI><A href="jackrabbit-configuration.html" title="Jackrabbit Configuration">Jackrabbit Configuration</A></LI>
+ <LI><A href="node-types.html" title="Node Types">Node Types</A></LI>
+ <LI><A href="object-content-mapping.html" title="Object Content Mapping">Object Content Mapping</A></LI>
+ </UL>
+ </LI>
+ <LI>Development
+ <UL>
+ <LI><A href="jackrabbit-team.html" title="Jackrabbit Team">Jackrabbit Team</A></LI>
+ <LI><A href="jackrabbit-roadmap.html" title="Jackrabbit Roadmap">Jackrabbit Roadmap</A></LI>
+ <LI><A href="building-jackrabbit.html" title="Building Jackrabbit">Building Jackrabbit</A></LI>
+ <LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI>
+ <LI><A href="issue-tracker.html" title="Issue Tracker">Issue Tracker</A></LI>
+ <LI><A href="source-repository.html" title="Source Repository">Source Repository</A></LI>
+ <LI><A href="continuous-integration.html" title="Continuous Integration">Continuous Integration</A></LI>
+ <LI><A href="website.html" title="Website">Website</A></LI>
+ <LI><A href="creating-releases.html" title="Creating Releases">Creating Releases</A></LI>
+ <LI><A href="supporting-software-attribution.html" title="Supporting software attribution">Attribution</A></LI>
+ </UL>
+ </LI>
+ <LI>Apache Software Foundation
+ <UL>
+ <LI><A href="http://www.apache.org/foundation/how-it-works.html" class="external-link">Introduction</A></LI>
+ <LI><A href="http://www.apache.org/foundation/sponsorship.html" class="external-link">Sponsorship</A></LI>
+ <LI><A href="http://www.apache.org/foundation/thanks.html" class="external-link">Current Sponsors</A></LI>
+ </UL>
+ </LI>
+</UL>
+ </DIV>
+ <DIV id="content">
+ <H1>OCM Version Management</H1>
+ <P>Right now, the OCM tools provides basic versioning features:</P>
+
+<UL>
+ <LI>Check in, check out.</LI>
+ <LI>Retrieve version history (first version, last version, the complete history, ...).</LI>
+ <LI>Apply labels.</LI>
+</UL>
+
+
+<P>Later, we would like to add more advanced versioning support like version compare, replace, revert, ... Each versioned object has to be mapped to a mix:versionable JCR node. It is possible to specify this node type in the xml class descriptor or with an annotation :</P>
+
+<H2><A name="OCMVersionManagement-CheckinCheckout"></A>Check in - Check out</H2>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+<SPAN class="code-comment">// Create a <SPAN class="code-keyword">new</SPAN> page - first version
+</SPAN>Page page = <SPAN class="code-keyword">new</SPAN> Page();
+page.setPath(<SPAN class="code-quote">"/page"</SPAN>);
+page.setTitle(<SPAN class="code-quote">"Page Title"</SPAN>);
+page.addParagraph(<SPAN class="code-keyword">new</SPAN> Paragraph(<SPAN class="code-quote">"para1"</SPAN>));
+page.addParagraph(<SPAN class="code-keyword">new</SPAN> Paragraph(<SPAN class="code-quote">"para2"</SPAN>));
+ocm.insert(page);
+ocm.save();
+
+<SPAN class="code-comment">// Update the page object and create a <SPAN class="code-keyword">new</SPAN> version
+</SPAN>page.addParagraph(<SPAN class="code-keyword">new</SPAN> Paragraph(<SPAN class="code-quote">"para3"</SPAN>));
+ocm.checkout(<SPAN class="code-quote">"/page"</SPAN>);
+ocm.update(page);
+ocm.save();
+ocm.checkin(<SPAN class="code-quote">"/page"</SPAN>);
+
+<SPAN class="code-comment">// Update the page object and create a <SPAN class="code-keyword">new</SPAN> version
+</SPAN>page.addParagraph(<SPAN class="code-keyword">new</SPAN> Paragraph(<SPAN class="code-quote">"para4"</SPAN>));
+ocm.checkout(<SPAN class="code-quote">"/page"</SPAN>);
+ocm.update(page);
+ocm.save();
+ocm.checkin(<SPAN class="code-quote">"/page"</SPAN>);
+</PRE>
+</DIV></DIV>
+
+<H2><A name="OCMVersionManagement-Retrievetheversionhistory"></A>Retrieve the version history</H2>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+VersionIterator versionIterator = ocm.getAllVersions(<SPAN class="code-quote">"/page"</SPAN>);
+<SPAN class="code-keyword">while</SPAN> (versionIterator.hasNext())
+{
+ Version version = (Version) versionIterator.next();
+ <SPAN class="code-object">System</SPAN>.out.println(<SPAN class="code-quote">"version found : "</SPAN>+ version.getName() + <SPAN class="code-quote">" - "</SPAN> +
+ version.getPath() + <SPAN class="code-quote">" - "</SPAN> + version.getCreated().getTime());
+}
+</PRE>
+</DIV></DIV>
+
+<H2><A name="OCMVersionManagement-Retrieveversiondescription"></A>Retrieve version description</H2>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+<SPAN class="code-comment">// Retrieve the first version description
+</SPAN>Version baseVersion = ocm.getBaseVersion(<SPAN class="code-quote">"/page"</SPAN>);
+<SPAN class="code-object">System</SPAN>.out.println(<SPAN class="code-quote">"Base version : "</SPAN> + baseVersion.getName());
+
+<SPAN class="code-comment">// Retrieve the latest version description
+</SPAN>Version rootVersion = ocm.getRootVersion(<SPAN class="code-quote">"/page"</SPAN>);
+<SPAN class="code-object">System</SPAN>.out.println(<SPAN class="code-quote">"Root version : "</SPAN> + rootVersion.getName());
+</PRE>
+</DIV></DIV>
+
+<H2><A name="OCMVersionManagement-Retrievetheobjectstatematchingtoaspecificversion"></A>Retrieve the object state matching to a specific version</H2>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+<SPAN class="code-comment">//Get the object matching to the first version
+</SPAN>Page page = (Page) ocm.getObject( <SPAN class="code-quote">"/page"</SPAN>, <SPAN class="code-quote">"1.0"</SPAN>);
+</PRE>
+</DIV></DIV>
+
+<H2><A name="OCMVersionManagement-Usingversionlabels"></A>Using version labels</H2>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+Page page = <SPAN class="code-keyword">new</SPAN> Page();
+page.setPath(<SPAN class="code-quote">"/page"</SPAN>);
+page.setTitle(<SPAN class="code-quote">"Page Title"</SPAN>);
+page.addParagraph(<SPAN class="code-keyword">new</SPAN> Paragraph(<SPAN class="code-quote">"para1"</SPAN>));
+page.addParagraph(<SPAN class="code-keyword">new</SPAN> Paragraph(<SPAN class="code-quote">"para2"</SPAN>));
+ocm.insert(page);
+ocm.save();
+
+<SPAN class="code-comment">// Checkin with some labels
+</SPAN>page.addParagraph(<SPAN class="code-keyword">new</SPAN> Paragraph(<SPAN class="code-quote">"para3"</SPAN>));
+ocm.checkout(<SPAN class="code-quote">"/page"</SPAN>);
+ocm.update(page);
+ocm.save();
+ocm.checkin(<SPAN class="code-quote">"/page"</SPAN>, <SPAN class="code-keyword">new</SPAN> <SPAN class="code-object">String</SPAN>[] {<SPAN class="code-quote">"A"</SPAN>, <SPAN class="code-quote">"B"</SPAN>});
+
+<SPAN class="code-comment">// Checkin with some labels
+</SPAN>page.addParagraph(<SPAN class="code-keyword">new</SPAN> Paragraph(<SPAN class="code-quote">"para4"</SPAN>));
+ocm.checkout(<SPAN class="code-quote">"/page"</SPAN>);
+ocm.update(page);
+ocm.save();
+ocm.checkin(<SPAN class="code-quote">"/page"</SPAN>, <SPAN class="code-keyword">new</SPAN> <SPAN class="code-object">String</SPAN>[] {<SPAN class="code-quote">"C"</SPAN>, <SPAN class="code-quote">"D"</SPAN>});
+
+<SPAN class="code-comment">// Retrieve all labels
+</SPAN><SPAN class="code-object">String</SPAN>[] allLabels = ocm.getAllVersionLabels(<SPAN class="code-quote">"/page"</SPAN>);
+assertTrue(<SPAN class="code-quote">"Incorrect number of labels"</SPAN>, allLabels.length == 4);
+
+<SPAN class="code-comment">// Retrieve labels assigned to the version 1.1
+</SPAN><SPAN class="code-object">String</SPAN>[] versionLabels = ocm.getVersionLabels(<SPAN class="code-quote">"/page"</SPAN>, <SPAN class="code-quote">"1.1"</SPAN>);
+assertTrue(<SPAN class="code-quote">"Incorrect number of labels"</SPAN>, versionLabels.length == 2);
+assertTrue(<SPAN class="code-quote">"Incorrect label"</SPAN>, versionLabels[0].equals(<SPAN class="code-quote">"C"</SPAN>) || versionLabels[0].equals(<SPAN class="code-quote">"D"</SPAN>));
+assertTrue(<SPAN class="code-quote">"Incorrect label"</SPAN>, versionLabels[1].equals(<SPAN class="code-quote">"C"</SPAN>) || versionLabels[0].equals(<SPAN class="code-quote">"D"</SPAN>));
+</PRE>
+</DIV></DIV>
+ </DIV>
+ <DIV id="end"></DIV>
+ </DIV>
+ <DIV id="footer">
+ <P>
+ © 2004-2010 The Apache Software Foundation.
+ - <A href="http://jackrabbit.apache.org/privacy-policy.html">Privacy Policy</A> -
+ [<A href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=75354">edit this page</A>]
+ <BR>
+ Apache Jackrabbit, Jackrabbit, Apache, the Apache feather logo, and the Apache
+ Jackrabbit project logo are trademarks of The Apache Software Foundation.
+ </P>
+ </DIV>
+ </DIV>
+<!-- JCR- 1315: Add Google Analytics to Jackrabbit web site -->
+<SCRIPT type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</SCRIPT>
+<SCRIPT type="text/javascript">
+var pageTracker = _gat._getTracker("UA-837900-2");
+pageTracker._initData();
+pageTracker._trackPageview();
+</SCRIPT>
+ </BODY>
+</HTML>
Added: websites/staging/jackrabbit/trunk/content/JCR/privacy-policy.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/privacy-policy.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/privacy-policy.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,125 @@
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+ <TITLE>Privacy Policy</TITLE>
+ <LINK type="text/css" rel="stylesheet" href="http://jackrabbit.apache.org/style/site.css">
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY>
+ <DIV id="page">
+ <DIV id="header">
+ <P id="jcr"><A href="http://jackrabbit.apache.org/"><IMG src="http://jackrabbit.apache.org/style/jlogo.gif" alt="Apache Jackrabbit" height="100" width="336"></A></P>
+ <P id="asf"><A href="http://www.apache.org/"><IMG src="http://jackrabbit.apache.org/style/asf-logo.gif" alt="Apache Software Foundation" height="100" width="387"></A></P>
+ </DIV>
+ <DIV id="body">
+ <DIV id="navigation">
+ <UL>
+ <LI>Apache Jackrabbit
+ <UL>
+ <LI><A href="welcome-to-apache-jackrabbit.html" title="Welcome to Apache Jackrabbit">Welcome</A></LI>
+ <LI><A href="downloads.html" title="Downloads">Downloads</A></LI>
+ <LI><A href="frequently-asked-questions.html" title="Frequently Asked Questions">FAQ</A></LI>
+ <LI><A href="http://wiki.apache.org/jackrabbit/FrontPage" class="external-link">Jackrabbit Wiki</A></LI>
+ <LI><A href="jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</A></LI>
+ </UL>
+ </LI>
+ <LI>Documentation
+ <UL>
+ <LI><A href="getting-started-with-apache-jackrabbit.html" title="Getting Started with Apache Jackrabbit">Getting Started</A></LI>
+ <LI><A href="standalone-server.html" title="Standalone Server">Standalone Server</A></LI>
+ <LI><A href="jackrabbit-components.html" title="Jackrabbit Components">Jackrabbit Components</A></LI>
+ <LI><A href="first-hops.html" title="First Hops">First Hops</A></LI>
+ <LI><A href="jcr-api.html" title="JCR & API">JCR & API</A></LI>
+ <LI><A href="jackrabbit-architecture.html" title="Jackrabbit Architecture">Jackrabbit Architecture</A></LI>
+ <LI><A href="deployment-models.html" title="Deployment Models">Deployment Models</A></LI>
+ <LI><A href="jackrabbit-configuration.html" title="Jackrabbit Configuration">Jackrabbit Configuration</A></LI>
+ <LI><A href="node-types.html" title="Node Types">Node Types</A></LI>
+ <LI><A href="object-content-mapping.html" title="Object Content Mapping">Object Content Mapping</A></LI>
+ </UL>
+ </LI>
+ <LI>Development
+ <UL>
+ <LI><A href="jackrabbit-team.html" title="Jackrabbit Team">Jackrabbit Team</A></LI>
+ <LI><A href="jackrabbit-roadmap.html" title="Jackrabbit Roadmap">Jackrabbit Roadmap</A></LI>
+ <LI><A href="building-jackrabbit.html" title="Building Jackrabbit">Building Jackrabbit</A></LI>
+ <LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI>
+ <LI><A href="issue-tracker.html" title="Issue Tracker">Issue Tracker</A></LI>
+ <LI><A href="source-repository.html" title="Source Repository">Source Repository</A></LI>
+ <LI><A href="continuous-integration.html" title="Continuous Integration">Continuous Integration</A></LI>
+ <LI><A href="website.html" title="Website">Website</A></LI>
+ <LI><A href="creating-releases.html" title="Creating Releases">Creating Releases</A></LI>
+ <LI><A href="supporting-software-attribution.html" title="Supporting software attribution">Attribution</A></LI>
+ </UL>
+ </LI>
+ <LI>Apache Software Foundation
+ <UL>
+ <LI><A href="http://www.apache.org/foundation/how-it-works.html" class="external-link">Introduction</A></LI>
+ <LI><A href="http://www.apache.org/foundation/sponsorship.html" class="external-link">Sponsorship</A></LI>
+ <LI><A href="http://www.apache.org/foundation/thanks.html" class="external-link">Current Sponsors</A></LI>
+ </UL>
+ </LI>
+</UL>
+ </DIV>
+ <DIV id="content">
+ <H1>Privacy Policy</H1>
+ <P>Information about your use of this website is collected using server access logs and a tracking cookie. The collected information consists of the following:</P>
+
+<OL>
+ <LI>The IP address from which you access the website;</LI>
+ <LI>The type of browser and operating system you use to access our site;</LI>
+ <LI>The date and time you access our site;</LI>
+ <LI>The pages you visit; and</LI>
+ <LI>The addresses of pages from where you followed a link to our site.</LI>
+</OL>
+
+
+<P>Part of this information is gathered using a tracking cookie set by the <A href="http://www.google.com/analytics/" class="external-link">Google Analytics</A> service and handled by Google as described in their <A href="http://www.google.com/privacy.html" class="external-link">privacy policy</A>. See your browser documentation for instructions on how to disable the cookie if you prefer not to share this data with Google.</P>
+
+<P>We use the gathered information to help us make our site more useful to visitors and to better understand how and when our site is used. We do not track or collect personally identifiable information or associate gathered data with any personally identifying information from other sources.</P>
+
+<P>By using this website, you consent to the collection of this data in the manner and for the purpose described above.</P>
+ </DIV>
+ <DIV id="end"></DIV>
+ </DIV>
+ <DIV id="footer">
+ <P>
+ © 2004-2010 The Apache Software Foundation.
+ - <A href="http://jackrabbit.apache.org/privacy-policy.html">Privacy Policy</A> -
+ [<A href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=105185">edit this page</A>]
+ <BR>
+ Apache Jackrabbit, Jackrabbit, Apache, the Apache feather logo, and the Apache
+ Jackrabbit project logo are trademarks of The Apache Software Foundation.
+ </P>
+ </DIV>
+ </DIV>
+<!-- JCR- 1315: Add Google Analytics to Jackrabbit web site -->
+<SCRIPT type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</SCRIPT>
+<SCRIPT type="text/javascript">
+var pageTracker = _gat._getTracker("UA-837900-2");
+pageTracker._initData();
+pageTracker._trackPageview();
+</SCRIPT>
+ </BODY>
+</HTML>
Added: websites/staging/jackrabbit/trunk/content/JCR/repository-lifecycle.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/repository-lifecycle.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/repository-lifecycle.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,138 @@
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+ <TITLE>Repository lifecycle</TITLE>
+ <LINK type="text/css" rel="stylesheet" href="http://jackrabbit.apache.org/style/site.css">
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY>
+ <DIV id="page">
+ <DIV id="header">
+ <P id="jcr"><A href="http://jackrabbit.apache.org/"><IMG src="http://jackrabbit.apache.org/style/jlogo.gif" alt="Apache Jackrabbit" height="100" width="336"></A></P>
+ <P id="asf"><A href="http://www.apache.org/"><IMG src="http://jackrabbit.apache.org/style/asf-logo.gif" alt="Apache Software Foundation" height="100" width="387"></A></P>
+ </DIV>
+ <DIV id="body">
+ <DIV id="navigation">
+ <UL>
+ <LI>Apache Jackrabbit
+ <UL>
+ <LI><A href="welcome-to-apache-jackrabbit.html" title="Welcome to Apache Jackrabbit">Welcome</A></LI>
+ <LI><A href="downloads.html" title="Downloads">Downloads</A></LI>
+ <LI><A href="frequently-asked-questions.html" title="Frequently Asked Questions">FAQ</A></LI>
+ <LI><A href="http://wiki.apache.org/jackrabbit/FrontPage" class="external-link">Jackrabbit Wiki</A></LI>
+ <LI><A href="jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</A></LI>
+ </UL>
+ </LI>
+ <LI>Documentation
+ <UL>
+ <LI><A href="getting-started-with-apache-jackrabbit.html" title="Getting Started with Apache Jackrabbit">Getting Started</A></LI>
+ <LI><A href="standalone-server.html" title="Standalone Server">Standalone Server</A></LI>
+ <LI><A href="jackrabbit-components.html" title="Jackrabbit Components">Jackrabbit Components</A></LI>
+ <LI><A href="first-hops.html" title="First Hops">First Hops</A></LI>
+ <LI><A href="jcr-api.html" title="JCR & API">JCR & API</A></LI>
+ <LI><A href="jackrabbit-architecture.html" title="Jackrabbit Architecture">Jackrabbit Architecture</A></LI>
+ <LI><A href="deployment-models.html" title="Deployment Models">Deployment Models</A></LI>
+ <LI><A href="jackrabbit-configuration.html" title="Jackrabbit Configuration">Jackrabbit Configuration</A></LI>
+ <LI><A href="node-types.html" title="Node Types">Node Types</A></LI>
+ <LI><A href="object-content-mapping.html" title="Object Content Mapping">Object Content Mapping</A></LI>
+ </UL>
+ </LI>
+ <LI>Development
+ <UL>
+ <LI><A href="jackrabbit-team.html" title="Jackrabbit Team">Jackrabbit Team</A></LI>
+ <LI><A href="jackrabbit-roadmap.html" title="Jackrabbit Roadmap">Jackrabbit Roadmap</A></LI>
+ <LI><A href="building-jackrabbit.html" title="Building Jackrabbit">Building Jackrabbit</A></LI>
+ <LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI>
+ <LI><A href="issue-tracker.html" title="Issue Tracker">Issue Tracker</A></LI>
+ <LI><A href="source-repository.html" title="Source Repository">Source Repository</A></LI>
+ <LI><A href="continuous-integration.html" title="Continuous Integration">Continuous Integration</A></LI>
+ <LI><A href="website.html" title="Website">Website</A></LI>
+ <LI><A href="creating-releases.html" title="Creating Releases">Creating Releases</A></LI>
+ <LI><A href="supporting-software-attribution.html" title="Supporting software attribution">Attribution</A></LI>
+ </UL>
+ </LI>
+ <LI>Apache Software Foundation
+ <UL>
+ <LI><A href="http://www.apache.org/foundation/how-it-works.html" class="external-link">Introduction</A></LI>
+ <LI><A href="http://www.apache.org/foundation/sponsorship.html" class="external-link">Sponsorship</A></LI>
+ <LI><A href="http://www.apache.org/foundation/thanks.html" class="external-link">Current Sponsors</A></LI>
+ </UL>
+ </LI>
+</UL>
+ </DIV>
+ <DIV id="content">
+ <H1>Repository lifecycle</H1>
+ <P>The lifecycle of any Jackrabbit Content Repository starts with a call to one of the RepositoryFactory.create() methods passing optionally the source of a repository configuration file (which by convention is called config.xml) and the RepositoryFactoryHome, which points to a directory from which the Repository will continue reading further information for start-up and in many cases will store the actual data that is persisted in the repository and its workspaces.</P>
+
+<P>Not supplying the RepositoryFactoryHome will default to the users home dir from the System property user.dir.</P>
+
+<P>Not supplying the configuration file parameter will default to the value of Repository.factory.config System Property and if that is not set it will default to the config.xml in the RepositoryFactoryHome.</P>
+
+<P>Calling the create() method will instantiate the RepositoryFactory singleton that will then, through the getRepository(String name) method, serve as the factory for Repository instances.</P>
+
+<P>As per the config.xml a repository are started up with the respectively configured RepositoryStore, the RepositoryStore defines where the repository stores information that is visible for the entire Repository which includes things like the uuid of the root node, repository properties, the namespace registry, node type definitions or the version backing store in a file structure as follows.</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+./meta:
+rep.properties
+rootUUID
+
+./namespaces:
+ns_reg.properties
+
+./nodetypes:
+custom_nodetypes.xml
+
+./versions:
+</PRE>
+</DIV></DIV>
+
+<P>The RepositoryStore normally points to a regular (i.e. local) file system but is abstracted through an abstract FileSystem that can be configured to point to a different FileSystem implementation, in case the above information should be stored in a different data container.</P>
+
+<P>... to be continued ... </P>
+ </DIV>
+ <DIV id="end"></DIV>
+ </DIV>
+ <DIV id="footer">
+ <P>
+ © 2004-2010 The Apache Software Foundation.
+ - <A href="http://jackrabbit.apache.org/privacy-policy.html">Privacy Policy</A> -
+ [<A href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=75336">edit this page</A>]
+ <BR>
+ Apache Jackrabbit, Jackrabbit, Apache, the Apache feather logo, and the Apache
+ Jackrabbit project logo are trademarks of The Apache Software Foundation.
+ </P>
+ </DIV>
+ </DIV>
+<!-- JCR- 1315: Add Google Analytics to Jackrabbit web site -->
+<SCRIPT type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</SCRIPT>
+<SCRIPT type="text/javascript">
+var pageTracker = _gat._getTracker("UA-837900-2");
+pageTracker._initData();
+pageTracker._trackPageview();
+</SCRIPT>
+ </BODY>
+</HTML>
Added: websites/staging/jackrabbit/trunk/content/JCR/repository-server-howto.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/repository-server-howto.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/repository-server-howto.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,165 @@
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+ <TITLE>Repository Server HOWTO</TITLE>
+ <LINK type="text/css" rel="stylesheet" href="http://jackrabbit.apache.org/style/site.css">
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY>
+ <DIV id="page">
+ <DIV id="header">
+ <P id="jcr"><A href="http://jackrabbit.apache.org/"><IMG src="http://jackrabbit.apache.org/style/jlogo.gif" alt="Apache Jackrabbit" height="100" width="336"></A></P>
+ <P id="asf"><A href="http://www.apache.org/"><IMG src="http://jackrabbit.apache.org/style/asf-logo.gif" alt="Apache Software Foundation" height="100" width="387"></A></P>
+ </DIV>
+ <DIV id="body">
+ <DIV id="navigation">
+ <UL>
+ <LI>Apache Jackrabbit
+ <UL>
+ <LI><A href="welcome-to-apache-jackrabbit.html" title="Welcome to Apache Jackrabbit">Welcome</A></LI>
+ <LI><A href="downloads.html" title="Downloads">Downloads</A></LI>
+ <LI><A href="frequently-asked-questions.html" title="Frequently Asked Questions">FAQ</A></LI>
+ <LI><A href="http://wiki.apache.org/jackrabbit/FrontPage" class="external-link">Jackrabbit Wiki</A></LI>
+ <LI><A href="jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</A></LI>
+ </UL>
+ </LI>
+ <LI>Documentation
+ <UL>
+ <LI><A href="getting-started-with-apache-jackrabbit.html" title="Getting Started with Apache Jackrabbit">Getting Started</A></LI>
+ <LI><A href="standalone-server.html" title="Standalone Server">Standalone Server</A></LI>
+ <LI><A href="jackrabbit-components.html" title="Jackrabbit Components">Jackrabbit Components</A></LI>
+ <LI><A href="first-hops.html" title="First Hops">First Hops</A></LI>
+ <LI><A href="jcr-api.html" title="JCR & API">JCR & API</A></LI>
+ <LI><A href="jackrabbit-architecture.html" title="Jackrabbit Architecture">Jackrabbit Architecture</A></LI>
+ <LI><A href="deployment-models.html" title="Deployment Models">Deployment Models</A></LI>
+ <LI><A href="jackrabbit-configuration.html" title="Jackrabbit Configuration">Jackrabbit Configuration</A></LI>
+ <LI><A href="node-types.html" title="Node Types">Node Types</A></LI>
+ <LI><A href="object-content-mapping.html" title="Object Content Mapping">Object Content Mapping</A></LI>
+ </UL>
+ </LI>
+ <LI>Development
+ <UL>
+ <LI><A href="jackrabbit-team.html" title="Jackrabbit Team">Jackrabbit Team</A></LI>
+ <LI><A href="jackrabbit-roadmap.html" title="Jackrabbit Roadmap">Jackrabbit Roadmap</A></LI>
+ <LI><A href="building-jackrabbit.html" title="Building Jackrabbit">Building Jackrabbit</A></LI>
+ <LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI>
+ <LI><A href="issue-tracker.html" title="Issue Tracker">Issue Tracker</A></LI>
+ <LI><A href="source-repository.html" title="Source Repository">Source Repository</A></LI>
+ <LI><A href="continuous-integration.html" title="Continuous Integration">Continuous Integration</A></LI>
+ <LI><A href="website.html" title="Website">Website</A></LI>
+ <LI><A href="creating-releases.html" title="Creating Releases">Creating Releases</A></LI>
+ <LI><A href="supporting-software-attribution.html" title="Supporting software attribution">Attribution</A></LI>
+ </UL>
+ </LI>
+ <LI>Apache Software Foundation
+ <UL>
+ <LI><A href="http://www.apache.org/foundation/how-it-works.html" class="external-link">Introduction</A></LI>
+ <LI><A href="http://www.apache.org/foundation/sponsorship.html" class="external-link">Sponsorship</A></LI>
+ <LI><A href="http://www.apache.org/foundation/thanks.html" class="external-link">Current Sponsors</A></LI>
+ </UL>
+ </LI>
+</UL>
+ </DIV>
+ <DIV id="content">
+ <H1>Repository Server HOWTO</H1>
+ <P>This document describes how to use a Jackrabbit content repository in the deployment model 3: The Repository Server. In this deployment model, a separate repository server is running outside the virtual machine the client application is running in. A repository server can serve multiple applications running on separate JVMs on separate network hosts. See the <A href="jcr-client-application-howto.html" title="JCR client application HOWTO">JCR client application HOWTO</A> for instructions on how to use the configured content repository server.</P>
+
+<P>Note that JCR specification defines no standard communication protocol for inter-JVM repository access, and that Jackrabbit supports no such protocol by default. However, Jackrabbit contains tools for using JCR content repositories over the RMI and WebDAV protocols (see the jcr-rmi and the jcr-server, webapp packages).</P>
+
+<P>This how-to contains instructions for accessing a JCR-RMI server in Tomcat versions 4.x and 5.x. It should be easy to modify the instructions for other container environments and communication protocols.</P>
+
+<P>In addition to the following the instructions in this document, you also need to have an already running JCR-RMI server. See the JCR-RMI javadocs for instructions on how to setup such a server.</P>
+
+<P>Warning: The current JCR-RMI library is designed for simplicity, not performance. You will probably experience major performance issues if you try running any non-trivial applications on top of JCR-RMI.</P>
+
+<H2><A name="RepositoryServerHOWTO-Tomcatinstructions"></A>Tomcat instructions</H2>
+
+<P>Follow the steps below to setup a model 3 JCR-RMI client deployment for your web application in Tomcat 4.x or 5.x. Example code for both versions of Tomcat is included after this overview.</P>
+
+<P>Note that these instructions closely follow the Model 1 HOWTO instructions. By making similar changes (change the factory class and parameters of the repository) to the Model 2 HOWTO instructions, you can setup a shared JCR-RMI client deployment for all applications in the container.</P>
+
+<OL>
+ <LI>Place the JCR-RMI jar file and its dependencies (including the JCR API jar) under <EM>Tomcat folder</EM>/webapps/<EM>your app</EM>/WEB-INF/lib.</LI>
+ <LI>Register the JCR-RMI client repository factory in the context scope.</LI>
+</OL>
+
+
+<H3><A name="RepositoryServerHOWTO-Step2Contextconfiguration"></A>Step 2 - Context configuration</H3>
+
+<P>In Tomcat 4.x and 5.0, add the following snippet in server.xml under the Context element of your web application.</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+<Resource name=<SPAN class="code-quote">"jcr/repository"</SPAN>
+ auth=<SPAN class="code-quote">"Container"</SPAN>
+ type=<SPAN class="code-quote">"javax.jcr.Repository"</SPAN>/>
+
+<ResourceParams name=<SPAN class="code-quote">"jcr/repository"</SPAN>>
+ <parameter>
+ <name>factory</name>
+ <value>org.apache.jackrabbit.rmi.client.ClientRepositoryFactory</value>
+ </parameter>
+ <parameter>
+ <name>url</name>
+ <value>[The RMI URL of the repository]</value>
+ </parameter>
+</ResourceParams>
+</PRE>
+</DIV></DIV>
+
+<P>In Tomcat 5.5, add the following snippet in your application's context.xml file (or in the server.xml file if you prefer central configuration).</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+<Resource name=<SPAN class="code-quote">"jcr/repository"</SPAN>
+ auth=<SPAN class="code-quote">"Container"</SPAN>
+ type=<SPAN class="code-quote">"javax.jcr.Repository"</SPAN>
+ factory=<SPAN class="code-quote">"org.apache.jackrabbit.rmi.client.ClientRepositoryFactory"</SPAN>
+ url=<SPAN class="code-quote">"[The RMI URL of the repository]"</SPAN>/>
+</PRE>
+</DIV></DIV>
+ </DIV>
+ <DIV id="end"></DIV>
+ </DIV>
+ <DIV id="footer">
+ <P>
+ © 2004-2010 The Apache Software Foundation.
+ - <A href="http://jackrabbit.apache.org/privacy-policy.html">Privacy Policy</A> -
+ [<A href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=75327">edit this page</A>]
+ <BR>
+ Apache Jackrabbit, Jackrabbit, Apache, the Apache feather logo, and the Apache
+ Jackrabbit project logo are trademarks of The Apache Software Foundation.
+ </P>
+ </DIV>
+ </DIV>
+<!-- JCR- 1315: Add Google Analytics to Jackrabbit web site -->
+<SCRIPT type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</SCRIPT>
+<SCRIPT type="text/javascript">
+var pageTracker = _gat._getTracker("UA-837900-2");
+pageTracker._initData();
+pageTracker._trackPageview();
+</SCRIPT>
+ </BODY>
+</HTML>