http://git-wip-us.apache.org/repos/asf/isis-site/blob/2f475bbf/content/versions/2.0.0-M1/guides/rgfis/rgfis.html ---------------------------------------------------------------------- diff --git a/content/versions/2.0.0-M1/guides/rgfis/rgfis.html b/content/versions/2.0.0-M1/guides/rgfis/rgfis.html new file mode 100644 index 0000000..79c4991 --- /dev/null +++ b/content/versions/2.0.0-M1/guides/rgfis/rgfis.html @@ -0,0 +1,1548 @@ +<!doctype html> +<html> + <head> + <!-- + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + --> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> + <meta charset="utf-8"> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + <!-- No caching headers --> + <meta http-equiv="cache-control" content="no-cache"> + <meta http-equiv="pragma" content="no-cache"> + <meta http-equiv="expires" content="-1"> + <title>Framework Internal Services</title> + <link rel="icon" type="image/png" href="../../images/isis-favicon.png"> + <!-- + Based on DataNucleus' template, + that was in turn based on an earlier version of Apache Isis' template, + that was in turn based on Apache Deltaspike's template. + + This template uses + * Bootstrap v3.3.7 (https://getbootstrap.com/) for navbar. + * Bootstrap TOC plugin v0.4.1 (https://afeld.github.io/bootstrap-toc/) + for the table of contents. + * jQuery (necessary for Bootstrap's JavaScript plugins) + * Font-Awesome for some icons used by Asciidoctor + + Also: + * Bootswatch "flatly" theme for Bootstrap (https://bootswatch.com/flatly). + * slick.js (carousel) + * add a link to all headers (home-grown, adapted from blog posts) + * integration of elasticlunr.js (home-grown, adapted from blog posts) + --> + <link href="https://cdnjs.cloudflare.com/ajax/libs/bootswatch/3.3.7/flatly/bootstrap.min.css"; rel="stylesheet"> + <link href="../../css/bootstrap-toc/0.4.1/bootstrap-toc.min.css" rel="stylesheet"> + <link href="../../css/asciidoctor/foundation.css" rel="stylesheet"> + <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.3.0/css/font-awesome.min.css"; rel="stylesheet"> + <link href="../../css/slick/1.5.0/slick.css" rel="stylesheet"> + <link href="../../css/slick/1.5.0/slick-theme.css" rel="stylesheet"> + <link href="../../css/search-panel/search-panel.css" rel="stylesheet"> + <link href="../../css/header-links/header-links.css" rel="stylesheet"> + <link href="../../css/sticky-header/sticky-header.css" rel="stylesheet"> + <link href="../../css/customisations.css" rel="stylesheet"> + <!-- Coderay syntax formatter --> + <style type="text/css"> + /* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */ +/*pre.CodeRay {background-color:#f7f7f8;}*/ +.CodeRay .line-numbers{border-right:1px solid #d8d8d8;padding:0 0.5em 0 .25em} +.CodeRay span.line-numbers{display:inline-block;margin-right:.5em;color:rgba(0,0,0,.3)} +.CodeRay .line-numbers strong{color:rgba(0,0,0,.4)} +table.CodeRay{border-collapse:separate;border-spacing:0;margin-bottom:0;border:0;background:none} +table.CodeRay td{vertical-align: top;line-height:1.45} +table.CodeRay td.line-numbers{text-align:right} +table.CodeRay td.line-numbers>pre{padding:0;color:rgba(0,0,0,.3)} +table.CodeRay td.code{padding:0 0 0 .5em} +table.CodeRay td.code>pre{padding:0} +.CodeRay .debug{color:#fff !important;background:#000080 !important} +.CodeRay .annotation{color:#007} +.CodeRay .attribute-name{color:#000080} +.CodeRay .attribute-value{color:#700} +.CodeRay .binary{color:#509} +.CodeRay .comment{color:#998;font-style:italic} +.CodeRay .char{color:#04d} +.CodeRay .char .content{color:#04d} +.CodeRay .char .delimiter{color:#039} +.CodeRay .class{color:#458;font-weight:bold} +.CodeRay .complex{color:#a08} +.CodeRay .constant,.CodeRay .predefined-constant{color:#008080} +.CodeRay .color{color:#099} +.CodeRay .class-variable{color:#369} +.CodeRay .decorator{color:#b0b} +.CodeRay .definition{color:#099} +.CodeRay .delimiter{color:#000} +.CodeRay .doc{color:#970} +.CodeRay .doctype{color:#34b} +.CodeRay .doc-string{color:#d42} +.CodeRay .escape{color:#666} +.CodeRay .entity{color:#800} +.CodeRay .error{color:#808} +.CodeRay .exception{color:inherit} +.CodeRay .filename{color:#099} +.CodeRay .function{color:#900;font-weight:bold} +.CodeRay .global-variable{color:#008080} +.CodeRay .hex{color:#058} +.CodeRay .integer,.CodeRay .float{color:#099} +.CodeRay .include{color:#555} +.CodeRay .inline{color:#000} +.CodeRay .inline .inline{background:#ccc} +.CodeRay .inline .inline .inline{background:#bbb} +.CodeRay .inline .inline-delimiter{color:#d14} +.CodeRay .inline-delimiter{color:#d14} +.CodeRay .important{color:#555;font-weight:bold} +.CodeRay .interpreted{color:#b2b} +.CodeRay .instance-variable{color:#008080} +.CodeRay .label{color:#970} +.CodeRay .local-variable{color:#963} +.CodeRay .octal{color:#40e} +.CodeRay .predefined{color:#369} +.CodeRay .preprocessor{color:#579} +.CodeRay .pseudo-class{color:#555} +.CodeRay .directive{font-weight:bold} +.CodeRay .type{font-weight:bold} +.CodeRay .predefined-type{color:inherit} +.CodeRay .reserved,.CodeRay .keyword {color:#000;font-weight:bold} +.CodeRay .key{color:#808} +.CodeRay .key .delimiter{color:#606} +.CodeRay .key .char{color:#80f} +.CodeRay .value{color:#088} +.CodeRay .regexp .delimiter{color:#808} +.CodeRay .regexp .content{color:#808} +.CodeRay .regexp .modifier{color:#808} +.CodeRay .regexp .char{color:#d14} +.CodeRay .regexp .function{color:#404;font-weight:bold} +.CodeRay .string{color:#d20} +.CodeRay .string .string .string{background:#ffd0d0} +.CodeRay .string .content{color:#d14} +.CodeRay .string .char{color:#d14} +.CodeRay .string .delimiter{color:#d14} +.CodeRay .shell{color:#d14} +.CodeRay .shell .delimiter{color:#d14} +.CodeRay .symbol{color:#990073} +.CodeRay .symbol .content{color:#a60} +.CodeRay .symbol .delimiter{color:#630} +.CodeRay .tag{color:#008080} +.CodeRay .tag-special{color:#d70} +.CodeRay .variable{color:#036} +.CodeRay .insert{background:#afa} +.CodeRay .delete{background:#faa} +.CodeRay .change{color:#aaf;background:#007} +.CodeRay .head{color:#f8f;background:#505} +.CodeRay .insert .insert{color:#080} +.CodeRay .delete .delete{color:#800} +.CodeRay .change .change{color:#66f} +.CodeRay .head .head{color:#f4f} + </style> + </head> + <body data-spy="scroll" data-target="#toc"> + <div id="basedir" style="display:none;"> + ../../ + </div> + <div id="docname" style="display:none;"> + rgfis + </div> + <div id="filetype" style="display:none;"> + html + </div> + <!-- Navbar --> + <nav class="navbar navbar-default navbar-static-top header"> + <div class="container"> + <div class="navbar-header"> + <!-- Three line menu button for use on mobile screens --> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar"> <span class="sr-only">Toggle navigation</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> + <a class="navbar-brand" href="../../index.html"> <img alt="Brand" src="../../images/isis-logo-48x48.png"> </a> + <a class="navbar-brand" href="../../index.html">Apache Isis</a> + </div> + <!-- Navbar that will collapse on mobile screens --> + <div id="navbar" class="navbar-collapse collapse"> + <ul class="nav navbar-nav"> + <li class="dropdown"> <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Documentation<span class="caret"></span></a> + <ul class="dropdown-menu"> + <li><a href="../../documentation.html">Table of Contents</a></li> + <li role="separator" class="divider"></li> + <li class="dropdown-header">User Guides</li> + <li><a href="../../guides/ugfun/ugfun.html">Fundamentals</a></li> + <li><a href="../../guides/ugvw/ugvw.html">Wicket Viewer</a></li> + <li><a href="../../guides/ugvro/ugvro.html">Restful Objects Viewer</a></li> + <li><a href="../../guides/ugodn/ugodn.html">DataNucleus Object Store</a></li> + <li><a href="../../guides/ugsec/ugsec.html">Security</a></li> + <li><a href="../../guides/ugtst/ugtst.html">Testing</a></li> + <li><a href="../../guides/ugbtb/ugbtb.html">Beyond the Basics</a></li> + <li role="separator" class="divider"></li> + <li class="dropdown-header">Reference Guides</li> + <li><a href="../../guides/rgant/rgant.html">Annotations</a></li> + <li><a href="../../guides/rgsvc/rgsvc.html">Domain Services</a></li> + <li><a href="../../guides/rgcfg/rgcfg.html">Core Config' Properties</a></li> + <li><a href="../../guides/rgcms/rgcms.html">Classes, Methods and Schema</a></li> + <li><a href="../../guides/rgmvn/rgmvn.html">Maven plugin</a></li> + <li><a href="../../guides/rgfis/rgfis.html">Framework Internal Services</a></li> + <li role="separator" class="divider"></li> + <li class="dropdown-header">Javadoc</li> + <li><a href="http://javadoc.io/doc/org.apache.isis.core/isis-core-applib";>Applib</a></li> + </ul> </li> + <li class="dropdown hidden-sm hidden-md"> <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Downloads<span class="caret"></span></a> + <ul class="dropdown-menu"> + <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="../../downloads.html">Downloads</a></li> + <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="https://github.com/apache/isis";>Github mirror</a></li> + </ul> </li> + <li class="dropdown hidden-sm"> <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Support<span class="caret"></span></a> + <ul class="dropdown-menu"> + <li class="dropdown-header">Guides</li> + <li><a href="../../guides/dg/dg.html">Developers' Guide</a></li> + <li><a href="../../guides/cgcom/cgcom.html">Committers' Guide</a></li> + <li><a href="../../guides/htg.html">Hints-n-Tips Guide</a></li> + <li role="separator" class="divider"></li> + <li class="dropdown-header">Mailing Lists</li> + <li><a href="../../support.html">How to subscribe</a></li> + <li><a href="https://lists.apache.org/list.html?us...@isis.apache.org";>Archives (ASF Pony mail)</a></li> + <li><a href="http://isis.markmail.org/search/?q=";>Archives (Markmail)</a></li> + <li role="separator" class="divider"></li> + <li class="dropdown-header">Other Resources</li> + <li><a href="https://issues.apache.org/jira/browse/ISIS";>ASF JIRA</a></li> + <li><a href="https://stackoverflow.com/questions/tagged/isis";>Stack Overflow</a></li> + <li><a href="../../help.html">Wiki, Fisheye etc.</a></li> + </ul> </li> + <li class="dropdown hidden-sm hidden-md"> <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">@ASF<span class="caret"></span></a> + <ul class="dropdown-menu"> + <li><a href="https://www.apache.org/";>Apache Homepage</a></li> + <li><a href="https://www.apache.org/events/current-event";>Events</a></li> + <li><a href="https://www.apache.org/licenses/";>Licenses</a></li> + <li><a href="https://www.apache.org/security/";>Security</a></li> + <li><a href="https://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li> + <li><a href="https://www.apache.org/foundation/thanks.html";>Thanks</a></li> + <li role="separator" class="divider"></li> + <li><a href="https://whimsy.apache.org/board/minutes/Isis.html";>PMC board minutes</a></li> + </ul> </li> + </ul> + <div class="nav navbar-nav navbar-right"> + <!-- 'style' added to fix height of input box. FIX THIS --> + <form class="navbar-form" role="search" id="search-form" style="padding: 1px 15px;"> + <div class="form-group"> + <input class="form-control" id="search-field" type="text" size="30" placeholder="Search"> + </div> + </form> + </div> + <p class="nav navbar-text navbar-right small">v2.0.0-M1</p> + </div> + </div> + </nav> + <div class="container"> + <div class="row-fluid"> + <div class="col-xs-12 col-sm-12 col-md-12 col-lg-9"> + <div id="search-panel"> + <div id="search-results"></div> + <div> + <br> + <a href="#" id="search-results-clear">clear</a> + </div> + </div> + <span class="pdf-link"><a href="rgfis.pdf"><img src="../../images/PDF-50.png"></a></span> + <div class="page-title"> + <h1>Framework Internal Services</h1> + </div> + <div id="doc-content"> + <div class="btn-group" style="float: right; font-size: small; padding: 6px; "> + <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.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.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.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.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.adoc"; target="_blank"><i class="fa fa-hand-o-right fa-fw" aria-hidden="true"></i> Blame</a></li> + </ul> + </div> + <div class="sect1"> + <h2 id="__rgfis">1. Framework Internal Services</h2> + <div class="sectionbody"> + <div class="paragraph"> + <p>This guide documents a number of domain services that are not part of the frameworkâs formal API, they use classes that are outside of the applib. They should be thought of as part of the internal design of the framework, and are liable to change from release to release.</p> + </div> + <div class="admonitionblock warning"> + <table> + <tbody> + <tr> + <td class="icon"> <i class="fa icon-warning" title="Warning"></i> </td> + <td class="content"> + <div class="paragraph"> + <p>We do not guarantee that <a href="http://semver.org";>semantic versioning</a> will be honoured for these services.</p> + </div> </td> + </tr> + </tbody> + </table> + </div> + <div class="sect2"> + <h3 id="_other_guides">1.1. Other Guides</h3> + <div class="paragraph"> + <p>Apache Isis documentation is broken out into a number of user, reference and "supporting procedures" guides.</p> + </div> + <div class="paragraph"> + <p>The user guides available are:</p> + </div> + <div class="ulist"> + <ul> + <li> <p><a href="../ugfun/ugfun.html">Fundamentals</a></p> </li> + <li> <p><a href="../ugvw/ugvw.html">Wicket viewer</a></p> </li> + <li> <p><a href="../ugvro/ugvro.html">Restful Objects viewer</a></p> </li> + <li> <p><a href="../ugodn/ugodn.html">DataNucleus object store</a></p> </li> + <li> <p><a href="../ugsec/ugsec.html">Security</a></p> </li> + <li> <p><a href="../ugtst/ugtst.html">Testing</a></p> </li> + <li> <p><a href="../ugbtb/ugbtb.html">Beyond the Basics</a></p> </li> + </ul> + </div> + <div class="paragraph"> + <p>The reference guides are:</p> + </div> + <div class="ulist"> + <ul> + <li> <p><a href="../rgant/rgant.html">Annotations</a></p> </li> + <li> <p><a href="../rgsvc/rgsvc.html">Domain Services</a></p> </li> + <li> <p><a href="../rgcfg/rgcfg.html">Configuration Properties</a></p> </li> + <li> <p><a href="../rgcms/rgcms.html">Classes, Methods and Schema</a></p> </li> + <li> <p><a href="../rgmvn/rgmvn.html">Apache Isis Maven plugin</a></p> </li> + <li> <p><a href="../rgfis/rgfis.html">Framework Internal Services</a> (this guide)</p> </li> + </ul> + </div> + <div class="paragraph"> + <p>The remaining guides are:</p> + </div> + <div class="ulist"> + <ul> + <li> <p><a href="../dg/dg.html">Developers' Guide</a> (how to set up a development environment for Apache Isis and contribute back to the project)</p> </li> + <li> <p><a href="../cgcom/cgcom.html">Committers' Guide</a> (release procedures and related practices)</p> </li> + </ul> + </div> + </div> + </div> + </div> + <div class="sect1"> + <h2 id="_rgfis_presentation-layer">2. Presentation Layer</h2> + <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_presentation-layer.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_presentation-layer.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_presentation-layer.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_presentation-layer.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_presentation-layer.adoc"; target="_blank"><i class="fa fa-hand-o-right fa-fw" aria-hidden="true"></i> Blame</a></li> + </ul> + </div> + <div class="sectionbody"> + <div class="paragraph"> + <p>These domain services are internal to the framework, controlling various aspects of the presentation layer.</p> + </div> + <div class="paragraph"> + <p>The table below summarizes the presentation layer internal SPIs defined by Apache Isis. It also lists their corresponding implementation, either a default implementation provided by Apache Isis itself, or provided by one of the (non-ASF) <a href="http://platform.incode.org"; target="_blank">Incode Platform</a> modules.</p> + </div> + <table class="tableblock frame-all grid-all spread"> + <caption class="title"> + Table 1. Internal Services + </caption> + <colgroup> + <col style="width: 30%;"> + <col style="width: 30%;"> + <col style="width: 20%;"> + <col style="width: 20%;"> + </colgroup> + <thead> + <tr> + <th class="tableblock halign-left valign-top">SPI</th> + <th class="tableblock halign-left valign-top">Maven Module<br> Implân (g: a:)</th> + <th class="tableblock halign-left valign-top">Implementation</th> + <th class="tableblock halign-left valign-top">Notes</th> + </tr> + </thead> + <tbody> + <tr> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgfis/rgfis.html#_rgfis_presentation-layer_ContentNegotiationService"><code>o.a.i.v.ro.</code><br> <code>rendering.service.conneg.</code><br> <code>ContentNegotiationService</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock">Encodes the algorithm that delegates to any registered <a href="../rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_ContentMappingService"><code>ContentMappingService</code></a>s.</p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><code>ContentNegotiationService-</code><br> <code>XRoDomainType</code><br> <code>o.a.i.core</code><br> <code>isis-core-viewer-restfulobjects-rendering</code></p></td> + <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_presentation-layer_RepresentationService"><code>o.a.i.v.ro.</code><br> <code>rendering.service.</code><br> <code>RepresentationService</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock">Generates the representations, delegating to any registered <a href="../rgfis/rgfis.html#_rgfis_presentation-layer_ContentNegotiationService"><code>ContentNegotiationService</code></a>s.</p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><code>RepresentationService-</code><br> <code>ForRestfulObjects</code><br> <code>o.a.i.core</code><br> <code>isis-core-viewer-restfulobjects-rendering</code></p></td> + <td class="tableblock halign-left valign-top"> + <div></div></td> + </tr> + </tbody> + </table> + <div class="paragraph"> + <p>Key:</p> + </div> + <div class="ulist"> + <ul> + <li> <p><code>o.a.i</code> is an abbreviation for <code>org.apache.isis</code></p> </li> + <li> <p><code>o.ia.m</code> is an abbreviation for <code>org.isisaddons.module</code></p> </li> + <li> <p><code>o.a.i.c.m.s</code> is an abbreviation for <code>org.apache.isis.core.metamodel.services</code></p> </li> + <li> <p><code>o.a.i.c.r.s</code> is an abbreviation for <code>org.apache.isis.core.runtime.services</code></p> </li> + <li> <p><code>o.a.i.v.ro</code> is an abbreviation for <code>org.apache.isis.viewer.restfulobjects</code></p> </li> + </ul> + </div> + <div class="sect2"> + <h3 id="_rgfis_presentation-layer_ContentNegotiationService">2.1. <code>ContentNegotiationService</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_presentation-layer_ContentNegotiationService.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_presentation-layer_ContentNegotiationService.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_presentation-layer_ContentNegotiationService.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_presentation-layer_ContentNegotiationService.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_presentation-layer_ContentNegotiationService.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 <code>ContentNegotiationService</code> is a plug-in point for the <a href="../ugvro/ugvro.html">RestfulObjects viewer</a> so that it can generate representations according to HTTP <code>Accept</code> header of the request. This idea is discussed in section 34.1 of the <a href="http://restfulobjects.org";>Restful Objects spec</a> v1.0.</p> + </div> + <div class="paragraph"> + <p>The principal motivation is to allow more flexible representations to be generated for REST clients that (perhaps through their use of a certain Javascript library, say) expect, or at least works best with, a certain style of representation.</p> + </div> + <div class="paragraph"> + <p>Another use case is to support "third party" REST clients over which you have no control. In this scenario you <em>must not</em> naively expose entities through the RO viewer, because over time those entities will inevitably evolve and change their structure. If the entities were exposed directly then those REST clients will break.</p> + </div> + <div class="paragraph"> + <p>Instead you need to create some sort of stable facade over your domain entities, one which you will preserve even if the domain entities change. There are three ways in which you can do this:</p> + </div> + <div class="ulist"> + <ul> + <li> <p>first is to solve the problem at the domain layer by defining a regular Apache Isis <a href="../ugfun/ugfun.html#_ugfun_building-blocks_types-of-domain-objects_view-models">view model</a>. This is then surfaced over the RO viewer. <br></p> + <div class="paragraph"> + <p>If the underlying entities change, then care must be taken to ensure that structure of the view model nevertheless is unchanged.</p> + </div> </li> + <li> <p>a second option is to solve the problem at the persistence layer, but defining a (SQL) view in the database and then <a href="../ugodn/ugodn.html#_ugodn_jdo-mappings_mapping-to-a-view">mapping this</a> to a (read-only) entity. Again this is surfaced by the RO viewer. <br></p> + <div class="paragraph"> + <p>If the underlying tables change (as the result of a change in their corresponding domain entities) then once more the view must be refactored so that it still presents the same structure.</p> + </div> </li> + <li> <p>our third option is to solve the problem at the presentation layer, using the <code>ContentNegotiationService</code> described in this section.<br></p> + <div class="paragraph"> + <p>The <code>ContentNegotiationService</code> is responsible for inspecting the HTTP <code>Accept</code> header, and use this to select the correct representation to render. <br></p> + </div> + <div class="paragraph"> + <p>The Apache Isis framework provides three implementations of <code>ContentNegotiationService</code> which inspects different elements of the HTTP <code>Accept</code> header. One of these implementations, <code>ContentNegotiationServiceXRoDomainType</code> will further delegate down to the companion <a href="../rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_ContentMappingService"><code>ContentMappingService</code></a> service (if configured/available), based on the value of the "x-ro-domain-type" parameter of the header.<br></p> + </div> + <div class="paragraph"> + <p>A typical implementation of <code>ContentMappingService</code> will convert the domain object into some sort of DTO (data transfer object) as specified by the "x-ro-domaintype". If this DTO is annotated with JAXB or Jackson mappings, then the RO viewer (courtesy of the underlying <a href="http://resteasy.jboss.org/";>RestEasy</a> framework) can serialize these directly.<br></p> + </div> + <div class="paragraph"> + <p>What all that means is that, if the underlying entities change, we are required to update the mappings in the <code>ContentMappingService</code> to map to the same DTOs.</p> + </div> </li> + </ul> + </div> + <div class="paragraph"> + <p>This diagram illustrates the three options available:</p> + </div> + <div class="imageblock"> + <div class="content"> + <a class="image" href="images/ContentNegotiationService/facade-choices.png"><img src="images/ContentNegotiationService/facade-choices.png" alt="facade choices" width="700px"></a> + </div> + </div> + <div class="sect3"> + <h4 id="_spi">2.1.1. SPI</h4> + <div class="paragraph"> + <p>The SPI defined by this 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">ContentNegotiationService</span> { + Response.ResponseBuilder buildResponse( <i class="conum" data-value="1"></i><b>(1)</b> + RepresentationService.Context2 renderContext2, + ObjectAdapter objectAdapter); + Response.ResponseBuilder buildResponse( <i class="conum" data-value="2"></i><b>(2)</b> + RepresentationService.Context2 renderContext2, + ObjectAndProperty objectAndProperty); + Response.ResponseBuilder buildResponse( <i class="conum" data-value="3"></i><b>(3)</b> + RepresentationService.Context2 renderContext2, + ObjectAndCollection objectAndCollection); + Response.ResponseBuilder buildResponse( <i class="conum" data-value="4"></i><b>(4)</b> + RepresentationService.Context2 renderContext2, + ObjectAndAction objectAndAction); + Response.ResponseBuilder buildResponse( <i class="conum" data-value="5"></i><b>(5)</b> + RepresentationService.Context2 renderContext2, + ObjectAndActionInvocation objectAndActionInvocation); +}</code></pre> + </div> + </div> + <div class="colist arabic"> + <table> + <tbody> + <tr> + <td><i class="conum" data-value="1"></i><b>1</b></td> + <td>representation of a single object, as per section 14.4 of the RO spec, v1.0</td> + </tr> + <tr> + <td><i class="conum" data-value="2"></i><b>2</b></td> + <td>representation of a single property of an object, as per section 16.4 of the RO spec v1.0</td> + </tr> + <tr> + <td><i class="conum" data-value="3"></i><b>3</b></td> + <td>representation of a single collection of an object, as per section 17.5 of the RO spec v1.0</td> + </tr> + <tr> + <td><i class="conum" data-value="4"></i><b>4</b></td> + <td>representation of a single action (prompt) of an object, as per section 18.2 of the RO spec v1.0</td> + </tr> + <tr> + <td><i class="conum" data-value="5"></i><b>5</b></td> + <td>representation of the results of a single action invocation, as per section 19.5 of the RO spec v1.0</td> + </tr> + </tbody> + </table> + </div> + <div class="paragraph"> + <p>These methods provide:</p> + </div> + <div class="ulist"> + <ul> + <li> <p>a <code>RepresentationService.Context2</code> which provides access to request-specific context (eg HTTP headers), session-specific context (eg authentication) and global context (eg configuration settings)</p> </li> + <li> <p>an object representing the information to be rendered<br></p> + <div class="paragraph"> + <p>eg <code>ObjectAdapter</code>, <code>ObjectAndProperty</code>, <code>ObjectAndCollection</code> etc</p> + </div> </li> + </ul> + </div> + <div class="paragraph"> + <p>In all cases, returning <code>null</code> will result in the regular RO spec representation being returned.</p> + </div> + </div> + <div class="sect3"> + <h4 id="_implementation">2.1.2. Implementation</h4> + <div class="paragraph"> + <p><code>ContentNegotiationServiceAbstract</code> (in <code>o.a.i.v.ro.rendering.service.conneg</code>) provides a no-op implementation of the SPI, along with supporting methods:</p> + </div> + <div class="listingblock"> + <div class="content"> + <pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="directive">abstract</span> <span class="type">class</span> <span class="class">ContentNegotiationServiceAbstract</span> <span class="directive">implements</span> ContentNegotiationService { + ... + protected <span class="predefined-type">Object</span> objectOf(<span class="directive">final</span> ObjectAdapter objectAdapter) { ... } + <span class="directive">protected</span> <span class="predefined-type">Object</span> returnedObjectOf(ObjectAndActionInvocation objectAndActionInvocation) { ... } + + <span class="directive">protected</span> <span class="predefined-type">Class</span><?> loadClass(<span class="predefined-type">String</span> cls) { ... } + + <span class="directive">protected</span> <span class="type">void</span> ensureJaxbAnnotated(<span class="predefined-type">Class</span><?> domainType) { ... } + <span class="directive">protected</span> <span class="type">void</span> ensureDomainObjectAssignable( + <span class="predefined-type">String</span> xRoDomainType, <span class="predefined-type">Class</span><?> domainType, <span class="predefined-type">Object</span> domainObject) { ... } +}</code></pre> + </div> + </div> + <div class="paragraph"> + <p>As discussed in the introduction, the framework also provides three implementation of this service, one of which is <code>o.a.i.v.ro.rendering.service.conneg.ContentNegotiationServiceXRoDomainType</code>. This implementation handles content negotiation for two of the possible representations, object representations and for action result representations:</p> + </div> + <div class="ulist"> + <ul> + <li> <p>For object representations it will handle requests with HTTP <code>Accept</code> headers of the form:</p> + <div class="ulist"> + <ul> + <li> <p><code>application/json;profile=urn:org.restfulobjects:repr-types/object;x-ro-domain-type=â¦â</code></p> </li> + <li> <p><code>application/xml;profile=urn:org.restfulobjects:repr-types/object;x-ro-domain-type=â¦â</code></p> </li> + </ul> + </div> </li> + <li> <p>for action result representations it will similarly handle requests with HTTP <code>Accept</code> headers of the form:</p> + <div class="ulist"> + <ul> + <li> <p><code>application/json;profile=urn:org.restfulobjects:repr-types/action-result;x-ro-domain-type=â¦â</code><br></p> </li> + <li> <p><code>application/xml;profile=urn:org.restfulobjects:repr-types/action-result;x-ro-domain-type=â¦â</code></p> </li> + </ul> + </div> </li> + </ul> + </div> + <div class="paragraph"> + <p>The value of the <code>x-ro-domain-type</code> parameter corresponds to the DTO to be mapped into by the <a href="../rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_ContentMappingService"><code>ContentMappingService</code></a>.</p> + </div> + <div class="paragraph"> + <p>If the DTO is annotated with JAXB, then also note that the runtime type must be annotated with the JAXB <code>javax.xml.bind.annotation.XmlRootElement</code> so that RestEasy is able to unambiguously serialize it.</p> + </div> + <div class="paragraph"> + <p>The other two implementations of <code>ContentNegotiationService</code> are:</p> + </div> + <div class="ulist"> + <ul> + <li> <p><code>ContentNegotiationServiceForRestfulObjectsV1_0</code><br></p> + <div class="paragraph"> + <p>which returns representations according to the <a href="http://restfulobjects.org";>Restful Objects</a> spec.</p> + </div> + <div class="paragraph"> + <p>One extension (specific to Apache Isis, not part of the RO spec) is that actions can also be invoked with an HTTP <code>Accept</code> header of the form:</p> + </div> + <div class="paragraph"> + <p><code>application/json;profile=urn:org.restfulobjects:repr-types/object</code></p> + </div> + <div class="paragraph"> + <p>If the action result returns a collection then this will automatically converted to a <code>DomainObjectList</code> view model. This can be useful for generic viewers.</p> + </div> </li> + <li> <p><code>ContentNegotiationServiceOrgApacheIsisV1</code><br></p> + <div class="paragraph"> + <p>which returns <a href="../ugvro/ugvro.html#_ugvro_simplified-representations">simplified representations</a></p> + </div> </li> + </ul> + </div> + </div> + <div class="sect3"> + <h4 id="_usage">2.1.3. Usage</h4> + <div class="paragraph"> + <p>You can find an example of all these services in the (non-ASF) <a href="http://github.com/isisaddons/isis-app-todoapp";>Isis addons' todoapp</a>. This defines a <code>ToDoItemDto</code> class that is JAXB annotated (it is in fact generated from an XSD).</p> + </div> + <div class="paragraph"> + <p>The example app also includes an implementation of <code>ContentMappingService</code> that maps <code>todoapp.dom.module.todoitem.ToDoItem</code> entities to <code>todoapp.dto.module.todoitem.ToDoItemDto</code> classes.</p> + </div> + <div class="paragraph"> + <p>A REST client can therefore request a DTO representation of an entity by invoking</p> + </div> + <div class="listingblock"> + <div class="content"> + <pre class="CodeRay highlight"><code>http://localhost:8080/restful/objects/TODO/0</code></pre> + </div> + </div> + <div class="paragraph"> + <p>with an <code>Accept</code> header of:</p> + </div> + <div class="listingblock"> + <div class="content"> + <pre class="CodeRay highlight"><code>application/xml;profile=urn:org.restfulobjects:repr-types/object;x-ro-domain-type=todoapp.dto.module.todoitem.ToDoItemDto</code></pre> + </div> + </div> + <div class="paragraph"> + <p>will result in an XML serialization of that class:</p> + </div> + <div class="imageblock"> + <div class="content"> + <a class="image" href="images/ContentNegotiationService/accept-xml.png"><img src="images/ContentNegotiationService/accept-xml.png" alt="accept xml" width="700px"></a> + </div> + </div> + <div class="paragraph"> + <p>while similarly hitting the same URL with an <code>Accept</code> header of:</p> + </div> + <div class="listingblock"> + <div class="content"> + <pre class="CodeRay highlight"><code>application/json;profile=urn:org.restfulobjects:repr-types/object;x-ro-domain-type=todoapp.dto.module.todoitem.ToDoItemDto</code></pre> + </div> + </div> + <div class="paragraph"> + <p>will result in the JSON serialization of that class:</p> + </div> + <div class="imageblock"> + <div class="content"> + <a class="image" href="images/ContentNegotiationService/accept-json.png"><img src="images/ContentNegotiationService/accept-json.png" alt="accept json" width="700px"></a> + </div> + </div> + </div> + <div class="sect3"> + <h4 id="_configuration">2.1.4. Configuration</h4> + <div class="paragraph"> + <p>The default <code>ContentNegotiationServiceXRoDomainType</code> implementation provides a <a href="../rgcfg/rgcfg.html#_rgcfg_configuring-core">configuration property</a> which controls whether a mapped domain object is pretty-printed (formatted, indented) or not:</p> + </div> + <div class="listingblock"> + <div class="content"> + <pre class="CodeRay highlight"><code data-lang="ini">isis.services.ContentNegotiationServiceXRoDomainType.prettyPrint=true</code></pre> + </div> + </div> + <div class="paragraph"> + <p>If the property is not set, then the default depends on the <a href="../rgcfg/rgcfg.html#_rgcfg_deployment-types">deployment type</a>; production mode will disable pretty printing, while prototyping mode will enable it.</p> + </div> + </div> + <div class="sect3"> + <h4 id="_registering_the_services">2.1.5. Registering the Services</h4> + <div class="paragraph"> + <p>Assuming that the <code>configuration-and-annotation</code> services installer is configured (implicit if using the <code>AppManifest</code> to <a href="../rgcms/rgcms.html#_rgcms_classes_AppManifest-bootstrapping">bootstrap the app</a>) then Apache Isis' default implementations of <code>ContentNegotiationService</code> service are automatically registered and injected (it is annotated with <code>@DomainService</code>) so no further configuration is required.</p> + </div> + <div class="paragraph"> + <p>To use an alternative implementation, use <a href="../rgant/rgant.html#_rgant-DomainServiceLayout_menuOrder"><code>@DomainServiceLayout#menuOrder()</code></a> (as explained in the <a href="../rgsvc/rgsvc.html#__rgsvc_intro_overriding-the-services">introduction</a> to this guide).</p> + </div> + </div> + <div class="sect3"> + <h4 id="_related_services">2.1.6. Related Services</h4> + <div class="paragraph"> + <p>The default implementation of <code>ContentNegotiationService</code> delegates to <a href="../rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_ContentMappingService"><code>ContentMappingService</code></a> (if present) to convert domain entities into a stable form (eg DTO).</p> + </div> + <div class="paragraph"> + <p>The <code>ContentNegotiationService</code> is itself called by the (default implementation of) <a href="../rgfis/rgfis.html#_rgfis_presentation-layer_RepresentationService"><code>RepresentationService</code></a>.</p> + </div> + </div> + </div> + <div class="sect2"> + <h3 id="_rgfis_presentation-layer_RepresentationService">2.2. <code>RepresentationService</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_presentation-layer_RepresentationService.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_presentation-layer_RepresentationService.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_presentation-layer_RepresentationService.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_presentation-layer_RepresentationService.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_presentation-layer_RepresentationService.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 <code>RepresentationService</code> is the main plug-in point for the <a href="../ugvro/ugvro.html">RestfulObjects viewer</a> to generate representations.</p> + </div> + <div class="paragraph"> + <p>The default implementation generates representations according to the <a href="http://restfulobjects.org";>Restful Objects spec</a> v1.0. However, it also delegates to the <a href="../rgfis/rgfis.html#_rgfis_presentation-layer_ContentNegotiationService"><code>ContentNegotiationService</code></a> which provides a mechanism for altering representations according to the HTTP <code>Accept</code> header.</p> + </div> + <div class="paragraph"> + <p>The principal motivation is to allow more flexible representations to be generated for REST clients that (perhaps through their use of a certain Javascript library, say) expect, or at least works best with, a certain style of representation.</p> + </div> + <div class="paragraph"> + <p>In all there are three domain services that can influence the representations generated: this service, <a href="../rgfis/rgfis.html#_rgfis_presentation-layer_ContentNegotiationService"><code>ContentNegotiationService</code></a>and the <a href="../rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_ContentMappingService"><code>ContentMappingService</code></a>. The diagram below shows how these collaborate:</p> + </div> + <div class="imageblock"> + <div class="content"> + <a class="image" href="images/RepresentationService/service-collaborations.png"><img src="images/RepresentationService/service-collaborations.png" alt="service collaborations" width="700px"></a> + </div> + </div> + <div class="paragraph"> + <p>The <code>RepresentationServiceForRestfulObjects</code> is the default implementation of this service; likewise <code>ContentNegotiationServiceXRoDomainType</code> is the default implementation of the <code>ContentNegotiationService</code>. If you inspect the source code youâll see that the default implementation of this serviceâs primary responsibility is to generate the default Restful Objects representations. Therefore, if you what you want to do is to generate a <em>different _representation then in many cases replacing either this service _or</em> the <code>ContentNegotiationService</code> will be equivalent (youâll notice that their SPIs are very similar).</p> + </div> + <div class="sect3"> + <h4 id="_spi_2">2.2.1. SPI</h4> + <div class="paragraph"> + <p>The SPI defined by this 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">RepresentationService</span> { + Response objectRepresentation( <i class="conum" data-value="1"></i><b>(1)</b> + <span class="predefined-type">Context</span> rendererContext, + ObjectAdapter objectAdapter); + Response propertyDetails( <i class="conum" data-value="2"></i><b>(2)</b> + <span class="predefined-type">Context</span> rendererContext, + ObjectAndProperty objectAndProperty, + MemberReprMode memberReprMode); + Response collectionDetails( <i class="conum" data-value="3"></i><b>(3)</b> + <span class="predefined-type">Context</span> rendererContext, + ObjectAndCollection objectAndCollection, + MemberReprMode memberReprMode); + Response actionPrompt( <i class="conum" data-value="4"></i><b>(4)</b> + <span class="predefined-type">Context</span> rendererContext, + ObjectAndAction objectAndAction); + Response actionResult( <i class="conum" data-value="5"></i><b>(5)</b> + <span class="predefined-type">Context</span> rendererContext, + ObjectAndActionInvocation objectAndActionInvocation, + ActionResultReprRenderer.SelfLink selfLink); + <span class="directive">public</span> <span class="directive">static</span> <span class="type">interface</span> <span class="class">Context</span> <span class="directive">extends</span> RendererContext { + ObjectAdapterLinkTo getAdapterLinkTo(); + } +}</code></pre> + </div> + </div> + <div class="colist arabic"> + <table> + <tbody> + <tr> + <td><i class="conum" data-value="1"></i><b>1</b></td> + <td>representation of a single object, as per section 14.4 of the RO spec, v1.0</td> + </tr> + <tr> + <td><i class="conum" data-value="2"></i><b>2</b></td> + <td>representation of a single property of an object, as per section 16.4 of the RO spec v1.0</td> + </tr> + <tr> + <td><i class="conum" data-value="3"></i><b>3</b></td> + <td>representation of a single collection of an object, as per section 17.5 of the RO spec v1.0</td> + </tr> + <tr> + <td><i class="conum" data-value="4"></i><b>4</b></td> + <td>representation of a single action (prompt) of an object, as per section 18.2 of the RO spec v1.0</td> + </tr> + <tr> + <td><i class="conum" data-value="5"></i><b>5</b></td> + <td>representation of the results of a single action invocation, as per section 19.5 of the RO spec v1.0</td> + </tr> + </tbody> + </table> + </div> + <div class="paragraph"> + <p>These methods provide:</p> + </div> + <div class="ulist"> + <ul> + <li> <p>a <code>RendererContext</code> which provides access to request-specific context (eg HTTP headers), session-specific context (eg authentication) and global context (eg configuration settings)</p> </li> + <li> <p>an object representing the information to be rendered<br></p> + <div class="paragraph"> + <p>eg <code>ObjectAdapter</code>, <code>ObjectAndProperty</code>, <code>ObjectAndCollection</code> etc</p> + </div> </li> + <li> <p>for members, whether the representation is in read/write mode<br></p> + <div class="paragraph"> + <p>ie <code>MemberReprMode</code></p> + </div> </li> + </ul> + </div> + </div> + <div class="sect3"> + <h4 id="_implementation_2">2.2.2. Implementation</h4> + <div class="paragraph"> + <p>As discussed in the introduction, the framework provides a default implementation, <code>o.a.i.v.ro.rendering.service.RepresentationServiceContentNegotiator</code>. This delegates to <a href="../rgfis/rgfis.html#_rgfis_presentation-layer_ContentNegotiationService"><code>ContentNegotiationService</code></a> to generate an alternative representation; but if none is provided then it falls back on generating the representations as defined in the <a href="http://restfulobjects.org";>Restful Objects spec</a> v1.0.</p> + </div> + <div class="paragraph"> + <p>To use an alternative implementation, use <a href="../rgant/rgant.html#_rgant-DomainServiceLayout_menuOrder"><code>@DomainServiceLayout#menuOrder()</code></a> (as explained in the <a href="../rgsvc/rgsvc.html#__rgsvc_intro_overriding-the-services">introduction</a> to this guide).</p> + </div> + </div> + <div class="sect3"> + <h4 id="_registering_the_services_2">2.2.3. Registering the Services</h4> + <div class="paragraph"> + <p>Assuming that the <code>configuration-and-annotation</code> services installer is configured (implicit if using the <code>AppManifest</code> to <a href="../rgcms/rgcms.html#_rgcms_classes_AppManifest-bootstrapping">bootstrap the app</a>) then Apache Isis' default implementation of <code>RepresentationService</code> service is automatically registered and injected (it is annotated with <code>@DomainService</code>) so no further configuration is required.</p> + </div> + </div> + <div class="sect3"> + <h4 id="_related_services_2">2.2.4. Related Services</h4> + <div class="paragraph"> + <p>The default implementation delegates to <a href="../rgfis/rgfis.html#_rgfis_presentation-layer_ContentNegotiationService"><code>ContentNegotiationService</code></a>, whose default implementation may delegate in turn to <a href="../rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_ContentMappingService"><code>ContentMappingService</code></a> (if present).</p> + </div> + </div> + </div> + </div> + </div> + <div class="sect1"> + <h2 id="_rgfis_application-layer">3. Application Layer</h2> + <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.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.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.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.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.adoc"; target="_blank"><i class="fa fa-hand-o-right fa-fw" aria-hidden="true"></i> Blame</a></li> + </ul> + </div> + <div class="sectionbody"> + <div class="paragraph"> + <p>These domain services are internal to the framework, controlling various aspects of the application layer.</p> + </div> + <div class="paragraph"> + <p>The table below summarizes the application layer internal SPIs defined by Apache Isis. It also lists their corresponding implementation, either a default implementation provided by Apache Isis itself, or provided by one of the (non-ASF) <a href="http://platform.incode.org"; target="_blank">Incode Platform</a> modules.</p> + </div> + <table class="tableblock frame-all grid-all spread"> + <caption class="title"> + Table 2. Internal Services + </caption> + <colgroup> + <col style="width: 30%;"> + <col style="width: 30%;"> + <col style="width: 20%;"> + <col style="width: 20%;"> + </colgroup> + <thead> + <tr> + <th class="tableblock halign-left valign-top">SPI</th> + <th class="tableblock halign-left valign-top">Maven Module<br> Implân (g: a:)</th> + <th class="tableblock halign-left valign-top">Implementation</th> + <th class="tableblock halign-left valign-top">Notes</th> + </tr> + </thead> + <tbody> + <tr> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgfis/rgfis.html#_rgfis_application-layer_AuthenticationSessionProvider"><code>o.a.i.core.commons.</code><br> <code>authentication.</code><br> <code>AuthenticationSessionProvider</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock">Simply responsible for obtaining the current <code>AuthenticationSession</code> (the frameworkâs internal representation of the currently logged-in user).</p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><code>AuthenticationSession-</code><br> <code>ProviderDefault</code><br> <code>isis-core-runtime</code></p></td> + <td class="tableblock halign-left valign-top"> + <div> + <div class="paragraph"> + <p>Default implementation looks up from <code>IsisSessionFactory</code> singletonâs thread-local</p> + </div> + </div></td> + </tr> + <tr> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgfis/rgfis.html#_rgfis_application-layer_CommandDtoServiceInternal"><code>o.a.i.c.m.s.command</code><br> <code>CommandDtoServiceInternal</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock">Creates memento of current action invocation, for use as a serializable XML reified command. The most notable usage of this is to allow the execution of the <code>Command</code> to be deferred to run in the background (via <a href="../rgant/rgant.html#_rgant-Action_command"><code>@Action#commandExecuteIn()</code></a> or <a href="../rgant/rgant.html#_rgant-Property_command"><code>@Property#commandExecuteIn()</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-runtime</code></p></td> + <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_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_PublisherService"><code>PublisherService</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> + <td class="tableblock halign-left valign-top"> + <div></div></td> + </tr> + </tbody> + </table> + <div class="paragraph"> + <p>Key:</p> + </div> + <div class="ulist"> + <ul> + <li> <p><code>o.a.i</code> is an abbreviation for <code>org.apache.isis</code></p> </li> + <li> <p><code>o.ia.m</code> is an abbreviation for <code>org.isisaddons.module</code></p> </li> + <li> <p><code>o.a.i.c.m.s</code> is an abbreviation for <code>org.apache.isis.core.metamodel.services</code></p> </li> + <li> <p><code>o.a.i.c.r.s</code> is an abbreviation for <code>org.apache.isis.core.runtime.services</code></p> </li> + </ul> + </div> + <div class="sect2"> + <h3 id="_rgfis_application-layer_AuthenticationSessionProvider">3.1. <code>AuthenticationSessionProvider</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_AuthenticationSessionProvider.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_AuthenticationSessionProvider.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_AuthenticationSessionProvider.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_AuthenticationSessionProvider.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_AuthenticationSessionProvider.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>AuthenticationSessionProvider</code> domain service is simply responsible for obtaining the <code>AuthenticationSession</code> (being the frameworkâs internal representation of the currently logged in user).</p> + </div> + <div class="sect3"> + <h4 id="_spi_and_implementation">3.1.1. SPI and Implementation</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">AuthenticationSessionProvider</span> { + AuthenticationSession getAuthenticationSession(); +}</code></pre> + </div> + </div> + <div class="paragraph"> + <p>The framework provides a default implementation of the service, <code>AuthenticationSessionProviderDefault</code>, which looks up the current <code>AuthenticationSession</code> from <code>IsisSessionFactory</code> singleton service:</p> + </div> + <div class="listingblock"> + <div class="content"> + <pre class="CodeRay highlight"><code data-lang="java">isisSessionFactory.getCurrentSession().getAuthenticationSession();</code></pre> + </div> + </div> + <div class="paragraph"> + <p>If <a href="../rgsvc/rgsvc.html#_rgsvc_testing_SudoService"><code>SudoService</code></a> has been used to temporarily override the user and/or roles, then this service will report the overridden values.</p> + </div> + </div> + </div> + <div class="sect2"> + <h3 id="_rgfis_application-layer_CommandDtoServiceInternal">3.2. <code>CommandDtoServiceInternal</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_CommandDtoServiceInternal.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_CommandDtoServiceInternal.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_CommandDtoServiceInternal.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_CommandDtoServiceInternal.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_CommandDtoServiceInternal.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 <code>CommandDtoServiceInternal</code> is responsible for creating an memento of the current action invocation or property edit, to store in the <code>Command</code> object (from <a href="../rgsvc/rgsvc.html#_rgsvc_application-layer-api_CommandContext"><code>CommandContext</code></a>). This memento is a JAXB DTO being an instance of the <a href="../rgcms/rgcms.html#_rgcms_schema-cmd">"cmd" schema</a>, so can be reified so that its execution can be deferred until later, as a <a href="../rgsvc/rgsvc.html#_rgsvc_application-layer-spi_BackgroundCommandService">background command</a>.</p> + </div> + <div class="sect3"> + <h4 id="_spi_implementation">3.2.1. SPI & Implementation</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">CommandDtoServiceInternal</span> { + CommandDto asCommandDto( <i class="conum" data-value="1"></i><b>(1)</b> + <span class="predefined-type">List</span><ObjectAdapter> targetAdapters, + ObjectAction objectAction, + ObjectAdapter<span class="type">[]</span> argAdapters); + CommandDto asCommandDto( <i class="conum" data-value="2"></i><b>(2)</b> + <span class="directive">final</span> <span class="predefined-type">List</span><ObjectAdapter> targetAdapters, + <span class="directive">final</span> OneToOneAssociation association, + <span class="directive">final</span> ObjectAdapter valueAdapterOrNull); + <span class="type">void</span> addActionArgs( <i class="conum" data-value="3"></i><b>(3)</b> + <span class="directive">final</span> ObjectAction objectAction, + <span class="directive">final</span> ActionDto actionDto, + <span class="directive">final</span> ObjectAdapter<span class="type">[]</span> argAdapters); + <span class="type">void</span> addPropertyValue( <i class="conum" data-value="4"></i><b>(4)</b> + <span class="directive">final</span> OneToOneAssociation property, + <span class="directive">final</span> PropertyDto propertyDto, + <span class="directive">final</span> ObjectAdapter valueAdapter); +}</code></pre> + </div> + </div> + <div class="colist arabic"> + <table> + <tbody> + <tr> + <td><i class="conum" data-value="1"></i><b>1</b></td> + <td>Returns a JAXB DTO being an instance of the <a href="../rgcms/rgcms.html#_rgcms_schema-cmd">"cmd" schema</a> (hence convertible to XML) that represents the <em>intention</em> to invoke an action on a target object (or possibly many targets, for bulk actions). If an action, it can also be either mixin action or a contributed action.</td> + </tr> + <tr> + <td><i class="conum" data-value="2"></i><b>2</b></td> + <td>Returns a JAXB DTO that represents the intention to edit (set or clear) a property on a target (or possibly many targets, for symmetry with actions).</td> + </tr> + <tr> + <td><i class="conum" data-value="3"></i><b>3</b></td> + <td>add the arguments of an action to an <code>ActionDto</code>. This is used when the command is actually executed (per <a href="../rgsvc/rgsvc.html#_rgsvc_application-layer-api_InteractionContext"><code>InteractionContext</code></a>) to populate the parameters of the equivalent <code>ActionInvocationDto</code>.</td> + </tr> + <tr> + <td><i class="conum" data-value="4"></i><b>4</b></td> + <td>add the new value argument of a property to a <code>PropertyDto</code>. This is used when the command is actually executed (per <a href="../rgsvc/rgsvc.html#_rgsvc_application-layer-api_InteractionContext"><code>InteractionContext</code></a>) to set the the new value of the equivalent <code>PropertyEditDto</code>.</td> + </tr> + </tbody> + </table> + </div> + <div class="paragraph"> + <p>The SPI is implemented by <code>o.a.i.c.r.s.command.CommandDtoServiceInternalServiceDefault</code>.</p> + </div> + </div> + <div class="sect3"> + <h4 id="_related_services_3">3.2.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_InteractionDtoServiceInternal"><code>InteractionDtoServiceInternal</code></a>, used to create the <code>MemberExecutionDto</code> (from the <a href="../rgcms/rgcms.html#_rgcms_schema-ixn">"ixn" schema</a>).</p> + </div> + </div> + </div> + <div class="sect2"> + <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> + <ul class="dropdown-menu"> + <li><a href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_application-layer_InteractionDtoServiceInternal.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_InteractionDtoServiceInternal.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_InteractionDtoServiceInternal.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_InteractionDtoServiceInternal.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 <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.3.1. SPI & Implementation</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">InteractionDtoServiceInternal</span> { + ActionInvocationDto asActionInvocationDto( <i class="conum" data-value="1"></i><b>(1)</b> + ObjectAction objectAction, + ObjectAdapter targetAdapter, + <span class="predefined-type">List</span><ObjectAdapter> argumentAdapters); + PropertyEditDto asPropertyEditDto( <i class="conum" data-value="2"></i><b>(2)</b> + OneToOneAssociation property, + ObjectAdapter targetAdapter, + ObjectAdapter newValueAdapterIfAny); + ActionInvocationDto updateResult( <i class="conum" data-value="3"></i><b>(3)</b> + ActionInvocationDto actionInvocationDto, + ObjectAction objectAction, + <span class="predefined-type">Object</span> resultPojo); +}</code></pre> + </div> + </div> + <div class="colist arabic"> + <table> + <tbody> + <tr> + <td><i class="conum" data-value="1"></i><b>1</b></td> + <td>called by the framework when invoking an action, to create a DTO capturing the details of the action invocation (target, arguments etc).</td> + </tr> + <tr> + <td><i class="conum" data-value="2"></i><b>2</b></td> + <td>called by the framework when editing a property, to create a DTO (for the <a href="../rgcms/rgcms.html#_rgcms_schema-ixn">"ixn" schema</a>) capturing the details of the property edit (target, new value etc).</td> + </tr> + <tr> + <td><i class="conum" data-value="3"></i><b>3</b></td> + <td>called by the framework to attach the result of an action invocation to the aforementioned DTO.</td> + </tr> + </tbody> + </table> + </div> + <div class="paragraph"> + <p>The service is implemented by <code>o.a.i.core.runtime.services.ixn.InteractionDtoServiceInternalDefault</code>.</p> + </div> + </div> + <div class="sect3"> + <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> + </div> + </div> + </div> + </div> + <div class="sect1"> + <h2 id="_rgfis_persistence-layer">4. Persistence Layer internal SPI</h2> + <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.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.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.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.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.adoc"; target="_blank"><i class="fa fa-hand-o-right fa-fw" aria-hidden="true"></i> Blame</a></li> + </ul> + </div> + <div class="sectionbody"> + <div class="paragraph"> + <p>These domain services are internal to the framework, controlling various aspects of the persistence layer.</p> + </div> + <div class="paragraph"> + <p>The table below summarizes the persistence layer internal SPIs defined by Apache Isis. It also lists their corresponding implementation, either a default implementation provided by Apache Isis itself, or provided by one of the (non-ASF) <a href="http://platform.incode.org"; target="_blank">Incode Platform</a> modules.</p> + </div> + <table class="tableblock frame-all grid-all spread"> + <caption class="title"> + Table 3. Internal Services + </caption> + <colgroup> + <col style="width: 30%;"> + <col style="width: 30%;"> + <col style="width: 20%;"> + <col style="width: 20%;"> + </colgroup> + <thead> + <tr> + <th class="tableblock halign-left valign-top">SPI</th> + <th class="tableblock halign-left valign-top">Maven Module<br> Implân (g: a:)</th> + <th class="tableblock halign-left valign-top">Implementation</th> + <th class="tableblock halign-left valign-top">Notes</th> + </tr> + </thead> + <tbody> + <tr> + <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgfis/rgfis.html#_rgfis_persistence-layer_AuditingServiceInternal"><code>o.a.i.c.r.s.auditing.</code><br> <code>AuditingServiceInternal</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock">Co-ordinates between <a href="../rgfis/rgfis.html#_rgfis_persistence-layer_ChangedObjectsServiceInternal"><code>ChangedObjectsServiceInternal</code></a> and <a href="../rgfis/rgfis.html#_rgfis_spi_AuditerService"><code>AuditerService</code></a>.</p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock">concrete class.</p></td> + <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_ChangedObjectsServiceInternal"><code>o.a.i.c.r.s.changes.</code><br> <code>ChangedObjectsServiceInternal</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock">Request-scoped service holding objects enlisted into current transaction.</p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock">concrete class.</p></td> + <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_PersistenceSessionServiceInternal"><code>o.a.i.c.m.s.</code><br> <code>persistsession.</code><br> <code>PersistenceSessionServiceInternal</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock">Acts as a facade to the underlying JDO persistence session / database connection. As such it provides methods for querying and for persisting objects.</p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><code>PersistenceSessionService-</code><br> <code>InternalDefault</code><br> <code>isis-core-runtime</code></p></td> + <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_PublishingServiceInternal"><code>o.a.i.c.m.s.publishing.</code><br> <code>PublishingServiceInternal</code></a></p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock">Co-ordinates between <a href="../rgfis/rgfis.html#_rgfis_persistence-layer_ChangedObjectsServiceInternal"><code>ChangedObjectsServiceInternal</code></a> and <a href="../rgsvc/rgsvc.html#_rgsvc_persistence-layer-api_MetricsService"><code>MetricsService</code></a> and the SPI services, and the <a href="../rgsvc/rgsvc.html#_rgsvc_persistence-layer-spi_PublisherService"><code>PublisherService</code></a>.</p></td> + <td class="tableblock halign-left valign-top"><p class="tableblock"><code>PublishingService-</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"> + <p>Key:</p> + </div> + <div class="ulist"> + <ul> + <li> <p><code>o.a.i</code> is an abbreviation for <code>org.apache.isis</code></p> </li> + <li> <p><code>o.ia.m</code> is an abbreviation for <code>org.isisaddons.module</code></p> </li> + <li> <p><code>o.a.i.c.m.s</code> is an abbreviation for <code>org.apache.isis.core.metamodel.services</code></p> </li> + <li> <p><code>o.a.i.c.r.s</code> is an abbreviation for <code>org.apache.isis.core.runtime.services</code></p> </li> + </ul> + </div> + <div class="sect2"> + <h3 id="_rgfis_persistence-layer_AuditingServiceInternal">4.1. <code>AuditingServiceInternal</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_AuditingServiceInternal.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_AuditingServiceInternal.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_AuditingServiceInternal.adoc"; target="_blank"><i class="fa fa-clock-o fa-fw" aria-hidden="true"></i> History</a></li> + <l
<TRUNCATED>
