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 2017/08/14 20:34:17 UTC
[08/24] isis-site git commit: ISIS-1521: updates for 1.15.0 release
(bump up from -SNAPSHOT)
http://git-wip-us.apache.org/repos/asf/isis-site/blob/83a95eb0/content/guides/rgfis/rgfis.html
----------------------------------------------------------------------
diff --git a/content/guides/rgfis/rgfis.html b/content/guides/rgfis/rgfis.html
index 0dc98d9..22e7250 100644
--- a/content/guides/rgfis/rgfis.html
+++ b/content/guides/rgfis/rgfis.html
@@ -200,7 +200,9 @@ table.CodeRay td.code>pre{padding:0}
<li><a href="../../release-notes/release-notes.html">Release Notes</a></li>
<li><a href="../../migration-notes/migration-notes.html">Migration Notes</a></li>
<li role="separator" class="divider"></li>
- <li><a href="../../guides/ugfun/ugfun.html#_ugfun_getting-started_simpleapp-archetype">Maven archetype</a></li>
+ <li class="dropdown-header">Maven archetypes</li>
+ <li><a href="../../guides/ugfun/ugfun.html#_ugfun_getting-started_helloworld-archetype">helloworld</a></li>
+ <li><a href="../../guides/ugfun/ugfun.html#_ugfun_getting-started_simpleapp-archetype">simpleapp</a></li>
<li role="separator" class="divider"></li>
<li><a href="https://issues.apache.org/jira/browse/ISIS">ASF JIRA</a></li>
<li><a href="https://github.com/apache/isis">Github mirror</a></li>
@@ -848,17 +850,6 @@ table.CodeRay td.code>pre{padding:0}
<div></div></td>
</tr>
<tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgfis/rgfis.html#_rgfis_application-layer_MessageBrokerServiceInternal"><code>o.a.i.c.m.s.msgbroker</code><br> <code>MessageBrokerServiceInternal</code></a></p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">A wrapper around <a href="../rgsvc/rgsvc.html#_rgsvc_application-layer-api_MessageService"><code>MessageService</code></a>.</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">MessageBrokerService-`<br> <code>InternalDefault</code><br> <code>isis-core-runtime</code></p></td>
- <td class="tableblock halign-left valign-top">
- <div>
- <div class="paragraph">
- <p>Removed in <code>1.15.0-SNAPSHOT; this service does not provide any additional capabilities over `MessageService</code>.</p>
- </div>
- </div></td>
- </tr>
- <tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgfis/rgfis.html#_rgfis_application-layer_InteractionDtoServiceInternal"><code>o.a.i.c.m.s.ixn</code><br> <code>InteractionDtoServiceInternal</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Creates DTO for the current execution of an action invocation or property edit, for use either as a reified command or for implementations of the <a href="../rgsvc/rgsvc.html#_rgsvc_persistence-layer-spi_PublishingService"><code>PublishingService</code></a>.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>CommandDtoService-</code><br> <code>InternalServiceDefault</code><br> <code>isis-core-metamodel</code></p></td>
@@ -1002,66 +993,7 @@ table.CodeRay td.code>pre{padding:0}
</div>
</div>
<div class="sect2">
- <h3 id="_rgfis_application-layer_MessageBrokerServiceInternal">3.3. <code>MessageBrokerServiceInternal</code> (removed in <code>1.15.0-SNAPSHOT</code>)</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/rgfis/_rgfis_application-layer_MessageBrokerServiceInternal.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>
- <ul class="dropdown-menu">
- <li><a href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_application-layer_MessageBrokerServiceInternal.adoc" target="_blank"><i class="fa fa-pencil-square-o fa-fw" aria-hidden="true"></i> Edit</a></li>
- <li><a href="https://github.com/apache/isis/commits/master/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_application-layer_MessageBrokerServiceInternal.adoc" target="_blank"><i class="fa fa-clock-o fa-fw" aria-hidden="true"></i> History</a></li>
- <li><a href="https://github.com/apache/isis/raw/master/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_application-layer_MessageBrokerServiceInternal.adoc" target="_blank"><i class="fa fa-file-text-o fa-fw" aria-hidden="true"></i> Raw</a></li>
- <li><a href="https://github.com/apache/isis/blame/master/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_application-layer_MessageBrokerServiceInternal.adoc" target="_blank"><i class="fa fa-hand-o-right fa-fw" aria-hidden="true"></i> Blame</a></li>
- </ul>
- </div>
- <div class="paragraph">
- <p>The (internal) <code>MessageBrokerServiceInternal</code> domain service is a wrapper around <a href="../rgsvc/rgsvc.html#_rgsvc_application-layer-api_MessageService"><code>MessageService</code></a>.</p>
- </div>
- <div class="admonitionblock note">
- <table>
- <tbody>
- <tr>
- <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
- <td class="content">
- <div class="paragraph">
- <p>As of <code>1.15.0-SNAPSHOT</code> this service has been removed; it does does not provide any additional capabilities over and those of <code>MessageService</code>.</p>
- </div> </td>
- </tr>
- </tbody>
- </table>
- </div>
- <div class="sect3">
- <h4 id="_spi_3">3.3.1. SPI</h4>
- <div class="paragraph">
- <p>The SPI of the service is:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">interface</span> <span class="class">MessageBrokerServiceInternal</span> {
- <span class="type">void</span> informUser(<span class="predefined-type">String</span> message);
- <span class="type">void</span> warnUser(<span class="predefined-type">String</span> message);
- <span class="type">void</span> raiseError(<span class="predefined-type">String</span> message);
-}</code></pre>
- </div>
- </div>
- </div>
- <div class="sect3">
- <h4 id="_runtime_vs_noop_implementation">3.3.2. Runtime vs Noop implementation</h4>
- <div class="paragraph">
- <p>The framework provides two implementations:</p>
- </div>
- <div class="ulist">
- <ul>
- <li> <p><code>MessageBrokerServiceInternalDefault</code> is provided by <code>isis-core-runtime</code>, and is used during normal use and integration tests</p> </li>
- <li> <p><code>MessageBrokerServiceInternalNoop</code> is provided as a fallback by <code>isis-core-metamodel</code>, and is provided to allow the <a href="../rgmvn/rgmvn.html">maven plugin</a> to be bootstrapped without any "backend" database.</p> </li>
- </ul>
- </div>
- <div class="paragraph">
- <p>The <code>…Default</code> implementation takes priority over the <code>…Noop</code> implementation.</p>
- </div>
- </div>
- </div>
- <div class="sect2">
- <h3 id="_rgfis_application-layer_InteractionDtoServiceInternal">3.4. <code>InteractionDtoServiceInternal</code></h3>
+ <h3 id="_rgfis_application-layer_InteractionDtoServiceInternal">3.3. <code>InteractionDtoServiceInternal</code></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/rgfis/_rgfis_application-layer_InteractionDtoServiceInternal.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>
@@ -1076,7 +1008,7 @@ table.CodeRay td.code>pre{padding:0}
<p>The <code>InteractionDtoServiceInternal</code> internal domain service is used by the framework to create and update DTOs representing member executions, ie the invocation of an action or the editing of a property. The DTO is in all cases a subclass of <code>MemberExecutionDto</code>, from the <a href="../rgcms/rgcms.html#_rgcms_schema-ixn">"ixn" schema</a>, and subsequently accessible from the <code>Interaction</code> object (per the <a href="../rgsvc/rgsvc.html#_rgsvc_application-layer-api_InteractionContext"><code>InteractionContext</code></a> service).</p>
</div>
<div class="sect3">
- <h4 id="_spi_implementation_2">3.4.1. SPI & Implementation</h4>
+ <h4 id="_spi_implementation_2">3.3.1. SPI & Implementation</h4>
<div class="paragraph">
<p>The SPI of the service is:</p>
</div>
@@ -1121,7 +1053,7 @@ table.CodeRay td.code>pre{padding:0}
</div>
</div>
<div class="sect3">
- <h4 id="_related_services_4">3.4.2. Related Services</h4>
+ <h4 id="_related_services_4">3.3.2. Related Services</h4>
<div class="paragraph">
<p>The design of this service is similar to that of <a href="../rgfis/rgfis.html#_rgfis_application-layer_CommandDtoServiceInternal"><code>CommandDtoServiceInternal</code></a>, used to create the <code>CommandDto</code> (from the <a href="../rgcms/rgcms.html#_rgcms_schema-cmd">"cmd" schema</a>).</p>
</div>
@@ -1195,13 +1127,6 @@ table.CodeRay td.code>pre{padding:0}
<td class="tableblock halign-left valign-top">
<div></div></td>
</tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgfis/rgfis.html#_rgfis_persistence-layer_TransactionStateProviderInternal"><code>o.a.i.c.m.s.</code><br> <code>transtate.</code><br> <code>TransactionStateProviderInternal</code></a></p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Simply provides the ability to check as to the state of the current transaction.</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock"><code>TransactionStateProvider-</code><br> <code>InternalDefault</code><br> <code>isis-core-runtime</code></p></td>
- <td class="tableblock halign-left valign-top">
- <div></div></td>
- </tr>
</tbody>
</table>
<div class="paragraph">
@@ -1405,7 +1330,7 @@ table.CodeRay td.code>pre{padding:0}
</table>
</div>
<div class="sect3">
- <h4 id="_spi_4">4.3.1. SPI</h4>
+ <h4 id="_spi_3">4.3.1. SPI</h4>
<div class="paragraph">
<p>The SPI of the service is a hierarchy of types. First is <code>AdapterManagerBase</code>:</p>
</div>
@@ -1506,7 +1431,7 @@ table.CodeRay td.code>pre{padding:0}
</div>
</div>
<div class="sect3">
- <h4 id="_runtime_vs_noop_implementation_2">4.3.2. Runtime vs Noop implementation</h4>
+ <h4 id="_runtime_vs_noop_implementation">4.3.2. Runtime vs Noop implementation</h4>
<div class="paragraph">
<p>The framework provides two implementations:</p>
</div>
@@ -1605,63 +1530,6 @@ table.CodeRay td.code>pre{padding:0}
</div>
</div>
</div>
- <div class="sect2">
- <h3 id="_rgfis_persistence-layer_TransactionStateProviderInternal">4.5. <code>TransactionStateProviderInternal</code> (removed in <code>1.15.0-SNAPSHOT</code>)</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/rgfis/_rgfis_persistence-layer_TransactionStateProviderInternal.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>
- <ul class="dropdown-menu">
- <li><a href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_persistence-layer_TransactionStateProviderInternal.adoc" target="_blank"><i class="fa fa-pencil-square-o fa-fw" aria-hidden="true"></i> Edit</a></li>
- <li><a href="https://github.com/apache/isis/commits/master/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_persistence-layer_TransactionStateProviderInternal.adoc" target="_blank"><i class="fa fa-clock-o fa-fw" aria-hidden="true"></i> History</a></li>
- <li><a href="https://github.com/apache/isis/raw/master/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_persistence-layer_TransactionStateProviderInternal.adoc" target="_blank"><i class="fa fa-file-text-o fa-fw" aria-hidden="true"></i> Raw</a></li>
- <li><a href="https://github.com/apache/isis/blame/master/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_persistence-layer_TransactionStateProviderInternal.adoc" target="_blank"><i class="fa fa-hand-o-right fa-fw" aria-hidden="true"></i> Blame</a></li>
- </ul>
- </div>
- <div class="paragraph">
- <p>The (internal) <code>TransactionStateProviderInternal</code> domain service simply provides the ability to check as to the state of the current transaction.</p>
- </div>
- <div class="admonitionblock note">
- <table>
- <tbody>
- <tr>
- <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
- <td class="content">
- <div class="paragraph">
- <p>This service has been removed in <code>1.15.0-SNAPSHOT</code>, having been combined with <a href="../rgsvc/rgsvc.html#_rgsvc_application-layer-api_TransactionService"><code>TransactionService</code></a>.</p>
- </div> </td>
- </tr>
- </tbody>
- </table>
- </div>
- <div class="sect3">
- <h4 id="_spi_and_implementation_5">4.5.1. SPI and Implementation</h4>
- <div class="paragraph">
- <p>The SPI of the service is simply:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">interface</span> <span class="class">TransactionStateProviderInternal</span> {
- TransactionState getTransactionState();
-}</code></pre>
- </div>
- </div>
- </div>
- <div class="sect3">
- <h4 id="_runtime_vs_noop_implementation_3">4.5.2. Runtime vs Noop implementation</h4>
- <div class="paragraph">
- <p>The framework provides two implementations:</p>
- </div>
- <div class="ulist">
- <ul>
- <li> <p><code>TransactionStateProviderInternalDefault</code> is provided by <code>isis-core-runtime</code>, and is used during normal use and integration tests</p> </li>
- <li> <p><code>TransactionStateProviderInternalNoop</code> is provided as a fallback by <code>isis-core-metamodel</code>, and is provided to allow the <a href="../rgmvn/rgmvn.html">maven plugin</a> to be bootstrapped without any "backend" database.</p> </li>
- </ul>
- </div>
- <div class="paragraph">
- <p>The <code>…Default</code> implementation takes priority over the <code>…Noop</code> implementation.</p>
- </div>
- </div>
- </div>
</div>
</div>
</div>