Spring/spring-boot-data-geode
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Edit Abstract, Introduction and Getting Started sections for grammar.

Browse Source
This commit is contained in:
John Blum
2018-06-22 13:31:21 -07:00
parent 511dfab075
commit ded7ad8863
1 changed files with 32 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files

64
spring-geode-docs/src/docs/asciidoc/index.adoc
View File

@@ -47,32 +47,28 @@ built into Spring Data for Apache Geode/Pivotal GemFire (SDG) as of the Spring D
[[introduction]]
== Introduction
Spring Boot for Apache Geode & Pivotal GemFire automatically applies auto-configuration support for several key
Spring Boot for Apache Geode & Pivotal GemFire automatically applies _auto-configuration_ for several key
application concerns, or _Use Cases_, including, but not limited to:
* _Look-Aside Caching_, using either Apache Geode or Pivotal GemFire as the caching provider in
{spring-framework-docs}/integration.html#cache[Spring's Cache Abstraction].
* Using Apache Geode or Pivotal GemFire as a {wikipedia-docs}/System_of_record[_System of Record_ (SOR)] to persist
application state consistently and reliably with {spring-data-commons-docs-html}/#repositories[Spring Data Repositories].
* Running _distributed computations_ with Apache Geode/Pivotal GemFire's
{apache-geode-docs}/developing/function_exec/chapter_overview.html[Function Execution API],
conveniently invoked with Spring Data for Apache Geode/Pivotal GemFire
{spring-data-geode-docs-html}/#function-annotations[POJO-based, Annotation Support for Function Executions & Implementations].
* Registering interests in and reacting to a stream of events with Apache Geode/Pivotal GemFire
{apache-geode-docs}/developing/continuous_querying/chapter_overview.html[Continuous Query (CQ)]
where process handlers can be defined as simple Message-Driven POJOs (MDP) using Spring's
{spring-framework-docs}/integration.html#jms-mdp[Message Listener Container],
which is {spring-data-geode-docs-html}/#bootstrap-annotation-config-continuous-queries[configurable]
and {spring-data-geode-docs-html}/#apis:continuous-query[implemented]
in Spring Data for Apache Geode/Pivotal GemFire CQ.
* Data Serialization with Apache Geode/Pivotal GemFire {apache-geode-docs}/developing/data_serialization/gemfire_pdx_serialization.html[PDX]
for which Spring Data for Apache Geode/Pivotal GemFire provides first-class
{spring-data-geode-docs-html}/#bootstrap-annotation-config-pdx[configuration]
* {wikipedia-docs}/System_of_record[_System of Record_ (SOR)], persisting application state in Apache Geode
or Pivotal GemFire consistently and reliably using {spring-data-commons-docs-html}/#repositories[Spring Data Repositories].
* _Distributed Computations_, run with Apache Geode/Pivotal GemFire's
{apache-geode-docs}/developing/function_exec/chapter_overview.html[Function framework],
conveniently implemented and executed with Spring Data for Apache Geode/Pivotal GemFire
{spring-data-geode-docs-html}/#function-annotations[POJO, annotation-based Function Executions & Implementations].
* _Continuous Queries_, expressing interests in a stream of events, where applications are able to react to and process
changes to data in near real-time using Apache Geode/Pivotal GemFire {apache-geode-docs}/developing/continuous_querying/chapter_overview.html[Continuous Query (CQ)].
Process handlers can be defined as simple Message-Driven POJOs (MDP) using Spring's {spring-framework-docs}/integration.html#jms-mdp[Message Listener Container],
which is {spring-data-geode-docs-html}/#bootstrap-annotation-config-continuous-queries[configurable] and {spring-data-geode-docs-html}/#apis:continuous-query[implemented]
in Spring Data for Apache Geode/Pivotal GemFire CQ support.
* _Data Serialization_ with Apache Geode/Pivotal GemFire {apache-geode-docs}/developing/data_serialization/gemfire_pdx_serialization.html[PDX]
for which Spring Data for Apache Geode/Pivotal GemFire provides first-class {spring-data-geode-docs-html}/#bootstrap-annotation-config-pdx[configuration]
and {spring-data-geode-docs-html}/#mapping.pdx-serializer[support].
* Security, encompassing all aspects of the term, including
{apache-geode-docs}/managing/security/authentication_overview.html[Authentication]/{apache-geode-docs}/managing/security/authorization_overview.html[Authorization]
as well as Transport Layer Security (TLS) using Apache Geode/Pivotal GemFire's
{apache-geode-docs}/managing/security/ssl_overview.html[Secure Socket Layer (SSL)].
* _Security_, encompassing all aspects of the term, including
{apache-geode-docs}/managing/security/authentication_overview.html[Authentication] / {apache-geode-docs}/managing/security/authorization_overview.html[Authorization]
as well as Transport Layer Security (TLS) using Apache Geode/Pivotal GemFire's {apache-geode-docs}/managing/security/ssl_overview.html[Secure Socket Layer (SSL)].
And, once again, Spring Data for Apache Geode/Pivotal GemFire has you covered with both
{spring-data-geode-docs-html}/#bootstrap-annotation-config-security[Auth] and {spring-data-geode-docs-html}/#bootstrap-annotation-config-ssl[SSL].
@@ -83,23 +79,27 @@ configuring all these really powerful Apache Geode/Pivotal GemFire features, Spr
[[getting-started]]
== Getting Started
In order to be effective with and productive using Spring Boot for Apache Geode/Pivotal GemFire, it is helpful
In order to be as effective as possible and productive with Spring Boot for Apache Geode/Pivotal GemFire, it is helpful
to understand the foundation on which this project was built.
Of course, our story begins with the core Spring Framework itself, and specifically, the foundation laid down
by the Spring container's {spring-framework-docs}/core.html#spring-core[core technologies and concepts].
Of course, our story begins with the core Spring Framework and specifically the foundation laid down by
the Spring container's {spring-framework-docs}/core.html#spring-core[core technologies and concepts].
Then, our journey continues with the extensions built into Spring Data for Apache Geode & Pivotal GemFire (SDG) to truly
simplify the development of GemFire/Geode applications in a Spring context, using Spring's powerful and highly consistent
programming model. This part of the story was greatly enhanced in Spring Data Kay, with SDG's new
{spring-data-geode-docs-html}/#bootstrap-annotation-config[configuration model using annotations].
Though this new annotation-based configuration approach provides sensible defaults out-of-the-box, its use
is very explicit and it assumes nothing. That is, you still must tell SDG what you want.
simplify the development of Apache Geode & Pivotal GemFire applications in a Spring context, using Spring's powerful
and highly consistent programming model.
This part of the story was greatly enhanced in Spring Data *Kay*, with SDG's new
{spring-data-geode-docs-html}/#bootstrap-annotation-config[annotation-based configuration model].
Though this new configuration approach using annotations provides sensible defaults out-of-the-box, its use
is also very explicit and it assumes nothing. That is, you still must tell SDG what you want.
Next, we venture into Spring Boot and all of its wonderfully expressive and highly opinionated "_convention over configuration_"
approach for getting the most out of your Spring GemFire/Geode-based applications in the quickest/easiest way possible.
We do that by combining Spring Data for Apache Geode/Pivotal GemFire's Annotation-based Configuration with Spring Boot
using "_auto-configuration_" to get you going even faster and more reliably so that you are productive from the start.
approach for getting the most out of your Spring, Apache Geode or Pivotal GemFire based applications in the quickest/easiest way
possible. We accomplish this by combining Spring Data for Apache Geode/Pivotal GemFire's
{spring-data-geode-docs-html}/#bootstrap-annotation-config[annotation-based configuration] with Spring Boot's
{spring-boot-docs-html}/#using-boot-auto-configuration[auto-configuration] to get you up and running even faster
and more reliably so that you are productive from the start.
As such, it would be pertinent to begin your Spring Boot education {spring-boot-docs-html}/#getting-started[here].