Modified: zest/site/content/java/develop/library-eventsourcing.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-eventsourcing.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/library-eventsourcing.html (original) +++ zest/site/content/java/develop/library-eventsourcing.html Fri Apr 15 08:28:56 2016 @@ -69,8 +69,8 @@ </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><span xmlns="" href="libraries.html">Libraries</span></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.htm l">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="libraries.html#_overview_5">Overview</a></span></dt><dt><span class="section"><a href="lang-groovy.html">Groovy Scripting</a></span></dt><dt><span class="section"><a href="lang-javascript.html">Javascript Scripting</a></span></dt><dt><span class="section"><a href="lang-scala.html">Scala Support</a></span></dt><dt><span class="section"><a href="library-alarm.html">Alarms</a></span></dt><dt><span class="section"><a href="library-circuitbreaker.html">Circuit Breaker</a></span></dt><dt><span class="section"><a href="library-constraints.html">Constraints</a></span></dt><dt><span class="section"><a href="library-conversion.html">Conversion - DEPRECATED</a></span></dt><dt><span class="section"><span xmlns="" href="library-eventsourcing.html">Event Sourcing</span></span></dt><dt><span c lass="section"><a href="library-fileconfig.html">FileConfig</a></span></dt><dt><span class="section"><a href="library-http.html">HTTP</a></span></dt><dt><span class="section"><a href="library-invocation-cache.html">Invocation Cache</a></span></dt><dt><span class="section"><a href="library-jmx.html">JMX</a></span></dt><dt><span class="section"><a href="library-locking.html">Locking</a></span></dt><dt><span class="section"><a href="library-logging.html">Logging</a></span></dt><dt><span class="section"><a href="library-metrics.html">Metrics Library</a></span></dt><dt><span class="section"><a href="library-osgi.html">OSGi</a></span></dt><dt><span class="section"><a href="library-rdf.html">RDF</a></span></dt><dt><span class="section"><a href="library-rest-client.html">ReST Client</a></span></dt><dt><span class="section"><a href="library-rest-client-primer.html">ReST - HATEOAS Primer</a></span></dt><dt><span class="section"><a href="library-rest-common.html">ReST Common</a></span></dt><dt ><span class="section"><a href="library-rest-server.html">ReST >Server</a></span></dt><dt><span class="section"><a >href="library-scheduler.html">Scheduler</a></span></dt><dt><span >class="section"><a >href="library-servlet.html">Servlet</a></span></dt><dt><span >class="section"><a href="library-shiro.html">Shiro >Security</a></span></dt><dt><span class="section"><a >href="library-shiro-web.html">Shiro Web Security</a></span></dt><dt><span >class="section"><a href="library-spring.html">Spring >Integration</a></span></dt><dt><span class="section"><a >href="library-sql.html">SQL</a></span></dt><dt><span class="section"><a >href="library-uid.html">UID</a></span></dt><dt><span class="section"><a >href="library-uowfile.html">UoWFile</a></span></dt></dl></div></div><div >class="section" title="Event Sourcing"><div class="titlepage"><div><div><h3 >class="title"><a id="library-eventsourcing"></a>Event >Sourcing</h3></div></div></div><p class="remark"><em><span >class="comment"></span></em></p><p class="dev status-code-beta">code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-some">tests</p><p>The Event Sourcing Library supports generating, storing and replaying two types of events: application-events and domain-events.</p><p>Application events are bound to Usecase and are produced by execution of specific methods (ones with <code class="literal">ApplicationEvent</code> as their first parameter). Each application event holds information about Usecase, method name and JSON serialized values of method parameters.</p><p>Domain events are bound to entity instances and are produced by execution of annotated (see <code class="literal">@DomainEvent</code>) methods that belongs to <code class="literal">EntityComposite</code>. Each domain event (see <code class="literal">DomainEventValue</code>) holds information about entity type, identity, method name and JSON serialized values of method parameters.</p><p>Both application and domain events are captured during <code class="literal">UnitOfWork</code> lifetime and are stored in <code class="literal">EventStore</code> after successfully completed <code class="literal">UnitOfWork</code> as collection together (see <code class="literal">UnitOfWorkDomainEventsValue</code> and <code class="literal">TransactionApplicationEvents</code>).</p><p>There is support for replaying events. -When events are replayed the same code is executed but no new events are generated.</p><p>There are helper classes that enables a service to easily track events feed, and for domain events there is <code class="literal">EventRouter</code> that allow to specify specificationâreceiver routes.</p><div class="table"><a id="idm491906227184"></a><p class="title"><strong>Table 29. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.eventsourcing</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><p><span class=" strong"><strong>JDBM backed store</strong></span></p><p>EventStore supports indexed and streamed access to events feed. -There is in-memory and JDBM backed implementations.</p><p class="remark"><em><span class="comment"></span></em></p><p class="devstatus-code-beta">code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-some">tests</p><div class="table"><a id="idm491906212048"></a><p class="title"><strong>Table 30. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.eventsourcing-jdbm</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><p><span class="strong"><strong>REST access</strong></span></p><p>For remote access to feed there is <code class="literal">eventsourcing-rest</code> library that exposes events as Atom feeds.</p><p class="remark"><em><span class="comment"></span></em></p><p class="devstatus-code-beta">code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-some">tests</p><div class="table"><a id="idm491906196432"></a><p class="title"><strong>Table 31. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.eventsourcing-rest</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><div class=" section" title="Application Events"><div class="titlepage"><div><div><h4 class="title"><a id="_application_events"></a>Application Events</h4></div></div></div><p>Assembly is done as follows:</p><pre class="programlisting brush: java">new EventsourcingAssembler() +When events are replayed the same code is executed but no new events are generated.</p><p>There are helper classes that enables a service to easily track events feed, and for domain events there is <code class="literal">EventRouter</code> that allow to specify specificationâreceiver routes.</p><div class="table"><a id="idp140567696637952"></a><p class="title"><strong>Table 29. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.eventsourcing</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><p><span class="strong"> <strong>JDBM backed store</strong></span></p><p>EventStore supports indexed and streamed access to events feed. +There is in-memory and JDBM backed implementations.</p><p class="remark"><em><span class="comment"></span></em></p><p class="devstatus-code-beta">code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-some">tests</p><div class="table"><a id="idp140567696653072"></a><p class="title"><strong>Table 30. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.eventsourcing-jdbm</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><p><span class="strong"><strong>REST access</strong></span></p><p>For remote access to feed there is <code class="literal">eventsourcing-rest</code> library that exposes events as Atom feeds.</p><p class="remark"><em><span class="comment"></span></em></p><p class="devstatus-code-beta">code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-some">tests</p><div class="table"><a id="idp140567696668672"></a><p class="title"><strong>Table 31. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.eventsourcing-rest</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title=" Application Events"><div class="titlepage"><div><div><h4 class="title"><a id="_application_events"></a>Application Events</h4></div></div></div><p>Assembly is done as follows:</p><pre class="programlisting brush: java">new EventsourcingAssembler() .withApplicationEvents() .withCurrentUserFromUOWPrincipal() .assemble(module);
Modified: zest/site/content/java/develop/library-fileconfig.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-fileconfig.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/library-fileconfig.html (original) +++ zest/site/content/java/develop/library-fileconfig.html Fri Apr 15 08:28:56 2016 @@ -66,7 +66,7 @@ })(); </script> - </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><span xmlns="" href="libraries.html">Libraries</span></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.htm l">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="libraries.html#_overview_5">Overview</a></span></dt><dt><span class="section"><a href="lang-groovy.html">Groovy Scripting</a></span></dt><dt><span class="section"><a href="lang-javascript.html">Javascript Scripting</a></span></dt><dt><span class="section"><a href="lang-scala.html">Scala Support</a></span></dt><dt><span class="section"><a href="library-alarm.html">Alarms</a></span></dt><dt><span class="section"><a href="library-circuitbreaker.html">Circuit Breaker</a></span></dt><dt><span class="section"><a href="library-constraints.html">Constraints</a></span></dt><dt><span class="section"><a href="library-conversion.html">Conversion - DEPRECATED</a></span></dt><dt><span class="section"><a href="library-eventsourcing.html">Event Sourcing</a></span></dt><dt><span class="section"> <span xmlns="" href="library-fileconfig.html">FileConfig</span></span></dt><dt><span class="section"><a href="library-http.html">HTTP</a></span></dt><dt><span class="section"><a href="library-invocation-cache.html">Invocation Cache</a></span></dt><dt><span class="section"><a href="library-jmx.html">JMX</a></span></dt><dt><span class="section"><a href="library-locking.html">Locking</a></span></dt><dt><span class="section"><a href="library-logging.html">Logging</a></span></dt><dt><span class="section"><a href="library-metrics.html">Metrics Library</a></span></dt><dt><span class="section"><a href="library-osgi.html">OSGi</a></span></dt><dt><span class="section"><a href="library-rdf.html">RDF</a></span></dt><dt><span class="section"><a href="library-rest-client.html">ReST Client</a></span></dt><dt><span class="section"><a href="library-rest-client-primer.html">ReST - HATEOAS Primer</a></span></dt><dt><span class="section"><a href="library-rest-common.html">ReST Common</a></span></dt><dt ><span class="section"><a href="library-rest-server.html">ReST >Server</a></span></dt><dt><span class="section"><a >href="library-scheduler.html">Scheduler</a></span></dt><dt><span >class="section"><a >href="library-servlet.html">Servlet</a></span></dt><dt><span >class="section"><a href="library-shiro.html">Shiro >Security</a></span></dt><dt><span class="section"><a >href="library-shiro-web.html">Shiro Web Security</a></span></dt><dt><span >class="section"><a href="library-spring.html">Spring >Integration</a></span></dt><dt><span class="section"><a >href="library-sql.html">SQL</a></span></dt><dt><span class="section"><a >href="library-uid.html">UID</a></span></dt><dt><span class="section"><a >href="library-uowfile.html">UoWFile</a></span></dt></dl></div></div><div >class="section" title="FileConfig"><div class="titlepage"><div><div><h3 >class="title"><a >id="library-fileconfig"></a>FileConfig</h3></div></div></div><p >class="remark"><em><span class="comment"></span></em></p><p >class="devstatus-code -stable">code</p><p class="devstatus-docs-good">docs</p><p class="devstatus-tests-good">tests</p><p>The FileConfig library provide a service for accessing application-specific directories.</p><p>A lot of the Zest⢠Libraries and Extensions make use of this library to locate files.</p><div class="table"><a id="idm491906162768"></a><p class="title"><strong>Table 32. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.fileconfig</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Us age"><div class="titlepage"><div><div><h4 class="title"><a id="_usage_2"></a>Usage</h4></div></div></div><pre class="programlisting brush: java">public interface FileConfiguration + </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><span xmlns="" href="libraries.html">Libraries</span></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.htm l">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="libraries.html#_overview_5">Overview</a></span></dt><dt><span class="section"><a href="lang-groovy.html">Groovy Scripting</a></span></dt><dt><span class="section"><a href="lang-javascript.html">Javascript Scripting</a></span></dt><dt><span class="section"><a href="lang-scala.html">Scala Support</a></span></dt><dt><span class="section"><a href="library-alarm.html">Alarms</a></span></dt><dt><span class="section"><a href="library-circuitbreaker.html">Circuit Breaker</a></span></dt><dt><span class="section"><a href="library-constraints.html">Constraints</a></span></dt><dt><span class="section"><a href="library-conversion.html">Conversion - DEPRECATED</a></span></dt><dt><span class="section"><a href="library-eventsourcing.html">Event Sourcing</a></span></dt><dt><span class="section"> <span xmlns="" href="library-fileconfig.html">FileConfig</span></span></dt><dt><span class="section"><a href="library-http.html">HTTP</a></span></dt><dt><span class="section"><a href="library-invocation-cache.html">Invocation Cache</a></span></dt><dt><span class="section"><a href="library-jmx.html">JMX</a></span></dt><dt><span class="section"><a href="library-locking.html">Locking</a></span></dt><dt><span class="section"><a href="library-logging.html">Logging</a></span></dt><dt><span class="section"><a href="library-metrics.html">Metrics Library</a></span></dt><dt><span class="section"><a href="library-osgi.html">OSGi</a></span></dt><dt><span class="section"><a href="library-rdf.html">RDF</a></span></dt><dt><span class="section"><a href="library-rest-client.html">ReST Client</a></span></dt><dt><span class="section"><a href="library-rest-client-primer.html">ReST - HATEOAS Primer</a></span></dt><dt><span class="section"><a href="library-rest-common.html">ReST Common</a></span></dt><dt ><span class="section"><a href="library-rest-server.html">ReST >Server</a></span></dt><dt><span class="section"><a >href="library-scheduler.html">Scheduler</a></span></dt><dt><span >class="section"><a >href="library-servlet.html">Servlet</a></span></dt><dt><span >class="section"><a href="library-shiro.html">Shiro >Security</a></span></dt><dt><span class="section"><a >href="library-shiro-web.html">Shiro Web Security</a></span></dt><dt><span >class="section"><a href="library-spring.html">Spring >Integration</a></span></dt><dt><span class="section"><a >href="library-sql.html">SQL</a></span></dt><dt><span class="section"><a >href="library-uid.html">UID</a></span></dt><dt><span class="section"><a >href="library-uowfile.html">UoWFile</a></span></dt></dl></div></div><div >class="section" title="FileConfig"><div class="titlepage"><div><div><h3 >class="title"><a >id="library-fileconfig"></a>FileConfig</h3></div></div></div><p >class="remark"><em><span class="comment"></span></em></p><p >class="devstatus-code -stable">code</p><p class="devstatus-docs-good">docs</p><p class="devstatus-tests-good">tests</p><p>The FileConfig library provide a service for accessing application-specific directories.</p><p>A lot of the Zest⢠Libraries and Extensions make use of this library to locate files.</p><div class="table"><a id="idp140567696702288"></a><p class="title"><strong>Table 32. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.fileconfig</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Usage"><di v class="titlepage"><div><div><h4 class="title"><a id="_usage_3"></a>Usage</h4></div></div></div><pre class="programlisting brush: java">public interface FileConfiguration { [...snip...] Modified: zest/site/content/java/develop/library-http.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-http.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/library-http.html (original) +++ zest/site/content/java/develop/library-http.html Fri Apr 15 08:28:56 2016 @@ -68,7 +68,7 @@ </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><span xmlns="" href="libraries.html">Libraries</span></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.htm l">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="libraries.html#_overview_5">Overview</a></span></dt><dt><span class="section"><a href="lang-groovy.html">Groovy Scripting</a></span></dt><dt><span class="section"><a href="lang-javascript.html">Javascript Scripting</a></span></dt><dt><span class="section"><a href="lang-scala.html">Scala Support</a></span></dt><dt><span class="section"><a href="library-alarm.html">Alarms</a></span></dt><dt><span class="section"><a href="library-circuitbreaker.html">Circuit Breaker</a></span></dt><dt><span class="section"><a href="library-constraints.html">Constraints</a></span></dt><dt><span class="section"><a href="library-conversion.html">Conversion - DEPRECATED</a></span></dt><dt><span class="section"><a href="library-eventsourcing.html">Event Sourcing</a></span></dt><dt><span class="section"> <a href="library-fileconfig.html">FileConfig</a></span></dt><dt><span class="section"><span xmlns="" href="library-http.html">HTTP</span></span></dt><dt><span class="section"><a href="library-invocation-cache.html">Invocation Cache</a></span></dt><dt><span class="section"><a href="library-jmx.html">JMX</a></span></dt><dt><span class="section"><a href="library-locking.html">Locking</a></span></dt><dt><span class="section"><a href="library-logging.html">Logging</a></span></dt><dt><span class="section"><a href="library-metrics.html">Metrics Library</a></span></dt><dt><span class="section"><a href="library-osgi.html">OSGi</a></span></dt><dt><span class="section"><a href="library-rdf.html">RDF</a></span></dt><dt><span class="section"><a href="library-rest-client.html">ReST Client</a></span></dt><dt><span class="section"><a href="library-rest-client-primer.html">ReST - HATEOAS Primer</a></span></dt><dt><span class="section"><a href="library-rest-common.html">ReST Common</a></span></dt><dt ><span class="section"><a href="library-rest-server.html">ReST >Server</a></span></dt><dt><span class="section"><a >href="library-scheduler.html">Scheduler</a></span></dt><dt><span >class="section"><a >href="library-servlet.html">Servlet</a></span></dt><dt><span >class="section"><a href="library-shiro.html">Shiro >Security</a></span></dt><dt><span class="section"><a >href="library-shiro-web.html">Shiro Web Security</a></span></dt><dt><span >class="section"><a href="library-spring.html">Spring >Integration</a></span></dt><dt><span class="section"><a >href="library-sql.html">SQL</a></span></dt><dt><span class="section"><a >href="library-uid.html">UID</a></span></dt><dt><span class="section"><a >href="library-uowfile.html">UoWFile</a></span></dt></dl></div></div><div >class="section" title="HTTP"><div class="titlepage"><div><div><h3 >class="title"><a id="library-http"></a>HTTP</h3></div></div></div><p >class="remark"><em><span class="comment"></span></em></p><p >class="devstatus-code-stable">code</p>< p class="devstatus-docs-good">docs</p><p class="devstatus-tests-good">tests</p><p>The HTTP library provides a Jetty based embedded HTTP service with support for easy event listeners, servlets and filters assembly as Services.</p><p>Itâs an easy way to embedd a servlet container and reuse everything that can be run in it (JAX-*, Restlet, Wicket, -Vaadin, GWT etc..). If instead you want to run a Zest⢠Application in a servlet container, see <a class="xref" href="library-servlet.html" title="Servlet">Servlet Library</a>.</p><div class="table"><a id="idm491906136656"></a><p class="title"><strong>Table 33. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.http</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Create an EventListenerService"><div class="titlepage"><div><div><h4 class="title"><a id="_create_an_eventlistene rservice"></a>Create an EventListenerService</h4></div></div></div><p>EventListeners in HttpService are assembled as Services, so one have to declare a ServiceComposite like this:</p><pre class="programlisting brush: java">@Mixins( FooServletContextListener.class ) +Vaadin, GWT etc..). If instead you want to run a Zest⢠Application in a servlet container, see <a class="xref" href="library-servlet.html" title="Servlet">Servlet Library</a>.</p><div class="table"><a id="idp140567696728432"></a><p class="title"><strong>Table 33. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.http</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Create an EventListenerService"><div class="titlepage"><div><div><h4 class="title"><a id="_create_an_eventlistenerservice "></a>Create an EventListenerService</h4></div></div></div><p>EventListeners in HttpService are assembled as Services, so one have to declare a ServiceComposite like this:</p><pre class="programlisting brush: java">@Mixins( FooServletContextListener.class ) public interface FooServletContextListenerService extends ServletContextListener, ServiceComposite { Modified: zest/site/content/java/develop/library-invocation-cache.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-invocation-cache.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/library-invocation-cache.html (original) +++ zest/site/content/java/develop/library-invocation-cache.html Fri Apr 15 08:28:56 2016 @@ -67,7 +67,7 @@ </script> </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><span xmlns="" href="libraries.html">Libraries</span></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.htm l">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="libraries.html#_overview_5">Overview</a></span></dt><dt><span class="section"><a href="lang-groovy.html">Groovy Scripting</a></span></dt><dt><span class="section"><a href="lang-javascript.html">Javascript Scripting</a></span></dt><dt><span class="section"><a href="lang-scala.html">Scala Support</a></span></dt><dt><span class="section"><a href="library-alarm.html">Alarms</a></span></dt><dt><span class="section"><a href="library-circuitbreaker.html">Circuit Breaker</a></span></dt><dt><span class="section"><a href="library-constraints.html">Constraints</a></span></dt><dt><span class="section"><a href="library-conversion.html">Conversion - DEPRECATED</a></span></dt><dt><span class="section"><a href="library-eventsourcing.html">Event Sourcing</a></span></dt><dt><span class="section"> <a href="library-fileconfig.html">FileConfig</a></span></dt><dt><span class="section"><a href="library-http.html">HTTP</a></span></dt><dt><span class="section"><span xmlns="" href="library-invocation-cache.html">Invocation Cache</span></span></dt><dt><span class="section"><a href="library-jmx.html">JMX</a></span></dt><dt><span class="section"><a href="library-locking.html">Locking</a></span></dt><dt><span class="section"><a href="library-logging.html">Logging</a></span></dt><dt><span class="section"><a href="library-metrics.html">Metrics Library</a></span></dt><dt><span class="section"><a href="library-osgi.html">OSGi</a></span></dt><dt><span class="section"><a href="library-rdf.html">RDF</a></span></dt><dt><span class="section"><a href="library-rest-client.html">ReST Client</a></span></dt><dt><span class="section"><a href="library-rest-client-primer.html">ReST - HATEOAS Primer</a></span></dt><dt><span class="section"><a href="library-rest-common.html">ReST Common</a></span></dt><dt ><span class="section"><a href="library-rest-server.html">ReST >Server</a></span></dt><dt><span class="section"><a >href="library-scheduler.html">Scheduler</a></span></dt><dt><span >class="section"><a >href="library-servlet.html">Servlet</a></span></dt><dt><span >class="section"><a href="library-shiro.html">Shiro >Security</a></span></dt><dt><span class="section"><a >href="library-shiro-web.html">Shiro Web Security</a></span></dt><dt><span >class="section"><a href="library-spring.html">Spring >Integration</a></span></dt><dt><span class="section"><a >href="library-sql.html">SQL</a></span></dt><dt><span class="section"><a >href="library-uid.html">UID</a></span></dt><dt><span class="section"><a >href="library-uowfile.html">UoWFile</a></span></dt></dl></div></div><div >class="section" title="Invocation Cache"><div class="titlepage"><div><div><h3 >class="title"><a id="library-invocation-cache"></a>Invocation >Cache</h3></div></div></div><p class="remark"><em><span >class="comment"></span></em></p><p cla ss="devstatus-code-stable">code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-none">tests</p><p>The Invocation Cache Library provides constructs to easily cache the return value of -method invocations on composites.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>It has nothing to do with the <a class="xref" href="core-spi.html#core-spi-cache" title="Cache SPI">Cache SPI</a>.</p></div><div class="table"><a id="idm491906089888"></a><p class="title"><strong>Table 34. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.invocation-cache</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><p>By applying one of the <a class="link" href="glossary.html#def-concern">Concerns</a> it is possible to cache the return values of method +method invocations on composites.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>It has nothing to do with the <a class="xref" href="core-spi.html#core-spi-cache" title="Cache SPI">Cache SPI</a>.</p></div><div class="table"><a id="idp140567696775056"></a><p class="title"><strong>Table 34. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.invocation-cache</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><p>By applying one of the <a class="link" href="gl ossary.html#def-concern">Concerns</a> it is possible to cache the return values of method calls. The concern will in turn delegate to the <code class="literal">InvocationCache</code> that is expected to be a <a class="xref" href="glossary.html#def-private-mixin">Private Mixin</a> in the same composite.</p><div class="section" title="@Cached"><div class="titlepage"><div><div><h4 class="title"><a id="_literal_cached_literal"></a><code class="literal">@Cached</code></h4></div></div></div><p>This annotation is used to mark the methods that should be considered for caching. Only if a caching concern has been defined and that an <code class="literal">InvocationCache</code> implementation mixin has been provided Modified: zest/site/content/java/develop/library-jmx.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-jmx.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/library-jmx.html (original) +++ zest/site/content/java/develop/library-jmx.html Fri Apr 15 08:28:56 2016 @@ -68,7 +68,7 @@ </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><span xmlns="" href="libraries.html">Libraries</span></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.htm l">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="libraries.html#_overview_5">Overview</a></span></dt><dt><span class="section"><a href="lang-groovy.html">Groovy Scripting</a></span></dt><dt><span class="section"><a href="lang-javascript.html">Javascript Scripting</a></span></dt><dt><span class="section"><a href="lang-scala.html">Scala Support</a></span></dt><dt><span class="section"><a href="library-alarm.html">Alarms</a></span></dt><dt><span class="section"><a href="library-circuitbreaker.html">Circuit Breaker</a></span></dt><dt><span class="section"><a href="library-constraints.html">Constraints</a></span></dt><dt><span class="section"><a href="library-conversion.html">Conversion - DEPRECATED</a></span></dt><dt><span class="section"><a href="library-eventsourcing.html">Event Sourcing</a></span></dt><dt><span class="section"> <a href="library-fileconfig.html">FileConfig</a></span></dt><dt><span class="section"><a href="library-http.html">HTTP</a></span></dt><dt><span class="section"><a href="library-invocation-cache.html">Invocation Cache</a></span></dt><dt><span class="section"><span xmlns="" href="library-jmx.html">JMX</span></span></dt><dt><span class="section"><a href="library-locking.html">Locking</a></span></dt><dt><span class="section"><a href="library-logging.html">Logging</a></span></dt><dt><span class="section"><a href="library-metrics.html">Metrics Library</a></span></dt><dt><span class="section"><a href="library-osgi.html">OSGi</a></span></dt><dt><span class="section"><a href="library-rdf.html">RDF</a></span></dt><dt><span class="section"><a href="library-rest-client.html">ReST Client</a></span></dt><dt><span class="section"><a href="library-rest-client-primer.html">ReST - HATEOAS Primer</a></span></dt><dt><span class="section"><a href="library-rest-common.html">ReST Common</a></span></dt><dt ><span class="section"><a href="library-rest-server.html">ReST >Server</a></span></dt><dt><span class="section"><a >href="library-scheduler.html">Scheduler</a></span></dt><dt><span >class="section"><a >href="library-servlet.html">Servlet</a></span></dt><dt><span >class="section"><a href="library-shiro.html">Shiro >Security</a></span></dt><dt><span class="section"><a >href="library-shiro-web.html">Shiro Web Security</a></span></dt><dt><span >class="section"><a href="library-spring.html">Spring >Integration</a></span></dt><dt><span class="section"><a >href="library-sql.html">SQL</a></span></dt><dt><span class="section"><a >href="library-uid.html">UID</a></span></dt><dt><span class="section"><a >href="library-uowfile.html">UoWFile</a></span></dt></dl></div></div><div >class="section" title="JMX"><div class="titlepage"><div><div><h3 >class="title"><a id="library-jmx"></a>JMX</h3></div></div></div><p >class="remark"><em><span class="comment"></span></em></p><p >class="devstatus-code-stable">code</p><p c lass="devstatus-docs-brief">docs</p><p class="devstatus-tests-some">tests</p><p>The JMX library provides a service that exposes a Zest⢠app in JMX automatically, giving you an opportunity to inspect the app much as -you would with the <a class="xref" href="tools-envisage.html" title="Envisage">Envisage Tool</a> tool.</p><div class="table"><a id="idm491906044832"></a><p class="title"><strong>Table 35. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.jmx</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Usage"><div class="titlepage"><div><div><h4 class="title"><a id="_usage_3"></a>Usage</h4></div></div></div><pre class="programlisting brush: java"> +you would with the <a class="xref" href="tools-envisage.html" title="Envisage">Envisage Tool</a> tool.</p><div class="table"><a id="idp140567696819936"></a><p class="title"><strong>Table 35. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.jmx</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Usage"><div class="titlepage"><div><div><h4 class="title"><a id="_usage_4"></a>Usage</h4></div></div></div><pre class="programlisting brush: java"> public void assemble( ModuleAssembly module ) throws AssemblyException { Modified: zest/site/content/java/develop/library-locking.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-locking.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/library-locking.html (original) +++ zest/site/content/java/develop/library-locking.html Fri Apr 15 08:28:56 2016 @@ -67,7 +67,7 @@ </script> </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><span xmlns="" href="libraries.html">Libraries</span></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.htm l">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="libraries.html#_overview_5">Overview</a></span></dt><dt><span class="section"><a href="lang-groovy.html">Groovy Scripting</a></span></dt><dt><span class="section"><a href="lang-javascript.html">Javascript Scripting</a></span></dt><dt><span class="section"><a href="lang-scala.html">Scala Support</a></span></dt><dt><span class="section"><a href="library-alarm.html">Alarms</a></span></dt><dt><span class="section"><a href="library-circuitbreaker.html">Circuit Breaker</a></span></dt><dt><span class="section"><a href="library-constraints.html">Constraints</a></span></dt><dt><span class="section"><a href="library-conversion.html">Conversion - DEPRECATED</a></span></dt><dt><span class="section"><a href="library-eventsourcing.html">Event Sourcing</a></span></dt><dt><span class="section"> <a href="library-fileconfig.html">FileConfig</a></span></dt><dt><span class="section"><a href="library-http.html">HTTP</a></span></dt><dt><span class="section"><a href="library-invocation-cache.html">Invocation Cache</a></span></dt><dt><span class="section"><a href="library-jmx.html">JMX</a></span></dt><dt><span class="section"><span xmlns="" href="library-locking.html">Locking</span></span></dt><dt><span class="section"><a href="library-logging.html">Logging</a></span></dt><dt><span class="section"><a href="library-metrics.html">Metrics Library</a></span></dt><dt><span class="section"><a href="library-osgi.html">OSGi</a></span></dt><dt><span class="section"><a href="library-rdf.html">RDF</a></span></dt><dt><span class="section"><a href="library-rest-client.html">ReST Client</a></span></dt><dt><span class="section"><a href="library-rest-client-primer.html">ReST - HATEOAS Primer</a></span></dt><dt><span class="section"><a href="library-rest-common.html">ReST Common</a></span></dt><dt ><span class="section"><a href="library-rest-server.html">ReST >Server</a></span></dt><dt><span class="section"><a >href="library-scheduler.html">Scheduler</a></span></dt><dt><span >class="section"><a >href="library-servlet.html">Servlet</a></span></dt><dt><span >class="section"><a href="library-shiro.html">Shiro >Security</a></span></dt><dt><span class="section"><a >href="library-shiro-web.html">Shiro Web Security</a></span></dt><dt><span >class="section"><a href="library-spring.html">Spring >Integration</a></span></dt><dt><span class="section"><a >href="library-sql.html">SQL</a></span></dt><dt><span class="section"><a >href="library-uid.html">UID</a></span></dt><dt><span class="section"><a >href="library-uowfile.html">UoWFile</a></span></dt></dl></div></div><div >class="section" title="Locking"><div class="titlepage"><div><div><h3 >class="title"><a id="library-locking"></a>Locking</h3></div></div></div><p >class="remark"><em><span class="comment"></span></em></p><p >class="devstatus-code-stable"> code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-some">tests</p><p>The Locking Library is a simple way to mark method with Read or Write locks, and the details is handled by this -library.</p><p>This library is heavily used in EntityStore implementations.</p><div class="table"><a id="idm491906023424"></a><p class="title"><strong>Table 36. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.locking</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><p>The library creates a <code class="literal">java.util.concurrent.ReentrantReadWriteLock</code> which is shared for all methods within the +library.</p><p>This library is heavily used in EntityStore implementations.</p><div class="table"><a id="idp140567696841280"></a><p class="title"><strong>Table 36. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.locking</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><p>The library creates a <code class="literal">java.util.concurrent.ReentrantReadWriteLock</code> which is shared for all methods within the composite. It then acquires the read or write lock in a concern that is applied to the methods of the composite, which have the corresponding annotations.</p><div class="section" title="@ReadLock"><div class="titlepage"><div><div><h4 class="title"><a id="_literal_readlock_literal"></a><code class="literal">@ReadLock</code></h4></div></div></div><p>This annotation will apply the <code class="literal">ReadLockConcern</code> to the method, and acquire the <code class="literal">lock.readLock()</code> on entry and relase it on exit of the method. See the <code class="literal">ReentrantReadWriteLock</code> for details on how/when to use it and the exact semantics.</p></div><div class="section" title="@WriteLock"><div class="titlepage"><div><div><h4 class="title"><a id="_literal_writelock_literal"></a><code class="literal">@WriteLock</code></h4></div></div></div><p>This annotation will apply the <code class="literal">WriteLockConcern</code> to the method, and acquire the <code class="literal">lock.writeLock()</code> on entry and relase Modified: zest/site/content/java/develop/library-logging.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-logging.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/library-logging.html (original) +++ zest/site/content/java/develop/library-logging.html Fri Apr 15 08:28:56 2016 @@ -83,7 +83,7 @@ not only different, but if not handled p to turning off whole or parts of the domain logging by mistake. We want to avoid this, and instead crystalize the needs for each scenario and audience.</p><p>Another drastic difference from previous frameworks is that we donât have an Appender notion. All messages are entities which are stored in a configured entity store. This means that especially the domain log can be more easily be given a -user interface suitable for the domain, without complex parsing of message strings</p><div class="table"><a id="idm491905983648"></a><p class="title"><strong>Table 37. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.logging</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Logging"><div class="titlepage"><div><div><h4 class="title"><a id="_logging"></a>Logging</h4></div></div></div><p>Logging is still not finalized and will need a lot more thought before considered done.</p></d iv><div class="section" title="Debugging"><div class="titlepage"><div><div><h4 class="title"><a id="_debugging"></a>Debugging</h4></div></div></div><p>To produce debugging output in your code you just need to add the field</p><pre class="programlisting brush: java">@Optional @This Debug debug; +user interface suitable for the domain, without complex parsing of message strings</p><div class="table"><a id="idp140567696880896"></a><p class="title"><strong>Table 37. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.logging</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Logging"><div class="titlepage"><div><div><h4 class="title"><a id="_logging"></a>Logging</h4></div></div></div><p>Logging is still not finalized and will need a lot more thought before considered done.</p></div><div class="section" title="Debugging"><div class="titlepage"><div><div><h4 class="title"><a id="_debugging"></a>Debugging</h4></div></div></div><p>To produce debugging output in your code you just need to add the field</p><pre class="programlisting brush: java">@Optional @This Debug debug; </pre><p>and then check for null at each usage</p><pre class="programlisting brush: java">if( debug != null ) { debug.debug( Debug.NORMAL, "Debugging is made easier." ); Modified: zest/site/content/java/develop/library-metrics.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-metrics.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/library-metrics.html (original) +++ zest/site/content/java/develop/library-metrics.html Fri Apr 15 08:28:56 2016 @@ -68,7 +68,7 @@ </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><span xmlns="" href="libraries.html">Libraries</span></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.htm l">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="libraries.html#_overview_5">Overview</a></span></dt><dt><span class="section"><a href="lang-groovy.html">Groovy Scripting</a></span></dt><dt><span class="section"><a href="lang-javascript.html">Javascript Scripting</a></span></dt><dt><span class="section"><a href="lang-scala.html">Scala Support</a></span></dt><dt><span class="section"><a href="library-alarm.html">Alarms</a></span></dt><dt><span class="section"><a href="library-circuitbreaker.html">Circuit Breaker</a></span></dt><dt><span class="section"><a href="library-constraints.html">Constraints</a></span></dt><dt><span class="section"><a href="library-conversion.html">Conversion - DEPRECATED</a></span></dt><dt><span class="section"><a href="library-eventsourcing.html">Event Sourcing</a></span></dt><dt><span class="section"> <a href="library-fileconfig.html">FileConfig</a></span></dt><dt><span class="section"><a href="library-http.html">HTTP</a></span></dt><dt><span class="section"><a href="library-invocation-cache.html">Invocation Cache</a></span></dt><dt><span class="section"><a href="library-jmx.html">JMX</a></span></dt><dt><span class="section"><a href="library-locking.html">Locking</a></span></dt><dt><span class="section"><a href="library-logging.html">Logging</a></span></dt><dt><span class="section"><span xmlns="" href="library-metrics.html">Metrics Library</span></span></dt><dt><span class="section"><a href="library-osgi.html">OSGi</a></span></dt><dt><span class="section"><a href="library-rdf.html">RDF</a></span></dt><dt><span class="section"><a href="library-rest-client.html">ReST Client</a></span></dt><dt><span class="section"><a href="library-rest-client-primer.html">ReST - HATEOAS Primer</a></span></dt><dt><span class="section"><a href="library-rest-common.html">ReST Common</a></span></dt><dt ><span class="section"><a href="library-rest-server.html">ReST >Server</a></span></dt><dt><span class="section"><a >href="library-scheduler.html">Scheduler</a></span></dt><dt><span >class="section"><a >href="library-servlet.html">Servlet</a></span></dt><dt><span >class="section"><a href="library-shiro.html">Shiro >Security</a></span></dt><dt><span class="section"><a >href="library-shiro-web.html">Shiro Web Security</a></span></dt><dt><span >class="section"><a href="library-spring.html">Spring >Integration</a></span></dt><dt><span class="section"><a >href="library-sql.html">SQL</a></span></dt><dt><span class="section"><a >href="library-uid.html">UID</a></span></dt><dt><span class="section"><a >href="library-uowfile.html">UoWFile</a></span></dt></dl></div></div><div >class="section" title="Metrics Library"><div class="titlepage"><div><div><h3 >class="title"><a id="library-metrics"></a>Metrics >Library</h3></div></div></div><p>The Metrics library is available to >application code to get production met rics from their applications. It allows applications to easily mark critical section for metrics gathering, without handling the details with the Metrics -Extension.</p><div class="table"><a id="idm491905953760"></a><p class="title"><strong>Table 38. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.metrics</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Usage"><div class="titlepage"><div><div><h4 class="title"><a id="_usage_4"></a>Usage</h4></div></div></div><p>There are currently the following possibilities available;</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> +Extension.</p><div class="table"><a id="idp140567696910720"></a><p class="title"><strong>Table 38. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.metrics</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Usage"><div class="titlepage"><div><div><h4 class="title"><a id="_usage_5"></a>Usage</h4></div></div></div><p>There are currently the following possibilities available;</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> @TimingCapture - capture timing on a single method </li><li class="listitem"> TimingCaptureAll - capture timing on all methods of a composite Modified: zest/site/content/java/develop/library-osgi.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-osgi.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/library-osgi.html (original) +++ zest/site/content/java/develop/library-osgi.html Fri Apr 15 08:28:56 2016 @@ -67,7 +67,7 @@ </script> </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><span xmlns="" href="libraries.html">Libraries</span></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.htm l">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="libraries.html#_overview_5">Overview</a></span></dt><dt><span class="section"><a href="lang-groovy.html">Groovy Scripting</a></span></dt><dt><span class="section"><a href="lang-javascript.html">Javascript Scripting</a></span></dt><dt><span class="section"><a href="lang-scala.html">Scala Support</a></span></dt><dt><span class="section"><a href="library-alarm.html">Alarms</a></span></dt><dt><span class="section"><a href="library-circuitbreaker.html">Circuit Breaker</a></span></dt><dt><span class="section"><a href="library-constraints.html">Constraints</a></span></dt><dt><span class="section"><a href="library-conversion.html">Conversion - DEPRECATED</a></span></dt><dt><span class="section"><a href="library-eventsourcing.html">Event Sourcing</a></span></dt><dt><span class="section"> <a href="library-fileconfig.html">FileConfig</a></span></dt><dt><span class="section"><a href="library-http.html">HTTP</a></span></dt><dt><span class="section"><a href="library-invocation-cache.html">Invocation Cache</a></span></dt><dt><span class="section"><a href="library-jmx.html">JMX</a></span></dt><dt><span class="section"><a href="library-locking.html">Locking</a></span></dt><dt><span class="section"><a href="library-logging.html">Logging</a></span></dt><dt><span class="section"><a href="library-metrics.html">Metrics Library</a></span></dt><dt><span class="section"><span xmlns="" href="library-osgi.html">OSGi</span></span></dt><dt><span class="section"><a href="library-rdf.html">RDF</a></span></dt><dt><span class="section"><a href="library-rest-client.html">ReST Client</a></span></dt><dt><span class="section"><a href="library-rest-client-primer.html">ReST - HATEOAS Primer</a></span></dt><dt><span class="section"><a href="library-rest-common.html">ReST Common</a></span></dt><dt ><span class="section"><a href="library-rest-server.html">ReST >Server</a></span></dt><dt><span class="section"><a >href="library-scheduler.html">Scheduler</a></span></dt><dt><span >class="section"><a >href="library-servlet.html">Servlet</a></span></dt><dt><span >class="section"><a href="library-shiro.html">Shiro >Security</a></span></dt><dt><span class="section"><a >href="library-shiro-web.html">Shiro Web Security</a></span></dt><dt><span >class="section"><a href="library-spring.html">Spring >Integration</a></span></dt><dt><span class="section"><a >href="library-sql.html">SQL</a></span></dt><dt><span class="section"><a >href="library-uid.html">UID</a></span></dt><dt><span class="section"><a >href="library-uowfile.html">UoWFile</a></span></dt></dl></div></div><div >class="section" title="OSGi"><div class="titlepage"><div><div><h3 >class="title"><a id="library-osgi"></a>OSGi</h3></div></div></div><p >class="remark"><em><span class="comment"></span></em></p><p >class="devstatus-code-stable">code</p>< p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-some">tests</p><p>OSGi Library allows you to import OSGi services as Zest⢠Services and to export Zest⢠Services as OSGi Services both -leveraging the Zest⢠Availability and OSGi FallbackStrategy mechanisms.</p><div class="table"><a id="idm491905920544"></a><p class="title"><strong>Table 39. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.osgi</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Export Zest⢠services to an OSGi Bundle"><div class="titlepage"><div><div><h4 class="title"><a id="_export_zest_services_to_an_osgi_bundle"></a>Export Zest⢠services to an OSGi Bundle</h4></div></div></div>< pre class="programlisting brush: java">interface MyZestService +leveraging the Zest⢠Availability and OSGi FallbackStrategy mechanisms.</p><div class="table"><a id="idp140567696943824"></a><p class="title"><strong>Table 39. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.osgi</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Export Zest⢠services to an OSGi Bundle"><div class="titlepage"><div><div><h4 class="title"><a id="_export_zest_services_to_an_osgi_bundle"></a>Export Zest⢠services to an OSGi Bundle</h4></div></div></div><pre clas s="programlisting brush: java">interface MyZestService extends OSGiEnabledService { // ... Modified: zest/site/content/java/develop/library-rdf.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-rdf.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/library-rdf.html (original) +++ zest/site/content/java/develop/library-rdf.html Fri Apr 15 08:28:56 2016 @@ -66,7 +66,7 @@ })(); </script> - </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><span xmlns="" href="libraries.html">Libraries</span></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.htm l">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="libraries.html#_overview_5">Overview</a></span></dt><dt><span class="section"><a href="lang-groovy.html">Groovy Scripting</a></span></dt><dt><span class="section"><a href="lang-javascript.html">Javascript Scripting</a></span></dt><dt><span class="section"><a href="lang-scala.html">Scala Support</a></span></dt><dt><span class="section"><a href="library-alarm.html">Alarms</a></span></dt><dt><span class="section"><a href="library-circuitbreaker.html">Circuit Breaker</a></span></dt><dt><span class="section"><a href="library-constraints.html">Constraints</a></span></dt><dt><span class="section"><a href="library-conversion.html">Conversion - DEPRECATED</a></span></dt><dt><span class="section"><a href="library-eventsourcing.html">Event Sourcing</a></span></dt><dt><span class="section"> <a href="library-fileconfig.html">FileConfig</a></span></dt><dt><span class="section"><a href="library-http.html">HTTP</a></span></dt><dt><span class="section"><a href="library-invocation-cache.html">Invocation Cache</a></span></dt><dt><span class="section"><a href="library-jmx.html">JMX</a></span></dt><dt><span class="section"><a href="library-locking.html">Locking</a></span></dt><dt><span class="section"><a href="library-logging.html">Logging</a></span></dt><dt><span class="section"><a href="library-metrics.html">Metrics Library</a></span></dt><dt><span class="section"><a href="library-osgi.html">OSGi</a></span></dt><dt><span class="section"><span xmlns="" href="library-rdf.html">RDF</span></span></dt><dt><span class="section"><a href="library-rest-client.html">ReST Client</a></span></dt><dt><span class="section"><a href="library-rest-client-primer.html">ReST - HATEOAS Primer</a></span></dt><dt><span class="section"><a href="library-rest-common.html">ReST Common</a></span></dt><dt ><span class="section"><a href="library-rest-server.html">ReST >Server</a></span></dt><dt><span class="section"><a >href="library-scheduler.html">Scheduler</a></span></dt><dt><span >class="section"><a >href="library-servlet.html">Servlet</a></span></dt><dt><span >class="section"><a href="library-shiro.html">Shiro >Security</a></span></dt><dt><span class="section"><a >href="library-shiro-web.html">Shiro Web Security</a></span></dt><dt><span >class="section"><a href="library-spring.html">Spring >Integration</a></span></dt><dt><span class="section"><a >href="library-sql.html">SQL</a></span></dt><dt><span class="section"><a >href="library-uid.html">UID</a></span></dt><dt><span class="section"><a >href="library-uowfile.html">UoWFile</a></span></dt></dl></div></div><div >class="section" title="RDF"><div class="titlepage"><div><div><h3 >class="title"><a id="library-rdf"></a>RDF</h3></div></div></div><p >class="remark"><em><span class="comment"></span></em></p><p >class="devstatus-code-stable">code</p><p c lass="devstatus-docs-none">docs</p><p class="devstatus-tests-some">tests</p><p>RDF Library</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This Library has no documentation yet. Learn how to contribute in <a class="xref" href="community-docs.html" title="Writing Zest⢠Documentation">Writing Documentation</a>.</p></div><div class="table"><a id="idm491905897888"></a><p class="title"><strong>Table 40. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.rdf</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p> </td></tr></tbody></table></div></div><br class="table-break" /></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="footer"><p> + </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><span xmlns="" href="libraries.html">Libraries</span></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.htm l">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="libraries.html#_overview_5">Overview</a></span></dt><dt><span class="section"><a href="lang-groovy.html">Groovy Scripting</a></span></dt><dt><span class="section"><a href="lang-javascript.html">Javascript Scripting</a></span></dt><dt><span class="section"><a href="lang-scala.html">Scala Support</a></span></dt><dt><span class="section"><a href="library-alarm.html">Alarms</a></span></dt><dt><span class="section"><a href="library-circuitbreaker.html">Circuit Breaker</a></span></dt><dt><span class="section"><a href="library-constraints.html">Constraints</a></span></dt><dt><span class="section"><a href="library-conversion.html">Conversion - DEPRECATED</a></span></dt><dt><span class="section"><a href="library-eventsourcing.html">Event Sourcing</a></span></dt><dt><span class="section"> <a href="library-fileconfig.html">FileConfig</a></span></dt><dt><span class="section"><a href="library-http.html">HTTP</a></span></dt><dt><span class="section"><a href="library-invocation-cache.html">Invocation Cache</a></span></dt><dt><span class="section"><a href="library-jmx.html">JMX</a></span></dt><dt><span class="section"><a href="library-locking.html">Locking</a></span></dt><dt><span class="section"><a href="library-logging.html">Logging</a></span></dt><dt><span class="section"><a href="library-metrics.html">Metrics Library</a></span></dt><dt><span class="section"><a href="library-osgi.html">OSGi</a></span></dt><dt><span class="section"><span xmlns="" href="library-rdf.html">RDF</span></span></dt><dt><span class="section"><a href="library-rest-client.html">ReST Client</a></span></dt><dt><span class="section"><a href="library-rest-client-primer.html">ReST - HATEOAS Primer</a></span></dt><dt><span class="section"><a href="library-rest-common.html">ReST Common</a></span></dt><dt ><span class="section"><a href="library-rest-server.html">ReST >Server</a></span></dt><dt><span class="section"><a >href="library-scheduler.html">Scheduler</a></span></dt><dt><span >class="section"><a >href="library-servlet.html">Servlet</a></span></dt><dt><span >class="section"><a href="library-shiro.html">Shiro >Security</a></span></dt><dt><span class="section"><a >href="library-shiro-web.html">Shiro Web Security</a></span></dt><dt><span >class="section"><a href="library-spring.html">Spring >Integration</a></span></dt><dt><span class="section"><a >href="library-sql.html">SQL</a></span></dt><dt><span class="section"><a >href="library-uid.html">UID</a></span></dt><dt><span class="section"><a >href="library-uowfile.html">UoWFile</a></span></dt></dl></div></div><div >class="section" title="RDF"><div class="titlepage"><div><div><h3 >class="title"><a id="library-rdf"></a>RDF</h3></div></div></div><p >class="remark"><em><span class="comment"></span></em></p><p >class="devstatus-code-stable">code</p><p c lass="devstatus-docs-none">docs</p><p class="devstatus-tests-some">tests</p><p>RDF Library</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This Library has no documentation yet. Learn how to contribute in <a class="xref" href="community-docs.html" title="Writing Zest⢠Documentation">Writing Documentation</a>.</p></div><div class="table"><a id="idp140567696966512"></a><p class="title"><strong>Table 40. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.rdf</p></td><td align="left" valign="top"><p>0</p></td></t r></tbody></table></div></div><br class="table-break" /></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="footer"><p> Copyright © 2015 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/"; target="_blank">Apache License, Version 2.0</a>. <br /><small> Apache Zest, Zest, Apache, the Apache feather logo, and the Apache Zest project logo are trademarks of The Apache Software Foundation.<br /> Modified: zest/site/content/java/develop/library-rest-client.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-rest-client.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/library-rest-client.html (original) +++ zest/site/content/java/develop/library-rest-client.html Fri Apr 15 08:28:56 2016 @@ -68,13 +68,13 @@ </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><span xmlns="" href="libraries.html">Libraries</span></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.htm l">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="libraries.html#_overview_5">Overview</a></span></dt><dt><span class="section"><a href="lang-groovy.html">Groovy Scripting</a></span></dt><dt><span class="section"><a href="lang-javascript.html">Javascript Scripting</a></span></dt><dt><span class="section"><a href="lang-scala.html">Scala Support</a></span></dt><dt><span class="section"><a href="library-alarm.html">Alarms</a></span></dt><dt><span class="section"><a href="library-circuitbreaker.html">Circuit Breaker</a></span></dt><dt><span class="section"><a href="library-constraints.html">Constraints</a></span></dt><dt><span class="section"><a href="library-conversion.html">Conversion - DEPRECATED</a></span></dt><dt><span class="section"><a href="library-eventsourcing.html">Event Sourcing</a></span></dt><dt><span class="section"> <a href="library-fileconfig.html">FileConfig</a></span></dt><dt><span class="section"><a href="library-http.html">HTTP</a></span></dt><dt><span class="section"><a href="library-invocation-cache.html">Invocation Cache</a></span></dt><dt><span class="section"><a href="library-jmx.html">JMX</a></span></dt><dt><span class="section"><a href="library-locking.html">Locking</a></span></dt><dt><span class="section"><a href="library-logging.html">Logging</a></span></dt><dt><span class="section"><a href="library-metrics.html">Metrics Library</a></span></dt><dt><span class="section"><a href="library-osgi.html">OSGi</a></span></dt><dt><span class="section"><a href="library-rdf.html">RDF</a></span></dt><dt><span class="section"><span xmlns="" href="library-rest-client.html">ReST Client</span></span></dt><dt><span class="section"><a href="library-rest-client-primer.html">ReST - HATEOAS Primer</a></span></dt><dt><span class="section"><a href="library-rest-common.html">ReST Common</a></span></dt><dt ><span class="section"><a href="library-rest-server.html">ReST >Server</a></span></dt><dt><span class="section"><a >href="library-scheduler.html">Scheduler</a></span></dt><dt><span >class="section"><a >href="library-servlet.html">Servlet</a></span></dt><dt><span >class="section"><a href="library-shiro.html">Shiro >Security</a></span></dt><dt><span class="section"><a >href="library-shiro-web.html">Shiro Web Security</a></span></dt><dt><span >class="section"><a href="library-spring.html">Spring >Integration</a></span></dt><dt><span class="section"><a >href="library-sql.html">SQL</a></span></dt><dt><span class="section"><a >href="library-uid.html">UID</a></span></dt><dt><span class="section"><a >href="library-uowfile.html">UoWFile</a></span></dt></dl></div></div><div >class="section" title="ReST Client"><div class="titlepage"><div><div><h3 >class="title"><a id="library-rest-client"></a>ReST >Client</h3></div></div></div><p class="remark"><em><span >class="comment"></span></em></p><p class="devstatus-c ode-stable">code</p><p class="devstatus-docs-good">docs</p><p class="devstatus-tests-some">tests</p><p>Rickard sent a very interesting <a class="xref" href="library-rest-client-primer.html" title="ReST - HATEOAS Primer"> HATEOAS Primer</a> to the mailing list in October 2011, as the starting point for the renovation of the ReST Client Library. You should read that to get the full background on the choices -made in this library.</p><div class="table"><a id="idm491905881152"></a><p class="title"><strong>Table 41. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.rest-client</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Usage"><div class="titlepage"><div><div><h4 class="title"><a id="_usage_5"></a>Usage</h4></div></div></div><p>This library leverages the <a class="ulink" href="http://restlet.org"; target="_top">Restlet library</a>, so keep its documentation nearby as well.</p><p>Th is library expects the client code to build up handlers on how to react to resources and errors. +made in this library.</p><div class="table"><a id="idp140567696983152"></a><p class="title"><strong>Table 41. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.rest-client</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Usage"><div class="titlepage"><div><div><h4 class="title"><a id="_usage_6"></a>Usage</h4></div></div></div><p>This library leverages the <a class="ulink" href="http://restlet.org"; target="_top">Restlet library</a>, so keep its documentation nearby as well.</p><p>This libra ry expects the client code to build up handlers on how to react to resources and errors. It is a more declarative approach than a typical ReST client application, which often isnât HATEOAS at all, and <a class="ulink" href="http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven"; target="_top">Roy Fielding is upset that ReST now means something else</a> than it was originally intended. We try to be true to Dr. Fieldingâs intentions.</p><div class="section" title="Establish Client"><div class="titlepage"><div><div><h5 class="title"><a id="_establish_client"></a>Establish Client</h5></div></div></div><p>The first thing that must be done is to create a ContextResourceClient. Letâs walk through the different steps typically needed.</p><pre class="programlisting brush: java">Client client = new Client( Protocol.HTTP ); -ContextResourceClientFactory contextResourceClientFactory = module.newObject( ContextResourceClientFactory.class, client ); +ContextResourceClientFactory contextResourceClientFactory = objectFactory.newObject( ContextResourceClientFactory.class, client ); contextResourceClientFactory.setAcceptedMediaTypes( MediaType.APPLICATION_JSON ); </pre><p>Above we create the Client instance and a ContextResourceClientFactory, which takes a client via @Uses annotation. We also set the accepted media type to JSON.</p><p>We then create the global handler, which will be set to all ContextResourceClient instances that this factory creates.</p><pre class="programlisting brush: java">contextResourceClientFactory.setErrorHandler( new ErrorHandler().onError( ErrorHandler.AUTHENTICATION_REQUIRED, new ResponseHandler() @@ -139,7 +139,7 @@ crc.start(); @Override public HandlerCommand handleResult( TestQuery result, ContextResourceClient client ) { - ValueBuilder<TestQuery> builder = module.newValueBuilderWithPrototype( result ); + ValueBuilder<TestQuery> builder = valueBuilderFactory.newValueBuilderWithPrototype( result ); builder.prototype().abc().set( "abc" + builder.prototype().abc().get() );
