You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2018/01/04 13:49:53 UTC
[09/28] isis-site git commit: updates SNAPSHOT
http://git-wip-us.apache.org/repos/asf/isis-site/blob/8c263125/content/versions/SNAPSHOT/guides/ugodn/ugodn.html
----------------------------------------------------------------------
diff --git a/content/versions/SNAPSHOT/guides/ugodn/ugodn.html b/content/versions/SNAPSHOT/guides/ugodn/ugodn.html
index bbc3b22..cd9bf05 100644
--- a/content/versions/SNAPSHOT/guides/ugodn/ugodn.html
+++ b/content/versions/SNAPSHOT/guides/ugodn/ugodn.html
@@ -409,7 +409,7 @@ table.CodeRay td.code>pre{padding:0}
<td class="tableblock halign-left valign-top">
<div>
<div class="paragraph">
- <p>(<code>1.16.0-SNAPSHOT</code>) Enables bulk load of standalone collections.</p>
+ <p>Enables bulk load of standalone collections.</p>
</div>
<div class="paragraph">
<p>Further <a href="../ugodn/ugodn.html#_ugodn_configuring_bulk-load">discussion below</a>.</p>
@@ -455,7 +455,7 @@ table.CodeRay td.code>pre{padding:0}
<td class="tableblock halign-left valign-top">
<div>
<div class="paragraph">
- <p>(As of <code>1.16.0-SNAPSHOT</code>), this property is derived automatically derived from the set of modules provided in the <a href="../rgcms/rgcms.html#_rgcms_classes_super_AppManifest"><code>AppManifest</code></a>, and so does not need to be specified explicitly.</p>
+ <p>This property is derived automatically derived from the set of modules provided in the <a href="../rgcms/rgcms.html#_rgcms_classes_super_AppManifest"><code>AppManifest</code></a>, and so does not need to be specified explicitly.</p>
</div>
<div class="paragraph">
<p>It holds the set of packages to search so that DataNucleus builds its metamodel eagerly rather than lazily.</p>
@@ -466,7 +466,7 @@ table.CodeRay td.code>pre{padding:0}
<td class="tableblock halign-left valign-top">
<div>
<div class="paragraph">
- <p><code>isis.persistor.datanucleus.</code><br> <code>PublishingService.serializedForm</code></p>
+ <p><code>isis.persistor.</code><br> <code>datanucleus.</code><br> <code>PublishingService.</code><br> <code>serializedForm</code></p>
</div>
</div></td>
<td class="tableblock halign-left valign-top">
@@ -484,6 +484,43 @@ table.CodeRay td.code>pre{padding:0}
</tr>
</tbody>
</table>
+ <div class="paragraph">
+ <p>Also:</p>
+ </div>
+ <table class="tableblock frame-all grid-all spread">
+ <colgroup>
+ <col style="width: 33.3333%;">
+ <col style="width: 16.6666%;">
+ <col style="width: 50.0001%;">
+ </colgroup>
+ <thead>
+ <tr>
+ <th class="tableblock halign-left valign-top">Property</th>
+ <th class="tableblock halign-left valign-top">Value<br> (default value)</th>
+ <th class="tableblock halign-left valign-top">Description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td class="tableblock halign-left valign-top">
+ <div>
+ <div class="paragraph">
+ <p><code>isis.persistor.</code><br> <code>disable</code><br> <code>ConcurrencyChecking</code></p>
+ </div>
+ </div></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br> (<code>false</code>)</p></td>
+ <td class="tableblock halign-left valign-top">
+ <div>
+ <div class="paragraph">
+ <p>Disables concurrency checking globally. <br></p>
+ </div>
+ <div class="paragraph">
+ <p>Only intended for "emergency use" as a workaround while pending fix/patch to Apache Isis itself. (Note that there is no "datanucleus" in the property).</p>
+ </div>
+ </div></td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="sect3">
<h4 id="_configuration_properties_passed_through_directly_to_datanucleus">2.1.2. Configuration Properties passed through directly to DataNucleus.</h4>
@@ -539,7 +576,7 @@ table.CodeRay td.code>pre{padding:0}
</div>
</div>
<div class="sect2">
- <h3 id="_ugodn_configuring_bulk-load">2.2. Bulk Load of Standalone Collections (<code>1.16.0-SNAPSHOT</code>)</h3>
+ <h3 id="_ugodn_configuring_bulk-load">2.2. Bulk Load of Standalone Collections</h3>
<div class="btn-group" style="float: right; font-size: small; padding: 6px; margin-top: -55px; ">
<button type="button" class="btn btn-xs btn-default" onclick="window.location.href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/ugodn/_ugodn_configuring_bulk-load.adoc""><i class="fa fa-pencil-square-o"></i> Edit</button>
<button type="button" class="btn btn-xs btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"><span class="caret"></span><span class="sr-only">Toggle Dropdown</span></button>
@@ -902,7 +939,7 @@ isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionPassword=</code></pre
</ul>
</div>
<div class="paragraph">
- <p>Testing (as of <code>1.13.0</code>, against <code>dn-core 4.1.7</code>/<code>dn-rdbms 4.1.9</code>) has determined there are two main rules:</p>
+ <p>Testing (against <code>dn-core 4.1.7</code>/<code>dn-rdbms 4.1.9</code>) has determined there are two main rules:</p>
</div>
<div class="ulist">
<ul>
@@ -1428,7 +1465,7 @@ isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionPassword=</code></pre
<p>In the same way that Java packages act as a namespace for domain objects, it’s good practice to map domain entities to their own (database) schemas.</p>
</div>
<div class="paragraph">
- <p>As of <code>1.9.0</code>, all the (non-ASF) <a href="http://platform.incode.org" target="_blank">Incode Platform</a> modules do this. For example:</p>
+ <p>All the (non-ASF) <a href="http://platform.incode.org" target="_blank">Incode Platform</a> modules do this. For example:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -1485,23 +1522,10 @@ isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionPassword=</code></pre
<div class="sect2">
<h3 id="_listener_to_create_schema">4.1. Listener to create schema</h3>
<div class="paragraph">
- <p>JDO/DataNucleus does not automatically create these schema objects, but it <em>does</em> provide a listener callback API on the initialization of each class into the JDO metamodel.</p>
- </div>
- <div class="admonitionblock tip">
- <table>
- <tbody>
- <tr>
- <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td>
- <td class="content">
- <div class="paragraph">
- <p>Actually, the above statement isn’t quite true. In DN 3.2.x (as used by Apache Isis up to v1.8.0) there was no support for schemas. As of Apache Isis 1.9.0 and DN 4.0 there is now support. But we implemented this feature initially against DN 3.2.x, and it still works, so for now we’ve decided to leave it in.</p>
- </div> </td>
- </tr>
- </tbody>
- </table>
+ <p>Apache Isis automatically creates owning schema objects for the tables that correspond to each entity class in the JDO metamodel.</p>
</div>
<div class="paragraph">
- <p>Therefore Apache Isis attaches a listener, <code>CreateSchemaObjectFromClassMetadata</code>, that checks for the schema’s existence, and creates the schema if required.</p>
+ <p>This is done by installing a listener, <code>CreateSchemaObjectFromClassMetadata</code>, on a callback provided by JDO/DataNucleus. The listener is invoked on the initialization of each class. It checks for the schema’s existence, and creates the schema if required.</p>
</div>
<div class="paragraph">
<p>The guts of its implementation is:</p>
@@ -1658,7 +1682,7 @@ isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionPassword=</code></pre
<p>The second approach (using an <code>.orm</code> file) is therefore often more useful than the first, because the metadata provided overrides rather than replaces the annotations (and annotations not overridden continue to be honoured).</p>
</div>
<div class="paragraph">
- <p>A typical use case is to change the database schema for an entity. For example, as of <code>1.9.0</code> the various (non-ASF) <a href="http://platform.incode.org" target="_blank">Incode Platform</a> modules use schemas for each entity. For example, the <code>AuditEntry</code> entity in the (non-ASF) <a href="http://platform.incode.org" target="_blank">Incode Platform</a>'s audit module is annotated as:</p>
+ <p>A typical use case is to change the database schema for an entity. For example, the various (non-ASF) <a href="http://platform.incode.org" target="_blank">Incode Platform</a> modules use schemas for each entity. For example, the <code>AuditEntry</code> entity in the (non-ASF) <a href="http://platform.incode.org" target="_blank">Incode Platform</a>'s audit module is annotated as:</p>
</div>
<div class="listingblock">
<div class="content">