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

Format, organize imports, remove eclipse artifacts

Browse Source
This commit is contained in:
J. Brisbin
2011-03-15 11:57:55 -05:00
parent d4f358abd0
commit 032de81478
217 changed files with 14868 additions and 14762 deletions
Download Patch File Download Diff File Expand all files Collapse all files

159
src/docbkx/introduction/getting-started.xml
View File

@@ -1,72 +1,89 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<chapter id="get-started">
<title>Getting Started</title>
<para>Learning a new framework is not always straight forward. In this
section, we (the Spring Data team) tried to provide, what we think is, an
easy to follow guide for starting with Spring Data Document module. Of
course, feel free to create your own learning 'path' as you see fit and, if
possible, please report back any improvements to the documentation that can
help others.</para>
section, we (the Spring Data team) tried to provide, what we think is, an
easy to follow guide for starting with Spring Data Document module. Of
course, feel free to create your own learning 'path' as you see fit and, if
possible, please report back any improvements to the documentation that can
help others.
</para>
<section id="get-started:first-steps">
<title>First Steps</title>
<para>As explained in <xref linkend="why-Spring Data-Document" />, Spring
Data Document (DATADOC) provides integration between Spring framework and
document oriented data stores. Thus, it is important to become acquainted
with both of these frameworks (storages or environments depending on how
you want to name them). Throughout the DATADOC documentation, each section
provides links to resources relevant however, it is best to become
familiar with these topics beforehand.</para>
<para>As explained in<xref linkend="why-Spring Data-Document"/>, Spring
Data Document (DATADOC) provides integration between Spring framework and
document oriented data stores. Thus, it is important to become acquainted
with both of these frameworks (storages or environments depending on how
you want to name them). Throughout the DATADOC documentation, each section
provides links to resources relevant however, it is best to become
familiar with these topics beforehand.
</para>
<section id="get-started:first-steps:spring">
<title>Knowing Spring</title>
<para>Spring Data uses heavily Spring framework's <ulink
url="http://static.springframework.org/spring/docs/3.0.x/reference/spring-core.html">core</ulink>
functionality, such as the <ulink
url="http://static.springframework.org/spring/docs/3.0.x/reference/beans.html">IoC</ulink>
container, <ulink
url="http://static.springframework.org/spring/docs/3.0.x/reference/resources.html">resource</ulink>
abstract or <ulink
url="http://static.springframework.org/spring/docs/3.0.x/reference/aop.html">AOP</ulink>
infrastructure. While it is not important to know the Spring APIs,
understanding the concepts behind them is. At a minimum, the idea behind
IoC should be familiar. These being said, the more knowledge one has
about the Spring, the faster she will pick up Spring Data Document.
Besides the very comprehensive (and sometimes disarming) documentation
that explains in detail the Spring Framework, there are a lot of
articles, blog entries and books on the matter - take a look at the
Spring framework <ulink
url="http://www.springsource.org/documentation">home page</ulink> for
more information. In general, this should be the starting point for
developers wanting to try Spring Data Document.</para>
<para>Spring Data uses heavily Spring framework's
<ulink
url="http://static.springframework.org/spring/docs/3.0.x/reference/spring-core.html">core
</ulink>
functionality, such as the
<ulink
url="http://static.springframework.org/spring/docs/3.0.x/reference/beans.html">IoC
</ulink>
container,
<ulink
url="http://static.springframework.org/spring/docs/3.0.x/reference/resources.html">resource
</ulink>
abstract or
<ulink
url="http://static.springframework.org/spring/docs/3.0.x/reference/aop.html">AOP
</ulink>
infrastructure. While it is not important to know the Spring APIs,
understanding the concepts behind them is. At a minimum, the idea behind
IoC should be familiar. These being said, the more knowledge one has
about the Spring, the faster she will pick up Spring Data Document.
Besides the very comprehensive (and sometimes disarming) documentation
that explains in detail the Spring Framework, there are a lot of
articles, blog entries and books on the matter - take a look at the
Spring framework
<ulink
url="http://www.springsource.org/documentation">home page
</ulink>
for
more information. In general, this should be the starting point for
developers wanting to try Spring Data Document.
</para>
</section>
<section id="get-started:first-steps:nosql">
<title>Knowing NoSQL and Document stores</title>
<para>NoSQL stores have taken the storage world by storm. It is a vast
domain with a plethora of solutions, terms and patterns (to make things
worth even the term itself has multiple <ulink
url="http://www.google.com/search?q=nosoql+acronym">meanings</ulink>).
While some of the principles are common, it is crucial that the user is
familiar to some degree with the stores supported by DATADOC. The best
way to get acquainted to this solutions is to read their documentation
and follow their examples - it usually doesn't take more then 5-10
minutes to go through them and if you are coming from an RDMBS-only
background many times these exercises can be an eye opener.</para>
domain with a plethora of solutions, terms and patterns (to make things
worth even the term itself has multiple<ulink
url="http://www.google.com/search?q=nosoql+acronym">meanings</ulink>).
While some of the principles are common, it is crucial that the user is
familiar to some degree with the stores supported by DATADOC. The best
way to get acquainted to this solutions is to read their documentation
and follow their examples - it usually doesn't take more then 5-10
minutes to go through them and if you are coming from an RDMBS-only
background many times these exercises can be an eye opener.
</para>
</section>
<section id="get-started:first-steps:samples">
<title>Trying Out The Samples</title>
<para>The DATADOC project is very young but there are some samples
available in the GitHub repository: <ulink
url="https://github.com/SpringSource/spring-data-document-examples">https://github.com/SpringSource/spring-data-document-examples</ulink>.</para>
available in the GitHub repository:<ulink
url="https://github.com/SpringSource/spring-data-document-examples">
https://github.com/SpringSource/spring-data-document-examples</ulink>.
</para>
</section>
</section>
@@ -74,25 +91,31 @@
<title>Need Help?</title>
<para>If you encounter issues or you are just looking for an advice, feel
free to use one of the links below:</para>
free to use one of the links below:
</para>
<section id="get-started:help:community">
<title>Community Forum</title>
<para>The Spring Data <ulink
url="http://forum.springframework.org/forumdisplay.php?f=80">forum</ulink>
is a message board for all Spring Data (not just Document) users to
share information and help each other. Note that registration is needed
<emphasis>only</emphasis> for posting.</para>
<para>The Spring Data
<ulink
url="http://forum.springframework.org/forumdisplay.php?f=80">forum
</ulink>
is a message board for all Spring Data (not just Document) users to
share information and help each other. Note that registration is needed
<emphasis>only</emphasis>
for posting.
</para>
</section>
<section id="get-started:help:professional">
<title>Professional Support</title>
<para>Professional, from-the-source support, with guaranteed response
time, is available from <ulink
url="http://www.springsource.com">SpringSource</ulink>, the company
behind Spring Data and Spring.</para>
time, is available from<ulink
url="http://www.springsource.com">SpringSource</ulink>, the company
behind Spring Data and Spring.
</para>
</section>
</section>
@@ -100,24 +123,32 @@
<title>Following Development</title>
<para>For information on the Spring Data source code repository, nightly
builds and snapshot artifacts please see the Spring Data home <ulink
url="http://www.springsource.org/spring-data">page</ulink>.</para>
builds and snapshot artifacts please see the Spring Data home<ulink
url="http://www.springsource.org/spring-data">page</ulink>.
</para>
<para>You can help make Spring Data best serve the needs of the Spring
community by interacting with developers through the Spring Community
<ulink url="http://forum.springsource.org">forums</ulink>.</para>
community by interacting with developers through the Spring Community
<ulink url="http://forum.springsource.org">forums</ulink>.
</para>
<para>If you encounter a bug or want to suggest an improvement, please
create a ticket on the Spring Data issue <ulink
url="https://jira.springframework.org/browse/DATAKV">tracker</ulink>.</para>
create a ticket on the Spring Data issue<ulink
url="https://jira.springframework.org/browse/DATAKV">tracker</ulink>.
</para>
<para>To stay up to date with the latest news and announcements in the
Spring eco system, subscribe to the Spring Community <ulink
url="http://www.springframework.org/">Portal</ulink>.</para>
Spring eco system, subscribe to the Spring Community<ulink
url="http://www.springframework.org/">Portal</ulink>.
</para>
<para>Lastly, you can follow the SpringSource Data <ulink
url="http://blog.springsource.com/category/data-access/">blog</ulink> or
the project team on Twitter (<ulink
url="http://twitter.com/SpringData">SpringData</ulink>)</para>
<para>Lastly, you can follow the SpringSource Data
<ulink
url="http://blog.springsource.com/category/data-access/">blog
</ulink>
or
the project team on Twitter (<ulink
url="http://twitter.com/SpringData">SpringData</ulink>)
</para>
</section>
</chapter>