Modified: zest/site/content/java/develop/lang-scala.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/lang-scala.html?rev=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/lang-scala.html (original) +++ zest/site/content/java/develop/lang-scala.html Fri Jul 24 21:17:59 2015 @@ -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"><span xmlns="" href="lang-scala.html">Scala Support</span></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 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="Scala Support"><div class="titlepage"><div><div><h3 >class="title"><a id="lang-scala"></a>Scala Support</h3></div></div></div><p >class="remark"><em><span class="comment"></span></em></p><p >class="devstatus-code-b eta">code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-some">tests</p><p>The Scala Support Library allows Fragments and Composites to be written as Scala traits.</p><div class="table"><a id="idm75005098464"></a><p class="title"><strong>Table 24. 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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.lang-scala</p></td><td align="left" valign="top"><p>2.1-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><p>The Scala Support Library is a Generic mixin class that implements Composites by delegating to Scala traits.</p><div class="section" title="C omposition"><div class="titlepage"><div><div><h4 class="title"><a id="_composition_2"></a>Composition</h4></div></div></div><p>Example mixin declaration:</p><pre class="programlisting brush: scala">trait HelloWorldMixin2 + </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"><span xmlns="" href="lang-scala.html">Scala Support</span></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 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="Scala Support"><div class="titlepage"><div><div><h3 >class="title"><a id="lang-scala"></a>Scala Support</h3></div></div></div><p >class="remark"><em><span class="comment"></span></em></p><p >class="devstatus-code-b eta">code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-some">tests</p><p>The Scala Support Library allows Fragments and Composites to be written as Scala traits.</p><div class="table"><a id="idm83805697008"></a><p class="title"><strong>Table 24. 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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.lang-scala</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><p>The Scala Support Library is a Generic mixin class that implements Composites by delegating to Scala traits.</p><div class="section" title="Composition" ><div class="titlepage"><div><div><h4 class="title"><a >id="_composition_2"></a>Composition</h4></div></div></div><p>Example mixin >declaration:</p><pre class="programlisting brush: scala">trait >HelloWorldMixin2 { def sayHello(@MaxLength(10) name: String ): String = "Hello " + name }
Modified: zest/site/content/java/develop/library-alarm.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-alarm.html?rev=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/library-alarm.html (original) +++ zest/site/content/java/develop/library-alarm.html Fri Jul 24 21:17:59 2015 @@ -74,7 +74,7 @@ clear view of what is going on in a plan donât. Very little thought has been spent on what happens when many independent systems interact and what the consequences are to other systems when one fails. The <span class="emphasis"><em>Alarm Point</em></span> concepts becomes a natural fit for the enterprise world of today, where <span class="emphasis"><em>Alarm Points</em></span> allows for fine-grained notification and view into the health of one or more -systems.</p><p>In Zest, we are building upon this powerful abstraction, from decades of field experience.</p><div class="table"><a id="idm75005053536"></a><p class="title"><strong>Table 25. 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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.alarm</p></td><td align="left" valign="top"><p>2.1-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Overview"><div class="titlepage"><div><div><h4 class="title"><a id="_overview_6"></a>Overview</h4></div></div></div><p>An <span class="emphasis"><em>Alarm Point</em></span> is of an <span class="emphasi s"><em>Alarm Class</em></span> and of an <span class="emphasis"><em>Alarm Category</em></span>. The <span class="emphasis"><em>Alarm Class</em></span> defines the <span class="strong"><strong>severity</strong></span> of the +systems.</p><p>In Zest, we are building upon this powerful abstraction, from decades of field experience.</p><div class="table"><a id="idm83805654192"></a><p class="title"><strong>Table 25. 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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.alarm</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Overview"><div class="titlepage"><div><div><h4 class="title"><a id="_overview_6"></a>Overview</h4></div></div></div><p>An <span class="emphasis"><em>Alarm Point</em></span> is of an <span class="emphasis"><em>Alar m Class</em></span> and of an <span class="emphasis"><em>Alarm Category</em></span>. The <span class="emphasis"><em>Alarm Class</em></span> defines the <span class="strong"><strong>severity</strong></span> of the <span class="emphasis"><em>Alarm Point</em></span> and the <span class="emphasis"><em>Alarm Category</em></span> defines which <span class="strong"><strong>part</strong></span> of the system it belongs to. <span class="emphasis"><em>Alarm Category</em></span> can be extended by the developer, and the package contains the <span class="emphasis"><em>SimpleAlarmCategory</em></span> as an example, where a Description property has been added.</p><p>An <span class="emphasis"><em>Alarm Point</em></span> also has a <span class="emphasis"><em>System Name</em></span>, which should be the subsystem or application name.</p><p><span class="emphasis"><em>Alarm Points</em></span> are <span class="strong"><strong>triggered</strong></span> and an <span class="emphasis"><em>Alarm Trigger</em></span> may cause the <span class="emphasis"><em>Alarm Status</em></span> to change. IF, and only if, the Modified: zest/site/content/java/develop/library-circuitbreaker.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-circuitbreaker.html?rev=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/library-circuitbreaker.html (original) +++ zest/site/content/java/develop/library-circuitbreaker.html Fri Jul 24 21:17:59 2015 @@ -91,7 +91,7 @@ tripping it should be possible to expose There is a standard implementation of the Availability interface that delegates to a circuit breaker and the Enabled configuration flag, which is what weâd suspect will be used in most cases where external systems -are invoked.</p><div class="table"><a id="idm75004980768"></a><p class="title"><strong>Table 26. 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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.circuitbreaker</p></td><td align="left" valign="top"><p>2.1-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Direct usage"><div class="titlepage"><div><div><h4 class="title"><a id="_direct_usage"></a>Direct usage</h4></div></div></div><p>The CircuitBreaker can be used directly, even without using anything else from the Zest⢠SDK.</p><p>Here is a code snippet that demonstrate how to creat e a CircuitBreaker and how it behave:</p><pre class="programlisting brush: java">// Create a CircuitBreaker with a threshold of 3, a 250ms timeout, allowing IllegalArgumentExceptions +are invoked.</p><div class="table"><a id="idm83805586192"></a><p class="title"><strong>Table 26. 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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.circuitbreaker</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Direct usage"><div class="titlepage"><div><div><h4 class="title"><a id="_direct_usage"></a>Direct usage</h4></div></div></div><p>The CircuitBreaker can be used directly, even without using anything else from the Zest⢠SDK.</p><p>Here is a code snippet that demonstrate how to create a Circuit Breaker and how it behave:</p><pre class="programlisting brush: java">// Create a CircuitBreaker with a threshold of 3, a 250ms timeout, allowing IllegalArgumentExceptions CircuitBreaker cb = new CircuitBreaker( 3, 250, CircuitBreakers.in( IllegalArgumentException.class ) ); [...snip...] Modified: zest/site/content/java/develop/library-constraints.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-constraints.html?rev=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/library-constraints.html (original) +++ zest/site/content/java/develop/library-constraints.html Fri Jul 24 21:17:59 2015 @@ -69,7 +69,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"><span xmlns="" href="library-constraints.html">Constraints</span></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 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="Constraints"><div class="titlepage"><div><div><h3 >class="title"><a >id="library-constraints"></a>Constraints</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-good">tests</p><p>The Constraints library provide a bunch of often used Constraints based on the Zest⢠Constraints api described in <a class="xref" href="glossary.html#def-constraint">Constraint</a>.</p><p>Remember that you are not limited to constraints presents in this library, you are encouraged to write your own constraints. See <a class="xref" href="howto-create-constraint.html" title="Create a Constraint">Create a Constraint</a> -or take a look at this library source code to learn how to write your own.</p><div class="table"><a id="idm75004938192"></a><p class="title"><strong>Table 27. 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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.constraints</p></td><td align="left" valign="top"><p>2.1-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"></a>Usage</h4></div></div></div><p>You can use theses constraints on Properties or on method arguments. +or take a look at this library source code to learn how to write your own.</p><div class="table"><a id="idm83805529840"></a><p class="title"><strong>Table 27. 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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.constraints</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"></a>Usage</h4></div></div></div><p>You can use theses constraints on Properties or on method arguments. Here are some examples:</p><pre class="programlisting brush: java">import org.qi4j.library.constraints.annotation.*; [...snip...] Modified: zest/site/content/java/develop/library-conversion.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-conversion.html?rev=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/library-conversion.html (original) +++ zest/site/content/java/develop/library-conversion.html Fri Jul 24 21:17:59 2015 @@ -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"><span xmlns="" href="library-conversion.html">Conversion - DEPRECATED</span></span></dt><dt><span class="section"><a href="library-eventsourcing.html">Event Sourcing</a></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="Conversion - DEPRECATED"><div >class="titlepage"><div><div><h3 class="title"><a >id="library-conversion"></a>Conversion - DEPRECATED</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 Conversion Library provides support for converting composite types.</p><div class="table"><a id="idm75004918944"></a><p class="title"><strong>Table 28. 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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.conversion</p></td><td align="left" valign="top"><p>2.1-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="warning" title="DEPRECATED" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">DEPRECATED</h3><p>This fu nctionality is now present in <a class="xref" href="glossary.html#def-unitofwork">UnitOfWork</a> as + </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"><span xmlns="" href="library-conversion.html">Conversion - DEPRECATED</span></span></dt><dt><span class="section"><a href="library-eventsourcing.html">Event Sourcing</a></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="Conversion - DEPRECATED"><div >class="titlepage"><div><div><h3 class="title"><a >id="library-conversion"></a>Conversion - DEPRECATED</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 Conversion Library provides support for converting composite types.</p><div class="table"><a id="idm83805511520"></a><p class="title"><strong>Table 28. 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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.conversion</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="warning" title="DEPRECATED" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">DEPRECATED</h3><p>This functionality is now present in <a class="xref" href="glossary.html#def-unitofwork">UnitOfWork</a> as the two methods toEntity() and toValue(). Since this library was written assocations of all kinds are now fully supported in Values.</p></div><div class="section" title="Entities to Values"><div class="titlepage"><div><div><h4 class="title"><a id="_entities_to_values"></a>Entities to Values</h4></div></div></div><p>To convert Entities to Values, use the EntityToValueService. It is easily assembled:</p><pre class="programlisting brush: java">new EntityToValueAssembler().assemble( module ); </pre><p>Letâs say we have an interface defining state:</p><pre class="programlisting brush: java">public interface PersonState Modified: zest/site/content/java/develop/library-eventsourcing.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-eventsourcing.html?rev=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/library-eventsourcing.html (original) +++ zest/site/content/java/develop/library-eventsourcing.html Fri Jul 24 21:17:59 2015 @@ -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="idm75004869008"></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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.eventsourcing</p></td><td align="left" valign="top"><p>2.1-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="idm75004853888"></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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.eventsourcing-jdbm</p></td><td align="left" valign="top"><p>2.1-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="idm75004838272"></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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.eventsourcing-rest</p></td><td align="left" valign="top"><p>2.1-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Application Ev ents"><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="idm83805464032"></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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.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 backe d 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="idm83805449360"></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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.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="idm83805433856"></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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.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="titl epage"><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=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/library-fileconfig.html (original) +++ zest/site/content/java/develop/library-fileconfig.html Fri Jul 24 21:17:59 2015 @@ -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="idm75004804608"></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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.fileconfig</p></td><td align="left" valign="top"><p>2.1-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_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="idm83805400208"></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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.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"><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 { [...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=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/library-http.html (original) +++ zest/site/content/java/develop/library-http.html Fri Jul 24 21:17:59 2015 @@ -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="idm75004778528"></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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.http</p></td><td align="left" valign="top"><p>2.1-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_eventlistenerservice"></a>C reate 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="idm83805374144"></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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.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 Ev entListenerService</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=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/library-invocation-cache.html (original) +++ zest/site/content/java/develop/library-invocation-cache.html Fri Jul 24 21:17:59 2015 @@ -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="idm75004731888"></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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.invocation-cache</p></td><td align="left" valign="top"><p>2.1-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="idm83805327424"></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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.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="glossary.html#def-co ncern">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=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/library-jmx.html (original) +++ zest/site/content/java/develop/library-jmx.html Fri Jul 24 21:17:59 2015 @@ -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="idm75004686832"></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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.jmx</p></td><td align="left" valign="top"><p>2.1-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="idm83805282384"></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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.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_3"></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=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/library-locking.html (original) +++ zest/site/content/java/develop/library-locking.html Fri Jul 24 21:17:59 2015 @@ -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="idm75004665424"></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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.library.locking</p></td><td align="left" valign="top"><p>2.1-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="idm83805260992"></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.qi4j.library</p></td><td align="left" valign="top"><p>org.qi4j.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
