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 [5/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-b...
Added: websites/staging/jackrabbit/trunk/content/JCR/frequently-asked-questions.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/frequently-asked-questions.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/frequently-asked-questions.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,256 @@
+
+<!--
+ 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>Frequently Asked Questions</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="" 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>Frequently Asked Questions</H1>
+ <H2><A name="FrequentlyAskedQuestions-General"></A>General</H2>
+
+<H3><A name="FrequentlyAskedQuestions-WhatisJCR%3F"></A>What is JCR?</H3>
+
+<P>JCR is the acronym of the Content Repository for Java technology API, a standard interface for accessing content repositories. JCR version 1.0 was specified in Java Specification Request 170 (<A href="http://jcp.org/en/jsr/detail?id=170" class="external-link">JSR 170</A>), and version 2.0 is currently under work in <A href="http://jcp.org/en/jsr/detail?id=283" class="external-link">JSR 283</A>.</P>
+
+<H3><A name="FrequentlyAskedQuestions-Whatisacontentrepository%3F"></A>What is a content repository?</H3>
+
+<P>A content repository is an information management system that provides various services for storing, accessing, and managing content. In addition to a hierarchically structured storage, common services of a content repository are versioning, access control, full text searching, and event monitoring. A content repository is not a content management system (CMS), although most existing CMSs contain a custom content repository implementation, often based on the file system or a relational database.</P>
+
+<H3><A name="FrequentlyAskedQuestions-WhatisApacheJackrabbit%3F"></A>What is Apache Jackrabbit?</H3>
+
+<P>Apache Jackrabbit is a fully featured content repository that implements the entire JCR API. The Jackrabbit project was started when Day Software, the JSR-170 specification lead, licensed their initial implementation of the JCR reference implementation. The Jackrabbit codebase was used for the official reference implementation (RI) and technology compatibility kit (TCK) released along with the final JCR API.</P>
+
+<H3><A name="FrequentlyAskedQuestions-WhatdoIdoifIhaveaquestion%3F"></A>What do I do if I have a question?</H3>
+
+<P>Please ask questions on the <A href="http://jackrabbit.apache.org/mailing-lists.html" class="external-link">Jackrabbit mailing lists</A>. There is the users list for questions around using JCR and Jackrabbit and the dev list for the development of Jackrabbit itself and for people starting to extend Jackrabbit or other advanced topics.</P>
+
+
+<H2><A name="FrequentlyAskedQuestions-BuildingJackrabbit"></A>Building Jackrabbit</H2>
+
+<H3><A name="FrequentlyAskedQuestions-HowdoIbuildtheApacheJackrabbitsources%3F"></A>How do I build the Apache Jackrabbit sources?</H3>
+
+<P>See the <A href="building-jackrabbit.html" title="Building Jackrabbit">Building Jackrabbit</A> page for detailed build instructions.</P>
+
+<H2><A name="FrequentlyAskedQuestions-UsingJackrabbit"></A>Using Jackrabbit</H2>
+
+<H3><A name="FrequentlyAskedQuestions-HowdoIdoXwithJCR%2FJackrabbit%3F"></A>How do I do X with JCR/Jackrabbit?</H3>
+
+<P>See the JCR specification, the JCR API documentation, or the Examples page on the Jackrabbit wiki for information on how to perform various operation using the JCR API.</P>
+
+<P>For Jackrabbit features (like access control and node type management) not covered by the JCR API, see the Examples page on the wiki, the Jackrabbit javadocs, or contact the Jackrabbit mailing list.</P>
+
+<H3><A name="FrequentlyAskedQuestions-HowdoIusetransactionswithJCR%3F"></A>How do I use transactions with JCR?</H3>
+
+<P>See the mailing list announcement for a simple example on using the JTA support in Jackrabbit. For a more complete explanation of the transaction features, please see section 8.1 Transactions of the JCR specification.</P>
+
+<H3><A name="FrequentlyAskedQuestions-HowdoIcreatenewworkspacesinJackrabbit%3F"></A>How do I create new workspaces in Jackrabbit?</H3>
+
+<P>The JCR 2.0 API has two <A href="http://www.day.com/maven/jsr170/javadocs/jcr-2.0/javax/jcr/Workspace.html#createWorkspace(java.lang.String)" class="external-link">Workspace.createWorkspace()</A> methods for that.</P>
+
+<P>The JCR 1.0 API does not contain features for creating or managing workspaces, so you need to use Jackrabbit-specific functionality for creating new workspaces. You can create a new workspace either manually or programmatically.</P>
+
+<P>The manual way is to create a new workspace directory within the repository home directory and to place a new workspace.xml configuration file in that folder. You can use the configuration file of an existing workspace as an example, just remember to change the name of the workspace in the Workspace name="..." tag. See the <A href="jackrabbit-configuration.html" title="Jackrabbit Configuration">Jackrabbit Configuration</A> page for configuration details. Note also that you need to restart the repository instance to access the new workspace.</P>
+
+<P>The programmatic way is to acquire a Workspace instance using the normal JCR API and to cast the instance to the JackrabbitWorkspace interface. You can then use the createWorkspace(String) method to create new workspaces.</P>
+
+<H3><A name="FrequentlyAskedQuestions-HowdoIdeleteaworkspaceinJackrabbit%3F"></A>How do I delete a workspace in Jackrabbit?</H3>
+
+<P>There is currently no programmatic way to delete workspaces. You can delete a workspace by manually removing the workspace directory when the repository instance is not running.</P>
+
+<H3><A name="FrequentlyAskedQuestions-HowdoIdeployJackrabbitintoTomcat%3F"></A>How do I deploy Jackrabbit into Tomcat?</H3>
+
+<UL>
+ <LI>Download <A href="http://www.day.com/maven/javax.jcr/jars/jcr-1.0.jar" class="external-link">jcr-1.0.jar</A> and put it into <TT><tomcat-install-dir>/shared/lib</TT>.</LI>
+ <LI>Get the WAR distribution from the <A href="downloads.html" title="Downloads">Downloads</A> page and deploy it into Tomcat.</LI>
+ <LI>Point your browser to <TT>http://</TT><TT>localhost:8080/jackrabbit-webapp-<version>/</TT></LI>
+</UL>
+
+
+<H2><A name="FrequentlyAskedQuestions-Accesscontrol"></A>Access control</H2>
+
+<H3><A name="FrequentlyAskedQuestions-HowdoIuseLDAP%2CKerberos%2CorsomeotherauthenticationmechanismwithJackrabbit%3F"></A>How do I use LDAP, Kerberos, or some other authentication mechanism with Jackrabbit?</H3>
+
+<P>Jackrabbit uses the Java Authentication and Authorization Service (JAAS) for authenticating users. You should be able to use any JAAS LoginModule implementation (e.g. the LoginModules in thecom.sum.security.auth.modulepackage) for authentication. See the JAAS documentation for configuration instructions.</P>
+
+<H3><A name="FrequentlyAskedQuestions-HowdoImanagetheaccessrightsofauthenticatedusers%3F"></A>How do I manage the access rights of authenticated users?</H3>
+
+<P>The current JackrabbitSimpleAccessManager class only supports three access levels: anonymous, normal, and system. Anonymous users have read access while normal and system users have full read-write access. You need to implement a custom AccessManager class to get more fine-grained access control.</P>
+
+
+<H2><A name="FrequentlyAskedQuestions-Persistencemanagers"></A>Persistence managers</H2>
+
+<H3><A name="FrequentlyAskedQuestions-Whatisapersistencemanager%3F"></A>What is a persistence manager?</H3>
+
+<P>A persistence manager (PM) is an internal Jackrabbit component that handles the persistent storage of content nodes and properties. Each workspace of a Jackrabbit content repository uses a separate persistence manager to store the content in that workspace. Also the Jackrabbit version handler uses a separate persistence manager.The persistence manager sits at the very bottom layer of the Jackrabbit system architecture. Reliability, integrity and performance of the PM are crucial to the overall stability and performance of the repository. If e.g. the data that a PM is based upon is allowed to change through external means the integrity of the repository would be at risk (think of referential integrity / node references e.g.).</P>
+
+<P>In practice, a persistence manager is any Java class that implements the PersistenceManager interface and the associated behavoural contracts. Jackrabbit contains a set of built-in persistence manager classes that cover most of the deployment needs. There are also a few contributed persistence managers that give additional flexibility.</P>
+
+<H3><A name="FrequentlyAskedQuestions-WhatisaJackrabbitfilesystem%3F"></A>What is a Jackrabbit file system?</H3>
+
+<P>A Jackrabbbit file system (FS) is an internal component that implements standard file system operations on top of some underlying storage mechanism (a normal file system, a database, a webdav server, or a custom file format). A file system component is any Java class that implements the FileSystem interface and the associated behavioral contracts. File systems are used in Jackrabbit both as subcomponents of the persistence managers and for general storage needs (for example to store the full text indexes).</P>
+
+<H3><A name="FrequentlyAskedQuestions-CanIuseapersistencemanagertoaccessanexistingdatasource%3F"></A>Can I use a persistence manager to access an existing data source?</H3>
+
+<P>No. The persistence manager interface was never intended as being a general SPI that you could implement in order to integrate external data sources with proprietary formats (e.g. a customers database). The reason why we abstracted the PM interface was to leave room for future performance optimizations that would not affect the rest of the implementation (e.g. by storing the raw data in a b-tree based database instead of individual file).</P>
+
+<H3><A name="FrequentlyAskedQuestions-Howsmartshouldapersistencemanagerbe%3F"></A>How smart should a persistence manager be?</H3>
+
+<P>A persistence manager should not be intelligent, i.e. it should not interpret the content it is managing. The only thing it should care about is to efficiently, consistently, and reliably store and read the content encapsulated in the passed NodeState and PropertyState objects. Though it might be feasible to write a custom persistence manager to represent existing legacy data in a level-1 (read-only) repository, I don't think the same is possible for a level-2 repository and I certainly would not recommend it.</P>
+
+<H2><A name="FrequentlyAskedQuestions-Query"></A>Query</H2>
+
+<H3><A name="FrequentlyAskedQuestions-I%27veconfiguredtextFilterClassesbutmyquerystilldoesn%27twork%2Cwhat%27swrong%3F"></A>I've configured textFilterClasses but my query still doesn't work, what's wrong?</H3>
+
+<P>Make sure you changed existing workspace.xml files as well. The workspace element in repository.xml only acts as a template for new workspaces.</P>
+
+<P>Verify that you also put the jar files into the classpath that jackrabbit depends on for text extraction. You can find all required jar files inside the jackrabbit-webapp war file (the <TT>WEB-INF/lib</TT> folder). Go to the <A href="downloads.html" title="Downloads">downloads</A> page to get the war file.</P>
+
+<P>Some documents may still not be searchable for various reasons: the document is corrupt, bug in one of the libraries that extract text, document is encrypted or otherwise protected, etc.</P>
+
+<H3><A name="FrequentlyAskedQuestions-Whydoesn%27t%7B%7B%2F%2F%5Cjcr%3Acontains%28@jcr%3Adata%2C%27foo%27%29%7D%7Dreturnmatchesforbinarycontent%3F"></A>Why doesn't <TT>//*[jcr:contains(@jcr:data, 'foo')]</TT> return matches for binary content?</H3>
+
+<P>Extracted text from binary content is only indexed on the parent node of the @jcr:data property. Use jcr:contains() on the nt:resource node.<BR>
+Examples:</P>
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>//element(*, nt:resource)[jcr:contains(., 'foo')]
+//element(*, nt:file)[jcr:contains(jcr:content, 'foo')]
+</PRE>
+</DIV></DIV>
+
+<H3><A name="FrequentlyAskedQuestions-CanIusetheLucenefieldsyntaxinjcr%3Acontains%28%29%3F"></A>Can I use the Lucene field syntax in jcr:contains()?</H3>
+
+<P>No, you cannot. Even though Jackrabbit uses a Lucene index, the fields for JCR properties do not map 1:1 to Lucene fields. Instead you can use the following:</P>
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>//element(*, book)[jcr:contains(@title, 'jackrabbit') and jcr:contains(@text, 'query')]
+</PRE>
+</DIV></DIV>
+
+<H3><A name="FrequentlyAskedQuestions-MyXPathqueryreturnsnoresultswhenIaddapathconstraint%2Cwhat%27swrong%3F"></A>My XPath query returns no results when I add a path constraint, what's wrong?</H3>
+
+<P>You probably forgot to prefix your statement with <TT>/jcr:root</TT>.</P>
+
+<P>JSR 170 says in section 6.6.4.3:</P>
+<BLOCKQUOTE>
+<P>The context node of an XPath query is the XML node relative to which the query expression is evaluated.</P>
+
+<P>A relative XPath statement (one that does not have a leading /) will be interpreted relative to the root node of the workspace, which, in the XML document view is the top-most XML element, <jcr:root>. This means that one should not include jcr:root as the first segment in a relative XPath statement, since that element is already the default context node.</P>
+
+<P>An absolute XPath (one with a leading /), in contrast, will be interpreted relative to a position one level above <jcr:root>. This means that an absolute XPath must either begin with // or with /jcr:root in order to match anything at all.</P></BLOCKQUOTE>
+
+<H3><A name="FrequentlyAskedQuestions-HowdoIforceaconsistencycheckonthesearchindex%3F"></A>How do I force a consistency check on the search index?</H3>
+
+<P>Forcing a consistency check may be useful when you think the index is inconsistent. You need to add two parameters to the SearchIndex section in the workspace.xml configuration file:</P>
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE><param name="enableConsistencyCheck" value="true"/>
+<param name="forceConsistencyCheck" value="true"/>
+</PRE>
+</DIV></DIV>
+
+<P>Then restart Jackrabbit and watch the log file for possible repair messages. Don't forget to remove the parameters again when you are done.</P>
+
+<H3><A name="FrequentlyAskedQuestions-Whyisthesizeofmyqueryresult1%3F"></A>Why is the size of my query result -1?</H3>
+
+<P>A JCR implementation may return -1 when the size is unknown. Starting with 2.0 Jackrabbit will return -1 for some query statements when there is potential for a more optimized query execution. If you still want a size information you can append an order by clause to your statement. This will force Jackrabbit to calculate the result size.</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=75346">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/getting-started-with-apache-jackrabbit.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/getting-started-with-apache-jackrabbit.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/getting-started-with-apache-jackrabbit.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>Getting Started with Apache Jackrabbit</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="" 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>Getting Started with Apache Jackrabbit</H1>
+ <P>To get started with Jackrabbit you should first become familiar with the JCR API. Download the <A href="http://jcp.org/aboutJava/communityprocess/final/jsr170/index.html" class="external-link">JSR 170 specification</A>, browse the <A href="http://www.day.com/maven/jsr170/javadocs/jcr-1.0/" class="external-link">API documentation</A>, check our introduction to JCR levels, or read some of the JCR articles to understand the content repository model that Jackrabbit implements. You can also take a look at the various JCR and Jackrabbit applications to get an idea of what to do with a content repository.</P>
+
+<P> If you are interested in using Jackrabbit, you should check the Jackrabbit architecture and try out the First Hops examples we have prepared. You can either download a binary release or build Jackrabbit from sources.</P>
+
+<P> Take a look at the Frequently Asked Questions or browse the archives of the user and development mailing lists (see also the searchable archives at The Mail Archive, Gmane, and Nabble) for answers to questions not covered by the documentation pages. See the Mailing Lists page if you want to subscribe or unsubscribe the Jackrabbit mailing lists.</P>
+
+<P> Apache Jackrabbit is an open source project and welcomes all contributions. You can participate by answering questions on the mailing list, filing bug reports for any problems or improvement ideas you come up with, contributing to the Jackrabbit Wiki, or writing documentation and code. See the How the ASF works page for background information on the Apache Software Foundation and the way we work.</P>
+
+<H2><A name="GettingStartedwithApacheJackrabbit-ContentRepositoryforJavaTechnologyAPI%28JCR%29"></A>Content Repository for Java Technology API (JCR)</H2>
+
+<P> Jackrabbit is a complete implementation of the JCR API, so the primary API for Jackrabbit application developers is to be found in the JCR section of the Documentation.</P>
+
+<H2><A name="GettingStartedwithApacheJackrabbit-JackrabbitarchitectureandDeploymentModels"></A>Jackrabbit architecture and Deployment Models</H2>
+
+<P> Find out more about the Jackrabbit Architecture or learn more about the Jackrabbit deployment Options be it as an embedded content repository to be delivered with you are application, a shared repository for example in a J2EE environment or a classical content repository server setup.</P>
+
+<H2><A name="GettingStartedwithApacheJackrabbit-NodeTypes"></A>Node Types</H2>
+
+<P> To learn about the content modeling system used in Jackrabbit, read the section on node types.</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=70795">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/how-jackrabbit-works.data/jackrabbit-ism_small.jpg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/jackrabbit/trunk/content/JCR/how-jackrabbit-works.data/jackrabbit-ism_small.jpg
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/jackrabbit/trunk/content/JCR/how-jackrabbit-works.data/jackrabbit-ism_small.jpg.jpeg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/jackrabbit/trunk/content/JCR/how-jackrabbit-works.data/jackrabbit-ism_small.jpg.jpeg
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/jackrabbit/trunk/content/JCR/how-jackrabbit-works.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/how-jackrabbit-works.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/how-jackrabbit-works.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>How Jackrabbit works</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>How Jackrabbit works</H1>
+ <P>The diagram on the left explains which components of the Jackrabbit are used when a user of the JCR API modified content in the content repository. This is a simple and very common operation, that touches a large portion of the components in the Jackrabbit implementation. Please keep in mind that this implementation architecture is not mandated by JCR, but has been designed from scratch based on JCR.</P>
+
+<DIV class="" align="center"><SPAN class="image-wrap" style=""><IMG src="how-jackrabbit-works.data/jackrabbit-ism_small.jpg" style="border: 0px solid black"></SPAN></DIV>
+
+
+<P>The used components and their respective functions in the order of their appearance in the use case of writing or modifying content in the content repository:</P>
+
+<UL>
+ <LI><B>Transient Item State Manager</B> Once content items are read by a session they are cached in the Transient Item State Manager. When those items are modified the modification is only visible to that same session, in the so-called "transient" space.</LI>
+ <LI><B>Transactional Item State Manager</B> When the Application persists the modified items using the JCR Item.save() or Session.save() the transient Items are promoted into the Transactional ISM. The modifications are still only visible within the scope of this transaction, meaning that other sessions will not see the modification until they are committed. The commit is implicit if the Content Repository is not running in an XA environment.</LI>
+ <LI><B>Shared Item State Manager</B> Once a transaction is committed the Shared Item State Manager receives the changelog and publishes the changes to all the sessions logged into the same workspace. This means that all the Item States that are cached and referenced by other sessions are notified and possibly updated or invalidated. The Shared Item State Manager also triggers the observation and hands the changelog over to the persistence manager that is configured for this workspace.</LI>
+ <LI><B>Persistence Manager</B> The Persistence Manager persists all the Item States in the changelog passed by the Shared ISM. The persistence manager is a very simple, fast and transactional interface that is very low-level and does not need to understand the complexities of the repository operations, but basically just needs to be able persist and retrieve a given item based on its item id.</LI>
+ <LI><B>Observation</B> When a transaction is committed the Shared Item State Manager triggers the Observation mechanism. This allows applications to asynchronously subscribe changes in the workspace. Jackrabbit also non-standard offers a synchronous observation.</LI>
+ <LI><B>Query Manager / Index</B> Through a synchronous observation event the Query Manager is instructed to index the new or modified items. A content repository index is much more complex than a classical RDB index since it deals with content repository features like the item hierarchy, nodetype inheritance or fulltext searches.</LI>
+</UL>
+
+ </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=75334">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/how-to-map-associations-between-objects.data/Beans_and_collections.zip
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/jackrabbit/trunk/content/JCR/how-to-map-associations-between-objects.data/Beans_and_collections.zip
------------------------------------------------------------------------------
svn:mime-type = application/zip
Added: websites/staging/jackrabbit/trunk/content/JCR/how-to-map-associations-between-objects.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/how-to-map-associations-between-objects.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/how-to-map-associations-between-objects.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,226 @@
+
+<!--
+ 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>How to map associations between objects</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>How to map associations between objects</H1>
+ <H2><A name="Howtomapassociationsbetweenobjects-Overview"></A>Overview</H2>
+
+<P>This tutorial explains how to map associations between objects (1:1 and 1:n). You can find the tutorial code sample from <A href="how-to-map-associations-between-objects.data/Beans_and_collections.zip">here</A>. It is based on Maven and ready to be used inside Eclipse. If you have some configuration issues, please review the tutorial "<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>". </P>
+
+<H2><A name="Howtomapassociationsbetweenobjects-TheContentModel"></A>The Content Model </H2>
+
+<P>We will extend the content model created in the previous tutorial <A href="5-with-jackrabbit-ocm.html" title="5' with Jackrabbit OCM">5' with Jackrabbit OCM</A>. Each PressRelease is made by an Author and it is possible to add some references (URL). </P>
+
+<P>So, we have to add 2 new associations in our model : </P>
+<UL class="alternate" type="square">
+ <LI>An 1:1 association between a PressRelease and an Author.</LI>
+ <LI>An 1:n association between PresseRelease and Url.</LI>
+</UL>
+
+
+
+<P>Here is the main java class, the PressRelease : </P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+@Node
+<SPAN class="code-keyword">public</SPAN> class PressRelease
+{
+ @Field(path=<SPAN class="code-keyword">true</SPAN>) <SPAN class="code-keyword">private</SPAN> <SPAN class="code-object">String</SPAN> path;
+ @Field <SPAN class="code-keyword">private</SPAN> <SPAN class="code-object">String</SPAN> title;
+ @Field <SPAN class="code-keyword">private</SPAN> Date pubDate;
+ @Field <SPAN class="code-keyword">private</SPAN> <SPAN class="code-object">String</SPAN> content;
+ @Bean <SPAN class="code-keyword">private</SPAN> Author author;
+ @Collection List<Url> urls;
+
+ <SPAN class="code-comment">//<SPAN class="code-keyword">if</SPAN> you want a map instead of a list, use the following declaration
+</SPAN> @Collection Map<<SPAN class="code-object">String</SPAN>,Url> map;
+
+ [... Add here getters & setters ...]
+
+}
+</PRE>
+</DIV></DIV>
+
+<P>Since the tutorial <A href="5-with-jackrabbit-ocm.html" title="5' with Jackrabbit OCM">5' with Jackrabbit OCM</A>, we can understand the goal of the annotations @Node and @Field. <BR>
+An association 1:1 can be specified with the annotation @Bean like </P>
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+@Bean <SPAN class="code-keyword">private</SPAN> Author author;
+</PRE>
+</DIV></DIV>
+
+<P>It is possible to set extra settings with this annotation but it is out of the scope of this tutorial.You can review the code of the Author class which is very simple. As you will see, it is not mandatory to add annotation @Field(path=true) in the Author class because it is an aggregation of a PressRelease.</P>
+
+<P>An 1:n association can be specified with the annotation @Collection like </P>
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+@Collection List<Url> urls;
+</PRE>
+</DIV></DIV>
+
+<P>For this kind of association, you can also use a Map instead of a Collection</P>
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+@Collection Map<<SPAN class="code-object">String</SPAN>,Url> map;
+</PRE>
+</DIV></DIV>
+
+
+<P>Right now, the support of Map is limited to the usage of String for the key because the map key will be used as the Node name.</P>
+
+
+<H2><A name="Howtomapassociationsbetweenobjects-Howarethoseobjectsstoredintherepository%3F"></A>How are those objects stored in the repository ?</H2>
+
+
+<P>For this tutorial each java class is mapped into the "nt:unstructured" node type. Making this kind of mapping is quite flexible because it does not imply specific repository configuration. There is no constraints in the JCR repository. All constrains are defined in the java code. </P>
+
+<DIV class="panelMacro"><TABLE class="infoMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>Note : It is possible to associate a specific node type to each java class but this imply more repository configurations. <BR>
+ It is also possible to change the corresponding JCR node structure by using specific Bean or Collection converters. <BR>
+ Later, we will add more tutorials on OCM converters.</TD></TR></TABLE></DIV>
+
+<P>Following our example, the Author and Urls nodes will be created as subnodes of a press release. <BR>
+Here is an example of the correspoding JCR structure : </P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+- PressRelease_1
+ * path : <SPAN class="code-quote">"/mypath/myrelease"</SPAN>
+ * title : <SPAN class="code-quote">"..."</SPAN>
+ * pubDate : 10/06/08
+ * content : <SPAN class="code-quote">"...."</SPAN>
+ - Author
+ * firstName : <SPAN class="code-quote">"..."</SPAN>
+ * lastName : <SPAN class="code-quote">"..."</SPAN>
+ - urls
+ * url1
+ * url : <SPAN class="code-quote">"http:<SPAN class="code-comment">//...."</SPAN>
+</SPAN> * caption : <SPAN class="code-quote">"..."</SPAN>
+ * description : <SPAN class="code-quote">"..."</SPAN>
+ * url2
+ * url : <SPAN class="code-quote">"http:<SPAN class="code-comment">//...."</SPAN>
+</SPAN> * caption : <SPAN class="code-quote">"..."</SPAN>
+ * description : <SPAN class="code-quote">"..."</SPAN>
+ ...
+ - map
+ * Apache
+ * url : <SPAN class="code-quote">"http:<SPAN class="code-comment">//www.apache.org"</SPAN>
+</SPAN> * caption : <SPAN class="code-quote">"..."</SPAN>
+ * description : <SPAN class="code-quote">"..."</SPAN>
+
+ * Jackrabbit
+ * url : <SPAN class="code-quote">"http:<SPAN class="code-comment">//jackrabbit.apache.org"</SPAN>
+</SPAN> * caption : <SPAN class="code-quote">"..."</SPAN>
+ * description : <SPAN class="code-quote">"..."</SPAN>
+
+</PRE>
+</DIV></DIV>
+
+<H2><A name="Howtomapassociationsbetweenobjects-Downloadthetutorialcode"></A>Download the tutorial code</H2>
+
+<P>You can download the OCM project from <A href="how-to-map-associations-between-objects.data/Beans_and_collections.zip">here</A> </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=96517">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/index-readers.data/index-readers-per-query-handler.jpg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/jackrabbit/trunk/content/JCR/index-readers.data/index-readers-per-query-handler.jpg
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/jackrabbit/trunk/content/JCR/index-readers.data/index-readers-per-query-handler.jpg.jpeg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/jackrabbit/trunk/content/JCR/index-readers.data/index-readers-per-query-handler.jpg.jpeg
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/jackrabbit/trunk/content/JCR/index-readers.data/index-readers-per-segment.jpg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/jackrabbit/trunk/content/JCR/index-readers.data/index-readers-per-segment.jpg
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/jackrabbit/trunk/content/JCR/index-readers.data/index-readers-per-segment.jpg.jpeg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/jackrabbit/trunk/content/JCR/index-readers.data/index-readers-per-segment.jpg.jpeg
------------------------------------------------------------------------------
svn:mime-type = image/jpeg
Added: websites/staging/jackrabbit/trunk/content/JCR/index-readers.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/index-readers.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/index-readers.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,148 @@
+
+<!--
+ 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>Index readers</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>Index readers</H1>
+ <P>Jackrabbit uses Lucene as the underlying index implementation and provides several extensions and customizations that help improve performance in an environment where changes to the index are frequent. The extensions also cover features that are not supported by Lucene, like hierarchical queries.</P>
+
+<DIV class="" align="center"><SPAN class="image-wrap" style=""><IMG src="index-readers.data/index-readers-per-segment.jpg" style="border: 0px solid black"></SPAN></DIV>
+
+
+<H2><A name="Indexreaders-CachingIndexReader"></A>CachingIndexReader</H2>
+
+<P>The CachingIndexReader is at the very bottom of the index reader stack in Jackrabbit. It's main purpose is to cache the parent relationship of a node. Each node is represented with a document in the index and one of the fields is _:PARENT. The value of this field is the string representation of the parent nodes UUID. In case of the root node the the parent field contains an empty string as its value. Several queries in Jackrabbit are hierarchical and check whether a node is a descendant of another node. For the very simple case, where one needs to know if a node is the child of another node, we can just look up both nodes (lucene documents) in the index and compare the parent field on one node with the _:UUID field of the other. If they match the one is the child of the other node. When it comes to evaluating a descendant axis, this becomes much more expensive and will cause lots of document lookups in lucene. By caching the parent child relationship of documents, hierarc
hical operations can be executed much faster.</P>
+
+<P>The cache consists of an array of DocId instances. The length of this array corresponds to the number of documents accessible through the index reader. That is every document in the index has a corresponding cache entry in the array. Initially the cache is empty and is filled as it is accessed. There are two kinds of DocIds: PlainDocId and UUIDDocId. When the parent of a node resides in the same index segment a PlainDocId is created, which simply contains the document number of the parent. If the parent resides in a different index segment a UUIDDocId is created, which contains the UUID of the parent node. When a UUIDDocId is resolved it is passed an index reader, which allows it to get the document number for the UUID and cache it for later reuse.</P>
+
+<H2><A name="Indexreaders-OverwritingDocId"></A>Overwriting DocId</H2>
+
+<P>It may happen that a PlainDocId is present in the cache of a CachingIndexReader but must be considered invalid in the context of a call. CachingIndexReader.getParent() may be called from a ReadOnlyIndexReader instance which has the target of the PlainDocId in the set of deleted document. This indicates that the nodes has been deleted or modified. Thus it has traveled to another index segment. In this case the PlainDocId is overwritten with a UUIDDocId. The opposite never happens. A UUIDDocId is never overwritten with a PlainDocId because when a document is added to an index a new CachingIndexReader is created.</P>
+
+<H2><A name="Indexreaders-SharedIndexReader"></A>SharedIndexReader</H2>
+
+<P>The SharedIndexReader wraps a CachingIndexReader and adds a reference count facility. A SharedIndexReader is kept open for the entire lifetime of a PersistentIndex. Even if documents are marked deleted in the underlying index (by another thread through CommittableIndexReader), the SharedIndexReader will still be kept open and considers the documents as valid. The reference counting is needed because it may happen that a client of the SharedIndexReader is still in use while the underlying PersistentIndex is closed. This may happen when the index merger replaces indexes while a query still operates on the indexes to be deleted. Using reference counts, closing the SharedIndexReader is delayed until all clients are finished with the SharedIndexReader.</P>
+
+<H2><A name="Indexreaders-ReadOnlyIndexReader"></A>ReadOnlyIndexReader</H2>
+
+<P>The inconsistency introduced by the SharedIndexReader (considers deleted documents as still valid) is corrected by the ReadOnlyIndexReader. Whenever a new instance of this reader is created it copies the currently marked deleted documents from the CommittableIndexReader. At the same time all methods that attempt delete documents will throw a UnsupportedOperationException.</P>
+
+<H2><A name="Indexreaders-CommittableIndexReader"></A>CommittableIndexReader</H2>
+
+<P>This is the index reader where documents are marked deleted in a PersistentIndex. As with the SharedIndexReader the CommittableIndexReader is kept open for the entire lifetime of the PersistentIndex. To achieve this the CommittableIndexReader exposes a method commitDeleted, which forces the underlying native lucene index reader to commit changes. Only committing changes whithout closing the index reader is otherwise not possible using the plain lucene index reader.</P>
+
+<H2><A name="Indexreaders-Combiningtheindexsegments"></A>Combining the index segments</H2>
+
+<DIV class="" align="center"><SPAN class="image-wrap" style=""><IMG src="index-readers.data/index-readers-per-query-handler.jpg" style="border: 0px solid black"></SPAN></DIV>
+
+
+<H2><A name="Indexreaders-CachingMultiIndexReader"></A>CachingMultiIndexReader</H2>
+
+<P>The index for the content of a workspace consists of multiple segments, that is multiple ReadOnlyIndexReaders. They are combined in a MultiIndex using a CachingMultiIndexReader. In order to speed up lookups by UUID the CachingMultiIndexReader also has a DocNumberCache. This cache uses a LRU algorithm to keep a limitted amount of UUID to document number mappings.</P>
+
+<H2><A name="Indexreaders-CombinedIndexReader"></A>CombinedIndexReader</H2>
+
+<P>This index reader is similar to the CachingMultiIndexReader, in fact both implement MultiIndexReader and HierarchyResolver. A CombinedIndexReader is created when a query needs an index reader that spans both the workspace index as well as the jcr:system index, where the version store resides.</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=75338">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/issue-tracker.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/issue-tracker.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/issue-tracker.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,199 @@
+
+<!--
+ 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>Issue Tracker</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="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="" 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>Issue Tracker</H1>
+ <P>Apache Jackrabbit uses Jira for tracking bug reports and requests for improvements, new features, and other changes.</P>
+
+<P>The issue tracker is available at <A href="https://issues.apache.org/jira/browse/JCR" class="external-link">https://issues.apache.org/jira/browse/JCR</A> and is readable by everyone. A Jira account is needed to create new issues and to comment on existing issues. Use the <A href="https://issues.apache.org/jira/secure/Signup!default.jspa" class="external-link">registration form</A> to request an account if you do not already have one.</P>
+
+<H2><A name="IssueTracker-Issueworkflow"></A>Issue workflow</H2>
+
+<P>When an issue is created, it's in the <B>Open</B> state. This is the time for describing the issue and discussing possible ways of solving it. If a proposed patch is attached, then the issue can optionally be moved to the <B>Patch available</B> state to give it more visibility. If the patch is cancelled because more work is needed, the issue moves back to the <B>Open</B> state.</P>
+
+<P>Once the issue is solved, the committer who committed the changes marks the issue as <B>Resolved</B> with resolution type <EM>Fixed</EM>. Other resolution types like <EM>Duplicate</EM>, <EM>Invalid</EM> or <EM>Won't Fix</EM> are used when resolving issues that for one reason or another require no changes in the codebase. An issue can be <B>Reopened</B> if the committed fix is found to be not good enough.</P>
+
+<P>When an issue is resolved as fixed, the committer should set the "Fix Version(s)" field to the next trunk version to mark that the change will be included in that release. If the fix is also backported to one or more of the maintenance branches (for backporting, use "svn merge -c <EM>revision</EM> ^/jackrabbit/trunk" in the root of the branch) the version numbers of the relevant next maintenance releases should also be included in the "Fix Version(s)" field.</P>
+
+<P>Finally, once a release containing the change has been made, the release manager will mark the issue <B>Closed</B>, after which the issue can no longer be reopened (since the release can obviously no longer be changed). Potential regressions or other related problems should be tracked in separate followup issues.</P>
+
+<H2><A name="IssueTracker-Issuecontents"></A>Issue contents</H2>
+
+<P>See below for guidelines on how to use the various fields in an issue.</P>
+
+<H3><A name="IssueTracker-Issuetype"></A>Issue type</H3>
+
+<P>When creating a new issue, select the issue type based as follows:</P>
+
+<DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Issue type </TH>
+<TH class="confluenceTh"> Description </TH>
+</TR>
+<TR>
+<TD class="confluenceTd"> <B>Bug</B> </TD>
+<TD class="confluenceTd"> Bug reports are used for cases where Jackrabbit fails not function as it should (as defined by the JCR specification or some other documentation). If you are not certain whether the issue you've found is actually a bug, please ask the Jackrabbit <A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A> first for help. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <B>New Feature</B> </TD>
+<TD class="confluenceTd"> Use a feature request when Jackrabbit does not have some functionality you need. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <B>Improvement</B> </TD>
+<TD class="confluenceTd"> Use an improvement request to suggest improvements to existing features. Typical improvement requests are about updating documentation, increasing stability and performance, simplifying the implementation, or other such changes that make Jackrabbit better without introducing new features or fixing existing bugs. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <B>Test</B> </TD>
+<TD class="confluenceTd"> Use this type when contributing test cases for existing features. Normally test cases should be contributed as a part of the original feature request or as regression tests associated with bug reports, but sometimes you just want to extend test coverage by introducing new test cases. This issue type is for such cases. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <B>Task</B> </TD>
+<TD class="confluenceTd"> Used only for issues related to project infrastructure. </TD>
+</TR>
+</TBODY></TABLE>
+</DIV>
+
+
+<H3><A name="IssueTracker-Issuesummary%2Cenvironmentanddescription"></A>Issue summary, environment and description</H3>
+
+<P>The issue summary should be a short and clear statement that indicates the scope of the issue. You are probably being too verbose if you exceed the length of the text field. Use the Environment and Description fields to provide more detailed information.</P>
+
+<H3><A name="IssueTracker-Issuepriority"></A>Issue priority</H3>
+
+<P>Issue priority should be set according to the following:</P>
+
+<DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Issue priority </TH>
+<TH class="confluenceTh"> Description </TH>
+</TR>
+<TR>
+<TD class="confluenceTd"> <B>Blocker</B> </TD>
+<TD class="confluenceTd"> Legal or other fundamental issue that makes it impossible to release Jackrabbit code </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <B>Critical</B> </TD>
+<TD class="confluenceTd"> Major loss of functionality that affects many Jackrabbit users </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <B>Major</B> </TD>
+<TD class="confluenceTd"> Important issue that should be resolved soon </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <B>Minor</B> </TD>
+<TD class="confluenceTd"> Nice to have issues </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <B>Trivial</B> </TD>
+<TD class="confluenceTd"> Trivial changes that can be applied whenever someone has extra time </TD>
+</TR>
+</TBODY></TABLE>
+</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=77286">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/jackrabbit-api.html
==============================================================================
--- websites/staging/jackrabbit/trunk/content/JCR/jackrabbit-api.html (added)
+++ websites/staging/jackrabbit/trunk/content/JCR/jackrabbit-api.html Mon Dec 31 12:40:56 2012
@@ -0,0 +1,124 @@
+
+<!--
+ 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 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="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>Jackrabbit API</H1>
+ <P>This is the API component of the Apache Jackrabbit project. This component contains the interface extensions that Apache Jackrabbit supports in addition to the standard JCR API. You can use these interfaces to access Jackrabbit-specific functionality.</P>
+
+<H2><A name="JackrabbitAPI-APIdocumentation"></A>API documentation</H2>
+
+<UL>
+ <LI><A href="http://jackrabbit.apache.org/api/1.4/org/apache/jackrabbit/api/package-summary.html" class="external-link">jackrabbit-api 1.4</A></LI>
+</UL>
+
+
+<H2><A name="JackrabbitAPI-ExternalDependencies"></A>External Dependencies</H2>
+
+<UL>
+ <LI><A href="jcr.html" title="JCR">JCR</A></LI>
+</UL>
+
+ </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=71435">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/jackrabbit-architecture.data/overview.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/jackrabbit/trunk/content/JCR/jackrabbit-architecture.data/overview.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/jackrabbit/trunk/content/JCR/jackrabbit-architecture.data/overview.png.jpeg
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/jackrabbit/trunk/content/JCR/jackrabbit-architecture.data/overview.png.jpeg
------------------------------------------------------------------------------
svn:mime-type = image/jpeg