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:[email protected]"
target="_top">[email protected]</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
{