You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jackrabbit.apache.org by kw...@apache.org on 2022/07/05 14:37:33 UTC
svn commit: r1902493 [22/33] - in /jackrabbit/site/live/jcr: ./ components/ css/ fonts/ js/ ocm/ status/
Modified: jackrabbit/site/live/jcr/ocm/advanced-mapping-strategies.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/jcr/ocm/advanced-mapping-strategies.html?rev=1902493&r1=1902492&r2=1902493&view=diff
==============================================================================
--- jackrabbit/site/live/jcr/ocm/advanced-mapping-strategies.html (original)
+++ jackrabbit/site/live/jcr/ocm/advanced-mapping-strategies.html Tue Jul 5 14:37:31 2022
@@ -1,42 +1,40 @@
<!DOCTYPE html>
+
+
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/ocm/advanced-mapping-strategies.md at 2022-03-29
- | Rendered using Apache Maven Fluido Skin 1.9
+ | Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/markdown/ocm/advanced-mapping-strategies.md at 2022-07-05
+ | Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
- <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.11.1" />
<title>Apache Jackrabbit – Advanced Mapping Strategies</title>
- <link rel="stylesheet" href="../css/apache-maven-fluido-1.9.min.css" />
+ <link rel="stylesheet" href="../css/apache-maven-fluido-1.11.1.min.css" />
<link rel="stylesheet" href="../css/site.css" />
<link rel="stylesheet" href="../css/print.css" media="print" />
- <script src="../js/apache-maven-fluido-1.9.min.js"></script>
-<!-- Matomo -->
-<script>
- var _paq = window._paq = window._paq || [];
- /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
- /* We explicitly disable cookie tracking to avoid privacy issues */
- _paq.push(['disableCookies']);
- _paq.push(['trackPageView']);
- _paq.push(['enableLinkTracking']);
- (function() {
- var u="https://matomo.privacy.apache.org/";
- _paq.push(['setTrackerUrl', u+'matomo.php']);
- _paq.push(['setSiteId', '4']);
- var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
- g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
- })();
-</script>
-<!-- End Matomo Code -->
+ <script src="../js/apache-maven-fluido-1.11.1.min.js"></script>
+
+ <!-- Matomo -->
+ <script>
+ var _paq = window._paq = window._paq || [];
+ _paq.push(['disableCookies']);
+ _paq.push(['trackPageView']);
+ _paq.push(['enableLinkTracking']);
+
+ (function() {
+ var u="https://analytics.apache.org";
+ _paq.push(['setTrackerUrl', u+'/matomo.php']);
+ _paq.push(['setSiteId', '4']);
+ var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
+ g.async=true; g.src=u+'/matomo.js'; s.parentNode.insertBefore(g,s);
+ })();
+ </script>
+ <!-- End Matomo Code -->
</head>
<body class="topBarEnabled">
- <a href="https://github.com/apache/jackrabbit">
- <img style="position: absolute; top: 0; right: 0; border: 0; z-index: 10000;"
- src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"
- alt="Fork me on GitHub">
- </a>
+ <a class="github-fork-ribbon right-top" href="https://github.com/apache/jackrabbit" data-ribbon="Fork me on GitHub" title="Fork me on GitHub">Fork me on GitHub</a>
<header id="topbar" class="navbar navbar-fixed-top ">
<div class="navbar-inner">
<div class="container-fluid">
@@ -49,18 +47,18 @@
</a>
<ul class="nav">
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Jackrabbit <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Apache Jackrabbit <b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="../index.html" title="Welcome">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="FAQ">FAQ</a></li>
- <li><a href="http://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" title="Archived Jackrabbit Wiki">Archived Jackrabbit Wiki</a></li>
+ <li><a href="https://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" title="Archived Jackrabbit Wiki">Archived Jackrabbit Wiki</a></li>
<li><a href="../jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</a></li>
</ul>
</li>
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="../getting-started-with-apache-jackrabbit.html" title="Getting Started">Getting Started</a></li>
<li><a href="../standalone-server.html" title="Standalone Server">Standalone Server</a></li>
@@ -75,7 +73,7 @@
</ul>
</li>
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a>
<ul class="dropdown-menu">
<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>
@@ -87,15 +85,15 @@
<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="Attribution">Attribution</a></li>
- <li><a href="../privacy-policy.html" title="Privacy">Privacy</a></li>
</ul>
</li>
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Software Foundation <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Apache Software Foundation <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="http://www.apache.org/foundation/how-it-works.html" title="Introduction">Introduction</a></li>
- <li><a href="http://www.apache.org/foundation/sponsorship.html" title="Sponsorship">Sponsorship</a></li>
- <li><a href="http://www.apache.org/foundation/thanks.html" title="Current Sponsors">Current Sponsors</a></li>
+ <li><a href="https://www.apache.org/foundation/how-it-works.html" title="Introduction">Introduction</a></li>
+ <li><a href="https://www.apache.org/foundation/sponsorship.html" title="Sponsorship">Sponsorship</a></li>
+ <li><a href="https://www.apache.org/foundation/thanks.html" title="Current Sponsors">Current Sponsors</a></li>
+ <li><a href="https://privacy.apache.org/policies/privacy-policy-public.html" title="Privacy">Privacy</a></li>
</ul>
</li>
</ul>
@@ -105,7 +103,7 @@
<div class="container-fluid">
<header>
<div id="banner">
- <div class="pull-left"><div id="bannerLeft"><h2>Apache Jackrabbit Site</h2>
+ <div class="pull-left"><div id="bannerLeft"><h1>Apache Jackrabbit Site</h1>
</div>
</div>
<div class="pull-right"></div>
@@ -114,7 +112,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2022-03-29</li>
+ <li id="publishDate">Last Published: 2022-07-05</li>
</ul>
</div>
</header>
@@ -127,7 +125,7 @@
<li><a href="../downloads.html" title="Downloads"><span class="none"></span>Downloads</a></li>
<li><a href="../articles.html" title="Articles"><span class="none"></span>Articles</a></li>
<li><a href="../frequently-asked-questions.html" title="FAQ"><span class="none"></span>FAQ</a></li>
- <li><a href="http://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" class="externalLink" title="Archived Jackrabbit Wiki"><span class="none"></span>Archived Jackrabbit Wiki</a></li>
+ <li><a href="https://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" class="externalLink" title="Archived Jackrabbit Wiki"><span class="none"></span>Archived Jackrabbit Wiki</a></li>
<li><a href="../jackrabbit-history.html" title="Jackrabbit History"><span class="none"></span>Jackrabbit History</a></li>
<li class="nav-header">Documentation</li>
<li><a href="../getting-started-with-apache-jackrabbit.html" title="Getting Started"><span class="none"></span>Getting Started</a></li>
@@ -151,15 +149,14 @@
<li><a href="../website.html" title="Website"><span class="none"></span>Website</a></li>
<li><a href="../creating-releases.html" title="Creating Releases"><span class="none"></span>Creating Releases</a></li>
<li><a href="../supporting-software-attribution.html" title="Attribution"><span class="none"></span>Attribution</a></li>
- <li><a href="../privacy-policy.html" title="Privacy"><span class="none"></span>Privacy</a></li>
<li class="nav-header">Apache Software Foundation</li>
- <li><a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="Introduction"><span class="none"></span>Introduction</a></li>
- <li><a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"><span class="none"></span>Sponsorship</a></li>
- <li><a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Current Sponsors"><span class="none"></span>Current Sponsors</a></li>
+ <li><a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="Introduction"><span class="none"></span>Introduction</a></li>
+ <li><a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"><span class="none"></span>Sponsorship</a></li>
+ <li><a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Current Sponsors"><span class="none"></span>Current Sponsors</a></li>
+ <li><a href="https://privacy.apache.org/policies/privacy-policy-public.html" class="externalLink" title="Privacy"><span class="none"></span>Privacy</a></li>
</ul>
</nav>
<div class="well sidebar-nav">
- <hr />
<div id="poweredBy">
<div class="clear"></div>
<div class="clear"></div>
@@ -191,15 +188,22 @@
<h2><a name="Interface"></a>Interface</h2>
<p>TODO</p></section><section>
<h2><a name="Components"></a>Components</h2>
-<p>A component is an entity that cannot live by its own, but has a logical meaning. Take for example an Address. It may live alone, but doesn’t make much sense in some systems. Once associated with an User it starts making sense. Now, as in RDBMS you can choose the persist this as a record in a separate table with a 1-1 relation, or you may choose to persist Address field along with the User.</p>
-<p>Now, returning to JCR, the component is fitting perfectly the mixin notion. A mixin cannot live by its own in the repository. It is associated with some node. It’s properties are added to the set of original node.</p></section><section>
+<p>A component is an entity that cannot live by its own, but has a logical
+meaning. Take for example an Address. It may live alone, but doesn't make
+much sense in some systems. Once associated with an User it starts making
+sense. Now, as in RDBMS you can choose the persist this as a record in a
+separate table with a 1-1 relation, or you may choose to persist Address
+field along with the User.</p>
+<p>Now, returning to JCR, the component is fitting perfectly the mixin notion.
+A mixin cannot live by its own in the repository. It is associated with
+some node. It's properties are added to the set of original node.</p></section><section>
<h2><a name="Group_some_bean_attributes_into_a_subnode"></a>Group some bean attributes into a subnode</h2>
<p>TODO</p></section><section>
<h2><a name="Map_to_another_node_structure"></a>Map to another node structure</h2>
-<p>Sometime, it should be interesting to map to a different jcr node structure. Here is an example, for a class “File”, we can have:</p>
+<p>Sometime, it should be interesting to map to a different jcr node
+structure. Here is an example, for a class “File”, we can have:</p>
-<div class="source">
-<div class="source"><pre class="prettyprint linenums">public class File
+<div class="source"><pre class="prettyprint linenums"><code>public class File
{
private String mimeType;
private String encoding;
@@ -207,19 +211,16 @@
private Calendar lastModified;
// Add getters/setters
}
-</pre></div></div>
-
+</code></pre></div>
<p>and in terms of JCR structure, we can have:</p>
-<div class="source">
-<div class="source"><pre class="prettyprint linenums">nt:file
+<div class="source"><pre class="prettyprint linenums"><code>nt:file
jcr:content
jcr:mimeType
jcr:encoding
jcr:data
jcr:lastModified
-</pre></div></div>
-
+</code></pre></div>
<p>So, the jcr:content node is an extra node to specify in the mapping file.</p></section>
</main>
</div>
@@ -232,10 +233,12 @@
<a href="https://www.apache.org/">The Apache Software Foundation</a> | <a href="https://privacy.apache.org/policies/privacy-policy-public.html">Privacy Policy</a>
</p>
</div>
- <div id="ohloh" class="pull-right">
- <script src="https://www.ohloh.net/p/jackrabbit/widgets/project_users_logo.js"></script>
- </div>
- </div>
+ </div>
</footer>
+<script>
+ if(anchors) {
+ anchors.add();
+ }
+</script>
</body>
</html>
\ No newline at end of file
Modified: jackrabbit/site/live/jcr/ocm/basic-ocm-operations.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/jcr/ocm/basic-ocm-operations.html?rev=1902493&r1=1902492&r2=1902493&view=diff
==============================================================================
--- jackrabbit/site/live/jcr/ocm/basic-ocm-operations.html (original)
+++ jackrabbit/site/live/jcr/ocm/basic-ocm-operations.html Tue Jul 5 14:37:31 2022
@@ -1,42 +1,40 @@
<!DOCTYPE html>
+
+
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/ocm/basic-ocm-operations.md at 2022-03-29
- | Rendered using Apache Maven Fluido Skin 1.9
+ | Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/markdown/ocm/basic-ocm-operations.md at 2022-07-05
+ | Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
- <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.11.1" />
<title>Apache Jackrabbit – Basic OCM operations</title>
- <link rel="stylesheet" href="../css/apache-maven-fluido-1.9.min.css" />
+ <link rel="stylesheet" href="../css/apache-maven-fluido-1.11.1.min.css" />
<link rel="stylesheet" href="../css/site.css" />
<link rel="stylesheet" href="../css/print.css" media="print" />
- <script src="../js/apache-maven-fluido-1.9.min.js"></script>
-<!-- Matomo -->
-<script>
- var _paq = window._paq = window._paq || [];
- /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
- /* We explicitly disable cookie tracking to avoid privacy issues */
- _paq.push(['disableCookies']);
- _paq.push(['trackPageView']);
- _paq.push(['enableLinkTracking']);
- (function() {
- var u="https://matomo.privacy.apache.org/";
- _paq.push(['setTrackerUrl', u+'matomo.php']);
- _paq.push(['setSiteId', '4']);
- var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
- g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
- })();
-</script>
-<!-- End Matomo Code -->
+ <script src="../js/apache-maven-fluido-1.11.1.min.js"></script>
+
+ <!-- Matomo -->
+ <script>
+ var _paq = window._paq = window._paq || [];
+ _paq.push(['disableCookies']);
+ _paq.push(['trackPageView']);
+ _paq.push(['enableLinkTracking']);
+
+ (function() {
+ var u="https://analytics.apache.org";
+ _paq.push(['setTrackerUrl', u+'/matomo.php']);
+ _paq.push(['setSiteId', '4']);
+ var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
+ g.async=true; g.src=u+'/matomo.js'; s.parentNode.insertBefore(g,s);
+ })();
+ </script>
+ <!-- End Matomo Code -->
</head>
<body class="topBarEnabled">
- <a href="https://github.com/apache/jackrabbit">
- <img style="position: absolute; top: 0; right: 0; border: 0; z-index: 10000;"
- src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"
- alt="Fork me on GitHub">
- </a>
+ <a class="github-fork-ribbon right-top" href="https://github.com/apache/jackrabbit" data-ribbon="Fork me on GitHub" title="Fork me on GitHub">Fork me on GitHub</a>
<header id="topbar" class="navbar navbar-fixed-top ">
<div class="navbar-inner">
<div class="container-fluid">
@@ -49,18 +47,18 @@
</a>
<ul class="nav">
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Jackrabbit <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Apache Jackrabbit <b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="../index.html" title="Welcome">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="FAQ">FAQ</a></li>
- <li><a href="http://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" title="Archived Jackrabbit Wiki">Archived Jackrabbit Wiki</a></li>
+ <li><a href="https://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" title="Archived Jackrabbit Wiki">Archived Jackrabbit Wiki</a></li>
<li><a href="../jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</a></li>
</ul>
</li>
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="../getting-started-with-apache-jackrabbit.html" title="Getting Started">Getting Started</a></li>
<li><a href="../standalone-server.html" title="Standalone Server">Standalone Server</a></li>
@@ -75,7 +73,7 @@
</ul>
</li>
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a>
<ul class="dropdown-menu">
<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>
@@ -87,15 +85,15 @@
<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="Attribution">Attribution</a></li>
- <li><a href="../privacy-policy.html" title="Privacy">Privacy</a></li>
</ul>
</li>
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Software Foundation <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Apache Software Foundation <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="http://www.apache.org/foundation/how-it-works.html" title="Introduction">Introduction</a></li>
- <li><a href="http://www.apache.org/foundation/sponsorship.html" title="Sponsorship">Sponsorship</a></li>
- <li><a href="http://www.apache.org/foundation/thanks.html" title="Current Sponsors">Current Sponsors</a></li>
+ <li><a href="https://www.apache.org/foundation/how-it-works.html" title="Introduction">Introduction</a></li>
+ <li><a href="https://www.apache.org/foundation/sponsorship.html" title="Sponsorship">Sponsorship</a></li>
+ <li><a href="https://www.apache.org/foundation/thanks.html" title="Current Sponsors">Current Sponsors</a></li>
+ <li><a href="https://privacy.apache.org/policies/privacy-policy-public.html" title="Privacy">Privacy</a></li>
</ul>
</li>
</ul>
@@ -105,7 +103,7 @@
<div class="container-fluid">
<header>
<div id="banner">
- <div class="pull-left"><div id="bannerLeft"><h2>Apache Jackrabbit Site</h2>
+ <div class="pull-left"><div id="bannerLeft"><h1>Apache Jackrabbit Site</h1>
</div>
</div>
<div class="pull-right"></div>
@@ -114,7 +112,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2022-03-29</li>
+ <li id="publishDate">Last Published: 2022-07-05</li>
</ul>
</div>
</header>
@@ -127,7 +125,7 @@
<li><a href="../downloads.html" title="Downloads"><span class="none"></span>Downloads</a></li>
<li><a href="../articles.html" title="Articles"><span class="none"></span>Articles</a></li>
<li><a href="../frequently-asked-questions.html" title="FAQ"><span class="none"></span>FAQ</a></li>
- <li><a href="http://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" class="externalLink" title="Archived Jackrabbit Wiki"><span class="none"></span>Archived Jackrabbit Wiki</a></li>
+ <li><a href="https://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" class="externalLink" title="Archived Jackrabbit Wiki"><span class="none"></span>Archived Jackrabbit Wiki</a></li>
<li><a href="../jackrabbit-history.html" title="Jackrabbit History"><span class="none"></span>Jackrabbit History</a></li>
<li class="nav-header">Documentation</li>
<li><a href="../getting-started-with-apache-jackrabbit.html" title="Getting Started"><span class="none"></span>Getting Started</a></li>
@@ -151,15 +149,14 @@
<li><a href="../website.html" title="Website"><span class="none"></span>Website</a></li>
<li><a href="../creating-releases.html" title="Creating Releases"><span class="none"></span>Creating Releases</a></li>
<li><a href="../supporting-software-attribution.html" title="Attribution"><span class="none"></span>Attribution</a></li>
- <li><a href="../privacy-policy.html" title="Privacy"><span class="none"></span>Privacy</a></li>
<li class="nav-header">Apache Software Foundation</li>
- <li><a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="Introduction"><span class="none"></span>Introduction</a></li>
- <li><a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"><span class="none"></span>Sponsorship</a></li>
- <li><a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Current Sponsors"><span class="none"></span>Current Sponsors</a></li>
+ <li><a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="Introduction"><span class="none"></span>Introduction</a></li>
+ <li><a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"><span class="none"></span>Sponsorship</a></li>
+ <li><a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Current Sponsors"><span class="none"></span>Current Sponsors</a></li>
+ <li><a href="https://privacy.apache.org/policies/privacy-policy-public.html" class="externalLink" title="Privacy"><span class="none"></span>Privacy</a></li>
</ul>
</nav>
<div class="well sidebar-nav">
- <hr />
<div id="poweredBy">
<div class="clear"></div>
<div class="clear"></div>
@@ -187,35 +184,36 @@
-->
<section>
<h2><a name="Basic_OCM_operations"></a>Basic OCM operations</h2>
-<p>When you have created a new <a href="object-content-manager.html">Object Content Manager</a> in your application, you can use this component to insert, update, delete and retrieve objects. The class ‘Folder’ used in the following sections has to be annotated or defined in a xml file class descriptor.</p>
-<p>This page describes only the main <a href="object-content-manager.html">Object Content Manager</a> methods. You can see the javadoc to get more information on the API. You can also read the tutorial <a href="5-with-jackrabbit-ocm.html">5’ with Jackrabbit OCM</a> to get more information on how to initialize the <a href="ocm">Object Content Manager</a>.</p></section><section>
+<p>When you have created a new <a href="object-content-manager.html">Object Content Manager</a>
+in your application, you can use this component to insert, update, delete
+and retrieve objects. The class ‘Folder’ used in the following sections has
+to be annotated or defined in a xml file class descriptor.</p>
+<p>This page describes only the main <a href="object-content-manager.html">Object Content Manager</a>
+methods. You can see the javadoc to get more information on the API.
+You can also read the tutorial <a href="5-with-jackrabbit-ocm.html">5' with Jackrabbit OCM</a>
+to get more information on how to initialize the <a href="ocm">Object Content Manager</a>.</p></section><section>
<h2><a name="Insert"></a>Insert</h2>
-<div class="source">
-<div class="source"><pre class="prettyprint linenums">Folder folder = new Folder();
+<div class="source"><pre class="prettyprint linenums"><code>Folder folder = new Folder();
folder.setPath("/myfolder");
folder.set...(); // call the setter methods
ocm.insert(myFolder);
-</pre></div></div>
-</section><section>
+</code></pre></div></section><section>
<h2><a name="Retrieve_and_update_an_object"></a>Retrieve and update an object</h2>
-<div class="source">
-<div class="source"><pre class="prettyprint linenums">Folder folder = (Folder) persistenceManager.getObject(Folder.class, "/myfolder");
+<div class="source"><pre class="prettyprint linenums"><code>Folder folder = (Folder) persistenceManager.getObject(Folder.class, "/myfolder");
folder.set...(); // call the setter methods
ocm.update(myFolder);
-</pre></div></div>
-</section><section>
+</code></pre></div></section><section>
<h2><a name="Delete"></a>Delete</h2>
-<div class="source">
-<div class="source"><pre class="prettyprint linenums">ocm.remove("/test");
-</pre></div></div>
-</section><section>
+<div class="source"><pre class="prettyprint linenums"><code>ocm.remove("/test");
+</code></pre></div></section><section>
<h2><a name="Save_last_changes"></a>Save last changes</h2>
-<p>After some inserts, deletes and/or updates, you can call the method <code>ocm.save()</code> to apply your changes into the JCR repository.</p></section>
+<p>After some inserts, deletes and/or updates, you can call the method
+<code>ocm.save()</code> to apply your changes into the JCR repository.</p></section>
</main>
</div>
</div>
@@ -227,10 +225,12 @@ ocm.update(myFolder);
<a href="https://www.apache.org/">The Apache Software Foundation</a> | <a href="https://privacy.apache.org/policies/privacy-policy-public.html">Privacy Policy</a>
</p>
</div>
- <div id="ohloh" class="pull-right">
- <script src="https://www.ohloh.net/p/jackrabbit/widgets/project_users_logo.js"></script>
- </div>
- </div>
+ </div>
</footer>
+<script>
+ if(anchors) {
+ anchors.add();
+ }
+</script>
</body>
</html>
\ No newline at end of file
Modified: jackrabbit/site/live/jcr/ocm/how-to-map-associations-between-objects.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/jcr/ocm/how-to-map-associations-between-objects.html?rev=1902493&r1=1902492&r2=1902493&view=diff
==============================================================================
--- jackrabbit/site/live/jcr/ocm/how-to-map-associations-between-objects.html (original)
+++ jackrabbit/site/live/jcr/ocm/how-to-map-associations-between-objects.html Tue Jul 5 14:37:31 2022
@@ -1,42 +1,40 @@
<!DOCTYPE html>
+
+
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/ocm/how-to-map-associations-between-objects.md at 2022-03-29
- | Rendered using Apache Maven Fluido Skin 1.9
+ | Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/markdown/ocm/how-to-map-associations-between-objects.md at 2022-07-05
+ | Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
- <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.11.1" />
<title>Apache Jackrabbit – How to map associations between objects</title>
- <link rel="stylesheet" href="../css/apache-maven-fluido-1.9.min.css" />
+ <link rel="stylesheet" href="../css/apache-maven-fluido-1.11.1.min.css" />
<link rel="stylesheet" href="../css/site.css" />
<link rel="stylesheet" href="../css/print.css" media="print" />
- <script src="../js/apache-maven-fluido-1.9.min.js"></script>
-<!-- Matomo -->
-<script>
- var _paq = window._paq = window._paq || [];
- /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
- /* We explicitly disable cookie tracking to avoid privacy issues */
- _paq.push(['disableCookies']);
- _paq.push(['trackPageView']);
- _paq.push(['enableLinkTracking']);
- (function() {
- var u="https://matomo.privacy.apache.org/";
- _paq.push(['setTrackerUrl', u+'matomo.php']);
- _paq.push(['setSiteId', '4']);
- var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
- g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
- })();
-</script>
-<!-- End Matomo Code -->
+ <script src="../js/apache-maven-fluido-1.11.1.min.js"></script>
+
+ <!-- Matomo -->
+ <script>
+ var _paq = window._paq = window._paq || [];
+ _paq.push(['disableCookies']);
+ _paq.push(['trackPageView']);
+ _paq.push(['enableLinkTracking']);
+
+ (function() {
+ var u="https://analytics.apache.org";
+ _paq.push(['setTrackerUrl', u+'/matomo.php']);
+ _paq.push(['setSiteId', '4']);
+ var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
+ g.async=true; g.src=u+'/matomo.js'; s.parentNode.insertBefore(g,s);
+ })();
+ </script>
+ <!-- End Matomo Code -->
</head>
<body class="topBarEnabled">
- <a href="https://github.com/apache/jackrabbit">
- <img style="position: absolute; top: 0; right: 0; border: 0; z-index: 10000;"
- src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"
- alt="Fork me on GitHub">
- </a>
+ <a class="github-fork-ribbon right-top" href="https://github.com/apache/jackrabbit" data-ribbon="Fork me on GitHub" title="Fork me on GitHub">Fork me on GitHub</a>
<header id="topbar" class="navbar navbar-fixed-top ">
<div class="navbar-inner">
<div class="container-fluid">
@@ -49,18 +47,18 @@
</a>
<ul class="nav">
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Jackrabbit <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Apache Jackrabbit <b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="../index.html" title="Welcome">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="FAQ">FAQ</a></li>
- <li><a href="http://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" title="Archived Jackrabbit Wiki">Archived Jackrabbit Wiki</a></li>
+ <li><a href="https://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" title="Archived Jackrabbit Wiki">Archived Jackrabbit Wiki</a></li>
<li><a href="../jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</a></li>
</ul>
</li>
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="../getting-started-with-apache-jackrabbit.html" title="Getting Started">Getting Started</a></li>
<li><a href="../standalone-server.html" title="Standalone Server">Standalone Server</a></li>
@@ -75,7 +73,7 @@
</ul>
</li>
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a>
<ul class="dropdown-menu">
<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>
@@ -87,15 +85,15 @@
<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="Attribution">Attribution</a></li>
- <li><a href="../privacy-policy.html" title="Privacy">Privacy</a></li>
</ul>
</li>
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Software Foundation <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Apache Software Foundation <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="http://www.apache.org/foundation/how-it-works.html" title="Introduction">Introduction</a></li>
- <li><a href="http://www.apache.org/foundation/sponsorship.html" title="Sponsorship">Sponsorship</a></li>
- <li><a href="http://www.apache.org/foundation/thanks.html" title="Current Sponsors">Current Sponsors</a></li>
+ <li><a href="https://www.apache.org/foundation/how-it-works.html" title="Introduction">Introduction</a></li>
+ <li><a href="https://www.apache.org/foundation/sponsorship.html" title="Sponsorship">Sponsorship</a></li>
+ <li><a href="https://www.apache.org/foundation/thanks.html" title="Current Sponsors">Current Sponsors</a></li>
+ <li><a href="https://privacy.apache.org/policies/privacy-policy-public.html" title="Privacy">Privacy</a></li>
</ul>
</li>
</ul>
@@ -105,7 +103,7 @@
<div class="container-fluid">
<header>
<div id="banner">
- <div class="pull-left"><div id="bannerLeft"><h2>Apache Jackrabbit Site</h2>
+ <div class="pull-left"><div id="bannerLeft"><h1>Apache Jackrabbit Site</h1>
</div>
</div>
<div class="pull-right"></div>
@@ -114,7 +112,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2022-03-29</li>
+ <li id="publishDate">Last Published: 2022-07-05</li>
</ul>
</div>
</header>
@@ -127,7 +125,7 @@
<li><a href="../downloads.html" title="Downloads"><span class="none"></span>Downloads</a></li>
<li><a href="../articles.html" title="Articles"><span class="none"></span>Articles</a></li>
<li><a href="../frequently-asked-questions.html" title="FAQ"><span class="none"></span>FAQ</a></li>
- <li><a href="http://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" class="externalLink" title="Archived Jackrabbit Wiki"><span class="none"></span>Archived Jackrabbit Wiki</a></li>
+ <li><a href="https://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" class="externalLink" title="Archived Jackrabbit Wiki"><span class="none"></span>Archived Jackrabbit Wiki</a></li>
<li><a href="../jackrabbit-history.html" title="Jackrabbit History"><span class="none"></span>Jackrabbit History</a></li>
<li class="nav-header">Documentation</li>
<li><a href="../getting-started-with-apache-jackrabbit.html" title="Getting Started"><span class="none"></span>Getting Started</a></li>
@@ -151,15 +149,14 @@
<li><a href="../website.html" title="Website"><span class="none"></span>Website</a></li>
<li><a href="../creating-releases.html" title="Creating Releases"><span class="none"></span>Creating Releases</a></li>
<li><a href="../supporting-software-attribution.html" title="Attribution"><span class="none"></span>Attribution</a></li>
- <li><a href="../privacy-policy.html" title="Privacy"><span class="none"></span>Privacy</a></li>
<li class="nav-header">Apache Software Foundation</li>
- <li><a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="Introduction"><span class="none"></span>Introduction</a></li>
- <li><a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"><span class="none"></span>Sponsorship</a></li>
- <li><a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Current Sponsors"><span class="none"></span>Current Sponsors</a></li>
+ <li><a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="Introduction"><span class="none"></span>Introduction</a></li>
+ <li><a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"><span class="none"></span>Sponsorship</a></li>
+ <li><a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Current Sponsors"><span class="none"></span>Current Sponsors</a></li>
+ <li><a href="https://privacy.apache.org/policies/privacy-policy-public.html" class="externalLink" title="Privacy"><span class="none"></span>Privacy</a></li>
</ul>
</nav>
<div class="well sidebar-nav">
- <hr />
<div id="poweredBy">
<div class="clear"></div>
<div class="clear"></div>
@@ -187,9 +184,15 @@
-->
<h1>How to map associations between objects</h1><section>
<h2><a name="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="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 simple OCM project with Maven & Eclipse]”.</p></section><section>
+<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="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 simple OCM
+project with Maven & Eclipse]”.</p></section><section>
<h2><a name="The_Content_Model"></a>The Content Model</h2>
-<p>We will extend the content model created in the previous tutorial <a href="5-with-jackrabbit-ocm.html">5’ with Jackrabbit OCM</a>. Each PressRelease is made by an Author and it is possible to add some references (URL).</p>
+<p>We will extend the content model created in the previous tutorial <a href="5-with-jackrabbit-ocm.html">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>
@@ -198,8 +201,7 @@
</ul>
<p>Here is the main java class, the PressRelease :</p>
-<div class="source">
-<div class="source"><pre class="prettyprint linenums">@Node
+<div class="source"><pre class="prettyprint linenums"><code>@Node
public class PressRelease
{
@Field(path=true) private String path;
@@ -215,98 +217,75 @@ public class PressRelease
[... Add here getters & setters ...]
}
-</pre></div></div>
-
-<p>Since the tutorial <a href="5-with-jackrabbit-ocm.html">5’ with Jackrabbit OCM</a>, we can understand the goal of the annotations <code>@Node</code> and <code>@Field</code>. An association 1:1 can be specified with the annotation <code>@Bean</code> like</p>
-
-<div class="source">
-<div class="source"><pre class="prettyprint linenums">@Bean private 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 <code>@Field(path=true)</code> in the Author class because it is an aggregation of a PressRelease.</p>
+</code></pre></div>
+<p>Since the tutorial <a href="5-with-jackrabbit-ocm.html">5' with Jackrabbit OCM</a>,
+we can understand the goal of the annotations <code>@Node</code> and <code>@Field</code>.
+An association 1:1 can be specified with the annotation <code>@Bean</code> like</p>
+
+<div class="source"><pre class="prettyprint linenums"><code>@Bean private Author author;
+</code></pre></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 <code>@Field(path=true)</code> in the Author class because it is an
+aggregation of a PressRelease.</p>
<p>An 1:n association can be specified with the annotation <code>@Collection</code> like</p>
-<div class="source">
-<div class="source"><pre class="prettyprint linenums">@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="source">
-<div class="source"><pre class="prettyprint linenums">@Collection Map<String,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></section><section>
+<div class="source"><pre class="prettyprint linenums"><code>@Collection List<Url> urls;
+</code></pre></div>
+<p>For this kind of association, you can also use a Map instead of a
+Collection</p>
+
+<div class="source"><pre class="prettyprint linenums"><code>@Collection Map<String,Url> map;
+</code></pre></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></section><section>
<h2><a name="How_are_those_objects_stored_in_the_repository_.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>
+<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>
<blockquote>
-<p>Note : It is possible to associate a specific node type to each java class but this imply more repository configurations. It is also possible to change the corresponding JCR node structure by using specific Bean or Collection converters. Later, we will add more tutorials on OCM converters.</p>
+<p>Note : It is possible to associate a specific node type to each java class
+but this imply more repository configurations.
+It is also possible to change the corresponding JCR node structure
+by using specific Bean or Collection converters.
+Later, we will add more tutorials on OCM converters.</p>
</blockquote>
-<p>Following our example, the Author and Urls nodes will be created as subnodes of a press release. Here is an example of the correspoding JCR structure :</p>
-<ul>
-
-<li>PressRelease_1
-<ul>
-
-<li>path : “/mypath/myrelease”
-<ul>
-
-<li>title : “…”</li>
-<li>pubDate : 10/06/08</li>
-<li>content : “….”</li>
-<li>Author
-<ul>
-
-<li>firstName : “…”</li>
-<li>lastName : “…”</li>
-</ul>
-</li>
-<li>urls
-<ul>
-
-<li>url1
-<ul>
-
-<li>url : “<a class="externalLink" href="http://.">http://.</a>...”</li>
-<li>caption : “…”</li>
-<li>description : “…”</li>
-</ul>
-</li>
-<li>url2
-<ul>
-
-<li>url : “<a class="externalLink" href="http://.">http://.</a>...”</li>
-<li>caption : “…”</li>
-<li>description : “…” …</li>
-</ul>
-</li>
-</ul>
-</li>
-<li>map</li>
-<li>Apache
-<ul>
-
-<li>url : “<a class="externalLink" href="http://www.apache.org">http://www.apache.org</a>”</li>
-<li>caption : “…”</li>
-<li>description : “…”</li>
-</ul>
-</li>
-<li>
-
-<p>Jackrabbit</p>
-<ul>
-
-<li>url : “<a class="externalLink" href="http://jackrabbit.apache.org">http://jackrabbit.apache.org</a>”</li>
-<li>caption : “…”</li>
-<li>description : “…”</li>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
-</li>
-</ul></section><section>
+<p>Following our example, the Author and Urls nodes will be created as
+subnodes of a press release.
+Here is an example of the correspoding JCR structure :</p>
+
+<div class="source"><pre class="prettyprint linenums"><code>- PressRelease_1
+ * path : "/mypath/myrelease"
+ * title : "..."
+ * pubDate : 10/06/08
+ * content : "...."
+ - Author
+ * firstName : "..."
+ * lastName : "..."
+ - urls
+ * url1
+ * url : "http://...."
+ * caption : "..."
+ * description : "..."
+ * url2
+ * url : "http://...."
+ * caption : "..."
+ * description : "..."
+ ...
+ - map
+ * Apache
+ * url : "http://www.apache.org"
+ * caption : "..."
+ * description : "..."
+
+ * Jackrabbit
+ * url : "http://jackrabbit.apache.org"
+ * caption : "..."
+ * description : "..."
+</code></pre></div></section><section>
<h2><a name="Download_the_tutorial_code"></a>Download the tutorial code</h2>
<p>You can download the OCM project from <a href="Beans_and_collections.zip">here</a></p></section>
</main>
@@ -320,10 +299,12 @@ public class PressRelease
<a href="https://www.apache.org/">The Apache Software Foundation</a> | <a href="https://privacy.apache.org/policies/privacy-policy-public.html">Privacy Policy</a>
</p>
</div>
- <div id="ohloh" class="pull-right">
- <script src="https://www.ohloh.net/p/jackrabbit/widgets/project_users_logo.js"></script>
- </div>
- </div>
+ </div>
</footer>
+<script>
+ if(anchors) {
+ anchors.add();
+ }
+</script>
</body>
</html>
\ No newline at end of file
Modified: jackrabbit/site/live/jcr/ocm/mapping-atomic-fields.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/jcr/ocm/mapping-atomic-fields.html?rev=1902493&r1=1902492&r2=1902493&view=diff
==============================================================================
--- jackrabbit/site/live/jcr/ocm/mapping-atomic-fields.html (original)
+++ jackrabbit/site/live/jcr/ocm/mapping-atomic-fields.html Tue Jul 5 14:37:31 2022
@@ -1,42 +1,40 @@
<!DOCTYPE html>
+
+
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/ocm/mapping-atomic-fields.md at 2022-03-29
- | Rendered using Apache Maven Fluido Skin 1.9
+ | Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/markdown/ocm/mapping-atomic-fields.md at 2022-07-05
+ | Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
- <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.11.1" />
<title>Apache Jackrabbit – Mapping Atomic Fields</title>
- <link rel="stylesheet" href="../css/apache-maven-fluido-1.9.min.css" />
+ <link rel="stylesheet" href="../css/apache-maven-fluido-1.11.1.min.css" />
<link rel="stylesheet" href="../css/site.css" />
<link rel="stylesheet" href="../css/print.css" media="print" />
- <script src="../js/apache-maven-fluido-1.9.min.js"></script>
-<!-- Matomo -->
-<script>
- var _paq = window._paq = window._paq || [];
- /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
- /* We explicitly disable cookie tracking to avoid privacy issues */
- _paq.push(['disableCookies']);
- _paq.push(['trackPageView']);
- _paq.push(['enableLinkTracking']);
- (function() {
- var u="https://matomo.privacy.apache.org/";
- _paq.push(['setTrackerUrl', u+'matomo.php']);
- _paq.push(['setSiteId', '4']);
- var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
- g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
- })();
-</script>
-<!-- End Matomo Code -->
+ <script src="../js/apache-maven-fluido-1.11.1.min.js"></script>
+
+ <!-- Matomo -->
+ <script>
+ var _paq = window._paq = window._paq || [];
+ _paq.push(['disableCookies']);
+ _paq.push(['trackPageView']);
+ _paq.push(['enableLinkTracking']);
+
+ (function() {
+ var u="https://analytics.apache.org";
+ _paq.push(['setTrackerUrl', u+'/matomo.php']);
+ _paq.push(['setSiteId', '4']);
+ var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
+ g.async=true; g.src=u+'/matomo.js'; s.parentNode.insertBefore(g,s);
+ })();
+ </script>
+ <!-- End Matomo Code -->
</head>
<body class="topBarEnabled">
- <a href="https://github.com/apache/jackrabbit">
- <img style="position: absolute; top: 0; right: 0; border: 0; z-index: 10000;"
- src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"
- alt="Fork me on GitHub">
- </a>
+ <a class="github-fork-ribbon right-top" href="https://github.com/apache/jackrabbit" data-ribbon="Fork me on GitHub" title="Fork me on GitHub">Fork me on GitHub</a>
<header id="topbar" class="navbar navbar-fixed-top ">
<div class="navbar-inner">
<div class="container-fluid">
@@ -49,18 +47,18 @@
</a>
<ul class="nav">
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Jackrabbit <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Apache Jackrabbit <b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="../index.html" title="Welcome">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="FAQ">FAQ</a></li>
- <li><a href="http://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" title="Archived Jackrabbit Wiki">Archived Jackrabbit Wiki</a></li>
+ <li><a href="https://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" title="Archived Jackrabbit Wiki">Archived Jackrabbit Wiki</a></li>
<li><a href="../jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</a></li>
</ul>
</li>
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="../getting-started-with-apache-jackrabbit.html" title="Getting Started">Getting Started</a></li>
<li><a href="../standalone-server.html" title="Standalone Server">Standalone Server</a></li>
@@ -75,7 +73,7 @@
</ul>
</li>
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a>
<ul class="dropdown-menu">
<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>
@@ -87,15 +85,15 @@
<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="Attribution">Attribution</a></li>
- <li><a href="../privacy-policy.html" title="Privacy">Privacy</a></li>
</ul>
</li>
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Software Foundation <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Apache Software Foundation <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="http://www.apache.org/foundation/how-it-works.html" title="Introduction">Introduction</a></li>
- <li><a href="http://www.apache.org/foundation/sponsorship.html" title="Sponsorship">Sponsorship</a></li>
- <li><a href="http://www.apache.org/foundation/thanks.html" title="Current Sponsors">Current Sponsors</a></li>
+ <li><a href="https://www.apache.org/foundation/how-it-works.html" title="Introduction">Introduction</a></li>
+ <li><a href="https://www.apache.org/foundation/sponsorship.html" title="Sponsorship">Sponsorship</a></li>
+ <li><a href="https://www.apache.org/foundation/thanks.html" title="Current Sponsors">Current Sponsors</a></li>
+ <li><a href="https://privacy.apache.org/policies/privacy-policy-public.html" title="Privacy">Privacy</a></li>
</ul>
</li>
</ul>
@@ -105,7 +103,7 @@
<div class="container-fluid">
<header>
<div id="banner">
- <div class="pull-left"><div id="bannerLeft"><h2>Apache Jackrabbit Site</h2>
+ <div class="pull-left"><div id="bannerLeft"><h1>Apache Jackrabbit Site</h1>
</div>
</div>
<div class="pull-right"></div>
@@ -114,7 +112,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2022-03-29</li>
+ <li id="publishDate">Last Published: 2022-07-05</li>
</ul>
</div>
</header>
@@ -127,7 +125,7 @@
<li><a href="../downloads.html" title="Downloads"><span class="none"></span>Downloads</a></li>
<li><a href="../articles.html" title="Articles"><span class="none"></span>Articles</a></li>
<li><a href="../frequently-asked-questions.html" title="FAQ"><span class="none"></span>FAQ</a></li>
- <li><a href="http://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" class="externalLink" title="Archived Jackrabbit Wiki"><span class="none"></span>Archived Jackrabbit Wiki</a></li>
+ <li><a href="https://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" class="externalLink" title="Archived Jackrabbit Wiki"><span class="none"></span>Archived Jackrabbit Wiki</a></li>
<li><a href="../jackrabbit-history.html" title="Jackrabbit History"><span class="none"></span>Jackrabbit History</a></li>
<li class="nav-header">Documentation</li>
<li><a href="../getting-started-with-apache-jackrabbit.html" title="Getting Started"><span class="none"></span>Getting Started</a></li>
@@ -151,15 +149,14 @@
<li><a href="../website.html" title="Website"><span class="none"></span>Website</a></li>
<li><a href="../creating-releases.html" title="Creating Releases"><span class="none"></span>Creating Releases</a></li>
<li><a href="../supporting-software-attribution.html" title="Attribution"><span class="none"></span>Attribution</a></li>
- <li><a href="../privacy-policy.html" title="Privacy"><span class="none"></span>Privacy</a></li>
<li class="nav-header">Apache Software Foundation</li>
- <li><a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="Introduction"><span class="none"></span>Introduction</a></li>
- <li><a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"><span class="none"></span>Sponsorship</a></li>
- <li><a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Current Sponsors"><span class="none"></span>Current Sponsors</a></li>
+ <li><a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="Introduction"><span class="none"></span>Introduction</a></li>
+ <li><a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"><span class="none"></span>Sponsorship</a></li>
+ <li><a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Current Sponsors"><span class="none"></span>Current Sponsors</a></li>
+ <li><a href="https://privacy.apache.org/policies/privacy-policy-public.html" class="externalLink" title="Privacy"><span class="none"></span>Privacy</a></li>
</ul>
</nav>
<div class="well sidebar-nav">
- <hr />
<div id="poweredBy">
<div class="clear"></div>
<div class="clear"></div>
@@ -190,7 +187,9 @@
type into a JCR property. By default, the persistence manager uses<br />
the correct mapping in function of the attribute type (see below<br />
the section “Supported Types”).</p>
-<p>Based on our model defined here, the following field-descriptor maps the bean field “title” (String type) into the JCR property “my:title”.</p><section>
+<p>Based on our model defined here, the following field-descriptor
+maps the bean field “title” (String type) into the JCR property
+“my:title”.</p><section>
<h2><a name="Supported_Types"></a>Supported Types</h2>
<p>It is not necessary to specify the type in the field-descriptor.<br />
The Persistence Manager uses the java introspection to get<br />
@@ -203,59 +202,62 @@ information on each atomic field.</p>
<th> Jcr Type </th></tr>
<tr class="b">
-<td> String </td>
+<td align="left"> String </td>
<td> STRING </td></tr>
<tr class="a">
-<td> Boolean, boolean </td>
+<td align="left"> Boolean, boolean </td>
<td> BOOLEAN </td></tr>
<tr class="b">
-<td> Double, double </td>
+<td align="left"> Double, double </td>
<td> DOUBLE </td></tr>
<tr class="a">
-<td> Integer, int </td>
+<td align="left"> Integer, int </td>
<td> DOUBLE </td></tr>
<tr class="b">
-<td> Long, long </td>
+<td align="left"> Long, long </td>
<td> LONG </td></tr>
<tr class="a">
-<td> byte\[\](\.html)
+<td align="left"> byte\[\](\.html)
</td>
<td> BINARY </td></tr>
<tr class="b">
-<td> java.io.InputStream </td>
+<td align="left"> java.io.InputStream </td>
<td> BINARY </td></tr>
<tr class="a">
-<td> java.util.Calendar </td>
+<td align="left"> java.util.Calendar </td>
<td> LONG (corresponding to Calendar.getTimeInMillis() </td></tr>
<tr class="b">
-<td> java.sql.Timestamp </td>
+<td align="left"> java.sql.Timestamp </td>
<td> LONG (corresponding to Timestamp.getTime() </td></tr>
<tr class="a">
-<td> java.util.Date </td>
+<td align="left"> java.util.Date </td>
<td> LONG (corresponding to java.util.Date.getTime() </td></tr>
</table>
<p>Due to some issues with Jackrabbit (mainly with xpath queries),<br />
-Calendar, Timestamp and date are converted into JCR LONG. We plan to add other converters for those types in the next release.</p></section><section>
+Calendar, Timestamp and date are converted into JCR LONG. We plan
+to add other converters for those types in the next release.</p></section><section>
<h2><a name="Using_Another_Atomic_Type_Converter"></a>Using Another Atomic Type Converter</h2>
<p>The OCM framework gives you the freedom to choose another kind of<br />
-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<br />
+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<br />
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,<br />
+<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,<br />
you have to make the following steps:</p><section>
<h3><a name="Specify_the_converter_class_in_the_field_descriptor"></a>Specify the converter class in the field descriptor</h3>
-<div class="source">
-<div class="source"><pre class="prettyprint linenums"><class-descriptor
+<div class="source"><pre class="prettyprint linenums"><code><class-descriptor
className="org.apache.jackrabbit.ocm.testmodel.Atomic"
jcrType="nt:unstructured">
<field-descriptor
@@ -264,13 +266,11 @@ you have to make the following steps:</p
converter="org.apache.jackrabbit.ocm.persistence.atomic.Int2BooleanTypeConverterImpl"
/>
</class-descriptor>
-</pre></div></div>
-</section><section>
+</code></pre></div></section><section>
<h3><a name="Implement_the_converter_class"></a>Implement the converter class</h3>
<p>Use the interface org.apache.jackrabbit.ocm.persistence.atomic.AtomicTypeConverter</p>
-<div class="source">
-<div class="source"><pre class="prettyprint linenums">package org.apache.jackrabbit.ocm.persistence.atomic;
+<div class="source"><pre class="prettyprint linenums"><code>package org.apache.jackrabbit.ocm.persistence.atomic;
import javax.jcr.Value;
import javax.jcr.ValueFactory;
@@ -341,7 +341,7 @@ public class Int2BooleanTypeConverterImp
}
}
-</pre></div></div></section></section>
+</code></pre></div></section></section>
</main>
</div>
</div>
@@ -353,10 +353,12 @@ public class Int2BooleanTypeConverterImp
<a href="https://www.apache.org/">The Apache Software Foundation</a> | <a href="https://privacy.apache.org/policies/privacy-policy-public.html">Privacy Policy</a>
</p>
</div>
- <div id="ohloh" class="pull-right">
- <script src="https://www.ohloh.net/p/jackrabbit/widgets/project_users_logo.js"></script>
- </div>
- </div>
+ </div>
</footer>
+<script>
+ if(anchors) {
+ anchors.add();
+ }
+</script>
</body>
</html>
\ No newline at end of file
Modified: jackrabbit/site/live/jcr/ocm/mapping-bean-fields.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/jcr/ocm/mapping-bean-fields.html?rev=1902493&r1=1902492&r2=1902493&view=diff
==============================================================================
--- jackrabbit/site/live/jcr/ocm/mapping-bean-fields.html (original)
+++ jackrabbit/site/live/jcr/ocm/mapping-bean-fields.html Tue Jul 5 14:37:31 2022
@@ -1,42 +1,40 @@
<!DOCTYPE html>
+
+
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/ocm/mapping-bean-fields.md at 2022-03-29
- | Rendered using Apache Maven Fluido Skin 1.9
+ | Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/markdown/ocm/mapping-bean-fields.md at 2022-07-05
+ | Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
- <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.11.1" />
<title>Apache Jackrabbit – Mapping Bean Fields</title>
- <link rel="stylesheet" href="../css/apache-maven-fluido-1.9.min.css" />
+ <link rel="stylesheet" href="../css/apache-maven-fluido-1.11.1.min.css" />
<link rel="stylesheet" href="../css/site.css" />
<link rel="stylesheet" href="../css/print.css" media="print" />
- <script src="../js/apache-maven-fluido-1.9.min.js"></script>
-<!-- Matomo -->
-<script>
- var _paq = window._paq = window._paq || [];
- /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
- /* We explicitly disable cookie tracking to avoid privacy issues */
- _paq.push(['disableCookies']);
- _paq.push(['trackPageView']);
- _paq.push(['enableLinkTracking']);
- (function() {
- var u="https://matomo.privacy.apache.org/";
- _paq.push(['setTrackerUrl', u+'matomo.php']);
- _paq.push(['setSiteId', '4']);
- var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
- g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
- })();
-</script>
-<!-- End Matomo Code -->
+ <script src="../js/apache-maven-fluido-1.11.1.min.js"></script>
+
+ <!-- Matomo -->
+ <script>
+ var _paq = window._paq = window._paq || [];
+ _paq.push(['disableCookies']);
+ _paq.push(['trackPageView']);
+ _paq.push(['enableLinkTracking']);
+
+ (function() {
+ var u="https://analytics.apache.org";
+ _paq.push(['setTrackerUrl', u+'/matomo.php']);
+ _paq.push(['setSiteId', '4']);
+ var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
+ g.async=true; g.src=u+'/matomo.js'; s.parentNode.insertBefore(g,s);
+ })();
+ </script>
+ <!-- End Matomo Code -->
</head>
<body class="topBarEnabled">
- <a href="https://github.com/apache/jackrabbit">
- <img style="position: absolute; top: 0; right: 0; border: 0; z-index: 10000;"
- src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"
- alt="Fork me on GitHub">
- </a>
+ <a class="github-fork-ribbon right-top" href="https://github.com/apache/jackrabbit" data-ribbon="Fork me on GitHub" title="Fork me on GitHub">Fork me on GitHub</a>
<header id="topbar" class="navbar navbar-fixed-top ">
<div class="navbar-inner">
<div class="container-fluid">
@@ -49,18 +47,18 @@
</a>
<ul class="nav">
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Jackrabbit <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Apache Jackrabbit <b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="../index.html" title="Welcome">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="FAQ">FAQ</a></li>
- <li><a href="http://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" title="Archived Jackrabbit Wiki">Archived Jackrabbit Wiki</a></li>
+ <li><a href="https://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" title="Archived Jackrabbit Wiki">Archived Jackrabbit Wiki</a></li>
<li><a href="../jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</a></li>
</ul>
</li>
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="../getting-started-with-apache-jackrabbit.html" title="Getting Started">Getting Started</a></li>
<li><a href="../standalone-server.html" title="Standalone Server">Standalone Server</a></li>
@@ -75,7 +73,7 @@
</ul>
</li>
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a>
<ul class="dropdown-menu">
<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>
@@ -87,15 +85,15 @@
<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="Attribution">Attribution</a></li>
- <li><a href="../privacy-policy.html" title="Privacy">Privacy</a></li>
</ul>
</li>
<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Software Foundation <b class="caret"></b></a>
+ <a class="dropdown-toggle" data-toggle="dropdown">Apache Software Foundation <b class="caret"></b></a>
<ul class="dropdown-menu">
- <li><a href="http://www.apache.org/foundation/how-it-works.html" title="Introduction">Introduction</a></li>
- <li><a href="http://www.apache.org/foundation/sponsorship.html" title="Sponsorship">Sponsorship</a></li>
- <li><a href="http://www.apache.org/foundation/thanks.html" title="Current Sponsors">Current Sponsors</a></li>
+ <li><a href="https://www.apache.org/foundation/how-it-works.html" title="Introduction">Introduction</a></li>
+ <li><a href="https://www.apache.org/foundation/sponsorship.html" title="Sponsorship">Sponsorship</a></li>
+ <li><a href="https://www.apache.org/foundation/thanks.html" title="Current Sponsors">Current Sponsors</a></li>
+ <li><a href="https://privacy.apache.org/policies/privacy-policy-public.html" title="Privacy">Privacy</a></li>
</ul>
</li>
</ul>
@@ -105,7 +103,7 @@
<div class="container-fluid">
<header>
<div id="banner">
- <div class="pull-left"><div id="bannerLeft"><h2>Apache Jackrabbit Site</h2>
+ <div class="pull-left"><div id="bannerLeft"><h1>Apache Jackrabbit Site</h1>
</div>
</div>
<div class="pull-right"></div>
@@ -114,7 +112,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2022-03-29</li>
+ <li id="publishDate">Last Published: 2022-07-05</li>
</ul>
</div>
</header>
@@ -127,7 +125,7 @@
<li><a href="../downloads.html" title="Downloads"><span class="none"></span>Downloads</a></li>
<li><a href="../articles.html" title="Articles"><span class="none"></span>Articles</a></li>
<li><a href="../frequently-asked-questions.html" title="FAQ"><span class="none"></span>FAQ</a></li>
- <li><a href="http://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" class="externalLink" title="Archived Jackrabbit Wiki"><span class="none"></span>Archived Jackrabbit Wiki</a></li>
+ <li><a href="https://jackrabbit.apache.org/archive/wiki/JCR/Home_70731.html" class="externalLink" title="Archived Jackrabbit Wiki"><span class="none"></span>Archived Jackrabbit Wiki</a></li>
<li><a href="../jackrabbit-history.html" title="Jackrabbit History"><span class="none"></span>Jackrabbit History</a></li>
<li class="nav-header">Documentation</li>
<li><a href="../getting-started-with-apache-jackrabbit.html" title="Getting Started"><span class="none"></span>Getting Started</a></li>
@@ -151,15 +149,14 @@
<li><a href="../website.html" title="Website"><span class="none"></span>Website</a></li>
<li><a href="../creating-releases.html" title="Creating Releases"><span class="none"></span>Creating Releases</a></li>
<li><a href="../supporting-software-attribution.html" title="Attribution"><span class="none"></span>Attribution</a></li>
- <li><a href="../privacy-policy.html" title="Privacy"><span class="none"></span>Privacy</a></li>
<li class="nav-header">Apache Software Foundation</li>
- <li><a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="Introduction"><span class="none"></span>Introduction</a></li>
- <li><a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"><span class="none"></span>Sponsorship</a></li>
- <li><a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Current Sponsors"><span class="none"></span>Current Sponsors</a></li>
+ <li><a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="Introduction"><span class="none"></span>Introduction</a></li>
+ <li><a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"><span class="none"></span>Sponsorship</a></li>
+ <li><a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Current Sponsors"><span class="none"></span>Current Sponsors</a></li>
+ <li><a href="https://privacy.apache.org/policies/privacy-policy-public.html" class="externalLink" title="Privacy"><span class="none"></span>Privacy</a></li>
</ul>
</nav>
<div class="well sidebar-nav">
- <hr />
<div id="poweredBy">
<div class="clear"></div>
<div class="clear"></div>
@@ -186,27 +183,35 @@
limitations under the License.
-->
<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 “pageInfo” (PageInfo class) into the JCR node called “pageInfo”.</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<br />
+<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 “pageInfo” (PageInfo class) into
+the JCR node called “pageInfo”.</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<br />
introspection to get information on the each bean fields.</p><section>
<h2><a name="The_JCR_Structure"></a>The JCR Structure</h2>
<p>Following our example, the resulting JCR structure is:</p>
-<div class="source">
-<div class="source"><pre class="prettyprint linenums">/mysite/page1
+<div class="source"><pre class="prettyprint linenums"><code>/mysite/page1
/mysite/page1/pageInfo
my:title = "This is my page title"
my:description = "This is my page description"
... other subnodes for page1 ...
-</pre></div></div>
-
+</code></pre></div>
<p>By default, the persistence manager will create a subnode<br />
(/mysite/page1/pageInfo) for the bean-descriptor pageInfo.</p></section><section>
<h2><a name="Using_Another_Bean_Converter"></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<br />
+<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<br />
section below).</p>
-<p>This can be done by writing your own bean converter class and reference this class in the bean-descriptor.</p><section>
+<p>This can be done by writing your own bean converter class and
+reference this class in the bean-descriptor.</p><section>
<h3><a name="Predefined_Bean_Converters"></a>Predefined Bean Converters</h3>
<p>Here is the list of existing custom bean converters:</p>
@@ -217,7 +222,7 @@ section below).</p>
<th> Description </th></tr>
<tr class="b">
-<td>
+<td align="left">
org.apache.jackrabbit.ocm.persistence.beanconverter.impl.ParentBeanConverterImpl
</td>
<td> Map a bean field to the parent node. it is used to access to the
@@ -225,7 +230,7 @@ org.apache.jackrabbit.ocm.persistence.be
a Folder object. </td></tr>
<tr class="a">
-<td>
+<td align="left">
org.apache.jackrabbit.ocm.persistence.beanconverter.impl.InlineBeanConverterImpl
</td>
<td> Bean converter used to map some node properties into one nested
@@ -240,8 +245,7 @@ its parent folder (parentFolder attribut
object has an attribute (parentFolder) that contains a reference<br />
to the parent node.</p>
-<div class="source">
-<div class="source"><pre class="prettyprint linenums"><class-descriptor
+<div class="source"><pre class="prettyprint linenums"><code><class-descriptor
className="org.apache.jackrabbit.ocm.testmodel.inheritance.impl.CmsObjectImpl"
jcrType="my:cmsobjectimpl" >
<field-descriptor fieldName="path" path="true" />
@@ -251,14 +255,12 @@ to the parent node.</p>
converter="org.apache.jackrabbit.ocm.persistence.beanconverter.impl.ParentBeanConverterImpl"
/>
</class-descriptor>
-</pre></div></div>
-</section><section>
+</code></pre></div></section><section>
<h3><a name="Building_your_own_Bean_Converters"></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="source">
-<div class="source"><pre class="prettyprint linenums"><class-descriptor
+<div class="source"><pre class="prettyprint linenums"><code><class-descriptor
className="org.apache.jackrabbit.ocm.testmodel.inheritance.impl.CmsObjectImpl"
jcrType="my:cmsobjectimpl" >
<bean-descriptor
@@ -266,15 +268,14 @@ to the parent node.</p>
converter="org.apache.jackrabbit.ocm.persistence.beanconverter.impl.ParentBeanConverterImpl"
/>
</class-descriptor>
-</pre></div></div>
-
+</code></pre></div>
<p>Then, implement the converter class (based on the interface<br />
org.apache.jackrabbit.ocm.persistence.beanconverter.BeanConverter).</p>
<p>Your bean converter class can also extends the class<br />
-AbstractBeanConverterImpl to have a default implementation for some methods.</p>
+AbstractBeanConverterImpl to have a default implementation for
+some methods.</p>
-<div class="source">
-<div class="source"><pre class="prettyprint linenums">import javax.jcr.Node;
+<div class="source"><pre class="prettyprint linenums"><code>import javax.jcr.Node;
import javax.jcr.Session;
import org.apache.commons.logging.Log;
@@ -330,7 +331,7 @@ public class ParentBeanConverterImpl ext
}
}
-</pre></div></div></section></section>
+</code></pre></div></section></section>
</main>
</div>
</div>
@@ -342,10 +343,12 @@ public class ParentBeanConverterImpl ext
<a href="https://www.apache.org/">The Apache Software Foundation</a> | <a href="https://privacy.apache.org/policies/privacy-policy-public.html">Privacy Policy</a>
</p>
</div>
- <div id="ohloh" class="pull-right">
- <script src="https://www.ohloh.net/p/jackrabbit/widgets/project_users_logo.js"></script>
- </div>
- </div>
+ </div>
</footer>
+<script>
+ if(anchors) {
+ anchors.add();
+ }
+</script>
</body>
</html>
\ No newline at end of file