Refactored and performed cleanup in the Spring Data GemFire Reference Guide. Added chapter on Bootstrapping a Spring ApplicationContext from GemFire using Gfsh.
This commit is contained in:
John Blum
@@ -1,14 +1,16 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<chapter xml:id="intro-introduction" xmlns="http://docbook.org/ns/docbook" version="5.0">
|
||||
<title>Introduction</title>
|
||||
|
||||
<para>This reference guide for the Spring Data GemFire project explains how to use Spring framework to
|
||||
configure and develop applications with vFabric GemFire.
|
||||
It presents the basic concepts, semantics and provides numerous examples to help you get started.
|
||||
</para>
|
||||
<title>Introduction</title>
|
||||
|
||||
<para>
|
||||
This reference guide for Spring Data GemFire explains how to use the Spring Framework to configure
|
||||
and develop applications with Pivotal GemFire. It presents the basic concepts, semantics and provides
|
||||
numerous examples to help you get started.
|
||||
</para>
|
||||
|
||||
<note>
|
||||
Spring Data GemFire started as a top-level Spring project called Spring GemFire (SGF) and since then
|
||||
has been moved under the Spring Data umbrella project and renamed accordingly.
|
||||
</note>
|
||||
|
||||
<note>Spring Data GemFire started as a top level Spring project called
|
||||
Spring GemFire (SGF) and has since moved under the Spring Data umbrella project
|
||||
and has been renamed accordingly.</note>
|
||||
</chapter>
|
||||
|
||||
|
||||
@@ -1,112 +1,248 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<chapter version="5.0" xml:id="new-features"
|
||||
xmlns="http://docbook.org/ns/docbook"
|
||||
xmlns:ns6="http://www.w3.org/1999/xlink"
|
||||
xmlns:ns5="http://www.w3.org/1999/xhtml"
|
||||
xmlns:ns4="http://www.w3.org/2000/svg"
|
||||
xmlns:ns3="http://www.w3.org/1998/Math/MathML"
|
||||
xmlns:ns="http://docbook.org/ns/docbook">
|
||||
<title>New Features</title>
|
||||
<chapter xml:id="new-features" xmlns="http://docbook.org/ns/docbook" version="5.0">
|
||||
<title>New Features</title>
|
||||
|
||||
<note>
|
||||
As of the 1.2.0 release, this project, formerly known as Spring GemFire, has been renamed to Spring Data GemFire to reflect that it is now a component of the
|
||||
<note>
|
||||
As of the 1.2.0 release, this project, formerly known as Spring GemFire, has been renamed to Spring Data GemFire
|
||||
to reflect that it is now a component of the
|
||||
<ulink url="http://www.springsource.org/spring-data">Spring Data</ulink> project.
|
||||
</note>
|
||||
|
||||
<ulink url="http://www.springsource.org/spring-data">Spring Data</ulink>
|
||||
<section id="new-in-1-2-0">
|
||||
<title>New in the 1.2.0 Release</title>
|
||||
|
||||
project.
|
||||
</note>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Full support for GemFire configuration via the SDG <emphasis>gfe</emphasis> namespace. Now GemFire
|
||||
components may be configured completely without requiring a native <emphasis>cache.xml</emphasis>
|
||||
file.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>WAN Gateway support for GemFire 6.6.x. See <xref linkend="bootstrap:gateway"/>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Spring Data Repository support using a dedicated SDG namespace, <emphasis>gfe-data</emphasis>.
|
||||
See <xref linkend="gemfire-repositories"/>
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Namespace support for registering GemFire Functions. See <xref linkend="bootstrap:function"/></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
A top-level <literal><disk-store></literal> element has been added to the SDG
|
||||
<emphasis>gfe</emphasis> namespace to allow sharing of persist stores among Regions,
|
||||
and other components that support persistent backup or overflow.
|
||||
See <xref linkend="bootstrap-diskstore"/>
|
||||
<caution>
|
||||
The <literal><*-region></literal> elements no longer allow a nested
|
||||
<literal><disk-store></literal>
|
||||
</caution>
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>GemFire Sub-Regions are supported via nested <literal><*-region></literal> elements.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>A <literal><local-region></literal> element has been added to configure a Local Region.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</section>
|
||||
|
||||
<section id="new-in-1-3-0">
|
||||
<title>New in the 1.3.0 Release</title>
|
||||
<section id="new-in-1-2-1">
|
||||
<title>New in the 1.2.1 Release</title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Annotation support for GemFire functions. It is now possible to
|
||||
declare and register functions written as POJOs with annotations. In
|
||||
addition function executions are defined as annotated interfaces,
|
||||
similar to the way Spring Data repositories work. See <xref
|
||||
linkend="function-annotations"/></para>
|
||||
</listitem>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Support for the re-designed WAN Gateway in GemFire 7.0.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</section>
|
||||
|
||||
<listitem>
|
||||
<para>We have added a <tag><datasource></tag> tag to the
|
||||
<emphasis>gfe-data</emphasis> XML namespace. This simplifies
|
||||
establishing a basic client <link
|
||||
linkend="data-access:datasource">connection</link> to a GemFire data
|
||||
grid.</para>
|
||||
</listitem>
|
||||
<section id="new-in-1-3-0">
|
||||
<title>New in the 1.3.0 Release</title>
|
||||
|
||||
<listitem>
|
||||
<para>To <link linkend="bootstrap:region:json">support JSON</link> features introduced in GemFire 7.0, we have
|
||||
added a ,<tag><json-region-autoproxy></tag> tag to the <emphasis>gfe-data</emphasis> XML
|
||||
namespace, enabling Spring AOP to perform the necessary conversions
|
||||
automatically on region operations.</para>
|
||||
</listitem>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Annotation support for GemFire Functions. It is now possible to declare and register Functions
|
||||
written as POJOs using annotations. In addition, Function executions are defined as
|
||||
annotated interfaces, similar to the way Spring Data Repositories work.
|
||||
See <xref linkend="function-annotations"/>.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Added a <tag><datasource></tag> element to the SDG <emphasis>gfe-data</emphasis> namespace to
|
||||
simplify establishing a basic <link linkend="data-access:datasource">client connection</link>
|
||||
to a GemFire data grid.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Added a <tag><json-region-autoproxy></tag> element to the SDG <emphasis>gfe-data</emphasis>
|
||||
namespace to <link linkend="bootstrap:region:json">support JSON</link> features introduced
|
||||
in GemFire 7.0, enabling Spring AOP to perform the necessary conversions automatically
|
||||
on Region operations.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Upgraded to GemFire 7.0.1 and added namespace support for new AsyncEventQueue attributes.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Added support for setting subscription interest policy on Regions.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</section>
|
||||
|
||||
<listitem>
|
||||
<para>Upgraded to GemFire 7.0.1 and added namespace support for new AsyncEventQueue attributes</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Added support for setting subscription interest policy on regions</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</section>
|
||||
<section id="new-in-1-3-1">
|
||||
<title>New in the 1.3.1 Release</title>
|
||||
|
||||
<section id="new-in-1-2-1">
|
||||
<title>New in the 1.2.1 Release</title>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Support for void returns on Function executions. See <xref linkend="function-annotations"/>
|
||||
for complete details.
|
||||
</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</section>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>WAN Gateway Support for GemFire 7.0</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</section>
|
||||
<section id="new-in-1-3-2">
|
||||
<title>New in the 1.3.2 Release</title>
|
||||
|
||||
<section id="new-in-1-2-0">
|
||||
<title>New in the 1.2.0 Release</title>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Support for persisting Local Regions. See <xref linkend="bootstrap:region:local"/> and
|
||||
<xref linkend="bootstrap:region:common:attributes"/>.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Support for entry time-to-live and entry idle-time on a GemFire Client Cache.
|
||||
See <xref linkend="bootstrap:cache:client"/>
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Support for multiple Spring Data GemFire web-based applications using a single GemFire cluster,
|
||||
operating concurrently inside tc Server.
|
||||
</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</section>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Full support for GemFire configuration via the
|
||||
<emphasis>gfe</emphasis> namespace. Now GemFire components may be
|
||||
configured completely without requiring a native cache.xml
|
||||
file.</para>
|
||||
</listitem>
|
||||
<section id="new-in-1-3-3">
|
||||
<title>New in the 1.3.3 Release</title>
|
||||
|
||||
<listitem>
|
||||
<para>WAN Gateway support for GemFire 6.6.x. See <xref
|
||||
linkend="bootstrap:gateway"/></para>
|
||||
</listitem>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Support for concurrency-checks-enabled on all GemFire Cache Region definitions using the SDG
|
||||
<emphasis>gfe</emphasis> namespace. See <xref linkend="bootstrap:region:common:attributes"/>.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Support for Cache Loaders and Cache Writers on Client, Local Regions.
|
||||
See <xref linkend="bootstrap:region:common:loaders-writers"/>.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Support for registering CacheListeners, AsyncEventQueues and Gateway Senders
|
||||
on GemFire Cache Sub-Regions.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Support for PDX persistent keys in GemFire Regions.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Support for correct Partition Region bean creation in a Spring context when collocation
|
||||
is specified with the <emphasis>colocated-with</emphasis> attribute.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Full support for GemFire Cache Sub-Regions using proper, nested <literal><*-region></literal>
|
||||
element syntax in the SDG <emphasis>gfe</emphasis> namespace.
|
||||
</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</section>
|
||||
|
||||
<listitem>
|
||||
<para>Spring Data Repository support with a dedicated namespace,
|
||||
<emphasis>gfe-data</emphasis>. See <xref
|
||||
linkend="gemfire-repositories"/></para>
|
||||
</listitem>
|
||||
<section id="new-in-1-3-4">
|
||||
<title>New in the 1.3.4 Release</title>
|
||||
|
||||
<listitem>
|
||||
<para>Namespace support for registering GemFire functions. See <xref
|
||||
linkend="bootstrap:function"/></para>
|
||||
</listitem>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Upgraded Spring Data GemFire to Spring Framework 3.2.8.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Upgraded Spring Data GemFire to Spring Data Commons 1.7.1.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</section>
|
||||
|
||||
<listitem>
|
||||
<para>A top level <literal><disk-store></literal> element has
|
||||
been added to the <emphasis>gfe</emphasis> namespace to allow sharing
|
||||
of persist stores among regions, and other components that support
|
||||
persistent backup. See <xref linkend="bootstrap-diskstore"/>
|
||||
<caution>The <literal><*-region></literal> elements no longer
|
||||
allow a nested <literal><disk-store></literal> </caution></para>
|
||||
</listitem>
|
||||
<section id="new-in-1-4-0">
|
||||
<title>New in the 1.4.0 Release</title>
|
||||
|
||||
<listitem>
|
||||
<para>GemFire subregions are supported via nested
|
||||
<literal><*-region></literal> elements</para>
|
||||
</listitem>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Upgrades Spring Data GemFire to GemFire 7.0.2.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Upgrades Spring Data GemFire to Spring Data Commons 1.8.0.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Integrates Spring Data GemFire with Spring Boot, which includes both a
|
||||
<emphasis>spring-boot-starter-data-gemfire </emphasis> POM along with a Spring Boot Sample
|
||||
application demonstrating GemFire Cache Transactions configured with SDG bootstrapped
|
||||
with Spring Boot.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Support for bootstrapping a Spring Context in a GemFire Server when started from Gfsh.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Support for persisting application domain object/entities to multiple GemFire Cache Regions.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Support for persisting application domain object/entities to GemFire Cache Sub-Regions, avoiding
|
||||
collisions when Sub-Regions are uniquely identifiable, but identically named.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Adds strict XSD type rules to, and full support for, Data Policies and Region Shortcuts on all
|
||||
GemFire Cache Region types.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Changed the default behavior of SDG <literal><*-region></literal> elements from lookup
|
||||
to always create a new Region along with an option to restore old behavior using the
|
||||
<emphasis>ignore-if-exists</emphasis> attribute.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Enables Spring Data GemFire to be fully built and ran on JDK 7 and JDK 8 (Note, however, GemFire
|
||||
has not yet been fully tested and supported on JDK 8;
|
||||
See <ulink url="http://pubs.vmware.com/vfabric53/topic/com.vmware.vfabric.gemfire.7.0/getting_started/system_requirements/supported_configurations.html">GemFire User Guide</ulink>
|
||||
for additional details.
|
||||
</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</section>
|
||||
|
||||
<listitem>
|
||||
<para>A <literal><local-region></literal> element has been added
|
||||
to configure a local region</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</section>
|
||||
</chapter>
|
||||
|
||||
@@ -1,9 +1,11 @@
|
||||
<chapter xml:id="requirements" xmlns="http://docbook.org/ns/docbook" version="5.0">
|
||||
<title>Requirements</title>
|
||||
<chapter xml:id="requirements" xmlns="http://docbook.org/ns/docbook" version="5.0">
|
||||
<title>Requirements</title>
|
||||
|
||||
<para>Spring Data GemFire requires JDK level 6.0 and above, Spring
|
||||
<ulink url="http://www.springsource.org/about">Framework</ulink> 3 and
|
||||
<ulink url="http://www.vmware.com/support/pubs/vfabric-gemfire.html">vFabric GemFire</ulink> 6.6 and above
|
||||
(version 7 or above is recommended).
|
||||
</para>
|
||||
</chapter>
|
||||
<para>
|
||||
Spring Data GemFire requires JDK 6.0 or above,
|
||||
<ulink url="http://www.springsource.org/about">Spring Framework</ulink> 3 and
|
||||
<ulink url="http://www.vmware.com/support/pubs/vfabric-gemfire.html">Pivotal GemFire</ulink>
|
||||
6.6 or above (version 7 or above is recommended).
|
||||
</para>
|
||||
|
||||
</chapter>
|
||||
|
||||
Reference in New Issue
Block a user