Reference preface edits.

This commit is contained in:
David Montag
2011-04-07 21:26:21 -07:00
parent 1a050d9dd1
commit 9324d4f013
4 changed files with 19 additions and 21 deletions

View File

@@ -88,8 +88,8 @@
<title>Reference</title>
<partintro>
<para>
This is the reference part of the book. It has information about the programming model, APIs,
concepts, and annotations of Spring Data Graph.
This is the reference part of the book. It has information about the
programming model, APIs, concepts, and annotations of Spring Data Graph.
</para>
</partintro>

View File

@@ -2,19 +2,17 @@
<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<preface id="reference:preface">
<title>Preface</title>
<para>The Spring Data Graph project applies core Spring concepts to the development of solutions using a graph style data store.
The basic approach is to mark simple POJO entities with Spring Data Graph annotations. That enables the AspectJ aspects that are contained
with the framework to adapt the instantiation and field access to have them stored and retrieved from the graph store.
Entities are mapped to nodes of the graph, references to other entities are represented by relationships. There are also
special relationship entities that provide access to the properties of graph relationships.
</para>
<para>
For the developer of a Spring Data Graph backed application only the public annotations
(<xref linkend="reference:programming_model:annotations"/>) and the additional,
added entity methods (<xref linkend="reference:programming-model:introduced-methods"/>) are relevant.
Basic knowledge of graph stores is needed to access advanced functionality like traversals.
Traversal results can also be mapped to fields of entities.
</para>
<title>Preface</title>
<para>
The Spring Data Graph project, as part of the Spring Data initiative, aims to simplify development
with graph databases. Like JPA, it uses annotations on simple POJO beans. The annotations activate
the AspectJ aspects in the Spring Data Graph framework, mapping the POJO entities and their fields
to nodes, relationships, and properties in the graph database.
</para>
<para>
To get started with a simple application, only the basic annotations
(see <xref linkend="reference:programming-model:annotations"/>) and the additional aspect-introduced
entity methods (see <xref linkend="reference:programming-model:introduced-methods"/>) are required.
Basic knowledge of graph stores is needed to access advanced functionality like traversals.
</para>
</preface>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id="reference:programming_model:annotations">
<section id="reference:programming-model:annotations">
<title>Annotations define POJO node entities</title>
<para>Entities are declared using the <code>@NodeEntity</code> annotation.
Relationship entities use the <code>@RelationshipEntity</code> annotation.

View File

@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<chapter id="reference_spring-data">
<title>Spring Data</title>
<chapter id="reference:spring-data">
<title>About Spring Data</title>
<para>
<ulink url="http://springsource.org/spring-data">Spring Data</ulink> is a SpringSource project that aims to
provide Spring's convenient programming model and well known conventions for NOSQL databases. Currently there
is support for Graph (e.g. Neo4j), Key-Value (e.g. Redis), Document (e.g. MongoDB) and Relational (e.g. Oracle)
is support for graph (e.g. Neo4j), key-value (e.g. Redis), document (e.g. MongoDB) and relational (e.g. Oracle)
databases. Mark Pollack, the author of Spring.NET is the project lead for the Spring Data project.
</para>
</chapter>