Modified: zest/site/content/java/develop/library-spring.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-spring.html?rev=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/library-spring.html (original) +++ zest/site/content/java/develop/library-spring.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"> <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="s ection"><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"><span xmlns="" href="library-spring.html">Spring Integration</span></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="Spring Integration"><div class="titlepage"><div><div><h3 class="title"><a id="library-spring"></a>Spring Integration</h3></div></div></div><p class="remark"><em><span class="comment"></span></em></p><p class="de vstatus-code-beta">code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-some">tests</p><div class="table"><a id="idm75004215568"></a><p class="title"><strong>Table 48. 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.spring</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="Using Spring Framework in Apache Zestâ¢"><div class="titlepage"><div><div><h4 class="title"><a id="_using_spring_framework_in_apache_zest"></a>Using Spring Framework in Apache Zestâ¢</h4></div>< /div></div><p>Zest⢠supports that Spring Application Context is imported into the Zest⢠runtime, and the declared Spring + </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"><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="s ection"><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"><span xmlns="" href="library-spring.html">Spring Integration</span></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="Spring Integration"><div class="titlepage"><div><div><h3 class="title"><a id="library-spring"></a>Spring Integration</h3></div></div></div><p class="remark"><em><span class="comment"></span></em></p><p class="de vstatus-code-beta">code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-some">tests</p><div class="table"><a id="idm83804827632"></a><p class="title"><strong>Table 48. 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.spring</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Using Spring Framework in Apache Zestâ¢"><div class="titlepage"><div><div><h4 class="title"><a id="_using_spring_framework_in_apache_zest"></a>Using Spring Framework in Apache Zestâ¢</h4></div></div></div> <p>Zest⢠supports that Spring Application Context is imported into the Zest⢠runtime, and the declared Spring beans will be available as Zest⢠services. The most important things to remember are;</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"> Only Spring Singletons are currently supported. </li><li class="listitem">
Modified: zest/site/content/java/develop/library-sql.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-sql.html?rev=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/library-sql.html (original) +++ zest/site/content/java/develop/library-sql.html Fri Jul 24 21:17:59 2015 @@ -69,19 +69,19 @@ </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"><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="s ection"><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"><span xmlns="" href="library-sql.html">SQL</span></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="SQL"><div class="titlepage"><div><div><h3 class="title"><a id="library-sql"></a>SQL</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-good">docs</p><p class="devstatus-tests-good">tests</p><p>The SQL Library provides facilities for working with SQL databases.</p><p>The center piece is the DataSource support that comes with <a class="xref" href="library-circuitbreaker.html" title="Circuit Breaker">Circuit Breaker Library</a> and <a class="xref" href="library-jmx.html" title="JMX"> JMX Library</a> support. Facilities for doing SQL I/O with the <a class="xref" href="core-io.html" title="Core I/O API">I/O API</a> are provided.</p><div class="tip" title="Tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>See the <a class="xref" href="sample-sql-support.html" title="SQL Support Sample">SQL Support Sample</a> that demonstrate combined use of <a class="xref" href="library-sql.html" title="SQL">SQL Library</a>, <a class="xref" href="extension-es-sql.html" title="SQL EntityStore"> SQL EntityStore</a> and <a class="xref" href="extension-indexing-sql.html" title="SQL Index/Query">SQL Index/Query</a>.</p></div><p>Moreover, supplementary libraries helps dealing with different connection pool implementations and schema migrations. -None of theses libraries depends on an actual JDBC driver, you are free to use the one that suits your needs.</p><div class="table"><a id="idm75004169584"></a><p class="title"><strong>Table 49. 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.sql</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="DataSource and connection pools"><div class="titlepage"><div><div><h4 class="title"><a id="_datasource_and_connection_pools"></a>DataSource and connection pools</h4></div></div></div><p>DataSource sup port comes in three flavors:</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> +None of theses libraries depends on an actual JDBC driver, you are free to use the one that suits your needs.</p><div class="table"><a id="idm83804781664"></a><p class="title"><strong>Table 49. 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.sql</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="DataSource and connection pools"><div class="titlepage"><div><div><h4 class="title"><a id="_datasource_and_connection_pools"></a>DataSource and connection pools</h4></div></div></div><p>DataSource support comes in three flavors:</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> using the <a class="ulink" href="http://jolbox.com/"; target="_top">BoneCP</a> connection pool </li><li class="listitem"> using the <a class="ulink" href="http://commons.apache.org/dbcp/"; target="_top">Apache DBCP</a> connection pool </li><li class="listitem"> importing an existing DataSource provided at assembly time -</li></ul></div><div class="section" title="Connection Pools"><div class="titlepage"><div><div><h5 class="title"><a id="_connection_pools"></a>Connection Pools</h5></div></div></div><p>Connection Pools support is provided by supplementary libraries.</p><p><span class="strong"><strong>BoneCP</strong></span></p><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><div class="table"><a id="idm75004147856"></a><p class="title"><strong>Table 50. 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.sql-bonecp</p></td><td align="left" valign="top"><p>2.1-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><p>BoneCP support resides in the <span class="strong"><strong>sql-bonecp</strong></span> module.</p><pre class="programlisting brush: java">// Assemble the BoneCP based Service Importer +</li></ul></div><div class="section" title="Connection Pools"><div class="titlepage"><div><div><h5 class="title"><a id="_connection_pools"></a>Connection Pools</h5></div></div></div><p>Connection Pools support is provided by supplementary libraries.</p><p><span class="strong"><strong>BoneCP</strong></span></p><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><div class="table"><a id="idm83804759952"></a><p class="title"><strong>Table 50. 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.sql-bonecp</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><p>BoneCP support resides in the <span class="strong"><strong>sql-bonecp</strong></span> module.</p><pre class="programlisting brush: java">// Assemble the BoneCP based Service Importer new BoneCPDataSourceServiceAssembler(). identifiedBy( DS_SERVICE_ID ). visibleIn( Visibility.module ). withConfig( config, Visibility.layer ). assemble( module ); -</pre><p><span class="strong"><strong>Apache DBCP</strong></span></p><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><div class="table"><a id="idm75004130448"></a><p class="title"><strong>Table 51. 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.sql-dbcp</p></td><td align="left" valign="top"><p>2.1-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><pre class="programlisting brush: java">// Assemble the Apache DBCP based Service Impo rter +</pre><p><span class="strong"><strong>Apache DBCP</strong></span></p><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><div class="table"><a id="idm83804742720"></a><p class="title"><strong>Table 51. 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.sql-dbcp</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><pre class="programlisting brush: java">// Assemble the Apache DBCP based Service Importer new DBCPDataSourceServiceAssembler(). identifiedBy( DS_SERVICE_ID ). visibleIn( Visibility.module ). @@ -172,7 +172,7 @@ Inputs.iterable( rows ).transferTo( Outp through JMX.</p><pre class="programlisting brush: java">new DataSourceJMXAssembler().visibleIn( Visibility.module ).assemble( module ); </pre><p>Every DataSource visible from the DataSourceConfigurationManager Service will get its Configuration available using a JMX client.</p><p>Note that the JMX support does not apply to existing DataSource imported as -described above.</p></div><div class="section" title="Schema migration"><div class="titlepage"><div><div><h4 class="title"><a id="_schema_migration"></a>Schema migration</h4></div></div></div><p>Database schema migration can be delegated to <a class="ulink" href="http://www.liquibase.org/"; target="_top">Liquibase</a>.</p><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><div class="table"><a id="idm75004086480"></a><p class="title"><strong>Table 52. 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="l eft" valign="top"><p>org.qi4j.library.sql-liquibase</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>Assembly</strong></span></p><pre class="programlisting brush: java">new LiquibaseAssembler(). +described above.</p></div><div class="section" title="Schema migration"><div class="titlepage"><div><div><h4 class="title"><a id="_schema_migration"></a>Schema migration</h4></div></div></div><p>Database schema migration can be delegated to <a class="ulink" href="http://www.liquibase.org/"; target="_top">Liquibase</a>.</p><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><div class="table"><a id="idm83804698768"></a><p class="title"><strong>Table 52. 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="l eft" valign="top"><p>org.qi4j.library.sql-liquibase</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>Assembly</strong></span></p><pre class="programlisting brush: java">new LiquibaseAssembler(). withConfig( configModule, Visibility.layer ). assemble( module ); </pre><p>The LiquibaseService is activated on Application startup and if enabled it Modified: zest/site/content/java/develop/library-uid.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-uid.html?rev=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/library-uid.html (original) +++ zest/site/content/java/develop/library-uid.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"> <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="s ection"><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"><span xmlns="" href="library-uid.html">UID</span></span></dt><dt><span class="section"><a href="library-uowfile.html">UoWFile</a></span></dt></dl></div></div><div class="section" title="UID"><div class="titlepage"><div><div><h3 class="title"><a id="library-uid"></a>UID</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-good">docs</p><p class="devstatus-tests-good">tests</p><p>This library provides Services to easily generate unique identifiers and sequences of numbers.</p><div class="table"><a id="idm75004063664"></a><p class="title"><strong>Table 53. 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.uid</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="Unique Identifiers"><div class="titlepage"><div><div><h4 class="title"><a id="_unique_identifiers"></a>Unique Identifiers</h4></div></di v></div><p>Assembly is done using the provided Assembler:</p><pre class="programlisting brush: java">new UuidServiceAssembler().visibleIn( layer ).assemble( moduleAssembly ); + </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"><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="s ection"><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"><span xmlns="" href="library-uid.html">UID</span></span></dt><dt><span class="section"><a href="library-uowfile.html">UoWFile</a></span></dt></dl></div></div><div class="section" title="UID"><div class="titlepage"><div><div><h3 class="title"><a id="library-uid"></a>UID</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-good">docs</p><p class="devstatus-tests-good">tests</p><p>This library provides Services to easily generate unique identifiers and sequences of numbers.</p><div class="table"><a id="idm83804675936"></a><p class="title"><strong>Table 53. 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.uid</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Unique Identifiers"><div class="titlepage"><div><div><h4 class="title"><a id="_unique_identifiers"></a>Unique Identifiers</h4></div></div></div><p> Assembly is done using the provided Assembler:</p><pre class="programlisting brush: java">new UuidServiceAssembler().visibleIn( layer ).assemble( moduleAssembly ); </pre><p>Usage is quite simple:</p><pre class="programlisting brush: java">@Service UuidService uuidService; public void doSomething() Modified: zest/site/content/java/develop/library-uowfile.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-uowfile.html?rev=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/library-uowfile.html (original) +++ zest/site/content/java/develop/library-uowfile.html Fri Jul 24 21:17:59 2015 @@ -71,7 +71,7 @@ Composites, mostly EntityComposites, so to files are discarded too. Concurrent modifications are properly handled.</p><p>Note that it has a performance impact relative to the files size as it duplicates the file to keep a backup for eventual rollback. However, the API provides a way to get non-managed handles on the attached files to keep your -read-only operations fast.</p><p>The location of files is left to the developer using a private mixin.</p><div class="table"><a id="idm75004028160"></a><p class="title"><strong>Table 54. 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.uowfile</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="Logging"><div class="titlepage"><div><div><h4 class="title"><a id="_logging_5"></a>Logging</h4></div></div></div><p>The SLF4J Logger used by this library is named "org.qi4j.library.uowfile".</p></div><di v class="section" title="Add an attached file to an Entity"><div class="titlepage"><div><div><h4 class="title"><a id="_add_an_attached_file_to_an_entity"></a>Add an attached file to an Entity</h4></div></div></div><p>Letâs say you have the following Entity:</p><pre class="programlisting brush: java">public interface TestedEntity +read-only operations fast.</p><p>The location of files is left to the developer using a private mixin.</p><div class="table"><a id="idm83804640448"></a><p class="title"><strong>Table 54. 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.uowfile</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_5"></a>Logging</h4></div></div></div><p>The SLF4J Logger used by this library is named "org.qi4j.library.uowfile".</p></div><div class="se ction" title="Add an attached file to an Entity"><div class="titlepage"><div><div><h4 class="title"><a id="_add_an_attached_file_to_an_entity"></a>Add an attached file to an Entity</h4></div></div></div><p>Letâs say you have the following Entity:</p><pre class="programlisting brush: java">public interface TestedEntity [...snip...] { Modified: zest/site/content/java/develop/releasing-apache.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/releasing-apache.html?rev=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/releasing-apache.html (original) +++ zest/site/content/java/develop/releasing-apache.html Fri Jul 24 21:17:59 2015 @@ -68,10 +68,11 @@ </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"><span xmlns="" href="tutorials.html">Tutorials</span></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"><a href="libraries.html">Libraries</a></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="tutorials.html#_overview">Overview</a></span></dt><dt><span class="section"><a href="two-minutes-intro.html">Zest⢠in 2 minutes</a></span></dt><dt><span class="section"><a href="ten-minutes-intro.html">Zest⢠in 10 minutes</a></span></dt><dt><span class="section"><a href="thirty-minutes-intro.html">Zest⢠in 30 minutes</a></span></dt><dt><span class="section"><a href="two-hours-intro.html">Zest⢠in 2 hours</a></span></dt><dt><span class="section"><a href="howto-depend-on-zest.html">Depend on Zest⢠in your build</a></span></dt><dt><span class="section"><a href="howto-assemble-application.html">Assemble an Application</a></span></dt><dt><span class="section"><a href="tut-composites.html">Transient Composites Tutorial</a></span></dt><dt><span class="section"> <a href="tut-services.html">Services Composites Tutorial</a></span></dt><dt><span class="section"><a href="howto-contextual-fragments.html">Use contextual fragments</a></span></dt><dt><span class="section"><a href="howto-leverage-properties.html">Leverage Properties</a></span></dt><dt><span class="section"><a href="howto-create-constraint.html">Create a Constraint</a></span></dt><dt><span class="section"><a href="howto-create-concern.html">Create a Concern</a></span></dt><dt><span class="section"><a href="howto-create-sideeffect.html">Create a SideEffect</a></span></dt><dt><span class="section"><a href="howto-create-entity.html">Create an Entity</a></span></dt><dt><span class="section"><a href="howto-configure-service.html">Configure a Service</a></span></dt><dt><span class="section"><a href="howto-invocation-annotation.html">Use @Invocation</a></span></dt><dt><span class="section"><a href="howto-use-io.html">Use I/O API</a></span></dt><dt><span class="section"><a href="build-system .html">Zest⢠Build System</a></span></dt><dt><span class="section"><a href="community-docs.html">Writing Zest⢠Documentation</a></span></dt><dt><span class="section"><span xmlns="" href="releasing-apache.html">Releasing Zestâ¢</span></span></dt></dl></div></div><div class="section" title="Releasing Zestâ¢"><div class="titlepage"><div><div><h3 class="title"><a id="releasing-apache"></a>Releasing Zestâ¢</h3></div></div></div><p>This tutorial is intended for Apache Zest⢠commiters who want to release a new version of Apache Zest⢠(Java Edition) at The Apache Software Foundation. It describes the tools and processes of a typical release.</p><p>It is intended to be a recommendation of best practices for the Apache Zest⢠project. -The instructions provided here are consistent with, but not a replacement for the <a class="ulink" href="https://www.apache.org/dev/release.html"; target="_top">ASF Release Guidelines</a>.</p><p>Before going further you obviously should have read the <a class="link" href="build-system.html" title="Zest⢠Build System">Build System</a> tutorial and already built Zest⢠from source, signing included.</p><div class="section" title="Preparing a release"><div class="titlepage"><div><div><h4 class="title"><a id="_preparing_a_release"></a>Preparing a release</h4></div></div></div><div class="section" title="Select a Release Manager"><div class="titlepage"><div><div><h5 class="title"><a id="_select_a_release_manager"></a>Select a Release Manager</h5></div></div></div><p>A Zest committer (normally one of the development team) should post an email to the development list proposing that a release be made and nominating a release manager. +The instructions provided here are consistent with, but not a replacement for the <a class="ulink" href="https://www.apache.org/dev/release.html"; target="_top">ASF Release Guidelines</a>.</p><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>You need a unix-like environment to actually perform the release process. +This tutorial is known to work on Linux and Mac.</p></div><p>Before going further you obviously should have read the <a class="link" href="build-system.html" title="Zest⢠Build System">Build System</a> tutorial and already built Zest⢠from source, signing included.</p><div class="section" title="Preparing a release"><div class="titlepage"><div><div><h4 class="title"><a id="_preparing_a_release"></a>Preparing a release</h4></div></div></div><div class="section" title="Select a Release Manager"><div class="titlepage"><div><div><h5 class="title"><a id="_select_a_release_manager"></a>Select a Release Manager</h5></div></div></div><p>A Zest committer (normally one of the development team) should post an email to the development list proposing that a release be made and nominating a release manager. Typically, the proposer volunteers as the release manager and it passes by <a class="ulink" href="https://www.apache.org/foundation/glossary.html#LazyConsensus"; target="_top">lazy consensus</a>.</p></div><div class="section" title="Clone/Checkout all repositories"><div class="titlepage"><div><div><h5 class="title"><a id="_clone_checkout_all_repositories"></a>Clone/Checkout all repositories</h5></div></div></div><p>Clone/checkout all needed repositories, next to each other:</p><pre class="programlisting brush: shell">mkdir zest-repos cd zest-repos -git clone https://git-wip-us.apache.org/repos/asf/zest-qi4j.git zest-java +git clone https://git-wip-us.apache.org/repos/asf/zest-java.git zest-java svn checkout https://svn.apache.org/repos/asf/zest/ zest-svn svn checkout https://dist.apache.org/repos/dist/dev/zest/ zest-dist-dev svn checkout https://dist.apache.org/repos/dist/release/zest/ zest-dist-release</pre><p>You should then get the following directory tree:</p><pre class="programlisting brush: text">. @@ -98,14 +99,33 @@ marking them as <code class="literal">IN changing their fix version to another unreleased version </li></ul></div><p>See the <a class="ulink" href="https://issues.apache.org/jira/browse/ZEST"; target="_top">ZEST</a> project on JIRA.</p></div><div class="section" title="Prepare Release-Notes"><div class="titlepage"><div><div><h5 class="title"><a id="_prepare_release_notes"></a>Prepare Release-Notes</h5></div></div></div><p>Apache Zest⢠release-notes are generated from JIRA issues.</p><p>Open the target Zest⢠versionâs release-notes in <a class="ulink" href="https://issues.apache.org/jira/browse/ZEST/?selectedTab=com.atlassian.jira.jira-projects-plugin:roadmap-panel"; target="_top">JIRA</a> and review them.</p><p>JIRA can produces release-notes as HTML or plain-text. Set it up to generate plain-text release-notes.</p><p>We will need these in several formats. -Starting from the plain-text one we will generate the others.</p><p>First save the text-plain release-notes in a file named <code class="literal">apache-zest-java-<RELEASE-VERSION>-release-notes.txt</code>.</p><p>Convert to Asciidoc:</p><pre class="programlisting brush: shell">cat apache-zest-java-<RELEASE-VERSION>-release-notes.txt | \ +Starting from the plain-text one we will generate the others.</p><p>First save the text-plain release-notes in a file named <code class="literal">apache-zest-java-<RELEASE-VERSION>-release-notes.txt</code>. +A good place for this file would be in the <code class="literal">zest-repos</code> directory created earlier, alongside all repositories.</p><p>Convert to Asciidoc:</p><pre class="programlisting brush: shell">cat apache-zest-java-<RELEASE-VERSION>-release-notes.txt | \ sed -e "s/* \[ZEST-\([0-9]\)*\]/- https:\/\/issues.apache.org\/jira\/browse\/ZEST-\1[ZEST-\1]/" | \ sed -e "s/^\*\*/===/" > apache-zest-java-<RELEASE-VERSION>-release-notes.adoc</pre><p>Convert to Markdown:</p><pre class="programlisting brush: shell">cat apache-zest-java-<RELEASE-VERSION>-release-notes.txt | \ sed -e "s/* \[ZEST-\([0-9]\)*\]/- [ZEST-\1](https:\/\/issues.apache.org\/jira\/browse\/ZEST-\1)/" | \ sed -e "s/^\*\*/###/" > apache-zest-java-<RELEASE-VERSION>-release-notes.md</pre><p>You should then have the two following files:</p><pre class="programlisting brush: shell">. âââ apache-zest-java-<RELEASE-VERSION>-release-notes.txt âââ apache-zest-java-<RELEASE-VERSION>-release-notes.adoc -âââ apache-zest-java-<RELEASE-VERSION>-release-notes.md</pre><p>We will use them later.</p></div><div class="section" title="Create a RC branch"><div class="titlepage"><div><div><h5 class="title"><a id="_create_a_rc_branch"></a>Create a RC branch</h5></div></div></div><p>We use <code class="literal"><RELEASE-VERSION>-RC#</code> where <code class="literal">RELEASE-VERSION</code> is the target release version and <code class="literal">RC#</code> for Release Candidate and an incremental number in case the release process has to be done several times.</p><pre class="programlisting brush: shell">git flow release start <RELEASE-VERSION>-RC#</pre><p>This will eventually generates a <code class="literal"><RELEASE-VERSION>-RC#</code> tag that we will rename to <code class="literal"><RELEASE-VERSION></code> if the vote passes, see below.</p></div><div class="section" title="Build and audit distributions"><div class="titlepage"><div><div><h5 class=" title"><a id="_build_and_audit_distributions"></a>Build and audit distributions</h5></div></div></div><p>Make a complete build:</p><pre class="programlisting brush: shell">./gradlew -Dversion=<RELEASE-VERSION> clean check buildAll checkDists</pre><p>Review the release distributions in <code class="literal">build/distributions</code>.</p><p>If any, make the required changes, commit them and iterate.</p></div><div class="section" title="Close the RC branch"><div class="titlepage"><div><div><h5 class="title"><a id="_close_the_rc_branch"></a>Close the RC branch</h5></div></div></div><p>Once you are satisfied with the produced artifacts, close the release candidate branch:</p><pre class="programlisting brush: shell">git flow release finish <RELEASE-VERSION>-RC#</pre></div><div class="section" title="Checkout the RC tag"><div class="titlepage"><div><div><h5 class="title"><a id="_checkout_the_rc_tag"></a>Checkout the RC tag</h5></div></div></div><p>To build the release candidat e bits, we need to checkout the release candidate tag, that will eventually be promoted as a signed release tag, because the Apache Zest⢠build system generates versionning information based on git metadata.</p><pre class="programlisting brush: shell">git checkout <RELEASE-VERSION>-RC#</pre></div><div class="section" title="Build RC artifacts and distributions"><div class="titlepage"><div><div><h5 class="title"><a id="_build_rc_artifacts_and_distributions"></a>Build RC artifacts and distributions</h5></div></div></div><pre class="programlisting brush: shell">./gradlew -Dversion=<RELEASE-VERSION> clean check buildAll checkDists</pre></div><div class="section" title="Stage RC maven artifacts"><div class="titlepage"><div><div><h5 class="title"><a id="_stage_rc_maven_artifacts"></a>Stage RC maven artifacts</h5></div></div></div><p>Stage artifacts to <a class="ulink" href="https://repository.apache.org/"; target="_top">repository.apache.org</a> :</p><pre class="programlis ting brush: shell">./gradlew -Dversion=<RELEASE-VERSION> uploadArchives</pre><p>Close the staging Nexus repository by following the <a class="ulink" href="https://www.apache.org/dev/publishing-maven-artifacts.html#close-stage"; target="_top">Closing the staged repository</a> guide.</p></div><div class="section" title="Upload RC distributions"><div class="titlepage"><div><div><h5 class="title"><a id="_upload_rc_distributions"></a>Upload RC distributions</h5></div></div></div><p>Upload source and binary distributions, checksums and signatures to <a class="ulink" href="https://dist.apache.org/repos/dist/dev/zest/"; target="_top">dist.apache.org/repos/dist/dev/zest</a>:</p><pre class="programlisting brush: shell">cp zest-java/build/distributions/* zest-dist-dev/ +âââ apache-zest-java-<RELEASE-VERSION>-release-notes.md</pre><p>We will use them later.</p></div><div class="section" title="Create a RC branch"><div class="titlepage"><div><div><h5 class="title"><a id="_create_a_rc_branch"></a>Create a RC branch</h5></div></div></div><p>We use <code class="literal"><RELEASE-VERSION>-RC#</code> where <code class="literal">RELEASE-VERSION</code> is the target release version and <code class="literal">RC#</code> for Release Candidate and an incremental number in case the release process has to be done several times.</p><pre class="programlisting brush: shell">git flow release start <RELEASE-VERSION>-RC#</pre><p>This will eventually generates a <code class="literal"><RELEASE-VERSION>-RC#</code> tag that we will rename to <code class="literal"><RELEASE-VERSION></code> if the vote passes, see below.</p></div><div class="section" title="Audit artifacts and distributions"><div class="titlepage"><div><div><h5 cla ss="title"><a id="_audit_artifacts_and_distributions"></a>Audit artifacts and distributions</h5></div></div></div><p>Make a complete build, deploying maven artifacts locally:</p><pre class="programlisting brush: shell">./gradlew -Dversion=<RELEASE-VERSION> -PuploadRepository="file://$(pwd)/build/repositories/zest-java" \ + clean buildAll checkDists uploadArchives</pre><p>Review maven artifacts in <code class="literal">build/repositories/zest-java</code>.</p><p>Also review the release distributions in <code class="literal">build/distributions</code> where you should find the following files:</p><pre class="programlisting brush: shell">. +âââ apache-zest-java-<RELEASE-VERSION>-bin.tgz +âââ apache-zest-java-<RELEASE-VERSION>-bin.tgz.MD5 +âââ apache-zest-java-<RELEASE-VERSION>-bin.tgz.SHA-512 +âââ apache-zest-java-<RELEASE-VERSION>-bin.tgz.asc +âââ apache-zest-java-<RELEASE-VERSION>-bin.zip +âââ apache-zest-java-<RELEASE-VERSION>-bin.zip.MD5 +âââ apache-zest-java-<RELEASE-VERSION>-bin.zip.SHA-512 +âââ apache-zest-java-<RELEASE-VERSION>-bin.zip.asc +âââ apache-zest-java-<RELEASE-VERSION>-src.tgz +âââ apache-zest-java-<RELEASE-VERSION>-src.tgz.MD5 +âââ apache-zest-java-<RELEASE-VERSION>-src.tgz.SHA-512 +âââ apache-zest-java-<RELEASE-VERSION>-src.tgz.asc +âââ apache-zest-java-<RELEASE-VERSION>-src.zip +âââ apache-zest-java-<RELEASE-VERSION>-src.zip.MD5 +âââ apache-zest-java-<RELEASE-VERSION>-src.zip.SHA-512 +âââ apache-zest-java-<RELEASE-VERSION>-src.zip.asc</pre><p>If any, make the required changes, commit them and iterate.</p></div><div class="section" title="Close the RC branch"><div class="titlepage"><div><div><h5 class="title"><a id="_close_the_rc_branch"></a>Close the RC branch</h5></div></div></div><p>Once you are satisfied with the produced artifacts, close the release candidate branch:</p><pre class="programlisting brush: shell">git flow release finish <RELEASE-VERSION>-RC#</pre></div><div class="section" title="Checkout the RC tag"><div class="titlepage"><div><div><h5 class="title"><a id="_checkout_the_rc_tag"></a>Checkout the RC tag</h5></div></div></div><p>To build the release candidate bits, we need to checkout the release candidate tag, that will eventually be promoted as a signed release tag, because the Apache Zest⢠build system generates versionning information based on git metadata.</p><pre class="programlisting brush: shell">git checkou t <RELEASE-VERSION>-RC#</pre></div><div class="section" title="Build RC artifacts and distributions"><div class="titlepage"><div><div><h5 class="title"><a id="_build_rc_artifacts_and_distributions"></a>Build RC artifacts and distributions</h5></div></div></div><pre class="programlisting brush: shell">./gradlew -Dversion=<RELEASE-VERSION> clean check buildAll checkDists</pre></div><div class="section" title="Stage RC maven artifacts"><div class="titlepage"><div><div><h5 class="title"><a id="_stage_rc_maven_artifacts"></a>Stage RC maven artifacts</h5></div></div></div><p>Stage artifacts to <a class="ulink" href="https://repository.apache.org/"; target="_top">repository.apache.org</a> :</p><pre class="programlisting brush: shell">./gradlew -Dversion=<RELEASE-VERSION> uploadArchives</pre><p>Close the staging Nexus repository by following the <a class="ulink" href="https://www.apache.org/dev/publishing-maven-artifacts.html#close-stage"; target="_top">Closing the staged re pository</a> guide.</p></div><div class="section" title="Upload RC distributions"><div class="titlepage"><div><div><h5 class="title"><a id="_upload_rc_distributions"></a>Upload RC distributions</h5></div></div></div><p>Upload source and binary distributions, checksums and signatures to <a class="ulink" href="https://dist.apache.org/repos/dist/dev/zest/"; target="_top">dist.apache.org/repos/dist/dev/zest</a>:</p><pre class="programlisting brush: shell">cp zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-src* zest-dist-dev/ +cp zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-bin* zest-dist-dev/ cd zest-dist-dev svn add * --force svn commit -m "zest: upload <RELEASE-VERSION> to dist/dev/zest"</pre></div></div><div class="section" title="Run the vote"><div class="titlepage"><div><div><h4 class="title"><a id="_run_the_vote"></a>Run the vote</h4></div></div></div><p>Send a "VOTE" to the <a class="ulink" href="mailto:[email protected]"; target="_top">developer mailing list</a> including links to release artifacts. A VOTE always contains two parts. Send an email to the developer mailing list with the subject line:</p><pre class="programlisting brush: text">[VOTE] Release Zest (Java Edition) version <RELEASE-VERSION></pre><p>Here is a sample template:</p><pre class="programlisting brush: text">Dear community, @@ -114,7 +134,7 @@ I am happy to start the VOTE thread for The changelog for this release can be found here: https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12316820&version=12332997 -Tag: https://git-wip-us.apache.org/repos/asf?p=zest-qi4j.git;a=tag;h=cc0f8211bf47b2df72a6239c9fdcd1d6906ea246 +Tag: https://git-wip-us.apache.org/repos/asf?p=zest-java.git;a=tag;h=cc0f8211bf47b2df72a6239c9fdcd1d6906ea246 The artifacts to be voted on are located here: https://dist.apache.org/repos/dist/dev/zest/ @@ -138,7 +158,8 @@ git checkout master git push origin master git checkout develop git push origin master -git push origin --tags</pre></div><div class="section" title="Publish bits"><div class="titlepage"><div><div><h5 class="title"><a id="_publish_bits"></a>Publish bits</h5></div></div></div><p>Promote the staged Nexus repository so it gets synched to Maven Central by following the <a class="ulink" href="https://www.apache.org/dev/publishing-maven-artifacts.html#promote"; target="_top">Promoting a repo</a> guide.</p><p>Move the release distributions, checksums and signatures from <a class="ulink" href="https://dist.apache.org/repos/dist/dev/zest/"; target="_top">dist.apache.org/repos/dist/dev/zest</a> to <a class="ulink" href="https://dist.apache.org/repos/dist/release/zest/"; target="_top">dist.apache.org/repos/dist/release/zest</a></p><pre class="programlisting brush: shell">mv zest-dist-dev/*<RELEASE-VERSION>*.* zest-dist-release/ +git push origin --tags</pre></div><div class="section" title="Publish bits"><div class="titlepage"><div><div><h5 class="title"><a id="_publish_bits"></a>Publish bits</h5></div></div></div><p>Promote the staged Nexus repository so it gets synched to Maven Central by following the <a class="ulink" href="https://www.apache.org/dev/publishing-maven-artifacts.html#promote"; target="_top">Promoting a repo</a> guide.</p><p>Move the release distributions, checksums and signatures from <a class="ulink" href="https://dist.apache.org/repos/dist/dev/zest/"; target="_top">dist.apache.org/repos/dist/dev/zest</a> to <a class="ulink" href="https://dist.apache.org/repos/dist/release/zest/"; target="_top">dist.apache.org/repos/dist/release/zest</a></p><pre class="programlisting brush: shell">mv zest-dist-dev/apache-zest-java-<RELEASE-VERSION>-src* zest-dist-release/ +mv zest-dist-dev/apache-zest-java-<RELEASE-VERSION>-bin* zest-dist-release/ cd zest-dist-dev svn add * --force svn commit -m "zest: removing <RELEASE-VERSION> from dist/dev/zest as the VOTE passed" @@ -146,11 +167,20 @@ cd .. cd zest-dist-release svn add * --force svn commit -m "zest: upload <RELEASE-VERSION> to dist/release/zest""</pre></div><div class="section" title="Wait 24 hours"><div class="titlepage"><div><div><h5 class="title"><a id="_wait_24_hours"></a>Wait 24 hours</h5></div></div></div><p>For mirrors to pick up the new bits.</p></div><div class="section" title="Prepare an announcement"><div class="titlepage"><div><div><h5 class="title"><a id="_prepare_an_announcement"></a>Prepare an announcement</h5></div></div></div><p>Coordinate a press release with <a class="ulink" href="mailto:[email protected]"; target="_top">[email protected]</a>.</p><pre class="literallayout">TODO</pre><p>You can reuse the release-notes content from the <code class="literal">txt</code>/<code class="literal">adoc</code>/<code class="literal">md</code> files created earlier.</p><p>This annoucement will be used in a veriety of media like emails, websites etc⦠-Start with a text version and once satisfied produce at least an Asciidoc version.</p></div><div class="section" title="Update the Zest⢠website"><div class="titlepage"><div><div><h5 class="title"><a id="_update_the_zest_website"></a>Update the Zest⢠website</h5></div></div></div><p>Generate the documentation and javadoc minisite:</p><pre class="programlisting brush: shell">cd zest-java -./gradlew -Dversion=<RELEASE-VERSION> archiveJavadocs manuals</pre><p>This will automatically put all files into the <code class="literal">zest-svn</code> website repository.</p><p>Create a new post on the Zest⢠website by creating a new Asciidoc file:</p><pre class="programlisting brush: shell">cd zest-svn -touch site/src/_posts/YYYY-MM-DD-apache-zest-java-<RELEASE-VERSION>.adoc -open !$</pre><p>You can reuse the Asciidoc formatted announcement content.</p><p>Finally, edit <code class="literal">zest-svn/site/src/_data/releases.yml</code> with the new release data. -Upmost is the latest.</p><p>You can live-preview your changes to the Zest⢠website:</p><pre class="programlisting brush: shell">cd zest-svn +Start with a text version and once satisfied produce at least a Markdown version for the website, see below.</p></div><div class="section" title="Update the Zest⢠website"><div class="titlepage"><div><div><h5 class="title"><a id="_update_the_zest_website"></a>Update the Zest⢠website</h5></div></div></div><p>Generate the documentation and javadoc minisite:</p><pre class="programlisting brush: shell">cd zest-java +./gradlew -Dversion=<RELEASE-VERSION> archiveJavadocs manuals</pre><p>This will automatically put all files into the <code class="literal">zest-svn</code> website repository.</p><p>Create a new post on the Zest⢠website by creating a new Markdown file:</p><pre class="programlisting brush: shell">cd zest-svn +touch site/src/_posts/YYYY-MM-DD-apache-zest-java-<RELEASE-VERSION>.md +open !$</pre><p>You can reuse the Markdown formatted announcement content.</p><p>Add the new released version in <code class="literal">zest-svn/site/content/java/versions.json</code> below the <code class="literal">latest</code> entry:</p><pre class="programlisting brush: json">{ + "develop": "develop", + "latest": "latest", + "<RELEASE-VERSION>", "<RELEASE-VERSION>", + "2.0": "2.0", + "<=1.4.x": "1.4" +}</pre><p>Finally, edit <code class="literal">zest-svn/site/src/_data/releases.yml</code> with the new release data. +Upmost is the latest:</p><pre class="programlisting brush: yaml">- version: <RELEASE-VERSION> + announcement: YYYY/MM/DD/apache-zest-java-<RELEASE-VERSION> + signer: John Doe + pgpId: FB751943</pre><p>You can live-preview your changes to the Zest⢠website:</p><pre class="programlisting brush: shell">cd zest-svn jekyll serve</pre><p>Once you are satisfied with the changes, build the production website:</p><pre class="programlisting brush: shell">cd zest-svn jekyll build</pre><p>And publish it:</p><pre class="programlisting brush: shell">svn add * --force svn commit -m "zest: update website"</pre></div><div class="section" title="Register the release"><div class="titlepage"><div><div><h5 class="title"><a id="_register_the_release"></a>Register the release</h5></div></div></div><p>Register the new release at <a class="ulink" href="https://reporter.apache.org/"; target="_top">reporter.apache.org</a></p></div><div class="section" title="Announce"><div class="titlepage"><div><div><h5 class="title"><a id="_announce"></a>Announce</h5></div></div></div><p>Finally, send an announcement to <a class="ulink" href="mailto:[email protected]"; target="_top">dev@</a> and <a class="ulink" href="mailto:[email protected]"; target="_top">users@</a> mailing lists. Email announcements should have the subject line:</p><pre class="programlisting brush: text">[ANNOUNCE] Released Zest (Java Edition) version <RELEASE-VERSION></pre><p>The announcement email should contains the release-notes as text, remember they are in the <code class="literal">apach e-zest-java-<RELEASE-VERSION>-release-notes.txt</code> file you created earlier.</p></div></div><div class="section" title="VOTE fails"><div class="titlepage"><div><div><h4 class="title"><a id="_vote_fails"></a>VOTE fails</h4></div></div></div><div class="section" title="Record failure"><div class="titlepage"><div><div><h5 class="title"><a id="_record_failure"></a>Record failure</h5></div></div></div><p>We keep the release candidate git history. Modified: zest/site/content/java/develop/sample-car-rental.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/sample-car-rental.html?rev=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/sample-car-rental.html (original) +++ zest/site/content/java/develop/sample-car-rental.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"><span xmlns="" href="samples.html">Samples</span></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></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="samples.html#_overview_2">Overview</a></span></dt><dt><span class="section"><a href="sample-dci.html">DCI Sample</a></span></dt><dt><span class="section"><a href="sample-dci-cargo.html">DCI Cargo Sample</a></span></dt><dt><span class="section"><a href="sample-forum.html">Forum Sample</a></span></dt><dt><span class="section"><span xmlns="" href="sample-car-rental.html">Car Rental Sample</span></span></dt><dt><span class="section"><a href="sample-sql-support.html">SQL Support Sample</a></span></dt><dt><span class="section"><a href="sample-swing.html">Swing Bindings Sample</a></span></dt></dl></div></div><div class="section" title="Car Rental Sample"><div class="titlepage"><div><div><h3 class="title"><a id="sample-car-rental"></a>Car Rental Sample</h3></div></div></div><p>Sample of implementation of a Car Rental application implemented as a Servlet -based Webapp packaged as a WAR.</p><p><a class="ulink" href="https://github.com/apache/zest-qi4j/tree/develop/samples/rental"; target="_top">Browse Source</a></p></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="footer"><p> +based Webapp packaged as a WAR.</p><p><a class="ulink" href="https://github.com/apache/zest-java/tree/develop/samples/rental"; target="_top">Browse Source</a></p></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/sample-dci-cargo.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/sample-dci-cargo.html?rev=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/sample-dci-cargo.html (original) +++ zest/site/content/java/develop/sample-dci-cargo.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"><span xmlns="" href="samples.html">Samples</span></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></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="samples.html#_overview_2">Overview</a></span></dt><dt><span class="section"><a href="sample-dci.html">DCI Sample</a></span></dt><dt><span class="section"><span xmlns="" href="sample-dci-cargo.html">DCI Cargo Sample</span></span></dt><dt><span class="section"><a href="sample-forum.html">Forum Sample</a></span></dt><dt><span class="section"><a href="sample-car-rental.html">Car Rental Sample</a></span></dt><dt><span class="section"><a href="sample-sql-support.html">SQL Support Sample</a></span></dt><dt><span class="section"><a href="sample-swing.html">Swing Bindings Sample</a></span></dt></dl></div></div><div class="section" title="DCI Cargo Sample"><div class="titlepage"><div><div><h3 class="title"><a id="sample-dci-cargo"></a>DCI Cargo Sample</h3></div></div></div><p>Sample of ho w DCI (Data, Context & Interaction) pattern is implemented with Zestâ¢, for Eric Evans DDD sample.</p><p>This sample, contributed by Marc Grue, is described in details on his -website: <a class="ulink" href="http://marcgrue.com/"; target="_top">http://marcgrue.com/</a></p><p><a class="ulink" href="https://github.com/apache/zest-qi4j/tree/develop/samples/dci-cargo"; target="_top">Browse Source</a></p></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="footer"><p> +website: <a class="ulink" href="http://marcgrue.com/"; target="_top">http://marcgrue.com/</a></p><p><a class="ulink" href="https://github.com/apache/zest-java/tree/develop/samples/dci-cargo"; target="_top">Browse Source</a></p></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/sample-dci.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/sample-dci.html?rev=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/sample-dci.html (original) +++ zest/site/content/java/develop/sample-dci.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"><span xmlns="" href="samples.html">Samples</span></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></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="samples.html#_overview_2">Overview</a></span></dt><dt><span class="section"><span xmlns="" href="sample-dci.html">DCI Sample</span></span></dt><dt><span class="section"><a href="sample-dci-cargo.html">DCI Cargo Sample</a></span></dt><dt><span class="section"><a href="sample-forum.html">Forum Sample</a></span></dt><dt><span class="section"><a href="sample-car-rental.html">Car Rental Sample</a></span></dt><dt><span class="section"><a href="sample-sql-support.html">SQL Support Sample</a></span></dt><dt><span class="section"><a href="sample-swing.html">Swing Bindings Sample</a></span></dt></dl></div></div><div class="section" title="DCI Sample"><div class="titlepage"><div><div><h3 class="title"><a id="sample-dci"></a>DCI Sample</h3></div></div></div><p>Sample of how DCI (Data, Conte xt & Interaction) pattern is implemented using -Zest⢠core only.</p><p><a class="ulink" href="https://github.com/apache/zest-qi4j/tree/develop/samples/dci"; target="_top">Browse Source</a></p></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="footer"><p> +Zest⢠core only.</p><p><a class="ulink" href="https://github.com/apache/zest-java/tree/develop/samples/dci"; target="_top">Browse Source</a></p></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/sample-forum.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/sample-forum.html?rev=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/sample-forum.html (original) +++ zest/site/content/java/develop/sample-forum.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"><span xmlns="" href="samples.html">Samples</span></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></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="samples.html#_overview_2">Overview</a></span></dt><dt><span class="section"><a href="sample-dci.html">DCI Sample</a></span></dt><dt><span class="section"><a href="sample-dci-cargo.html">DCI Cargo Sample</a></span></dt><dt><span class="section"><span xmlns="" href="sample-forum.html">Forum Sample</span></span></dt><dt><span class="section"><a href="sample-car-rental.html">Car Rental Sample</a></span></dt><dt><span class="section"><a href="sample-sql-support.html">SQL Support Sample</a></span></dt><dt><span class="section"><a href="sample-swing.html">Swing Bindings Sample</a></span></dt></dl></div></div><div class="section" title="Forum Sample"><div class="titlepage"><div><div><h3 class="title"><a id="sample-forum"></a>Forum Sample</h3></div></div></div><p>Sample of how to build a web forum using <a class="xref" href="library-rest-server.html" title="ReST Server"> ReST Server Library</a>, -<a class="xref" href="extension-es-file.html" title="File EntityStore">File EntityStore</a> and <a class="xref" href="library-fileconfig.html" title="FileConfig">FileConfig Library</a>.</p><p><a class="ulink" href="https://github.com/apache/zest-qi4j/tree/develop/samples/forum"; target="_top">Browse Source</a></p></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="footer"><p> +<a class="xref" href="extension-es-file.html" title="File EntityStore">File EntityStore</a> and <a class="xref" href="library-fileconfig.html" title="FileConfig">FileConfig Library</a>.</p><p><a class="ulink" href="https://github.com/apache/zest-java/tree/develop/samples/forum"; target="_top">Browse Source</a></p></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/sample-sql-support.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/sample-sql-support.html?rev=1692588&r1=1692587&r2=1692588&view=diff ============================================================================== --- zest/site/content/java/develop/sample-sql-support.html (original) +++ zest/site/content/java/develop/sample-sql-support.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"><span xmlns="" href="samples.html">Samples</span></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></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="samples.html#_overview_2">Overview</a></span></dt><dt><span class="section"><a href="sample-dci.html">DCI Sample</a></span></dt><dt><span class="section"><a href="sample-dci-cargo.html">DCI Cargo Sample</a></span></dt><dt><span class="section"><a href="sample-forum.html">Forum Sample</a></span></dt><dt><span class="section"><a href="sample-car-rental.html">Car Rental Sample</a></span></dt><dt><span class="section"><span xmlns="" href="sample-sql-support.html">SQL Support Sample</span></span></dt><dt><span class="section"><a href="sample-swing.html">Swing Bindings Sample</a></span></dt></dl></div></div><div class="section" title="SQL Support Sample"><div class="titlepage"><div><div><h3 class="title"><a id="sample-sql-support"></a>SQL Support Sample</h3></div></div></div><div clas s="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This sample use PostgreSQL and drop all of its data once run in order to be runnable multiple times.</p></div><p>Sample of how to fully use Zest⢠SQL support : <a class="xref" href="library-sql.html" title="SQL">SQL Library</a>, <a class="xref" href="extension-es-sql.html" title="SQL EntityStore"> SQL EntityStore</a> and <a class="xref" href="extension-indexing-sql.html" title="SQL Index/Query">SQL Index/Query</a>.</p><p><a class="ulink" href="https://github.com/apache/zest-qi4j/tree/develop/samples/sql-support"; target="_top">Browse Source</a></p><p>Here are the steps needed to setup the database using the <code class="literal">psql</code> utility command:</p><pre class="programlisting brush: bash">user@host $ psql postgres + </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"><span xmlns="" href="samples.html">Samples</span></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></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="samples.html#_overview_2">Overview</a></span></dt><dt><span class="section"><a href="sample-dci.html">DCI Sample</a></span></dt><dt><span class="section"><a href="sample-dci-cargo.html">DCI Cargo Sample</a></span></dt><dt><span class="section"><a href="sample-forum.html">Forum Sample</a></span></dt><dt><span class="section"><a href="sample-car-rental.html">Car Rental Sample</a></span></dt><dt><span class="section"><span xmlns="" href="sample-sql-support.html">SQL Support Sample</span></span></dt><dt><span class="section"><a href="sample-swing.html">Swing Bindings Sample</a></span></dt></dl></div></div><div class="section" title="SQL Support Sample"><div class="titlepage"><div><div><h3 class="title"><a id="sample-sql-support"></a>SQL Support Sample</h3></div></div></div><div clas s="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This sample use PostgreSQL and drop all of its data once run in order to be runnable multiple times.</p></div><p>Sample of how to fully use Zest⢠SQL support : <a class="xref" href="library-sql.html" title="SQL">SQL Library</a>, <a class="xref" href="extension-es-sql.html" title="SQL EntityStore"> SQL EntityStore</a> and <a class="xref" href="extension-indexing-sql.html" title="SQL Index/Query">SQL Index/Query</a>.</p><p><a class="ulink" href="https://github.com/apache/zest-java/tree/develop/samples/sql-support"; target="_top">Browse Source</a></p><p>Here are the steps needed to setup the database using the <code class="literal">psql</code> utility command:</p><pre class="programlisting brush: bash">user@host $ psql postgres postgres=# CREATE USER jdbc_test_login WITH PASSWORD 'password'; CREATE ROLE postgres=# CREATE DATABASE jdbc_test_db;
