Modified: zest/site/content/java/develop/library-sql.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/library-sql.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/library-sql.html (original) +++ zest/site/content/java/develop/library-sql.html Fri Apr 15 08:28:56 2016 @@ -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="idm491905543648"></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.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.sql</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="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"> +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="idp140567697330064"></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.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.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>DataSou rce 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="idm491905521920"></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.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.sql-bonecp</p></td><td align="left" valign="top"><p>3.0-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="idp140567697351840"></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.apache.zest.library</p></td><td align="le ft" valign="top"><p>org.apache.zest.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="idm491905504656"></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.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.sql-dbcp</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><pre class="programlisting brush: java">// Assemble the Apache DBCP bas ed Service Importer +</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="idp140567697369248"></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.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.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 Servi ce Importer new DBCPDataSourceServiceAssembler(). identifiedBy( DS_SERVICE_ID ). visibleIn( Visibility.module ). @@ -114,20 +114,25 @@ See <a class="xref" href="howto-configur @Optional Property<String> validationQuery(); @UseDefaults Property<String> properties(); } -</pre><p>Sample DataSource configuration defaults:</p><pre class="programlisting brush: plain"># Licensed to the Apache Software Foundation (ASF) under one or more -# contributor license agreements. See the NOTICE file distributed with -# this work for additional information regarding copyright ownership. -# The ASF licenses this file to You under the Apache License, Version 2.0 -# (the "License"); you may not use this file except in compliance with -# the License. You may obtain a copy of the License at +</pre><p>Sample DataSource configuration defaults:</p><pre class="programlisting brush: plain"># +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# # -# http://www.apache.org/licenses/LICENSE-2.0 # -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. enabled=true url=jdbc:derby:memory:testdb;create=true @@ -172,7 +177,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="idm491905460672"></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.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.sql-liquibase</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><p><span class="strong"><strong>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="idp140567697413184"></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.apache.zest.library</p></td>< td align="left" valign="top"><p>org.apache.zest.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=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/library-uid.html (original) +++ zest/site/content/java/develop/library-uid.html Fri Apr 15 08:28:56 2016 @@ -66,7 +66,7 @@ })(); </script> - </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><span xmlns="" href="libraries.html">Libraries</span></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.htm l">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="libraries.html#_overview_5">Overview</a></span></dt><dt><span class="section"><a href="lang-groovy.html">Groovy Scripting</a></span></dt><dt><span class="section"><a href="lang-javascript.html">Javascript Scripting</a></span></dt><dt><span class="section"><a href="lang-scala.html">Scala Support</a></span></dt><dt><span class="section"><a href="library-alarm.html">Alarms</a></span></dt><dt><span class="section"><a href="library-circuitbreaker.html">Circuit Breaker</a></span></dt><dt><span class="section"><a href="library-constraints.html">Constraints</a></span></dt><dt><span class="section"><a href="library-conversion.html">Conversion - DEPRECATED</a></span></dt><dt><span class="section"><a href="library-eventsourcing.html">Event Sourcing</a></span></dt><dt><span class="section"> <a href="library-fileconfig.html">FileConfig</a></span></dt><dt><span class="section"><a href="library-http.html">HTTP</a></span></dt><dt><span class="section"><a href="library-invocation-cache.html">Invocation Cache</a></span></dt><dt><span class="section"><a href="library-jmx.html">JMX</a></span></dt><dt><span class="section"><a href="library-locking.html">Locking</a></span></dt><dt><span class="section"><a href="library-logging.html">Logging</a></span></dt><dt><span class="section"><a href="library-metrics.html">Metrics Library</a></span></dt><dt><span class="section"><a href="library-osgi.html">OSGi</a></span></dt><dt><span class="section"><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="idm491905437808"></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.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.uid</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="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 ); + </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="idp140567697436064"></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.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.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></d iv></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=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/library-uowfile.html (original) +++ zest/site/content/java/develop/library-uowfile.html Fri Apr 15 08:28:56 2016 @@ -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="idm491905402304"></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.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.library.uowfile</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Logging"><div class="titlepage"><div><div><h4 class="title"><a id="_logging_5"></a>Logging</h4></div></div></div><p>The SLF4J Logger used by this library is named "org.apache.zest.library. uowfile".</p></div><div 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="idp140567695270192"></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.apache.zest.library</p></td><td align="left" valign="top"><p>org.apache.zest.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.apache.zest.library.uowfile" .</p></div><div 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 [...snip...] { Modified: zest/site/content/java/develop/schemas/2008/dev-status/1/dev-status.xsd URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/schemas/2008/dev-status/1/dev-status.xsd?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/schemas/2008/dev-status/1/dev-status.xsd (original) +++ zest/site/content/java/develop/schemas/2008/dev-status/1/dev-status.xsd Fri Apr 15 08:28:56 2016 @@ -1,20 +1,23 @@ <?xml version="1.0" encoding="UTF-8"?> <!-- - Licensed to the Apache Software Foundation (ASF) under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - The ASF licenses this file to You under the Apache License, Version 2.0 - (the "License"); you may not use this file except in compliance with - the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. ---> + ~ Licensed to the Apache Software Foundation (ASF) under one + ~ or more contributor license agreements. See the NOTICE file + ~ distributed with this work for additional information + ~ regarding copyright ownership. The ASF licenses this file + ~ to you under the Apache License, Version 2.0 (the + ~ "License"); you may not use this file except in compliance + ~ with the License. You may obtain a copy of the License at + ~ + ~ http://www.apache.org/licenses/LICENSE-2.0 + ~ + ~ Unless required by applicable law or agreed to in writing, software + ~ distributed under the License is distributed on an "AS IS" BASIS, + ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + ~ See the License for the specific language governing permissions and + ~ limitations under the License. + ~ + ~ + --> <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="http://zest.apache.org/schemas/2008/dev-status/1"; Modified: zest/site/content/java/develop/ten-minutes-intro.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/ten-minutes-intro.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/ten-minutes-intro.html (original) +++ zest/site/content/java/develop/ten-minutes-intro.html Fri Apr 15 08:28:56 2016 @@ -82,7 +82,7 @@ Fragments are Mixins, Concerns, Constrai </li><li class="listitem"> Only Mixins carry Composite state. The others are shared between Composite instances. </li></ul></div><p>If you want to reproduce whatâs explained in this tutorial, remember to depend on the Core Runtime artifact that depends -on Core API, Core SPI, Core Bootstrap and Core Functional & I/O APIs:</p><div class="table"><a id="idm491908306672"></a><p class="title"><strong>Table 2. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.core</p></td><td align="left" valign="top"><p>org.apache.zest.core.runtime</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><p>Moreover, youâll need an EntityStore for persistence and an Indexing engine for querying. Choose among the available +on Core API, Core SPI, Core Bootstrap and Core Functional & I/O APIs:</p><div class="table"><a id="idp140567694857088"></a><p class="title"><strong>Table 2. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.core</p></td><td align="left" valign="top"><p>org.apache.zest.core.runtime</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><p>Moreover, youâll need an EntityStore for persistence and an Indexing engine for querying. Choose among the available implementations listed in the <a class="xref" href="extensions.html" title="Extensions">Extensions</a> section.</p><p>See the <a class="xref" href="howto-depend-on-zest.html" title="Depend on Zest⢠in your build">Depend on Zest⢠in your build</a> tutorial for details.</p><p>Composition is done with Java interfaces and Annotations. Example;</p><pre class="programlisting brush: java">@Concerns( { PurchaseLimitConcern.class, InventoryConcern.class } ) public interface OrderEntity extends Order, Confirmable, @@ -164,7 +164,7 @@ public interface OrderEntity </pre><p>The MailService is dependency injected, as we have seen before.</p><p>@This is telling Zest⢠that the SideEffect needs a reference to the Composite instance that it belongs to.</p><p>By asking for both the HasCustomer and the HasLineItems types, we get type-safety and donât need to bother with casts. In fact, Zest⢠will ensure that you canât even cast the <code class="literal">hasCustomer</code> instance to the HasLineItems type.</p><p>By not referencing the aggregated interface OrderEntity, we reduce the coupling of this SideEffect and it can be used in any other Composite where the HasCustomer and HasLineItems combination is used, for instance in an InvoiceEntity.</p><p>So, build the report, send it via the MailService.</p><div class="section" title="Conclusion"><div class="titlepage"><div><div><h4 class="title"><a id="_conclusion"></a>Conclusion</h4></div></div></div><p>In this short introduction, we have covered the essence of Zestâ¢. We have looked at what is a Composite, seen some of the -Fragments in action, and how simple it is to turn a Composite into a persisted Composite, known as an EntityComposite.</p></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="footer"><p> +Fragments in action, and how simple it is to turn a Composite into a persisted Composite, known as an EntityComposite.</p><p>Next step, <a class="xref" href="thirty-minutes-intro.html" title="Zest⢠in 30 minutes">Zest⢠in 30 minutes</a>.</p></div></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/thirty-minutes-intro.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/thirty-minutes-intro.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/thirty-minutes-intro.html (original) +++ zest/site/content/java/develop/thirty-minutes-intro.html Fri Apr 15 08:28:56 2016 @@ -70,7 +70,7 @@ <a class="ulink" href="https://zest.apache.org/download.html"; target="_top">Zest⢠SDK sources</a>. You should start your favorite editor and find the code related to this tutorial, run it and play with it.</p></div><p>This introduction will deepen your understanding of Zestâ¢, as we touches on a couple of the common features of Zestâ¢. It is expected that you have gone through and understood the "Zest⢠in 10 minutes" introduction.</p><p>If you want to reproduce whatâs explained in this tutorial, remember to depend on the Core Runtime artifact that depends -on Core API, Core SPI, Core Bootstrap and Core Functional & I/O APIs:</p><div class="table"><a id="idm491908269216"></a><p class="title"><strong>Table 3. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.core</p></td><td align="left" valign="top"><p>org.apache.zest.core.runtime</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><p>Moreover, youâll need an EntityStore for persistence and an Indexing engine for querying. Choose among the available +on Core API, Core SPI, Core Bootstrap and Core Functional & I/O APIs:</p><div class="table"><a id="idp140567694895408"></a><p class="title"><strong>Table 3. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.core</p></td><td align="left" valign="top"><p>org.apache.zest.core.runtime</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><p>Moreover, youâll need an EntityStore for persistence and an Indexing engine for querying. Choose among the available implementations listed in the <a class="xref" href="extensions.html" title="Extensions">Extensions</a> section.</p><p>See the <a class="xref" href="howto-depend-on-zest.html" title="Depend on Zest⢠in your build">Depend on Zest⢠in your build</a> tutorial for details.</p><p>We will go back to the OrderEntity example;</p><pre class="programlisting brush: java">@Concerns( { PurchaseLimitConcern.class, InventoryConcern.class } ) public interface OrderEntity extends Order, Confirmable, @@ -129,7 +129,7 @@ public class TrailableMixin<M> private Action<M> addAction( M item, Action.Type type ) { ValueBuilder<Action> builder = - module.newValueBuilder(Action.class); // [4] + valueBuilderFactory.newValueBuilder( Action.class); // [4] Action<M> prototype = builder.prototypeFor( Action.class ); prototype.item().set( item ); prototype.action().set( type ); @@ -238,7 +238,7 @@ import org.apache.zest.api.query.QueryBu [...snip...] UnitOfWork uow = uowFactory.currentUnitOfWork(); - QueryBuilder<Order> builder = module.newQueryBuilder( Order.class ); + QueryBuilder<Order> builder = queryBuilderFactory.newQueryBuilder( Order.class ); String orderNumber = "12345"; HasSequenceNumber template = templateFor( HasSequenceNumber.class ); @@ -262,7 +262,7 @@ The QueryExpressions.templateFor() metho </li><li class="listitem"> The where() clause, which has a statically imported method eq(), which builds up the expression logic, and will be translated into the underlying query language upon execution, which happens in the iterator() method. -</li></ul></div><p>Another example,</p><pre class="programlisting brush: java">QueryBuilder<Order> builder = module.newQueryBuilder( Order.class ); +</li></ul></div><p>Another example,</p><pre class="programlisting brush: java">QueryBuilder<Order> builder = queryBuilderFactory.newQueryBuilder( Order.class ); Calendar cal = Calendar.getInstance(); cal.setTime( new Date() ); @@ -278,7 +278,7 @@ for( Order order : query ) } </pre><p>In the above case, we find the Orders that has been created in the last 90 days, and add them to a report to be generated. This example assumes that the Order type has a Property<Date> createdDate() method.</p><p>Now, Orders has a relation to the CustomerComposite which is also an Entity. Letâs create a query for all customers -that has made an Order in the last 30 days;</p><pre class="programlisting brush: java">QueryBuilder<HasCustomer> builder = module.newQueryBuilder( HasCustomer.class ); +that has made an Order in the last 30 days;</p><pre class="programlisting brush: java">QueryBuilder<HasCustomer> builder = queryBuilderFactory.newQueryBuilder( HasCustomer.class ); Calendar cal = Calendar.getInstance(); cal.setTime( new Date() ); @@ -299,7 +299,7 @@ classes and only operate with interfaces it is pure Java, albeit heavy use of dynamic proxies to capture the intent of the query.</p><div class="section" title="Conclusion"><div class="titlepage"><div><div><h4 class="title"><a id="_conclusion_2"></a>Conclusion</h4></div></div></div><p>We have now explored a couple more intricate features of Zestâ¢, hopefully without being overwhelmed with details on how to create applications from scratch, how to structure applications, and how the entire Zest⢠Extension system works. We have looked at how to add a Concern that uses a private Mixin, we have touched a bit on Generic Concerns, and -finally a short introduction to the Query API.</p></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="footer"><p> +finally a short introduction to the Query API.</p><p>Next step, <a class="xref" href="two-hours-intro.html" title="Zest⢠in 2 hours">Zest⢠in 2 hours</a>.</p></div></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/tools-envisage.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/tools-envisage.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/tools-envisage.html (original) +++ zest/site/content/java/develop/tools-envisage.html Fri Apr 15 08:28:56 2016 @@ -67,7 +67,7 @@ </script> </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><span xmlns="" href="tools.html">Tools</span></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="tools.html#_overview_8">Overview</a></span></dt><dt><span class="section"><span xmlns="" href="tools-envisage.html">Envisage</span></span></dt></dl></div></div><div class="section" title="Envisage"><div class="titlepage"><div><div><h3 class="title"><a id="tools-envisage"></a>Envisage</h3></div></div></div><p>Envisage is a Swing based visualization tool for the Zest⢠Application model. -Visualizations can be printed to PDFs.</p><div class="section" title="Usage"><div class="titlepage"><div><div><h4 class="title"><a id="_usage_6"></a>Usage</h4></div></div></div><p>Envisage can be easily used directly and prior your Application activation:</p><pre class="programlisting brush: java">public static void main( String[] args ) +Visualizations can be printed to PDFs.</p><div class="section" title="Usage"><div class="titlepage"><div><div><h4 class="title"><a id="_usage_7"></a>Usage</h4></div></div></div><p>Envisage can be easily used directly and prior your Application activation:</p><pre class="programlisting brush: java">public static void main( String[] args ) throws Exception { Energy4Java energy4Java = new Energy4Java(); @@ -79,7 +79,7 @@ Visualizations can be printed to PDFs.</ } </pre><p>As you can see, Envisage operates on the ApplicationModel, this means that you can easily embedd it in your own Applications too.</p><p>Two gradle tasks runSample and runSchool are defined in this module as a -shortcut to run the examples. See <a class="xref" href="build-system.html" title="Zest⢠Build System">Build System</a>.</p></div><div class="section" title="Screenshots"><div class="titlepage"><div><div><h4 class="title"><a id="_screenshots"></a>Screenshots</h4></div></div></div><p><span class="inlinemediaobject"><img src="images/tools-envisage-structure.png" width="800" alt="tools-envisage-structure.png" /></span></p><p><span class="inlinemediaobject"><img src="images/tools-envisage-type.png" width="800" alt="tools-envisage-type.png" /></span></p><p><span class="inlinemediaobject"><img src="images/tools-envisage-stacked.png" width="800" alt="tools-envisage-stacked.png" /></span></p><p><span class="inlinemediaobject"><img src="images/tools-envisage-stacked-collapsed.png" width="800" alt="tools-envisage-stacked-collapsed.png" /></span></p></div><div class="section" title="Embedd in your Application"><div class="titlepage"><div><div><h4 class="title"><a id="_embedd_in_your_applic ation"></a>Embedd in your Application</h4></div></div></div><div class="table"><a id="idm491904696816"></a><p class="title"><strong>Table 78. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.tool</p></td><td align="left" valign="top"><p>org.apache.zest.tool.envisage</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="footer"><p> +shortcut to run the examples. See <a class="xref" href="build-system.html" title="Zest⢠Build System">Build System</a>.</p></div><div class="section" title="Screenshots"><div class="titlepage"><div><div><h4 class="title"><a id="_screenshots"></a>Screenshots</h4></div></div></div><p><span class="inlinemediaobject"><img src="images/tools-envisage-structure.png" width="800" alt="tools-envisage-structure.png" /></span></p><p><span class="inlinemediaobject"><img src="images/tools-envisage-type.png" width="800" alt="tools-envisage-type.png" /></span></p><p><span class="inlinemediaobject"><img src="images/tools-envisage-stacked.png" width="800" alt="tools-envisage-stacked.png" /></span></p><p><span class="inlinemediaobject"><img src="images/tools-envisage-stacked-collapsed.png" width="800" alt="tools-envisage-stacked-collapsed.png" /></span></p></div><div class="section" title="Embedd in your Application"><div class="titlepage"><div><div><h4 class="title"><a id="_embedd_in_your_applic ation"></a>Embedd in your Application</h4></div></div></div><div class="table"><a id="idp140567698030544"></a><p class="title"><strong>Table 78. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.tool</p></td><td align="left" valign="top"><p>org.apache.zest.tool.envisage</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /></div></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/tut-composites.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/tut-composites.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/tut-composites.html (original) +++ zest/site/content/java/develop/tut-composites.html Fri Apr 15 08:28:56 2016 @@ -94,7 +94,7 @@ so that you donât have to write eve </li></ul></div><p>Each tutorial step in this series starts with the result from the previous tutorial, so you can always look at the next tutorial step for guidance on what to do.</p><p>At the bottom of each tutorial step, the is Solutions section, which list the files you should have come to if you have followed the instructions.</p><p>If you want to reproduce whatâs explained in this tutorial, remember to depend on the Core Runtime artifact that depends -on Core API, Core SPI, Core Bootstrap and Core Functional & I/O APIs:</p><div class="table"><a id="idm491908093488"></a><p class="title"><strong>Table 5. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.core</p></td><td align="left" valign="top"><p>org.apache.zest.core.runtime</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><p>See the <a class="xref" href="howto-depend-on-zest.html" title="Depend on Zest⢠in your build">Depend on Zest⢠in your build</a> tutorial for details.</p><div class="section" title="Step 1 - Interface Refactoring"><div class="titlepage"><d iv><div><h4 class="title"><a id="tut-composites-step1"></a>Step 1 - Interface Refactoring</h4></div></div></div><div class="section" title="Initial Hello World"><div class="titlepage"><div><div><h5 class="title"><a id="_initial_hello_world"></a>Initial Hello World</h5></div></div></div><p>This whole tutorial describes how to step-by-step modify a typical HelloWorld "application" into a full-fledged Zest⢠+on Core API, Core SPI, Core Bootstrap and Core Functional & I/O APIs:</p><div class="table"><a id="idp140567695072032"></a><p class="title"><strong>Table 5. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.core</p></td><td align="left" valign="top"><p>org.apache.zest.core.runtime</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><p>See the <a class="xref" href="howto-depend-on-zest.html" title="Depend on Zest⢠in your build">Depend on Zest⢠in your build</a> tutorial for details.</p><div class="section" title="Step 1 - Interface Refactoring"><div class="titlepage"><div><div> <h4 class="title"><a id="tut-composites-step1"></a>Step 1 - Interface Refactoring</h4></div></div></div><div class="section" title="Initial Hello World"><div class="titlepage"><div><div><h5 class="title"><a id="_initial_hello_world"></a>Initial Hello World</h5></div></div></div><p>This whole tutorial describes how to step-by-step modify a typical HelloWorld "application" into a full-fledged Zest⢠Composite Oriented application. Here is the initial code of HelloWorld.</p><pre class="programlisting brush: java"> /** * Initial HelloWorld implementation. Everything is mixed up Modified: zest/site/content/java/develop/tut-services.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/tut-services.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/tut-services.html (original) +++ zest/site/content/java/develop/tut-services.html Fri Apr 15 08:28:56 2016 @@ -80,7 +80,7 @@ activation and Configuration Entities ma </li></ul></div><p>Each tutorial step in this series starts with the result from the previous tutorial, so you can always look at the next tutorial step for guidance on what to do.</p><p>At the bottom of each tutorial step, the is Solutions section, which list the files you should have come to if you have followed the instructions.</p><p>If you want to reproduce whatâs explained in this tutorial, remember to depend on the Core Runtime artifact that depends -on Core API, Core SPI, Core Bootstrap and Core Functional & I/O APIs:</p><div class="table"><a id="idm491907859968"></a><p class="title"><strong>Table 6. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.core</p></td><td align="left" valign="top"><p>org.apache.zest.core.runtime</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><p>See the <a class="xref" href="howto-depend-on-zest.html" title="Depend on Zest⢠in your build">Depend on Zest⢠in your build</a> tutorial for details.</p><div class="section" title="Step 1 - Creating a ServiceComposite"><div class="titlepa ge"><div><div><h4 class="title"><a id="tut-services-step1"></a>Step 1 - Creating a ServiceComposite</h4></div></div></div><p>In this tutorial we start with basic Java classes, to simulate a very simple Library where you can borrow +on Core API, Core SPI, Core Bootstrap and Core Functional & I/O APIs:</p><div class="table"><a id="idp140567693658896"></a><p class="title"><strong>Table 6. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.core</p></td><td align="left" valign="top"><p>org.apache.zest.core.runtime</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><p>See the <a class="xref" href="howto-depend-on-zest.html" title="Depend on Zest⢠in your build">Depend on Zest⢠in your build</a> tutorial for details.</p><div class="section" title="Step 1 - Creating a ServiceComposite"><div class="titlepage"><div ><div><h4 class="title"><a id="tut-services-step1"></a>Step 1 - Creating a >ServiceComposite</h4></div></div></div><p>In this tutorial we start with >basic Java classes, to simulate a very simple Library where you can borrow and return books.</p><p>Zest⢠relies heavily on the use of interfaces. This makes it possible for an object to externally implement a number of interfaces which internally is backed by a number of Mixins, some of which you may have written yourself, and some of which may have been Modified: zest/site/content/java/develop/two-minutes-intro.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/two-minutes-intro.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/two-minutes-intro.html (original) +++ zest/site/content/java/develop/two-minutes-intro.html Fri Apr 15 08:28:56 2016 @@ -70,7 +70,7 @@ <a class="ulink" href="https://zest.apache.org/download.html"; target="_top">Zest⢠SDK sources</a>. You should start your favorite editor and find the code related to this tutorial, run it and play with it.</p></div><p>To show that Zest⢠is not necessarily complex, not hard to get going with and easy to deploy, we are first showing the classic HelloWorld, as small as it can get and still be Composite Oriented Programming and not only standard OOP.</p><p>If you want to reproduce whatâs explained in this tutorial, remember to depend on the Core Runtime artifact that depends -on Core API, Core SPI, Core Bootstrap and Core Functional & I/O APIs:</p><div class="table"><a id="idm491908341104"></a><p class="title"><strong>Table 1. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.core</p></td><td align="left" valign="top"><p>org.apache.zest.core.runtime</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><p>See the <a class="xref" href="howto-depend-on-zest.html" title="Depend on Zest⢠in your build">Depend on Zest⢠in your build</a> tutorial for details.</p><p>Ready, Set, Go!</p><p>Letâs say we want to do the common HelloWorld example, but with a more domain-oriented setting. +on Core API, Core SPI, Core Bootstrap and Core Functional & I/O APIs:</p><div class="table"><a id="idp140567694821792"></a><p class="title"><strong>Table 1. Artifact</strong></p><div class="table-contents"><table summary="Artifact" border="1"><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th align="left" valign="top">Group ID</th><th align="left" valign="top">Artifact ID</th><th align="left" valign="top">Version</th></tr></thead><tbody><tr><td align="left" valign="top"><p>org.apache.zest.core</p></td><td align="left" valign="top"><p>org.apache.zest.core.runtime</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><p>See the <a class="xref" href="howto-depend-on-zest.html" title="Depend on Zest⢠in your build">Depend on Zest⢠in your build</a> tutorial for details.</p><p>Ready, Set, Go!</p><p>Letâs say we want to do the common HelloWorld example, but with a more domain-oriented setting. We have a Speaker interface that does the talking. But we also need an implementation for Speaker, which we declare here via the <code class="literal">@Mixins( SpeakerMixin.class )</code>.</p><pre class="programlisting brush: java">@Mixins( SpeakerMixin.class ) public interface Speaker @@ -112,7 +112,7 @@ The SingletonAssembler is a convenience We declare a TransientComposite of type <code class="literal">Speaker</code>. </li><li class="listitem"> We create the Composite instance from the Module. -</li></ol></div><p><span class="strong"><strong>Done!</strong></span></p></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="footer"><p> +</li></ol></div><p><span class="strong"><strong>Done!</strong></span></p><p>Next step, <a class="xref" href="ten-minutes-intro.html" title="Zest⢠in 10 minutes">Zest⢠in 10 minutes</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/what-is-cop.html URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/what-is-cop.html?rev=1739254&r1=1739253&r2=1739254&view=diff ============================================================================== --- zest/site/content/java/develop/what-is-cop.html (original) +++ zest/site/content/java/develop/what-is-cop.html Fri Apr 15 08:28:56 2016 @@ -73,9 +73,14 @@ potentially deserves one or more languag <a class="ulink" href="http://msdn.microsoft.com/en-us/windowsmobile/bb264332.aspx"; target="_top">Microsoft Permissive License</a> , more recently known as <a class="ulink" href="http://www.opensource.org/licenses/MS-PL"; target="_top">Microsoft Public License</a>. The content below -is NOT under the usual <a class="ulink" href="http://www.opensource.org/licenses/Apache-2.0"; target="_top">Apache License</a>.</p><p>We would like to thank Fredrik Kalseth for his explicit approval as well.</p><div class="section" title="Composite Oriented Programming"><div class="titlepage"><div><div><h4 class="title"><a id="_ulink_url_http_iridescence_no_post_composite_oriented_programming_aspx_composite_oriented_programming_ulink"></a><a class="ulink" href="http://iridescence.no/post/composite-oriented-programming.aspx"; target="_top">Composite Oriented Programming</a></h4></div></div></div><p>Iâve written a series of post on AOP lately (here, here and here), and in the last part I promised to tackle mixins -and introductions in a future post. When I was doing my research for just that, I came cross a Java framework (just -humor me :p) called Zest⢠(thatâs <span class="emphasis"><em>chee for jay</em></span>), written by Swedish Richard Ãberg, pioneering the idea of Composite +is NOT under the usual <a class="ulink" href="http://www.opensource.org/licenses/Apache-2.0"; target="_top">Apache License</a>.</p><p>We would like to thank Fredrik Kalseth for his explicit approval as well.</p><p>Since then, this article went offline but can be found on the +<a class="ulink" href="https://web.archive.org/web/20130414005509/http://iridescence.no/post/composite-oriented-programming.aspx"; target="_top">Internet Archive</a>.</p><div class="section" title="Composite Oriented Programming"><div class="titlepage"><div><div><h4 class="title"><a id="_ulink_url_http_iridescence_no_post_composite_oriented_programming_aspx_composite_oriented_programming_ulink"></a><a class="ulink" href="http://iridescence.no/post/composite-oriented-programming.aspx"; target="_top">Composite Oriented Programming</a></h4></div></div></div><p>Iâve written a series of post on AOP lately +(<a class="ulink" href="https://web.archive.org/web/20090417052136/http://www.iridescence.no/post/Aspect-Oriented-Programming---A-Primer.aspx"; target="_top">here</a>, +<a class="ulink" href="https://web.archive.org/web/20091222150653/http://www.iridescence.no/post/Implementing-an-AOP-Framework-Part-1.aspx"; target="_top">here</a> +and <a class="ulink" href="https://web.archive.org/web/20130417090819/http://www.iridescence.no/post/Implementing-an-AOP-Framework-Part-2.aspx"; target="_top">here</a>), +and in the last part I promised to tackle mixins and introductions in a future post. +When I was doing my research for just that, I came cross a Java framework (just +humor me :p) called Apache Zestâ¢, written by Swedish Richard Ãberg, pioneering the idea of Composite Oriented Programming, which instantly put a spell on me. Essentially, it takes the concepts from Aspect Oriented Programming to the extreme, and for the past week Iâve dug into it with a passion. This post is the first fruits of my labor.</p><div class="section" title="OOP is Not Object Oriented!"><div class="titlepage"><div><div><h5 class="title"><a id="_oop_is_not_object_oriented"></a>OOP is Not Object Oriented!</h5></div></div></div><p>One of the things that Richard Ãberg argues, is that OOP is not really object oriented at all, but rather class
