You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@polygene.apache.org by ni...@apache.org on 2016/04/15 10:28:57 UTC
svn commit: r1739254 [1/9] - in /zest/site/content: ./ java/develop/
java/develop/css/ java/develop/images/icons/admon/
java/develop/images/icons/callouts/ java/develop/js/
java/develop/schemas/2008/dev-status/1/
Author: niclas
Date: Fri Apr 15 08:28:56 2016
New Revision: 1739254
URL: http://svn.apache.org/viewvc?rev=1739254&view=rev
Log:
Updated the 'develop' section of the documentation.
Modified:
zest/site/content/doap.rdf
zest/site/content/java/develop/core-api.html
zest/site/content/java/develop/core-bootstrap-assembly.html
zest/site/content/java/develop/core-functional.html
zest/site/content/java/develop/core-io.html
zest/site/content/java/develop/core-runtime.html
zest/site/content/java/develop/core-spi.html
zest/site/content/java/develop/core-testsupport.html
zest/site/content/java/develop/core.html
zest/site/content/java/develop/css/progressive-enhancement.css
zest/site/content/java/develop/css/shCore.css
zest/site/content/java/develop/css/shCoreEclipse.css
zest/site/content/java/develop/css/shThemeEclipse.css
zest/site/content/java/develop/css/style.css
zest/site/content/java/develop/css/zest.css
zest/site/content/java/develop/extension-cache-ehcache.html
zest/site/content/java/develop/extension-cache-memcache.html
zest/site/content/java/develop/extension-es-file.html
zest/site/content/java/develop/extension-es-hazelcast.html
zest/site/content/java/develop/extension-es-jclouds.html
zest/site/content/java/develop/extension-es-jdbm.html
zest/site/content/java/develop/extension-es-leveldb.html
zest/site/content/java/develop/extension-es-memory.html
zest/site/content/java/develop/extension-es-mongodb.html
zest/site/content/java/develop/extension-es-preferences.html
zest/site/content/java/develop/extension-es-redis.html
zest/site/content/java/develop/extension-es-riak.html
zest/site/content/java/develop/extension-es-sql.html
zest/site/content/java/develop/extension-index-elasticsearch.html
zest/site/content/java/develop/extension-index-rdf.html
zest/site/content/java/develop/extension-index-solr.html
zest/site/content/java/develop/extension-indexing-sql.html
zest/site/content/java/develop/extension-metrics-yammer.html
zest/site/content/java/develop/extension-migration.html
zest/site/content/java/develop/extension-reindexer.html
zest/site/content/java/develop/extension-vs-jackson.html
zest/site/content/java/develop/extension-vs-orgjson.html
zest/site/content/java/develop/extension-vs-stax.html
zest/site/content/java/develop/howto-assemble-application.html
zest/site/content/java/develop/howto-configure-service.html
zest/site/content/java/develop/howto-contextual-fragments.html
zest/site/content/java/develop/howto-create-concern.html
zest/site/content/java/develop/howto-create-constraint.html
zest/site/content/java/develop/howto-create-entity.html
zest/site/content/java/develop/howto-create-sideeffect.html
zest/site/content/java/develop/howto-leverage-properties.html
zest/site/content/java/develop/howto-use-io.html
zest/site/content/java/develop/images/icons/admon/caution.svg
zest/site/content/java/develop/images/icons/admon/important.svg
zest/site/content/java/develop/images/icons/admon/note.svg
zest/site/content/java/develop/images/icons/admon/tip.svg
zest/site/content/java/develop/images/icons/admon/warning.svg
zest/site/content/java/develop/images/icons/callouts/1.svg
zest/site/content/java/develop/images/icons/callouts/10.svg
zest/site/content/java/develop/images/icons/callouts/11.svg
zest/site/content/java/develop/images/icons/callouts/12.svg
zest/site/content/java/develop/images/icons/callouts/13.svg
zest/site/content/java/develop/images/icons/callouts/14.svg
zest/site/content/java/develop/images/icons/callouts/15.svg
zest/site/content/java/develop/images/icons/callouts/16.svg
zest/site/content/java/develop/images/icons/callouts/17.svg
zest/site/content/java/develop/images/icons/callouts/18.svg
zest/site/content/java/develop/images/icons/callouts/19.svg
zest/site/content/java/develop/images/icons/callouts/2.svg
zest/site/content/java/develop/images/icons/callouts/20.svg
zest/site/content/java/develop/images/icons/callouts/21.svg
zest/site/content/java/develop/images/icons/callouts/22.svg
zest/site/content/java/develop/images/icons/callouts/23.svg
zest/site/content/java/develop/images/icons/callouts/24.svg
zest/site/content/java/develop/images/icons/callouts/25.svg
zest/site/content/java/develop/images/icons/callouts/26.svg
zest/site/content/java/develop/images/icons/callouts/27.svg
zest/site/content/java/develop/images/icons/callouts/28.svg
zest/site/content/java/develop/images/icons/callouts/29.svg
zest/site/content/java/develop/images/icons/callouts/3.svg
zest/site/content/java/develop/images/icons/callouts/30.svg
zest/site/content/java/develop/images/icons/callouts/4.svg
zest/site/content/java/develop/images/icons/callouts/5.svg
zest/site/content/java/develop/images/icons/callouts/6.svg
zest/site/content/java/develop/images/icons/callouts/7.svg
zest/site/content/java/develop/images/icons/callouts/8.svg
zest/site/content/java/develop/images/icons/callouts/9.svg
zest/site/content/java/develop/index.html
zest/site/content/java/develop/javadocs.html
zest/site/content/java/develop/js/imagescaler.js
zest/site/content/java/develop/js/jquery.scrollTo-1.4.2.js
zest/site/content/java/develop/js/progressive-enhancement.js
zest/site/content/java/develop/js/shBrushAS3.js
zest/site/content/java/develop/js/shBrushAppleScript.js
zest/site/content/java/develop/js/shBrushBash.js
zest/site/content/java/develop/js/shBrushCSharp.js
zest/site/content/java/develop/js/shBrushColdFusion.js
zest/site/content/java/develop/js/shBrushCpp.js
zest/site/content/java/develop/js/shBrushCss.js
zest/site/content/java/develop/js/shBrushDelphi.js
zest/site/content/java/develop/js/shBrushDiff.js
zest/site/content/java/develop/js/shBrushErlang.js
zest/site/content/java/develop/js/shBrushGroovy.js
zest/site/content/java/develop/js/shBrushJScript.js
zest/site/content/java/develop/js/shBrushJava.js
zest/site/content/java/develop/js/shBrushJavaFX.js
zest/site/content/java/develop/js/shBrushPerl.js
zest/site/content/java/develop/js/shBrushPhp.js
zest/site/content/java/develop/js/shBrushPlain.js
zest/site/content/java/develop/js/shBrushPowerShell.js
zest/site/content/java/develop/js/shBrushPython.js
zest/site/content/java/develop/js/shBrushRuby.js
zest/site/content/java/develop/js/shBrushSass.js
zest/site/content/java/develop/js/shBrushScala.js
zest/site/content/java/develop/js/shBrushSql.js
zest/site/content/java/develop/js/shBrushVb.js
zest/site/content/java/develop/js/shBrushXml.js
zest/site/content/java/develop/js/tablestyler.js
zest/site/content/java/develop/lang-groovy.html
zest/site/content/java/develop/lang-javascript.html
zest/site/content/java/develop/lang-scala.html
zest/site/content/java/develop/library-alarm.html
zest/site/content/java/develop/library-circuitbreaker.html
zest/site/content/java/develop/library-constraints.html
zest/site/content/java/develop/library-conversion.html
zest/site/content/java/develop/library-eventsourcing.html
zest/site/content/java/develop/library-fileconfig.html
zest/site/content/java/develop/library-http.html
zest/site/content/java/develop/library-invocation-cache.html
zest/site/content/java/develop/library-jmx.html
zest/site/content/java/develop/library-locking.html
zest/site/content/java/develop/library-logging.html
zest/site/content/java/develop/library-metrics.html
zest/site/content/java/develop/library-osgi.html
zest/site/content/java/develop/library-rdf.html
zest/site/content/java/develop/library-rest-client.html
zest/site/content/java/develop/library-rest-common.html
zest/site/content/java/develop/library-rest-server.html
zest/site/content/java/develop/library-scheduler.html
zest/site/content/java/develop/library-servlet.html
zest/site/content/java/develop/library-shiro-web.html
zest/site/content/java/develop/library-shiro.html
zest/site/content/java/develop/library-spring.html
zest/site/content/java/develop/library-sql.html
zest/site/content/java/develop/library-uid.html
zest/site/content/java/develop/library-uowfile.html
zest/site/content/java/develop/schemas/2008/dev-status/1/dev-status.xsd
zest/site/content/java/develop/ten-minutes-intro.html
zest/site/content/java/develop/thirty-minutes-intro.html
zest/site/content/java/develop/tools-envisage.html
zest/site/content/java/develop/tut-composites.html
zest/site/content/java/develop/tut-services.html
zest/site/content/java/develop/two-minutes-intro.html
zest/site/content/java/develop/what-is-cop.html
Modified: zest/site/content/doap.rdf
URL: http://svn.apache.org/viewvc/zest/site/content/doap.rdf?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
Binary files - no diff available.
Modified: zest/site/content/java/develop/core-api.html
URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/core-api.html?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
--- zest/site/content/java/develop/core-api.html (original)
+++ zest/site/content/java/develop/core-api.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"><span xmlns="" href="core.html">Core</span></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="core.html#_overview_3">Overview</a></span></dt><dt><span class="section"><span xmlns="" href="core-api.html">Core API</span></span></dt><dt><span class="section"><a href="core-bootstrap-assembly.html">Core Bootstrap</a></span></dt><dt><span class="section"><a href="core-testsupport.html">Core Test Support</a></span></dt><dt><span class="section"><a href="core-functional.html">Core Functional API</a></span></dt><dt><span class="section"><a href="core-io.html">Core I/O API</a></span></dt><dt><span class="section"><a href="core-spi.html">Core Extension SPI</a></span></dt><dt><span class="section"><a href="core-runtime.html">Core Runtime</a></span></dt></dl></div></div><div class="section" title="Core API"><div class="titlepage"><div><div><h3 class="title"><a id="core-api"></a>Core
API</h3></div></div></div><p class="remark"><em><span class="comment"></span></em></p><p class="devstatus-code-stable">code</p><p class="devstatus-docs-good">docs</p><p class="devstatus-tests-good">tests</p><p>The Zest⢠Core API is the primary interface for client application code during the main execution phase, i.e. after the
-application has been activated.</p><div class="table"><a id="idm491907282656"></a><p class="title"><strong>Table 15. 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.api</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="Composition"><div class="titlepage"><div><div><h4 class="title"><a id="core-api-composition"></a>Composition</h4></div></div></div><p>Composition is at the heart of COP, and refers to two different levels of constructs;</p><div class="orderedlist"><ol class="orderedlis
t" type="1"><li class="listitem">
+application has been activated.</p><div class="table"><a id="idp140567695572400"></a><p class="title"><strong>Table 15. 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.api</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Composition"><div class="titlepage"><div><div><h4 class="title"><a id="core-api-composition"></a>Composition</h4></div></div></div><p>Composition is at the heart of COP, and refers to two different levels of constructs;</p><div class="orderedlist"><ol class="orderedlist" type=
"1"><li class="listitem">
the ability to assemble (compose) objects from smaller pieces, called Fragments.
</li><li class="listitem">
the construction of applications by assembling Composites into Modules and Modules into Layers.
@@ -216,12 +216,13 @@ public void assemble( ModuleAssembly mod
public void defaultValueSerialization()
{
- SomeValue someValue = someNewValueInstance( module ); // (3)
+ SomeValue someValue = someNewValueInstance(); // (3)
String json = someValue.toString(); // (4)
- SomeValue someNewValue = module.newValueFromSerializedState( SomeValue.class, json ); // (5)
+ SomeValue someNewValue = valueBuilderFactory.newValueFromSerializedState( SomeValue.class, json ); // (5)
[...snip...]
}
+
</pre><p>Reading this first example step by step we ;</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
declare a ValueComposite,
</li><li class="listitem">
@@ -248,6 +249,7 @@ public void assemble( ModuleAssembly mod
{
module.values( SomeValue.class ); // (2)
new OrgJsonValueSerializationAssembler().assemble( module ); // (3)
+ new DefaultUnitOfWorkAssembler().assemble( module );
}
[...snip...]
@@ -260,9 +262,9 @@ private ValueDeserializer valueDeseriali
public void assembledDefaultServiceSerialization()
{
- SomeValue someValue = someNewValueInstance( module ); // (5)
+ SomeValue someValue = someNewValueInstance(); // (5)
String json = valueSerializer.serialize( someValue ); // (6)
- SomeValue someNewValue = valueDeserializer.deserialize( SomeValue.class, json ); // (7)
+ SomeValue someNewValue = valueDeserializer.deserialize( module, SomeValue.class, json ); // (7)
[...snip...]
}
@@ -296,7 +298,7 @@ and finally, use the <code class="litera
InputStream input = sourceStream; // Eg. reading incoming JSON
// (4)
- List<AcmeValue> values = valueDeserializer.deserialize( CollectionType.listOf( AcmeValue.class ), input );
+ List<AcmeValue> values = valueDeserializer.deserialize( module, CollectionType.listOf( AcmeValue.class ), input );
[...snip...]
}
@@ -329,7 +331,7 @@ deserialize data from the <code class="l
List<AcmeValue> values = new ArrayList<AcmeValue>();
// (5)
- Function<String, AcmeValue> deserialize = valueDeserializer.deserialize( AcmeValue.class );
+ Function<String, AcmeValue> deserialize = valueDeserializer.deserialize( module, AcmeValue.class );
// Deserialization of a collection of AcmeValue from a String.
// One serialized AcmeValue per line.
@@ -552,7 +554,27 @@ It can not be serialized nor persisted.
hashcode/equals are not treated specially and will be delegated to fragment(s) implementing those methods.
</li><li class="listitem">
It can not be used as a Property type.
-</li></ul></div></div><div class="section" title="Mixin"><div class="titlepage"><div><div><h4 class="title"><a id="core-api-mixin"></a>Mixin</h4></div></div></div><p>Mixins are the state-carrying part of a Composite instance. The other Fragments can not retain state between method
+</li></ul></div></div><div class="section" title="Objects"><div class="titlepage"><div><div><h4 class="title"><a id="core-api-object"></a>Objects</h4></div></div></div><p>There are times when Apache Zest needs to interoperate with other systems, which
+does not have interfaces as their abstraction. Zest has a notion of
+Objects, which are Zest-managed classes and can still be injected with
+the Zest runtime model, such as @Structure and @Service.</p><p>The characteristics of an Object compared to Composite meta types are;</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem">
+It is a Class, not an interface.
+</li><li class="listitem">
+It can have injections applied to it after it has been created.
+</li><li class="listitem">
+No Mixins, Concerns or SideEffects.
+</li><li class="listitem">
+No Constraints.
+</li><li class="listitem">
+Can not have Property instances managed by the Zest runtime.
+</li></ul></div><div class="section" title="Serialization"><div class="titlepage"><div><div><h5 class="title"><a id="_serialization"></a>Serialization</h5></div></div></div><p>Objects can be serialized and deserialized using the ValueSerialization API, if and only
+if they are used as types in Properties in Values or Entities. It depends on the
+ValueSerialization implementation on how the objects are serialized, and
+what the requirements are to allow for deserialization. In general, the Spring
+POJO setter/getter approach will always work, a default constructor is needed, and
+to be safe, make it into <code class="literal">java.io.Serializable</code>.</p></div><div class="section" title="Usage"><div class="titlepage"><div><div><h5 class="title"><a id="_usage"></a>Usage</h5></div></div></div><p>Objects are instantiated either by calling <code class="literal">ObjectFactory.newObject( type, ⦠)</code> or
+instantiating it in some other fashion and then call <code class="literal">ObjectFactory.injectInto(â¦)</code>
+to populate the fields.</p></div></div><div class="section" title="Mixin"><div class="titlepage"><div><div><h4 class="title"><a id="core-api-mixin"></a>Mixin</h4></div></div></div><p>Mixins are the state-carrying part of a Composite instance. The other Fragments can not retain state between method
invocations as they are shared across Composite instances.</p><div class="section" title="Mixin Type"><div class="titlepage"><div><div><h5 class="title"><a id="_mixin_type"></a>Mixin Type</h5></div></div></div><p>The Mixin Type is the interface that declares the Mixin methods. Each Mixin implementation (the classes defined in
the @Mixins annotation of a Composite declaration) implements one or more methods from one or more Mixin Types.</p><p>Mixin Type can be very simple, like;</p><pre class="programlisting brush: java">public interface BankAccount
{
@@ -861,7 +883,7 @@ public interface FooModel
</pre><p>The DecoratorMixin expects that the implementation is found among the "@Uses" objects, so to create a view we simply
do;</p><pre class="programlisting brush: java">public View1 createView1( FooModel model )
{
- TransientBuilder<View1> builder = module.newTransientBuilder( View1.class );
+ TransientBuilder<View1> builder = transientBuilderFactory.newTransientBuilder( View1.class );
builder.use( model );
return builder.newInstance();
}
Modified: zest/site/content/java/develop/core-bootstrap-assembly.html
URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/core-bootstrap-assembly.html?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
--- zest/site/content/java/develop/core-bootstrap-assembly.html (original)
+++ zest/site/content/java/develop/core-bootstrap-assembly.html Fri Apr 15 08:28:56 2016
@@ -87,7 +87,7 @@ Set <span class="emphasis"><em>meta info
Import external services to be available as Zest⢠services.
</li><li class="listitem">
Tag services with markers
-</li></ul></div><div class="table"><a id="idm491906864720"></a><p class="title"><strong>Table 16. 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.bootstrap</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="Defining Objects"><div class="titlepage"><div><div><h4 class="title"><a id="_defining_objects"></a>Defining Objects</h4></div></div></div><pre class="programlisting brush: java">@Override
+</li></ul></div><div class="table"><a id="idp140567696003440"></a><p class="title"><strong>Table 16. 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.bootstrap</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Defining Objects"><div class="titlepage"><div><div><h4 class="title"><a id="_defining_objects"></a>Defining Objects</h4></div></div></div><pre class="programlisting brush: java">@Override
public void assemble( ModuleAssembly module )
throws AssemblyException
{
Modified: zest/site/content/java/develop/core-functional.html
URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/core-functional.html?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
--- zest/site/content/java/develop/core-functional.html (original)
+++ zest/site/content/java/develop/core-functional.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"><span xmlns="" href="core.html">Core</span></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="core.html#_overview_3">Overview</a></span></dt><dt><span class="section"><a href="core-api.html">Core API</a></span></dt><dt><span class="section"><a href="core-bootstrap-assembly.html">Core Bootstrap</a></span></dt><dt><span class="section"><a href="core-testsupport.html">Core Test Support</a></span></dt><dt><span class="section"><span xmlns="" href="core-functional.html">Core Functional API</span></span></dt><dt><span class="section"><a href="core-io.html">Core I/O API</a></span></dt><dt><span class="section"><a href="core-spi.html">Core Extension SPI</a></span></dt><dt><span class="section"><a href="core-runtime.html">Core Runtime</a></span></dt></dl></div></div><div class="section" title="Core Functional API"><div class="titlepage"><div><div><h3 class="title"><a id="core-fun
ctional"></a>Core Functional API</h3></div></div></div><p class="remark"><em><span class="comment"></span></em></p><p class="devstatus-code-beta">code</p><p class="devstatus-docs-good">docs</p><p class="devstatus-tests-good">tests</p><p>The Zest⢠Core Functional API is a generic package to work with Iterables in a "functional programming language" style.</p><p>This package is completely independent of everything else in Zest⢠and may be used on its own in any kind of environment
-such as Spring or Java EE applications.</p><div class="table"><a id="idm491906739376"></a><p class="title"><strong>Table 18. 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.functional</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="First Example"><div class="titlepage"><div><div><h4 class="title"><a id="_first_example"></a>First Example</h4></div></div></div><p>Letâs say that you have an Iterable of Integers and you want to sum them all up. Most people would create a loop and
+such as Spring or Java EE applications.</p><div class="table"><a id="idp140567696128640"></a><p class="title"><strong>Table 18. 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.functional</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="First Example"><div class="titlepage"><div><div><h4 class="title"><a id="_first_example"></a>First Example</h4></div></div></div><p>Letâs say that you have an Iterable of Integers and you want to sum them all up. Most people would create a loop and
sum it all up in something like this;</p><pre class="programlisting brush: java">Iterable<Long> data = new ArrayList<Long>();
[...snip...]
@@ -78,13 +78,9 @@ for( Long point : data )
sum = sum + point;
}
System.out.println( "The sum is " + sum );
-</pre><p>With the Zest⢠Core Functional API, you go about it in a different way. The code ends up looking like this;</p><pre class="programlisting brush: java">import static org.apache.zest.functional.ForEach.forEach;
-import static org.apache.zest.functional.Functions.longSum;
- [...snip...]
-
- Iterable<Number> data = new ArrayList<Number>();
- Long sum = forEach( data ).map( longSum() ).last();
- System.out.println( "The sum is " + sum );
+</pre><p>With the Zest⢠Core Functional API, you go about it in a different way. The code ends up looking like this;</p><pre class="programlisting brush: java">Iterable<Long> data = new ArrayList<>();
+Long total = StreamSupport.stream( data.spliterator(), true ).reduce( 0L, ( sum, n ) -> sum + n );
+System.out.println( "The sum is " + total );
</pre><p>And this is just the tip of the iceberg.</p></div><div class="section" title="The Big Picture"><div class="titlepage"><div><div><h4 class="title"><a id="_the_big_picture"></a>The Big Picture</h4></div></div></div><p>The Zest⢠Core Functional API are divided a handful of powerful concepts, especially when used together;</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem">
<span class="strong"><strong>Iterables</strong></span> - many methods to deal with Iterable data, so that the loops in your programs can largely be removed.
Modified: zest/site/content/java/develop/core-io.html
URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/core-io.html?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
--- zest/site/content/java/develop/core-io.html (original)
+++ zest/site/content/java/develop/core-io.html Fri Apr 15 08:28:56 2016
@@ -70,7 +70,7 @@
independently of Zest, together with the Zest⢠Core Functional API, which the Core I/O API depends on.</p><p>The Zest⢠Core I/O API tries to address the problem around shuffling data around from various I/O inputs and outputs,
possibly with transformations and filtering along the way. It was identified that there is a general mix-up of concerns
in the stereotypical I/O handling codebases that people deal with all the time. The reasoning around this, can be found
-in the <a class="xref" href="howto-use-io.html" title="Use I/O API">Use I/O API</a>, and is recommended reading.</p><div class="table"><a id="idm491906700976"></a><p class="title"><strong>Table 19. 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.io</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="The Problem"><div class="titlepage"><div><div><h4 class="title"><a id="_the_problem"></a>The Problem</h4></div></div></div><p>Why does I/O operations in Java have to be so complicated, with
nested try/catch/finally and loops? Donât you wish
+in the <a class="xref" href="howto-use-io.html" title="Use I/O API">Use I/O API</a>, and is recommended reading.</p><div class="table"><a id="idp140567696166928"></a><p class="title"><strong>Table 19. 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.io</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="The Problem"><div class="titlepage"><div><div><h4 class="title"><a id="_the_problem"></a>The Problem</h4></div></div></div><p>Why does I/O operations in Java have to be so complicated, with nested
try/catch/finally and loops? Donât you wish
that the operations could be expressed in a more natural way, such as;</p><pre class="programlisting brush: java">File source = ...
File destination = ...
source.copyTo( destination );</pre><p>It seems natural to do, yet it is not present for us. We need to involve FileInputStream/FileOutputStream, wrap them
@@ -155,7 +155,7 @@ the section First Example above.</p><p>T
}
@Override
- public T map( T t )
+ public T apply( T t )
{
count++;
return t;
@@ -186,9 +186,9 @@ transfer is complete, or in a separate t
}
@Override
- public T map( T t )
+ public T apply( T t )
{
- counter.map( t );
+ counter.apply( t );
if( counter.count % interval == 0 )
{
logProgress();
@@ -201,23 +201,16 @@ transfer is complete, or in a separate t
{
if( log != null )
{
- log.map( counter.count + "" );
+ log.apply( counter.count + "" );
}
}
}
</pre><p>It combines the Counter and the Log implementations, so that the count is forwarded to the Log at a given interval, such
as every 1000 items. This may not be what you think a ProgressLog should look like, but it serves as a good example on
-how you can combine the general principles found in the Zest⢠Core API package.</p></div><div class="section" title="How to write a filter specification?"><div class="titlepage"><div><div><h4 class="title"><a id="_how_to_write_a_filter_specification"></a>How to write a filter specification?</h4></div></div></div><p>The filter transform takes a specification implementation which has a very simple method, isSatisfiedBy() (read more
-about that in <a class="xref" href="core-functional.html" title="Core Functional API">Function</a>.</p><pre class="programlisting brush: java">public interface Specification<T>
-{
- [...snip...]
-
- boolean satisfiedBy( T item );
-}
-</pre><p>The only thing that the implementation need to do is return <span class="strong"><strong>true</strong></span> or <span class="strong"><strong>false</strong></span> for whether the item passed in is within
-the limits of the Specification. Letâs say that you have a IntegerRangeSpecification, which could then be implemented
-as</p><pre class="programlisting brush: java">public static class IntegerRangeSpecification
- implements Specification<Integer>
+how you can combine the general principles found in the Zest⢠Core API package.</p></div><div class="section" title="How to write a filter specification?"><div class="titlepage"><div><div><h4 class="title"><a id="_how_to_write_a_filter_specification"></a>How to write a filter specification?</h4></div></div></div><p>The filter transform takes a regular java.util.function.Predicate as an argument, where the implementation needs to
+return <span class="strong"><strong>true</strong></span> or <span class="strong"><strong>false</strong></span> for whether the item passed in is within
+the limits. Letâs say that you have a IntegerRangeSpecification, which could then be implemented as</p><pre class="programlisting brush: java">public static class IntegerRangeSpecification
+ implements Predicate<Integer>
{
private int lower;
@@ -230,7 +223,7 @@ as</p><pre class="programlisting brush:
}
@Override
- public boolean satisfiedBy( Integer item )
+ public boolean test( Integer item )
{
return item >= lower && item <= higher;
}
Modified: zest/site/content/java/develop/core-runtime.html
URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/core-runtime.html?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
--- zest/site/content/java/develop/core-runtime.html (original)
+++ zest/site/content/java/develop/core-runtime.html Fri Apr 15 08:28:56 2016
@@ -68,7 +68,7 @@
</head><body><div xmlns="" xmlns:exsl="http://exslt.org/common" class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common" class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml" class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><span xmlns="" href="core.html">Core</span></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="core.html#_overview_3">Overview</a></span></dt><dt><span class="section"><a href="core-api.html">Core API</a></span></dt><dt><span class="section"><a href="core-bootstrap-assembly.html">Core Bootstrap</a></span></dt><dt><span class="section"><a href="core-testsupport.html">Core Test Support</a></span></dt><dt><span class="section"><a href="core-functional.html">Core Functional API</a></span></dt><dt><span class="section"><a href="core-io.html">Core I/O API</a></span></dt><dt><span class="section"><a href="core-spi.html">Core Extension SPI</a></span></dt><dt><span class="section"><span xmlns="" href="core-runtime.html">Core Runtime</span></span></dt></dl></div></div><div class="section" title="Core Runtime"><div class="titlepage"><div><div><h3 class="title"><a id="core-runtime"><
/a>Core Runtime</h3></div></div></div><p class="remark"><em><span class="comment"></span></em></p><p class="devstatus-code-stable">code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-good">tests</p><p>First of all, your code should never, ever, have a dependency on Core Runtime. If you think you need this, you should
probably contact <a class="ulink" href="mailto:users@zest.apache.org" target="_top">users@zest.apache.org</a> mailing list and see if your usecase can either be solved in a existing way or
-perhaps that a new Core SPI Extension is needed.</p><div class="table"><a id="idm491906558640"></a><p class="title"><strong>Table 21. 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>Letâs repeat that; <span class="strong"><strong>Never, never, ever depend on Core Runtime</strong></span>. Make sure that the compile dependency does NOT include
+perhaps that a new Core SPI Extension is needed.</p><div class="table"><a id="idp140567696306768"></a><p class="title"><strong>Table 21. 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>Letâs repeat that; <span class="strong"><strong>Never, never, ever depend on Core Runtime</strong></span>. Make sure that the compile dependency does NOT include
the <code class="literal">org.apache.zest.core.runtime</code> jar.</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>
Modified: zest/site/content/java/develop/core-spi.html
URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/core-spi.html?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
--- zest/site/content/java/develop/core-spi.html (original)
+++ zest/site/content/java/develop/core-spi.html Fri Apr 15 08:28:56 2016
@@ -68,7 +68,7 @@
</head><body><div xmlns="" xmlns:exsl="http://exslt.org/common" class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common" class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml" class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><span xmlns="" href="core.html">Core</span></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="core.html#_overview_3">Overview</a></span></dt><dt><span class="section"><a href="core-api.html">Core API</a></span></dt><dt><span class="section"><a href="core-bootstrap-assembly.html">Core Bootstrap</a></span></dt><dt><span class="section"><a href="core-testsupport.html">Core Test Support</a></span></dt><dt><span class="section"><a href="core-functional.html">Core Functional API</a></span></dt><dt><span class="section"><a href="core-io.html">Core I/O API</a></span></dt><dt><span class="section"><span xmlns="" href="core-spi.html">Core Extension SPI</span></span></dt><dt><span class="section"><a href="core-runtime.html">Core Runtime</a></span></dt></dl></div></div><div class="section" title="Core Extension SPI"><div class="titlepage"><div><div><h3 class="title"><a id="core-spi"
></a>Core Extension SPI</h3></div></div></div><p class="remark"><em><span class="comment"></span></em></p><p class="devstatus-code-stable">code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-good">tests</p><p>The Zest⢠Core Runtime has a number of extension points, which we call the <span class="emphasis"><em>Zest Core Extension SPI</em></span>. These are defined
interfaces used <span class="strong"><strong>only</strong></span> by the Core Runtime and <span class="strong"><strong>never</strong></span> directly by application code. <a class="xref" href="extensions.html" title="Extensions">Extensions</a> are assembled in
-applications during the bootstrap phase.</p><div class="table"><a id="idm491906621072"></a><p class="title"><strong>Table 20. 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.spi</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><p>There are currently 5 Core SPI extensions;</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem">
+applications during the bootstrap phase.</p><div class="table"><a id="idp140567696244480"></a><p class="title"><strong>Table 20. 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.spi</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><p>There are currently 5 Core SPI extensions;</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem">
<a class="xref" href="core-spi.html#core-spi-valueserialization" title="ValueSerialization SPI">ValueSerialization SPI</a>
</li><li class="listitem">
<a class="xref" href="core-spi.html#core-spi-entitystore" title="EntityStore SPI">EntityStore SPI</a>
Modified: zest/site/content/java/develop/core-testsupport.html
URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/core-testsupport.html?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
--- zest/site/content/java/develop/core-testsupport.html (original)
+++ zest/site/content/java/develop/core-testsupport.html Fri Apr 15 08:28:56 2016
@@ -69,7 +69,7 @@
</head><body><div xmlns="" xmlns:exsl="http://exslt.org/common" class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common" class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml" class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><span xmlns="" href="core.html">Core</span></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="core.html#_overview_3">Overview</a></span></dt><dt><span class="section"><a href="core-api.html">Core API</a></span></dt><dt><span class="section"><a href="core-bootstrap-assembly.html">Core Bootstrap</a></span></dt><dt><span class="section"><span xmlns="" href="core-testsupport.html">Core Test Support</span></span></dt><dt><span class="section"><a href="core-functional.html">Core Functional API</a></span></dt><dt><span class="section"><a href="core-io.html">Core I/O API</a></span></dt><dt><span class="section"><a href="core-spi.html">Core Extension SPI</a></span></dt><dt><span class="section"><a href="core-runtime.html">Core Runtime</a></span></dt></dl></div></div><div class="section" title="Core Test Support"><div class="titlepage"><div><div><h3 class="title"><a id="core-tests
upport"></a>Core Test Support</h3></div></div></div><p class="remark"><em><span class="comment"></span></em></p><p class="devstatus-code-stable">code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-none">tests</p><p>Zest⢠comes with classes to help with testing. For general development, only a couple of classes are of interest as the
others are mostly for EntityStore and Index/Query SPI implementations. There is also some mocking support, to allow
some of Zestâs unique aspects to be mocked, but since Zest⢠is so flexible at a fine-granular level, we have found that
-mocking is seldom, if ever, needed.</p><div class="table"><a id="idm491906766624"></a><p class="title"><strong>Table 17. 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.testsupport</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="Your First Testcase"><div class="titlepage"><div><div><h4 class="title"><a id="_your_first_testcase"></a>Your First Testcase</h4></div></div></div><p>In most cases, you will probably use the AbstractZestTest class to simplify starting a Zest⢠test inst
ance.</p><pre class="programlisting brush: java">public class HelloTest extends AbstractZestTest
+mocking is seldom, if ever, needed.</p><div class="table"><a id="idp140567696101344"></a><p class="title"><strong>Table 17. 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.testsupport</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" title="Your First Testcase"><div class="titlepage"><div><div><h4 class="title"><a id="_your_first_testcase"></a>Your First Testcase</h4></div></div></div><p>In most cases, you will probably use the AbstractZestTest class to simplify starting a Zest⢠test instance.</p
><pre class="programlisting brush: java">public class HelloTest extends AbstractZestTest
{
[...snip...]
@@ -127,7 +127,7 @@ public interface Hello
be named anything).</p><p>And then we create the actual test;</p><pre class="programlisting brush: java">@Test
public void givenHelloValueInitializedToHelloWorldWhenCallingSayExpectHelloWorld()
{
- ValueBuilder<Hello> builder = module.newValueBuilder( Hello.class );
+ ValueBuilder<Hello> builder = valueBuilderFactory.newValueBuilder( Hello.class );
builder.prototypeFor( Hello.State.class ).phrase().set( "Hello" );
builder.prototypeFor( Hello.State.class ).name().set( "World" );
Hello underTest = builder.newInstance();
Modified: zest/site/content/java/develop/core.html
URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/core.html?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
--- zest/site/content/java/develop/core.html (original)
+++ zest/site/content/java/develop/core.html Fri Apr 15 08:28:56 2016
@@ -68,7 +68,7 @@
</head><body><div xmlns="" xmlns:exsl="http://exslt.org/common" class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common" class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml" class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><span xmlns="" href="core.html">Core</span></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"><span xmlns="" href="core.html#_overview_3">Overview</span></span></dt><dt><span class="section"><a href="core-api.html">Core API</a></span></dt><dt><span class="section"><a href="core-bootstrap-assembly.html">Core Bootstrap</a></span></dt><dt><span class="section"><a href="core-testsupport.html">Core Test Support</a></span></dt><dt><span class="section"><a href="core-functional.html">Core Functional API</a></span></dt><dt><span class="section"><a href="core-io.html">Core I/O API</a></span></dt><dt><span class="section"><a href="core-spi.html">Core Extension SPI</a></span></dt><dt><span class="section"><a href="core-runtime.html">Core Runtime</a></span></dt></dl></div></div><div class="section" title="Core"><div class="titlepage"><div><div><h2 class="title"><a id="core"></a>Core</h2></di
v></div></div><div class="section" title="Overview"><div class="titlepage"><div><div><h3 class="title"><a id="_overview_3"></a>Overview</h3></div></div></div><p>The Zest⢠Core is composed of several artifacts described in this section.</p><p>The following figure show the Core artifacts alongside <a class="link" href="libraries.html" title="Libraries">libraries</a> and <a class="link" href="extensions.html" title="Extensions">extensions</a>, and, in green,
typical applications artifacts. This is not a full code dependency graph but should give you a good overview of how the
-pieces fit together. Find out more about each of the Zest⢠Core artifacts below.</p><div class="figure"><a id="idm491907316736"></a><p class="title"><strong>Figure 1. Zest⢠Core Overview</strong></p><div class="figure-contents"><a class="ulink" href="images/core-overview.png" target="_top">
+pieces fit together. Find out more about each of the Zest⢠Core artifacts below.</p><div class="figure"><a id="idp140567694473504"></a><p class="title"><strong>Figure 1. Zest⢠Core Overview</strong></p><div class="figure-contents"><a class="ulink" href="images/core-overview.png" target="_top">
<span class="inlinemediaobject"><img src="images/core-overview.png" alt="core-overview.png" /></span>
</a></div></div><br class="figure-break" /><div class="section" title="Core API"><div class="titlepage"><div><div><h4 class="title"><a id="_core_api"></a>Core API</h4></div></div></div><p>The Zest⢠Core API is the primary interface for client application code during the main execution phase, i.e. after the
application has been activated.</p><p><a class="link" href="core-api.html" title="Core API">Learn more</a></p></div><div class="section" title="Core Bootstrap"><div class="titlepage"><div><div><h4 class="title"><a id="_core_bootstrap"></a>Core Bootstrap</h4></div></div></div><p>Zest⢠has a distinct bootstrap phase, also known as the <span class="emphasis"><em>Assembly</em></span> of an application, where the applications structure
Modified: zest/site/content/java/develop/css/progressive-enhancement.css
URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/css/progressive-enhancement.css?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
--- zest/site/content/java/develop/css/progressive-enhancement.css (original)
+++ zest/site/content/java/develop/css/progressive-enhancement.css Fri Apr 15 08:28:56 2016
@@ -1,20 +1,21 @@
/*
- * 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
+ * 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.
*/
/**
Modified: zest/site/content/java/develop/css/shCore.css
URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/css/shCore.css?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
--- zest/site/content/java/develop/css/shCore.css (original)
+++ zest/site/content/java/develop/css/shCore.css Fri Apr 15 08:28:56 2016
@@ -1,18 +1,21 @@
-/**
- * SyntaxHighlighter
- * http://alexgorbatchev.com/SyntaxHighlighter
+/*
+ * 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
*
- * SyntaxHighlighter is donationware. If you are using it, please donate.
- * http://alexgorbatchev.com/SyntaxHighlighter/donate.html
+ * 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.
*
- * @version
- * 3.0.83 (July 02 2010)
- *
- * @copyright
- * Copyright (C) 2004-2010 Alex Gorbatchev.
*
- * @license
- * Dual licensed under the MIT and GPL licenses.
*/
.syntaxhighlighter a,
.syntaxhighlighter div,
Modified: zest/site/content/java/develop/css/shCoreEclipse.css
URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/css/shCoreEclipse.css?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
--- zest/site/content/java/develop/css/shCoreEclipse.css (original)
+++ zest/site/content/java/develop/css/shCoreEclipse.css Fri Apr 15 08:28:56 2016
@@ -1,18 +1,21 @@
-/**
- * SyntaxHighlighter
- * http://alexgorbatchev.com/SyntaxHighlighter
+/*
+ * 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
*
- * SyntaxHighlighter is donationware. If you are using it, please donate.
- * http://alexgorbatchev.com/SyntaxHighlighter/donate.html
+ * 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.
*
- * @version
- * 3.0.83 (July 02 2010)
- *
- * @copyright
- * Copyright (C) 2004-2010 Alex Gorbatchev.
*
- * @license
- * Dual licensed under the MIT and GPL licenses.
*/
.syntaxhighlighter a,
.syntaxhighlighter div,
Modified: zest/site/content/java/develop/css/shThemeEclipse.css
URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/css/shThemeEclipse.css?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
--- zest/site/content/java/develop/css/shThemeEclipse.css (original)
+++ zest/site/content/java/develop/css/shThemeEclipse.css Fri Apr 15 08:28:56 2016
@@ -1,18 +1,21 @@
-/**
- * SyntaxHighlighter
- * http://alexgorbatchev.com/SyntaxHighlighter
+/*
+ * 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
*
- * SyntaxHighlighter is donationware. If you are using it, please donate.
- * http://alexgorbatchev.com/SyntaxHighlighter/donate.html
+ * 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.
*
- * @version
- * 3.0.83 (July 02 2010)
- *
- * @copyright
- * Copyright (C) 2004-2010 Alex Gorbatchev.
*
- * @license
- * Dual licensed under the MIT and GPL licenses.
*/
.syntaxhighlighter {
background-color: white !important;
Modified: zest/site/content/java/develop/css/style.css
URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/css/style.css?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
--- zest/site/content/java/develop/css/style.css (original)
+++ zest/site/content/java/develop/css/style.css Fri Apr 15 08:28:56 2016
@@ -1,17 +1,21 @@
/*
- * Copyright (c) 2012, Niclas Hedhman. All Rights Reserved.
+ * 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
*
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with 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.
*
- * 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.
*/
body
Modified: zest/site/content/java/develop/css/zest.css
URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/css/zest.css?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
--- zest/site/content/java/develop/css/zest.css (original)
+++ zest/site/content/java/develop/css/zest.css Fri Apr 15 08:28:56 2016
@@ -1,20 +1,21 @@
/*
- * 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
+ * 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.
*/
span.remark
Modified: zest/site/content/java/develop/extension-cache-ehcache.html
URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/extension-cache-ehcache.html?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
--- zest/site/content/java/develop/extension-cache-ehcache.html (original)
+++ zest/site/content/java/develop/extension-cache-ehcache.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"><a href="libraries.html">Libraries</a></span></dt><dt><span class="section"><span xmlns="" href="extensions.html">Extensions</span></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="extensions.html#_overview_7">Overview</a></span></dt><dt><span class="section"><a href="extension-vs-orgjson.html">org.json ValueSerialization</a></span></dt><dt><span class="section"><a href="extension-vs-jackson.html">Jackson ValueSerialization</a></span></dt><dt><span class="section"><a href="extension-vs-stax.html">StAX ValueSerialization</a></span></dt><dt><span class="section"><span xmlns="" href="extension-cache-ehcache.html">Ehcache Cache</span></span></dt><dt><span class="section"><a href="extension-cache-memcache.html">Memcache Cache</a></span></dt><dt><span class="section"><a href="extension-es-memory.html">Memory EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-file.html">File EntityStore</a></span></dt><dt><span class="section"><a href="ext
ension-es-hazelcast.html">Hazelcast EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-jclouds.html">JClouds EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-jdbm.html">JDBM EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-leveldb.html">LevelDB EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-mongodb.html">MongoDB EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-preferences.html">Preferences EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-redis.html">Redis EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-riak.html">Riak EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-sql.html">SQL EntityStore</a></span></dt><dt><span class="section"><a href="extension-index-elasticsearch.html">ElasticSearch Index/Query</a></span></dt><dt><span class="section"><a href="extension-index-rdf.html">O
penRDF Index/Query</a></span></dt><dt><span class="section"><a href="extension-index-solr.html">Apache Solr Index/Query</a></span></dt><dt><span class="section"><a href="extension-indexing-sql.html">SQL Index/Query</a></span></dt><dt><span class="section"><a href="extension-metrics-yammer.html">Yammer Metrics</a></span></dt><dt><span class="section"><a href="extension-migration.html">Migration</a></span></dt><dt><span class="section"><a href="extension-reindexer.html">Reindexer</a></span></dt></dl></div></div><div class="section" title="Ehcache Cache"><div class="titlepage"><div><div><h3 class="title"><a id="extension-cache-ehcache"></a>Ehcache Cache</h3></div></div></div><p class="remark"><em><span class="comment"></span></em></p><p class="devstatus-code-beta">code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-some">tests</p><p>EntityStore cache backed by <a class="ulink" href="http://ehcache.org/" target="_top">EhCache</a>.</p><div class="table"><a id="idm49
1905269136"></a><p class="title"><strong>Table 58. 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.extension</p></td><td align="left" valign="top"><p>org.apache.zest.extension.cache-ehcache</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><p>Not all EntityStore implementations use the Cache extension, so check the implementation details of the
+ </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"><span xmlns="" href="extensions.html">Extensions</span></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="extensions.html#_overview_7">Overview</a></span></dt><dt><span class="section"><a href="extension-vs-orgjson.html">org.json ValueSerialization</a></span></dt><dt><span class="section"><a href="extension-vs-jackson.html">Jackson ValueSerialization</a></span></dt><dt><span class="section"><a href="extension-vs-stax.html">StAX ValueSerialization</a></span></dt><dt><span class="section"><span xmlns="" href="extension-cache-ehcache.html">Ehcache Cache</span></span></dt><dt><span class="section"><a href="extension-cache-memcache.html">Memcache Cache</a></span></dt><dt><span class="section"><a href="extension-es-memory.html">Memory EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-file.html">File EntityStore</a></span></dt><dt><span class="section"><a href="ext
ension-es-hazelcast.html">Hazelcast EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-jclouds.html">JClouds EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-jdbm.html">JDBM EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-leveldb.html">LevelDB EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-mongodb.html">MongoDB EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-preferences.html">Preferences EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-redis.html">Redis EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-riak.html">Riak EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-sql.html">SQL EntityStore</a></span></dt><dt><span class="section"><a href="extension-index-elasticsearch.html">ElasticSearch Index/Query</a></span></dt><dt><span class="section"><a href="extension-index-rdf.html">O
penRDF Index/Query</a></span></dt><dt><span class="section"><a href="extension-index-solr.html">Apache Solr Index/Query</a></span></dt><dt><span class="section"><a href="extension-indexing-sql.html">SQL Index/Query</a></span></dt><dt><span class="section"><a href="extension-metrics-yammer.html">Yammer Metrics</a></span></dt><dt><span class="section"><a href="extension-migration.html">Migration</a></span></dt><dt><span class="section"><a href="extension-reindexer.html">Reindexer</a></span></dt></dl></div></div><div class="section" title="Ehcache Cache"><div class="titlepage"><div><div><h3 class="title"><a id="extension-cache-ehcache"></a>Ehcache Cache</h3></div></div></div><p class="remark"><em><span class="comment"></span></em></p><p class="devstatus-code-beta">code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-some">tests</p><p>EntityStore cache backed by <a class="ulink" href="http://ehcache.org/" target="_top">EhCache</a>.</p><div class="table"><a id="idp14
0567695380128"></a><p class="title"><strong>Table 58. 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.extension</p></td><td align="left" valign="top"><p>org.apache.zest.extension.cache-ehcache</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><p>Not all EntityStore implementations use the Cache extension, so check the implementation details of the
EntityStore whether the cache extension can bring any benefits or not.</p><div class="section" title="Assembly"><div class="titlepage"><div><div><h4 class="title"><a id="_assembly_8"></a>Assembly</h4></div></div></div><p>Assembly is done using the provided Assembler:</p><pre class="programlisting brush: java">public void assemble( ModuleAssembly module )
throws AssemblyException
{
Modified: zest/site/content/java/develop/extension-cache-memcache.html
URL: http://svn.apache.org/viewvc/zest/site/content/java/develop/extension-cache-memcache.html?rev=1739254&r1=1739253&r2=1739254&view=diff
==============================================================================
--- zest/site/content/java/develop/extension-cache-memcache.html (original)
+++ zest/site/content/java/develop/extension-cache-memcache.html Fri Apr 15 08:28:56 2016
@@ -68,7 +68,7 @@
</head><body><div xmlns="" xmlns:exsl="http://exslt.org/common" class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common" class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml" class="toc"><dl><dt><span class="section"><a href="index.html#home">Zestâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></span></dt><dt><span class="section"><span xmlns="" href="extensions.html">Extensions</span></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="extensions.html#_overview_7">Overview</a></span></dt><dt><span class="section"><a href="extension-vs-orgjson.html">org.json ValueSerialization</a></span></dt><dt><span class="section"><a href="extension-vs-jackson.html">Jackson ValueSerialization</a></span></dt><dt><span class="section"><a href="extension-vs-stax.html">StAX ValueSerialization</a></span></dt><dt><span class="section"><a href="extension-cache-ehcache.html">Ehcache Cache</a></span></dt><dt><span class="section"><span xmlns="" href="extension-cache-memcache.html">Memcache Cache</span></span></dt><dt><span class="section"><a href="extension-es-memory.html">Memory EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-file.html">File EntityStore</a></span></dt><dt><span class="section"><a href="ext
ension-es-hazelcast.html">Hazelcast EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-jclouds.html">JClouds EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-jdbm.html">JDBM EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-leveldb.html">LevelDB EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-mongodb.html">MongoDB EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-preferences.html">Preferences EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-redis.html">Redis EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-riak.html">Riak EntityStore</a></span></dt><dt><span class="section"><a href="extension-es-sql.html">SQL EntityStore</a></span></dt><dt><span class="section"><a href="extension-index-elasticsearch.html">ElasticSearch Index/Query</a></span></dt><dt><span class="section"><a href="extension-index-rdf.html">O
penRDF Index/Query</a></span></dt><dt><span class="section"><a href="extension-index-solr.html">Apache Solr Index/Query</a></span></dt><dt><span class="section"><a href="extension-indexing-sql.html">SQL Index/Query</a></span></dt><dt><span class="section"><a href="extension-metrics-yammer.html">Yammer Metrics</a></span></dt><dt><span class="section"><a href="extension-migration.html">Migration</a></span></dt><dt><span class="section"><a href="extension-reindexer.html">Reindexer</a></span></dt></dl></div></div><div class="section" title="Memcache Cache"><div class="titlepage"><div><div><h3 class="title"><a id="extension-cache-memcache"></a>Memcache Cache</h3></div></div></div><p class="remark"><em><span class="comment"></span></em></p><p class="devstatus-code-beta">code</p><p class="devstatus-docs-brief">docs</p><p class="devstatus-tests-some">tests</p><p>EntityStore cache backed by a Memcache server like <a class="ulink" href="http://memcached.org/" target="_top">Memcached</a>.</p><
p>Memcached is an in-memory key-value store for small chunks of arbitrary data.
By default, entities serialized state must not exceed 1MB.</p><p>Other implementations such as <a class="ulink" href="https://www.memcachier.com/" target="_top">MemCachier</a> have different peculiarities,
-see their documentation.</p><div class="table"><a id="idm491905244496"></a><p class="title"><strong>Table 59. 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.extension</p></td><td align="left" valign="top"><p>org.apache.zest.extension.cache-memcache</p></td><td align="left" valign="top"><p>3.0-SNAPSHOT</p></td></tr></tbody></table></div></div><br class="table-break" /><p>Not all EntityStore implementations use the Cache extension, so check the implementation details of the
+see their documentation.</p><div class="table"><a id="idp140567695403264"></a><p class="title"><strong>Table 59. 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.extension</p></td><td align="left" valign="top"><p>org.apache.zest.extension.cache-memcache</p></td><td align="left" valign="top"><p>0</p></td></tr></tbody></table></div></div><br class="table-break" /><p>Not all EntityStore implementations use the Cache extension, so check the implementation details of the
EntityStore whether the cache extension can bring any benefits or not.</p><div class="section" title="Assembly"><div class="titlepage"><div><div><h4 class="title"><a id="_assembly_9"></a>Assembly</h4></div></div></div><p>Assembly is done using the <code class="literal">MemcacheAssembler</code>:</p><pre class="programlisting brush: java">public void assemble( ModuleAssembly module )
throws AssemblyException
{