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 2016/04/08 13:01:53 UTC
[3/3] isis-site git commit: ISIS-1361: new BookmarkService2
subinterface to provide finer-grained control as to whether to reset fields
when reloading an object;
changing the JAXB PersistentEntityAdapter to use new API;
also extending EntityPage onBefore
ISIS-1361: new BookmarkService2 subinterface to provide finer-grained control as to whether to reset fields when reloading an object; changing the JAXB PersistentEntityAdapter to use new API; also extending EntityPage onBeforeRender to disable concurrency checking for *all* objects, not merely the object being rendered. Also updates to docs.
Project: http://git-wip-us.apache.org/repos/asf/isis-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis-site/commit/dd007c3f
Tree: http://git-wip-us.apache.org/repos/asf/isis-site/tree/dd007c3f
Diff: http://git-wip-us.apache.org/repos/asf/isis-site/diff/dd007c3f
Branch: refs/heads/asf-site
Commit: dd007c3f2f37aea09d928d8f1c732bba875269bf
Parents: 3486929
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Fri Apr 8 11:46:34 2016 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Fri Apr 8 11:46:34 2016 +0100
----------------------------------------------------------------------
content/guides/rgsvc.html | 30 +-
content/guides/rgsvc.pdf | 15125 ++++++++++++++++++++-------------------
2 files changed, 7913 insertions(+), 7242 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis-site/blob/dd007c3f/content/guides/rgsvc.html
----------------------------------------------------------------------
diff --git a/content/guides/rgsvc.html b/content/guides/rgsvc.html
index 52896ef..5cadaf5 100644
--- a/content/guides/rgsvc.html
+++ b/content/guides/rgsvc.html
@@ -6951,9 +6951,9 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgsvc_api_BookmarkService"><code>o.a.i.applib.</code><br>
<code>services.bookmark</code><br>
-<code>BookmarkService</code></a></p></td>
+<code>BookmarkService2</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Convert object reference to a serializable "bookmark", and vice versa</p>
+<p>Convert object reference to a serializable "bookmark", and vice versa.</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>BookmarkServiceDefault</code><br>
<code>o.a.i.core</code><br>
@@ -7040,9 +7040,9 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
</tbody>
</table>
<div class="sect2">
-<h3 id="_rgsvc_api_BookmarkService">8.1. <code>BookmarkService</code></h3>
+<h3 id="_rgsvc_api_BookmarkService">8.1. <code>BookmarkService2</code></h3>
<div class="paragraph">
-<p>The <code>BookmarkService</code> provides the ability to obtain a serializable <code>o.a.i.applib.bookmarks.Bookmark</code> for any (persisted) domain object, and to lookup domain objects given a <code>Bookmark</code>. This can then in turn be converted to and from a string.</p>
+<p>The <code>BookmarkService2</code> API (the <code>BookmarkService2</code> subinterface to <code>BookmarkService</code> was introduced in <code>1.12.1-SNAPSHOT</code>) provides the ability to obtain a serializable <code>o.a.i.applib.bookmarks.Bookmark</code> for any (persisted) domain object, and to lookup domain objects given a <code>Bookmark</code>. This can then in turn be converted to and from a string.</p>
</div>
<div class="paragraph">
<p>For example, a <code>Customer</code> object with:</p>
@@ -7097,17 +7097,21 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
<div class="sect3">
<h4 id="_api_implementation_8">8.1.1. API & Implementation</h4>
<div class="paragraph">
-<p>The API defined by <code>BookmarkService</code> is:</p>
+<p>The API defined by <code>BookmarkService2</code> (<code>1.12.1-SNAPSHOT</code>) 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">BookmarkService</span> {
+<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">interface</span> <span class="class">BookmarkService2</span> {
+ <span class="type">enum</span> FieldResetPolicy { <i class="conum" data-value="1"></i><b>(1)</b>
+ RESET,
+ DONT_RESET
+ }
<span class="annotation">@Programmatic</span>
- <span class="predefined-type">Object</span> lookup(BookmarkHolder bookmarkHolder);
+ <span class="predefined-type">Object</span> lookup(BookmarkHolder bookmarkHolder, FieldResetPolicy policy);
<span class="annotation">@Programmatic</span>
- <span class="predefined-type">Object</span> lookup(Bookmark bookmark);
+ <span class="predefined-type">Object</span> lookup(Bookmark bookmark, FieldResetPolicy policy);
<span class="annotation">@Programmatic</span>
- <T> T lookup(Bookmark bookmark, <span class="predefined-type">Class</span><T> cls); <i class="conum" data-value="1"></i><b>(1)</b>
+ <T> T lookup(Bookmark bookmark, FieldResetPolicy policy, <span class="predefined-type">Class</span><T> cls); <i class="conum" data-value="2"></i><b>(2)</b>
<span class="annotation">@Programmatic</span>
Bookmark bookmarkFor(<span class="predefined-type">Object</span> domainObject);
<span class="annotation">@Programmatic</span>
@@ -7119,6 +7123,10 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
<table>
<tr>
<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>(<code>1.12.1-SNAPSHOT</code>) - if the object has already been loaded from the database, then whether to reset its fields. The default it to <code>RESET</code>.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
<td>same as <code>lookup(Bookmark bookmark)</code>, but downcasts to the specified type.</td>
</tr>
</table>
@@ -7158,7 +7166,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
</div>
<div class="listingblock">
<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainObject</span>
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@DomainService</span>(nature=NatureOfService.DOMAIN)
<span class="directive">public</span> <span class="type">class</span> <span class="class">AlwaysHideBookmarkHolderAssociationsObjectProperty</span> {
<span class="annotation">@Subscribe</span>
<span class="directive">public</span> <span class="type">void</span> on(BookmarkHolderAssociationContributions.ObjectDomainEvent ev) {
@@ -10910,7 +10918,7 @@ in the <a href="#_rgsvc_intro_overriding-the-services">introduction</a> to this
</li>
<li><a href="#_rgsvc_integration-api">8. Integration API</a>
<ul class="sectlevel2">
-<li><a href="#_rgsvc_api_BookmarkService">8.1. <code>BookmarkService</code></a>
+<li><a href="#_rgsvc_api_BookmarkService">8.1. <code>BookmarkService2</code></a>
<ul class="sectlevel3">
<li><a href="#_api_implementation_8">8.1.1. API & Implementation</a></li>
<li><a href="#__code_bookmarkholder_code">8.1.2. <code>BookmarkHolder</code></a></li>