jackrabbit-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r844404 [12/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-...
Date Mon, 31 Dec 2012 12:40:59 GMT
Added: websites/staging/jackrabbit/trunk/content/JCR/jackrabbit-webdav-library.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/jackrabbit-webdav-library.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/jackrabbit-webdav-library.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,128 @@
+
+<!-- 
+  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>Jackrabbit WebDAV Library</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 &amp; 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>Jackrabbit WebDAV Library</H1>
+  <P>This is the WebDAV Library component of the Apache Jackrabbit project. This component provides interfaces and common utility classes used for building a WebDAV server or client.</P>
+
+<P>The following RFCs have been integrated:</P>
+<UL>
+	<LI><A href="http://www.webdav.org/specs/rfc4918.html" class="external-link">RFC 4918</A> (WebDAV - HTTP Extensions for Distributed Authoring, obsoleting RFC 2518)</LI>
+	<LI><A href="http://www.webdav.org/specs/rfc3253.html" class="external-link">RFC 3253</A> (DeltaV - Versioning Extensions to WebDAV)</LI>
+	<LI><A href="http://www.webdav.org/specs/rfc3648.html" class="external-link">RFC 3648</A> (Ordered Collections Protocol)</LI>
+	<LI><A href="http://www.webdav.org/specs/rfc3744.html" class="external-link">RFC 3744</A> (Access Control Protocol)</LI>
+	<LI><A href="http://www.webdav.org/specs/rfc5323.html" class="external-link">RFC 5323</A> (WebDAV SEARCH; previously DASL - DAV Searching and Locating)</LI>
+	<LI><A href="http://greenbytes.de/tech/webdav/draft-ietf-webdav-bind-latest.html" class="external-link">draft-ietf-webdav-bind</A> (Binding Extensions to Web Distributed Authoring and Versioning (WebDAV))</LI>
+</UL>
+
+
+<P>In addition this library defines (unspecified)</P>
+<UL>
+	<LI>Observation</LI>
+	<LI>Bundling multiple request with extensions to locking</LI>
+</UL>
+
+        </DIV>
+        <DIV id="end"></DIV>
+      </DIV>
+      <DIV id="footer">
+        <P>
+          &copy; 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=75201">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/jcr-api.data/level-1.jpg
==============================================================================
Binary file - no diff available.

Propchange: websites/staging/jackrabbit/trunk/content/JCR/jcr-api.data/level-1.jpg
------------------------------------------------------------------------------
    svn:mime-type = image/jpeg

Added: websites/staging/jackrabbit/trunk/content/JCR/jcr-api.data/level-1.jpg.jpeg
==============================================================================
Binary file - no diff available.

Propchange: websites/staging/jackrabbit/trunk/content/JCR/jcr-api.data/level-1.jpg.jpeg
------------------------------------------------------------------------------
    svn:mime-type = image/jpeg

Added: websites/staging/jackrabbit/trunk/content/JCR/jcr-api.data/level-2.jpg
==============================================================================
Binary file - no diff available.

Propchange: websites/staging/jackrabbit/trunk/content/JCR/jcr-api.data/level-2.jpg
------------------------------------------------------------------------------
    svn:mime-type = image/jpeg

Added: websites/staging/jackrabbit/trunk/content/JCR/jcr-api.data/level-2.jpg.jpeg
==============================================================================
Binary file - no diff available.

Propchange: websites/staging/jackrabbit/trunk/content/JCR/jcr-api.data/level-2.jpg.jpeg
------------------------------------------------------------------------------
    svn:mime-type = image/jpeg

Added: websites/staging/jackrabbit/trunk/content/JCR/jcr-api.data/level-adv.jpg
==============================================================================
Binary file - no diff available.

Propchange: websites/staging/jackrabbit/trunk/content/JCR/jcr-api.data/level-adv.jpg
------------------------------------------------------------------------------
    svn:mime-type = image/jpeg

Added: websites/staging/jackrabbit/trunk/content/JCR/jcr-api.data/level-adv.jpg.jpeg
==============================================================================
Binary file - no diff available.

Propchange: websites/staging/jackrabbit/trunk/content/JCR/jcr-api.data/level-adv.jpg.jpeg
------------------------------------------------------------------------------
    svn:mime-type = image/jpeg

Added: websites/staging/jackrabbit/trunk/content/JCR/jcr-api.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/jcr-api.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/jcr-api.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,166 @@
+
+<!-- 
+  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>JCR & API</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="" title="JCR & API">JCR &amp; 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>JCR &amp; API</H1>
+  <P>Jackrabbit is a complete, and fully compliant implementation of  the Content Repository API for Java Technology (JCR) and therefore its primary API is defined by JCR. For a developer this means that most operations required are defined by the JCR API. The classes and interfaces within Apache Jackrabbit are only needed when accessing functionality that is not specified in JCR.</P>
+
+<P>Beyond the JCR API Jackrabbit features numerous extensions and administrational features that are needed to run a repository  but are not (yet) specified by JCR. (see <A href="jackrabbit-architecture.html" title="Jackrabbit Architecture">Jackrabbit Architecture</A>)</P>
+
+<P>See the javadoc documentation of the JCR API and Apache Jackrabbit releases:</P>
+
+<UL>
+	<LI><A href="http://www.day.com/maven/javax.jcr/javadocs/jcr-2.0/" class="external-link">JCR 2.0</A></LI>
+	<LI><A href="http://jackrabbit.apache.org/api/2.4/" class="external-link">Apache Jackrabbit 2.4</A></LI>
+	<LI><A href="http://jackrabbit.apache.org/api/2.2/" class="external-link">Apache Jackrabbit 2.2</A></LI>
+	<LI><A href="http://jackrabbit.apache.org/api/2.1/" class="external-link">Apache Jackrabbit 2.1</A></LI>
+	<LI><A href="http://jackrabbit.apache.org/api/2.0/" class="external-link">Apache Jackrabbit 2.0</A></LI>
+</UL>
+
+
+<UL>
+	<LI><A href="http://www.day.com/maven/jsr170/javadocs/jcr-1.0/" class="external-link">JCR 1.0</A></LI>
+	<LI><A href="http://jackrabbit.apache.org/api/1.6/" class="external-link">Apache Jackrabbit 1.6</A></LI>
+	<LI><A href="http://jackrabbit.apache.org/api/1.5/" class="external-link">Apache Jackrabbit 1.5</A></LI>
+	<LI><A href="http://jackrabbit.apache.org/api/1.4/" class="external-link">Apache Jackrabbit 1.4</A></LI>
+	<LI><A href="http://jackrabbit.apache.org/api/1.3/" class="external-link">Apache Jackrabbit 1.3</A></LI>
+	<LI><A href="http://jackrabbit.apache.org/api/1.2.3/" class="external-link">Apache Jackrabbit 1.2</A></LI>
+	<LI><A href="http://jackrabbit.apache.org/api-1/" class="external-link">Apache Jackrabbit 1.0</A></LI>
+</UL>
+
+
+<H2><A name="JCR%26API-JSR170Levels"></A>JSR-170 Levels</H2>
+
+<P>The Content Repository API for Java Technology (JSR-170) is split into different Levels of compliancy, to allow Repository Vendors to gradually adopt JSR-170 and to avoid that the overhead is unnecessarily high for repository vendors that only want to expose portions of their repository functionality through a JSR-170 compliant Interface.   JSR-170 specifies a Level 1, a Level 2 and a set of advanced repository  feature blocks. Jackrabbit is fully JSR-170 compliant and therefore supports Level 1, Level 2 and all the optional blocks.</P>
+
+<H3><A name="JCR%26API-Level1%3AEaseofAdoption%2CCoveringmanyusecases"></A>Level 1 : Ease of Adoption, Covering many usecases</H3>
+
+<P>The Scope of Level 1 of JSR-170 to cover a large number of simple  Applications, that need to search repositories and need to read  from repositories. Level 1 specifies a read-only API that allows to  introspect Node and Property-types and offers hierarchical read access to content stored in a repository. </P>
+
+<DIV class="" align="center"><SPAN class="image-wrap" style=""><IMG src="jcr-api.data/level-1.jpg" style="border: 0px solid black"></SPAN></DIV>
+
+
+<P>Level 1 of JSR-170 is geared to allow people to write  applications such as search and display Portlets,  CMS-Templates, Reports, Exports or other applications  that harvest, search, present or display information  from one or multiple repositories.</P>
+
+<H3><A name="JCR%26API-Level2%3AWriteableRepository"></A>Level 2 : Writeable Repository</H3>
+
+<P>Level 2 of JSR-170 specifies all the writing  capabilities need to bi-directionally interact with a content repository in a fine and coarse grained  fashion.</P>
+
+<DIV class="" align="center"><SPAN class="image-wrap" style=""><IMG src="jcr-api.data/level-2.jpg" style="border: 0px solid black"></SPAN></DIV>
+
+
+<P>Applications written against Level 2 of JSR-170 include management applications or generally speaking any  application that generates data, information or content for both structured and unstructured information.</P>
+
+<H3><A name="JCR%26API-AdvancedOptions"></A>Advanced Options</H3>
+
+<P>On top of Level 1 or Level 2 a number of functional  block serve for more advanced repository functionality. This includes functions like: Versioning,  (JTA) Transactions, Query using SQL, Explicit  Locking and Content Observation.</P>
+
+<DIV class="" align="center"><SPAN class="image-wrap" style=""><IMG src="jcr-api.data/level-adv.jpg" style="border: 0px solid black"></SPAN></DIV>
+
+
+<P>A fully JSR-170 compliant repository like Jackrabbit encompasses all the functionalities and therefore lends itself as general purpose, off-the-shelf  infrastructure for Content-, Document- and Source Code Management or for just about any  other application that persists content.</P>
+        </DIV>
+        <DIV id="end"></DIV>
+      </DIV>
+      <DIV id="footer">
+        <P>
+          &copy; 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=75340">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/jcr-client-application-howto.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/jcr-client-application-howto.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/jcr-client-application-howto.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,154 @@
+
+<!-- 
+  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>JCR client application 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 &amp; 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>JCR client application HOWTO</H1>
+  <P>This document describes the common configuration and initialization code of a client application that uses a JCR content repository. The application setup does not depend on the underlying deployment model, implementation, or configuration of the content repository.</P>
+
+<P>The instructions in this document apply to a J2EE web application that uses JNDI to access the content repository. It should however be easy to modify the instructions for other container environments.</P>
+
+<H2><A name="JCRclientapplicationHOWTO-J2EEwebapplicationinstructions"></A>J2EE web application instructions</H2>
+
+<P>Follow the steps below to access a JNDI-bound content repository within a J2EE web application. Example code is included after this overview. See the deployment model howtos for instructions on how to create the JNDI bindings for the standard deployment models.</P>
+
+<OL>
+	<LI>Place the JCR API jar in the WEB-INF/lib subdirectory of your web application.</LI>
+	<LI>Declare the JNDI address under which you will request the repository instance in the deployment descriptor.</LI>
+	<LI>Code your application to use the resource.</LI>
+</OL>
+
+
+<P>Note that that none of your code or configuration needs to depend on the underlying repository implementation or deployment model. All those details are handled by the container and can easily be changed without modifying your application. Just make sure that you have documented the JCR repository level and optional features your application requires so that your application can be deployed in an appropriate environment.</P>
+
+<H3><A name="JCRclientapplicationHOWTO-Step2Deploymentdescriptor"></A>Step 2 - Deployment descriptor</H3>
+
+<P>Add the following snippet in your web.xml deployment descriptor to declare your application's use of a content repository resource.</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+&lt;resource-env-ref&gt;
+  &lt;description&gt;Content Repository&lt;/description&gt;
+  &lt;resource-env-ref-name&gt;jcr/repository&lt;/resource-env-ref-name&gt;
+  &lt;resource-env-ref-type&gt;javax.jcr.Repository&lt;/resource-env-ref-type&gt;
+&lt;/resource-env-ref&gt;
+</PRE>
+</DIV></DIV>
+
+<P>Note that the java:comp/env/jcr subcontext is the preferred naming context for JCR content repository resources.</P>
+
+<H3><A name="JCRclientapplicationHOWTO-Step3Javacode"></A>Step 3 - Java code</H3>
+
+<P>Use the following Java code snippet to get a reference to the configured content repository instance.</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+InitialContext context = <SPAN class="code-keyword">new</SPAN> InitialContext();
+Context environment = (Context) context.lookup(<SPAN class="code-quote">&quot;java:comp/env&quot;</SPAN>);
+Repository repository = (Repository) environment.lookup(<SPAN class="code-quote">&quot;jcr/repository&quot;</SPAN>);
+</PRE>
+</DIV></DIV>
+
+        </DIV>
+        <DIV id="end"></DIV>
+      </DIV>
+      <DIV id="footer">
+        <P>
+          &copy; 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=75320">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/jcr.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/jcr.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/jcr.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,112 @@
+
+<!-- 
+  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>JCR</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 &amp; 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>JCR</H1>
+  <P>The JCR API library is a core dependency for most of the <A href="jackrabbit-components.html" title="Jackrabbit Components">Jackrabbit Components</A>. The <TT>jcr-1.0.jar</TT> file contains all the <A href="http://www.day.com/maven/jsr170/javadocs/jcr-1.0/" class="external-link">javax.jcr interfaces</A> specified by <A href="http://jcp.org/en/jsr/detail?id=170" class="external-link">JSR 170</A>.</P>
+
+<P>The JCR API library is available under the <A href="http://www.day.com/maven/jsr170/licenses/day-spec-license.htm" class="external-link">Day Spec License</A> and can be downloaded either from the <A href="http://jcp.org/aboutJava/communityprocess/final/jsr170/index.html" class="external-link">JCP web site</A> or the <A href="http://repo1.maven.org/maven2/javax/jcr/jcr/1.0/" class="external-link">central Maven repository</A>.</P>
+        </DIV>
+        <DIV id="end"></DIV>
+      </DIV>
+      <DIV id="footer">
+        <P>
+          &copy; 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=86992">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/mailing-lists.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/mailing-lists.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/mailing-lists.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,205 @@
+
+<!-- 
+  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>Mailing Lists</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 &amp; 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="" 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>Mailing Lists</H1>
+  <P>Mailing lists are the primary communication channel of the Apache Jackrabbit project. See the Apache <A href="http://www.apache.org/foundation/mailinglists.html" class="external-link">mailing list</A> and <A href="http://www.apache.org/dev/contrib-email-tips.html" class="external-link">email contribution</A> pages for general information about mailing list usage and the expected behaviour on the mailing lists.</P>
+
+<P>The following lists are used by the Apache Jackrabbit project:</P>
+
+<DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Mailing list </TH>
+<TH class="confluenceTh"> Address </TH>
+<TH class="confluenceTh"> Subscribe </TH>
+<TH class="confluenceTh"> Unsubscribe </TH>
+</TR>
+<TR>
+<TD class="confluenceTd"> Jackrabbit Announcements List </TD>
+<TD class="confluenceTd"> <A href="mailto:announce@jackrabbit.apache.org" class="external-link">announce@jackrabbit.apache.org</A> </TD>
+<TD class="confluenceTd"> <A href="mailto:announce-subscribe@jackrabbit.apache.org?subject=subscribe" class="external-link">subscribe</A> </TD>
+<TD class="confluenceTd"> <A href="mailto:announce-unsubscribe@jackrabbit.apache.org?subject=unsubscribe" class="external-link">unsubscribe</A> </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> Jackrabbit Users List </TD>
+<TD class="confluenceTd"> <A href="mailto:users@jackrabbit.apache.org" class="external-link">users@jackrabbit.apache.org</A> </TD>
+<TD class="confluenceTd"> <A href="mailto:users-subscribe@jackrabbit.apache.org?subject=subscribe" class="external-link">subscribe</A> </TD>
+<TD class="confluenceTd"> <A href="mailto:users-unsubscribe@jackrabbit.apache.org?subject=unsubscribe" class="external-link">unsubscribe</A> </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> Jackrabbit Development List </TD>
+<TD class="confluenceTd"> <A href="mailto:dev@jackrabbit.apache.org" class="external-link">dev@jackrabbit.apache.org</A> </TD>
+<TD class="confluenceTd"> <A href="mailto:dev-subscribe@jackrabbit.apache.org?subject=subscribe" class="external-link">subscribe</A> </TD>
+<TD class="confluenceTd"> <A href="mailto:dev-unsubscribe@jackrabbit.apache.org?subject=unsubscribe" class="external-link">unsubscribe</A> </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> Jackrabbit Commits List </TD>
+<TD class="confluenceTd"> <A href="mailto:commits@jackrabbit.apache.org" class="external-link">commits@jackrabbit.apache.org</A> </TD>
+<TD class="confluenceTd"> <A href="mailto:commits-subscribe@jackrabbit.apache.org?subject=subscribe" class="external-link">subscribe</A> </TD>
+<TD class="confluenceTd"> <A href="mailto:commits-unsubscribe@jackrabbit.apache.org?subject=unsubscribe" class="external-link">unsubscribe</A> </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> Oak Development List </TD>
+<TD class="confluenceTd"> <A href="mailto:oak-dev@jackrabbit.apache.org" class="external-link">oak-dev@jackrabbit.apache.org</A> </TD>
+<TD class="confluenceTd"> <A href="mailto:oak-dev-subscribe@jackrabbit.apache.org?subject=subscribe" class="external-link">subscribe</A> </TD>
+<TD class="confluenceTd"> <A href="mailto:oak-dev-unsubscribe@jackrabbit.apache.org?subject=unsubscribe" class="external-link">unsubscribe</A> </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> Oak Commits List </TD>
+<TD class="confluenceTd"> <A href="mailto:oak-commits@jackrabbit.apache.org" class="external-link">oak-commits@jackrabbit.apache.org</A> </TD>
+<TD class="confluenceTd"> <A href="mailto:oak-commits-subscribe@jackrabbit.apache.org?subject=subscribe" class="external-link">subscribe</A> </TD>
+<TD class="confluenceTd"> <A href="mailto:oak-commits-unsubscribe@jackrabbit.apache.org?subject=unsubscribe" class="external-link">unsubscribe</A> </TD>
+</TR>
+</TBODY></TABLE>
+</DIV>
+
+
+<P>See the <A href="http://www.ezmlm.org/ezman/ezman1.html" class="external-link">ezmlm user manual</A> and especially the sections on <A href="http://www.ezmlm.org/ezman/ezman1.html#ss1.3" class="external-link">subscribing</A> and <A href="http://www.ezmlm.org/ezman/ezman1.html#ss1.4" class="external-link">unsubscribing</A> for instructions on how to use the Jackrabbit mailing lists.</P>
+
+<H2><A name="MailingLists-Troubleunsubscribing%3F"></A>Trouble unsubscribing?</H2>
+
+<P>If you have trouble unsubscribing from Jackrabbit mailing lists, you probably have subscribed some other address than the one you're trying to unsubscribe. To find out the address you are subscribed with, look for a <TT>Return-Path</TT> header in the source of one of the messages you've received from the mailing list. It should contain something like <TT>listname-return-1234-your.address=example.com@jackrabbit.apache.org</TT> which means that you're subscribed with <TT>your.address@example.com</TT>. You can turn that into an unsubscription request by replacing the &quot;return-1234&quot; part (the numbers change per message) with &quot;unsubscribe&quot;, like this: <TT>listname-unsubscribe-your.address=example.com@jackrabbit.apache.org</TT>. Send a message to that address to unsubscribe.</P>
+
+<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>Please do not send unsubscription requests directly to the normal mailing list addresses. If you have trouble unsubscribing and the above instructions don't work, you can ask <A href="mailto:dev-owner@jackrabbit.apache.org" class="external-link">dev-owner@jackrabbit.apache.org</A> for help.</TD></TR></TABLE></DIV>
+
+<H2><A name="MailingLists-Mailinglistarchives"></A>Mailing list archives</H2>
+
+<P>The Jackrabbit mailing lists are archived in many places that provide different features for browsing and searching the archives.</P>
+
+<DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Archive site </TH>
+<TH class="confluenceTh"> Jackrabbit Archives </TH>
+</TR>
+<TR>
+<TD class="confluenceTd">  Apache       </TD>
+<TD class="confluenceTd"> <A href="http://mail-archives.apache.org/mod_mbox/jackrabbit-announce/" class="external-link">announce</A> <A href="http://mail-archives.apache.org/mod_mbox/jackrabbit-users/" class="external-link">users</A> <A href="http://mail-archives.apache.org/mod_mbox/jackrabbit-dev/" class="external-link">dev</A> <A href="http://mail-archives.apache.org/mod_mbox/jackrabbit-commits/" class="external-link">commits</A> <A href="http://mail-archives.apache.org/mod_mbox/jackrabbit-oak-dev/" class="external-link">oak-dev</A> <A href="http://mail-archives.apache.org/mod_mbox/jackrabbit-oak-commits/" class="external-link">oak-commits</A> </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> Gmane </TD>
+<TD class="confluenceTd"> <A href="http://dir.gmane.org/gmane.comp.apache.jackrabbit.user" class="external-link">users</A> <A href="http://dir.gmane.org/gmane.comp.apache.jackrabbit.devel" class="external-link">dev</A> </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> The Mail Archive </TD>
+<TD class="confluenceTd"> <A href="http://www.mail-archive.com/users@jackrabbit.apache.org" class="external-link">users</A> <A href="http://www.mail-archive.com/dev@jackrabbit.apache.org" class="external-link">dev</A> <A href="http://www.mail-archive.com/oak-dev@jackrabbit.apache.org" class="external-link">oak-dev</A> </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> Nabble </TD>
+<TD class="confluenceTd"> <A href="http://www.nabble.com/Jackrabbit---Users-f14897.html" class="external-link">users</A> <A href="http://www.nabble.com/Jackrabbit---Dev-f371.html" class="external-link">dev</A> </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> MarkMail </TD>
+<TD class="confluenceTd"> <A href="http://jackrabbit.markmail.org/" class="external-link">All Jackrabbit lists</A> </TD>
+</TR>
+</TBODY></TABLE>
+</DIV>
+
+
+<P>The raw list archives are also available as compressed mbox files at <A href="http://jackrabbit.apache.org/mail/" class="external-link">http://jackrabbit.apache.org/mail/</A>.</P>
+        </DIV>
+        <DIV id="end"></DIV>
+      </DIV>
+      <DIV id="footer">
+        <P>
+          &copy; 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=77278">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/mapping-atomic-fields.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/mapping-atomic-fields.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/mapping-atomic-fields.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,267 @@
+
+<!-- 
+  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>Mapping Atomic Fields</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 &amp; 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>Mapping Atomic Fields</H1>
+  <P>The field-descriptor maps a bean attribute based on a Java primitive           type into a JCR property. By default, the persistence manager uses           the correct mapping in function of the attribute type (see below           the section &quot;Supported Types&quot;).</P>
+
+<P>Based on our model defined here,           the following field-descriptor maps the bean field &quot;title&quot;           (String type) into the JCR property &quot;my:title&quot;.</P>
+
+<H2><A name="MappingAtomicFields-SupportedTypes"></A>Supported Types</H2>
+
+<P> It is not necessary to specify the type in the field-descriptor.           The Persistence Manager uses the java introspection to get           information on each atomic field.</P>
+<DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Java Type </TH>
+<TH class="confluenceTh"> Jcr Type </TH>
+</TR>
+<TR>
+<TD class="confluenceTd"> String </TD>
+<TD class="confluenceTd"> STRING </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> Boolean, boolean </TD>
+<TD class="confluenceTd"> BOOLEAN </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> Double, double </TD>
+<TD class="confluenceTd"> DOUBLE </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> Integer, int </TD>
+<TD class="confluenceTd"> DOUBLE </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> Long, long </TD>
+<TD class="confluenceTd"> LONG </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> byte[] </TD>
+<TD class="confluenceTd"> BINARY </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> java.io.InputStream </TD>
+<TD class="confluenceTd"> BINARY </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> java.util.Calendar </TD>
+<TD class="confluenceTd"> LONG (corresponding to Calendar.getTimeInMillis() </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> java.sql.Timestamp </TD>
+<TD class="confluenceTd"> LONG (corresponding to Timestamp.getTime() </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> java.util.Date </TD>
+<TD class="confluenceTd"> LONG (corresponding to java.util.Date.getTime() </TD>
+</TR>
+</TBODY></TABLE>
+</DIV>
+
+
+<P> Due to some issues with Jackrabbit (mainly with xpath queries),           Calendar, Timestamp and date are converted into JCR LONG.           We plan to add other converters for those types in the next release.</P>
+
+<H2><A name="MappingAtomicFields-UsingAnotherAtomicTypeConverter"></A>Using Another Atomic Type Converter</H2>
+
+<P>The OCM framework gives you the freedom to choose another kind of          mapping for atomic fields. For example, you can convert          java.util.Date bean field into a JCR Date type instead of a          JCR Long type. This can be done by writing your own atomic type          converter class.</P>
+
+<P>Let's start with a simple example. If you want to use a mapping           strategy which convert a boolean bean field into a JCR Long type,           you have to make the following steps:</P>
+
+<H3><A name="MappingAtomicFields-Specifytheconverterclassinthefielddescriptor"></A>Specify the converter class in the field descriptor</H3>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+&lt;class-descriptor
+    className=<SPAN class="code-quote">&quot;org.apache.jackrabbit.ocm.testmodel.Atomic&quot;</SPAN>
+    jcrType=<SPAN class="code-quote">&quot;nt:unstructured&quot;</SPAN>&gt;
+  &lt;field-descriptor
+      fieldName=<SPAN class="code-quote">&quot;int2boolean&quot;</SPAN> jcrName=<SPAN class="code-quote">&quot;int2boolean&quot;</SPAN>
+      converter=<SPAN class="code-quote">&quot;org.apache.jackrabbit.ocm.persistence.atomic.Int2BooleanTypeConverterImpl&quot;</SPAN> /&gt;
+&lt;/class-descriptor&gt;
+</PRE>
+</DIV></DIV>
+
+<H3><A name="MappingAtomicFields-Implementtheconverterclass"></A>Implement the converter class</H3>
+
+<P>Use the interface             org.apache.jackrabbit.ocm.persistence.atomic.AtomicTypeConverter</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;"><B>Int2BooleanTypeConverterImpl.java</B></DIV><DIV class="codeContent panelContent">
+<PRE class="code-java">
+<SPAN class="code-keyword">package</SPAN> org.apache.jackrabbit.ocm.persistence.atomic;
+
+<SPAN class="code-keyword">import</SPAN> javax.jcr.Value;
+<SPAN class="code-keyword">import</SPAN> javax.jcr.ValueFactory;
+
+<SPAN class="code-keyword">import</SPAN> org.apache.jackrabbit.ocm.exception.IncorrectAtomicTypeException;
+<SPAN class="code-keyword">import</SPAN> org.apache.jackrabbit.ocm.persistence.atomictypeconverter.AtomicTypeConverter;
+
+/**
+ * This is a simple converter which convert a <SPAN class="code-object">boolean</SPAN> field value into a jcr <SPAN class="code-object">long</SPAN> property.
+ *
+ * @author &lt;a href=<SPAN class="code-quote">&quot;mailto:christophe.lombart@gmail.com&quot;</SPAN>&gt;Christophe Lombart&lt;/a&gt;
+ */
+<SPAN class="code-keyword">public</SPAN> class Int2BooleanTypeConverterImpl <SPAN class="code-keyword">implements</SPAN> AtomicTypeConverter
+{
+  /**
+   *
+   * @see org.apache.jackrabbit.ocm.persistence.atomictypeconverter.AtomicTypeConverter#getValue(java.lang.<SPAN class="code-object">Object</SPAN>)
+   */
+  <SPAN class="code-keyword">public</SPAN> Value getValue(ValueFactory valueFactory, <SPAN class="code-object">Object</SPAN> propValue)
+  {
+    <SPAN class="code-keyword">if</SPAN> (propValue == <SPAN class="code-keyword">null</SPAN>)
+    {
+      <SPAN class="code-keyword">return</SPAN> <SPAN class="code-keyword">null</SPAN>;
+    }
+    <SPAN class="code-object">boolean</SPAN> value = ((<SPAN class="code-object">Boolean</SPAN>) propValue).booleanValue();
+    <SPAN class="code-object">int</SPAN> jcrValue = 0;
+
+    <SPAN class="code-keyword">if</SPAN> (value)
+    {
+      jcrValue = 1;
+    }
+    <SPAN class="code-keyword">return</SPAN> valueFactory.createValue(jcrValue);
+  }
+
+
+    /**
+     *
+     * @see org.apache.jackrabbit.ocm.persistence.atomictypeconverter.AtomicTypeConverter#getObject(javax.jcr.Value)
+     */
+  <SPAN class="code-keyword">public</SPAN> <SPAN class="code-object">Object</SPAN> getObject(Value value)
+    {
+      <SPAN class="code-keyword">try</SPAN>
+      {
+        <SPAN class="code-object">long</SPAN> jcrValue = value.getLong();
+        <SPAN class="code-keyword">if</SPAN> (jcrValue == 1)
+        {
+           <SPAN class="code-keyword">return</SPAN> <SPAN class="code-keyword">new</SPAN> <SPAN class="code-object">Boolean</SPAN>(<SPAN class="code-keyword">true</SPAN>);
+        }
+        <SPAN class="code-keyword">else</SPAN>
+        {
+           <SPAN class="code-keyword">return</SPAN> <SPAN class="code-keyword">new</SPAN> <SPAN class="code-object">Boolean</SPAN>(<SPAN class="code-keyword">false</SPAN>);
+        }
+    }
+    <SPAN class="code-keyword">catch</SPAN> (Exception e)
+    {
+      <SPAN class="code-keyword">throw</SPAN> <SPAN class="code-keyword">new</SPAN> IncorrectAtomicTypeException(<SPAN class="code-quote">&quot;Impossible to convert the value : &quot;</SPAN> + value.toString()  , e);
+    }
+    }
+
+  /**
+   *
+   * @see org.apache.jackrabbit.ocm.persistence.atomictypeconverter.AtomicTypeConverter#getStringValue(java.lang.<SPAN class="code-object">Object</SPAN>)
+   */
+  <SPAN class="code-keyword">public</SPAN> <SPAN class="code-object">String</SPAN> getStringValue(<SPAN class="code-object">Object</SPAN> object)
+  {
+
+    <SPAN class="code-keyword">return</SPAN> ((<SPAN class="code-object">Boolean</SPAN>) object).booleanValue() ? <SPAN class="code-quote">&quot;1&quot;</SPAN> : <SPAN class="code-quote">&quot;0&quot;</SPAN>;
+  }
+
+}
+</PRE>
+</DIV></DIV>
+        </DIV>
+        <DIV id="end"></DIV>
+      </DIV>
+      <DIV id="footer">
+        <P>
+          &copy; 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=75359">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/mapping-bean-fields.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/mapping-bean-fields.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/mapping-bean-fields.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,258 @@
+
+<!-- 
+  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>Mapping Bean Fields</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 &amp; 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>Mapping Bean Fields</H1>
+  <P> The bean-descriptor maps a bean attribute into one JCR node           (or a set of properties). Generally, this attribute is an           object based on a custom class.</P>
+
+<P> Based on our model defined here,           the following bean-descriptor is used to map the bean field           &quot;pageInfo&quot; (PageInfo class) into the JCR node called &quot;pageInfo&quot;.</P>
+
+<P> The PageInfo class has a corresponding class-descriptor in the           mapping file. By this way, the Persistence Manager can map each           PageInfo attributes. It is not necessary to specify the type in           the bean-descriptor. The Persistence Manager uses the Java           introspection to get information on the each bean fields.</P>
+
+<H2><A name="MappingBeanFields-TheJCRStructure"></A>The JCR Structure</H2>
+
+<P>Following our example, the resulting JCR structure is:</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+/mysite/page1
+  /mysite/page1/pageInfo
+       my:title = <SPAN class="code-quote">&quot;This is my page title&quot;</SPAN>
+       my:description = <SPAN class="code-quote">&quot;This is my page description&quot;</SPAN>
+  ... other subnodes <SPAN class="code-keyword">for</SPAN> page1 ...
+</PRE>
+</DIV></DIV>
+
+<P>By default, the persistence manager will create a subnode           (/mysite/page1/pageInfo) for the bean-descriptor pageInfo.</P>
+
+<H2><A name="MappingBeanFields-UsingAnotherBeanConverter"></A>Using Another Bean Converter</H2>
+
+<P>The OCM framework gives you the freedom to choose another kind            of mapping for bean fields. For example, you can use a custom            bean converter to access to the parent node (see the next            section below).</P>
+
+<P>This can be done by writing your own bean converter class and            reference this class in the bean-descriptor.</P>
+
+<H3><A name="MappingBeanFields-PredefinedBeanConverters"></A>Predefined Bean Converters</H3>
+
+<P> Here is the list of existing custom  bean converters:</P>
+<DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Custom Bean Converter Class </TH>
+<TH class="confluenceTh"> Description </TH>
+</TR>
+<TR>
+<TD class="confluenceTd"> org.apache.jackrabbit.ocm.persistence.beanconverter.impl.ParentBeanConverterImpl </TD>
+<TD class="confluenceTd"> Map a bean field to the parent node. it is used to access to the               parent object in read-only mode. See below the example based on               a Folder object. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> org.apache.jackrabbit.ocm.persistence.beanconverter.impl.InlineBeanConverterImpl </TD>
+<TD class="confluenceTd"> Bean converter used to map some node properties into one nested               bean field. The corresponding bean field is not associated to a               subnode. </TD>
+</TR>
+</TBODY></TABLE>
+</DIV>
+
+
+<P>If you want to use one of this bean converter, you have to           reference it into a bean-field descriptor.</P>
+
+<P>The following descriptor bean-descriptor contains a reference to           its parent folder (parentFolder attribute). Now the CmsObjectImpl           object has an attribute (parentFolder) that contains a reference           to the parent node.</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+&lt;class-descriptor
+    className=<SPAN class="code-quote">&quot;org.apache.jackrabbit.ocm.testmodel.inheritance.impl.CmsObjectImpl&quot;</SPAN>
+    jcrType=<SPAN class="code-quote">&quot;my:cmsobjectimpl&quot;</SPAN> &gt;
+  &lt;field-descriptor fieldName=<SPAN class="code-quote">&quot;path&quot;</SPAN> path=<SPAN class="code-quote">&quot;<SPAN class="code-keyword">true</SPAN>&quot;</SPAN> /&gt;
+  &lt;field-descriptor fieldName=<SPAN class="code-quote">&quot;name&quot;</SPAN> jcrName=<SPAN class="code-quote">&quot;my:name&quot;</SPAN> id=<SPAN class="code-quote">&quot;<SPAN class="code-keyword">true</SPAN>&quot;</SPAN> /&gt;
+  &lt;bean-descriptor
+      fieldName=<SPAN class="code-quote">&quot;parentFolder&quot;</SPAN>
+      converter=<SPAN class="code-quote">&quot;org.apache.jackrabbit.ocm.persistence.beanconverter.impl.ParentBeanConverterImpl&quot;</SPAN> /&gt;
+&lt;/class-descriptor&gt;
+</PRE>
+</DIV></DIV>
+
+<H3><A name="MappingBeanFields-BuildingyourownBeanConverters"></A>Building your own Bean Converters</H3>
+
+<P>Here is the different steps used to create a new bean converter :</P>
+
+<P>First, specify the converter class in the bean descriptor:</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+&lt;class-descriptor
+    className=<SPAN class="code-quote">&quot;org.apache.jackrabbit.ocm.testmodel.inheritance.impl.CmsObjectImpl&quot;</SPAN>
+    jcrType=<SPAN class="code-quote">&quot;my:cmsobjectimpl&quot;</SPAN> &gt;
+  &lt;bean-descriptor
+      fieldName=<SPAN class="code-quote">&quot;parentFolder&quot;</SPAN>
+      converter=<SPAN class="code-quote">&quot;org.apache.jackrabbit.ocm.persistence.beanconverter.impl.ParentBeanConverterImpl&quot;</SPAN> /&gt;
+&lt;/class-descriptor&gt;
+</PRE>
+</DIV></DIV>
+
+<P>Then, implement the converter class (based on the interface           org.apache.jackrabbit.ocm.persistence.beanconverter.BeanConverter).</P>
+
+<P>Your bean converter class can also extends the class           AbstractBeanConverterImpl to have a default implementation for           some methods.</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;"><B>ParentBeanConverterImpl.java</B></DIV><DIV class="codeContent panelContent">
+<PRE class="code-java">
+<SPAN class="code-keyword">import</SPAN> javax.jcr.Node;
+<SPAN class="code-keyword">import</SPAN> javax.jcr.Session;
+
+<SPAN class="code-keyword">import</SPAN> org.apache.commons.logging.Log;
+<SPAN class="code-keyword">import</SPAN> org.apache.commons.logging.LogFactory;
+<SPAN class="code-keyword">import</SPAN> org.apache.jackrabbit.ocm.exception.JcrMappingException;
+<SPAN class="code-keyword">import</SPAN> org.apache.jackrabbit.ocm.exception.PersistenceException;
+<SPAN class="code-keyword">import</SPAN> org.apache.jackrabbit.ocm.exception.RepositoryException;
+<SPAN class="code-keyword">import</SPAN> org.apache.jackrabbit.ocm.mapper.Mapper;
+<SPAN class="code-keyword">import</SPAN> org.apache.jackrabbit.ocm.mapper.model.BeanDescriptor;
+<SPAN class="code-keyword">import</SPAN> org.apache.jackrabbit.ocm.mapper.model.ClassDescriptor;
+<SPAN class="code-keyword">import</SPAN> org.apache.jackrabbit.ocm.persistence.atomictypeconverter.AtomicTypeConverterProvider;
+<SPAN class="code-keyword">import</SPAN> org.apache.jackrabbit.ocm.persistence.beanconverter.BeanConverter;
+<SPAN class="code-keyword">import</SPAN> org.apache.jackrabbit.ocm.persistence.objectconverter.ObjectConverter;
+/**
+ *
+ * Bean converter used to access to the parent object.
+ *
+ *
+ * @author &lt;a href=<SPAN class="code-quote">&quot;mailto:christophe.lombart@gmail.com&quot;</SPAN>&gt;Lombart Christophe &lt;/a&gt;
+ *
+ */
+<SPAN class="code-keyword">public</SPAN> class ParentBeanConverterImpl <SPAN class="code-keyword">extends</SPAN> AbstractBeanConverterImpl  <SPAN class="code-keyword">implements</SPAN> BeanConverter {
+
+  <SPAN class="code-keyword">private</SPAN> <SPAN class="code-keyword">final</SPAN> <SPAN class="code-keyword">static</SPAN> Log log = LogFactory.getLog(ParentBeanConverterImpl.class);
+
+  <SPAN class="code-keyword">public</SPAN> ParentBeanConverterImpl(Mapper mapper, ObjectConverter objectConverter, AtomicTypeConverterProvider atomicTypeConverterProvider)
+  {
+    <SPAN class="code-keyword">super</SPAN>(mapper, objectConverter, atomicTypeConverterProvider);
+  }
+
+  <SPAN class="code-keyword">public</SPAN> void insert(Session session, Node parentNode, BeanDescriptor beanDescriptor, ClassDescriptor beanClassDescriptor, <SPAN class="code-object">Object</SPAN> object, ClassDescriptor parentClassDescriptor, <SPAN class="code-object">Object</SPAN> parent)
+      <SPAN class="code-keyword">throws</SPAN> PersistenceException, RepositoryException,   JcrMappingException {
+
+      <SPAN class="code-comment">// Add code to insert the object
+</SPAN>  }
+
+  <SPAN class="code-keyword">public</SPAN> void update(Session session, Node parentNode, BeanDescriptor beanDescriptor, ClassDescriptor beanClassDescriptor, <SPAN class="code-object">Object</SPAN> object, ClassDescriptor parentClassDescriptor, <SPAN class="code-object">Object</SPAN> parent)
+      <SPAN class="code-keyword">throws</SPAN> PersistenceException, RepositoryException,  JcrMappingException {
+
+      <SPAN class="code-comment">// Add code to update the object
+</SPAN>  }
+
+  <SPAN class="code-keyword">public</SPAN> <SPAN class="code-object">Object</SPAN> getObject(Session session, Node parentNode, BeanDescriptor beanDescriptor, ClassDescriptor beanClassDescriptor, <SPAN class="code-object">Class</SPAN> beanClass, <SPAN class="code-object">Object</SPAN> parent)
+      <SPAN class="code-keyword">throws</SPAN> PersistenceException, RepositoryException,JcrMappingException {
+
+      <SPAN class="code-comment">// Add code to retrieve the object
+</SPAN>  }
+
+  <SPAN class="code-keyword">public</SPAN> void remove(Session session, Node parentNode, BeanDescriptor beanDescriptor, ClassDescriptor beanClassDescriptor, <SPAN class="code-object">Object</SPAN> object, ClassDescriptor parentClassDescriptor, <SPAN class="code-object">Object</SPAN> parent)
+            <SPAN class="code-keyword">throws</SPAN> PersistenceException,  RepositoryException, JcrMappingException {
+
+      <SPAN class="code-comment">// Add the code to remove the object
+</SPAN>  }
+
+}
+</PRE>
+</DIV></DIV>
+        </DIV>
+        <DIV id="end"></DIV>
+      </DIV>
+      <DIV id="footer">
+        <P>
+          &copy; 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=75361">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>



Mime
View raw message