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/01 16:00:53 UTC
[13/46] isis-site git commit: updating content (built from
adocs/documentation in isis.git repo)
http://git-wip-us.apache.org/repos/asf/isis-site/blob/db31837d/content/guides/rgsvc/rgsvc.html
----------------------------------------------------------------------
diff --git a/content/guides/rgsvc/rgsvc.html b/content/guides/rgsvc/rgsvc.html
index 441cc68..3f1c568 100644
--- a/content/guides/rgsvc/rgsvc.html
+++ b/content/guides/rgsvc/rgsvc.html
@@ -791,7 +791,7 @@ table.CodeRay td.code>pre{padding:0}
</ul>
</div>
<div class="paragraph">
- <p>The <code>ContentMappingService</code> supports the (default implementation of the) <a href="../rgfis/rgfis.html#_rgfis_presentation-layer_ContentNegotiationService"><code>ContentNegotiationService</code></a> allowing the <a href="../ugvro/ugvro.html">RestfulObjects viewer</a> to allow domain objects to be transformed into some other format as specified by the HTTP <code>Accept</code> header.</p>
+ <p>The <code>ContentMappingService</code> supports the (default implementation of the) <a href="../rgfis/rgfis.html#_rgfis_presentation-layer_ContentNegotiationService"><code>ContentNegotiationService</code></a> enabling the <a href="../ugvro/ugvro.html">RestfulObjects viewer</a> to represent domain objects in some other format as specified by the HTTP <code>Accept</code> header.</p>
</div>
<div class="paragraph">
<p>See <a href="../rgfis/rgfis.html#_rgfis_presentation-layer_ContentNegotiationService"><code>ContentNegotiationService</code></a> for further discussion.</p>
@@ -1031,7 +1031,7 @@ table.CodeRay td.code>pre{padding:0}
</ul>
</div>
<div class="paragraph">
- <p>The <code>ErrorReportingService</code> service is an optional SPI that providies the ability to record any errors/exceptions that might occur in the application into an external incident recording system (such as JIRA). The service also allows a user-friendly (jargon-free) error message to be returned and rendered to the end-user, along with an optional incident reference (eg a JIRA issue <code>XXX-1234</code>).</p>
+ <p>The <code>ErrorReportingService</code> service is an optional SPI that provides the ability to record any errors/exceptions that might occur in the application into an external incident recording system (such as JIRA). The service also allows a user-friendly (jargon-free) error message to be returned and rendered to the end-user, along with an optional incident reference (eg a JIRA issue <code>XXX-1234</code>).</p>
</div>
<div class="sect3">
<h4 id="_spi_3">3.3.1. SPI</h4>
@@ -4182,7 +4182,7 @@ org.quartz.plugin.jobInitializer.failOnFileNotFound = true</code></pre>
</ul>
</div>
<div class="paragraph">
- <p>The <code>WrapperFactory</code> provides the ability to enforce business rules for programmatic interactions between domain objects. If there is a (lack-of-) trust boundary between the caller and callee — eg if they reside in different modules — then the wrapper factory is a useful mechanism to ensure that any business constraints defined by te callee are honoured.</p>
+ <p>The <code>WrapperFactory</code> provides the ability to enforce business rules for programmatic interactions between domain objects. If there is a (lack-of-) trust boundary between the caller and callee — eg if they reside in different modules — then the wrapper factory is a useful mechanism to ensure that any business constraints defined by the callee are honoured.</p>
</div>
<div class="paragraph">
<p>For example, if the calling object attempts to modify an unmodifiable property on the target object, then an exception will be thrown. Said another way: interactions are performed "as if" they are through the viewer.</p>
@@ -8405,7 +8405,7 @@ Element customerXsd = snapshot.getXsdElement();</code></pre>
</ul>
</div>
<div class="paragraph">
- <p>The <code>ServiceRegistry2</code> service collects together methods for accessing other domain services.</p>
+ <p>The <code>ServiceRegistry2</code> service collects together methods for injecting or looking up domain services (either provided by the framework or application-specific) currently known to the runtime.</p>
</div>
<div class="admonitionblock note">
<table>
@@ -8522,7 +8522,7 @@ repositoryService.persist(cust);</code></pre>
<td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
<td class="content">
<div class="paragraph">
- <p>Not all of the REST API exposed by the <a href="../ugvro/ugvro.html">Restful Objects viewer</a> is included in the Swagger spec files; the emphasis is those REST resources that are used to develop custom apps: domain objects, domain object collections and action invocations. When combined with Apache Isis' own <a href="../ugvro/ugvro.html#_ugvro_simplified-representations">simplified representations</a>, these are pretty much all that is needed for this use case.</p>
+ <p>Not all of the REST API exposed by the <a href="../ugvro/ugvro.html">Restful Objects viewer</a> is included in the Swagger schema definition files; the emphasis is those REST resources that are used to develop custom apps: domain objects, domain object collections and action invocations. When combined with Apache Isis' own <a href="../ugvro/ugvro.html#_ugvro_simplified-representations">simplified representations</a>, these are pretty much all that is needed for this use case.</p>
</div> </td>
</tr>
</tbody>
@@ -11293,7 +11293,7 @@ log4j.additivity.org.apache.isis.applib.services.publish.PublisherServiceLogging
</ul>
</div>
<div class="sect2">
- <h3 id="_rgsvc_bootstrapping-spi_ClassDiscoveryService">12.1. <code>ClassDiscoveryService</code></h3>
+ <h3 id="_rgsvc_bootstrapping-spi_ClassDiscoveryService">12.1. <code>ClassDiscoveryService2</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/rgsvc/_rgsvc_bootstrapping-spi_ClassDiscoveryService.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>
@@ -11305,7 +11305,7 @@ log4j.additivity.org.apache.isis.applib.services.publish.PublisherServiceLogging
</ul>
</div>
<div class="paragraph">
- <p>The <code>ClassDiscovery</code> service is used to automatically discover subclasses of any given type on the classpath. The primary use case is to support "convention-over-configuration" designs that work with a minimum of configuration.</p>
+ <p>The <code>ClassDiscoveryService2</code> service is used to automatically discover subclasses of any given type on the classpath. The primary use case is to support "convention-over-configuration" designs that work with a minimum of configuration.</p>
</div>
<div class="paragraph">
<p>This service is used by the <a href="../rgcms/rgcms.html#_rgcms_classes_super_FixtureScripts"><code>FixtureScripts</code></a> service to automatically locate any <a href="../rgcms/rgcms.html#_rgcms_classes_super_FixtureScript"><code>FixtureScript</code></a> implementations.</p>
@@ -11349,7 +11349,7 @@ log4j.additivity.org.apache.isis.applib.services.publish.PublisherServiceLogging
<td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
<td class="content">
<div class="paragraph">
- <p>This implementation is also used to discover domain services annotated with <a href="../rgant/rgant.html#_rgant-DomainService"><code>@DomainService</code></a>. Currently this logic uses the implementation directly, so is not pluggable. However, the entire <code>ServicesInstaller</code></p>
+ <p>This implementation is also used to discover domain services annotated with <a href="../rgant/rgant.html#_rgant-DomainService"><code>@DomainService</code></a>. Currently this logic uses the implementation directly, so is not pluggable.</p>
</div> </td>
</tr>
</tbody>