From a832cd1e4739a1da0adaa454f9c5524eb218db79 Mon Sep 17 00:00:00 2001
From: Oliver Gierke <info@olivergierke.de>
Date: Thu, 3 Feb 2011 15:03:36 +0000
Subject: [PATCH] Added documentation for PagingAndSortingRepository.

---
 src/docbkx/repositories.xml | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/src/docbkx/repositories.xml b/src/docbkx/repositories.xml
index ea0a26021..8c5d51fa3 100644
--- a/src/docbkx/repositories.xml
+++ b/src/docbkx/repositories.xml
@@ -107,6 +107,27 @@
     to include additional technology specific methods. We will now ship
     implementations for a variety of Spring Data modules that implement that
     interface.</para>
+
+    <para>On top of the Repository there is a PagingAndSortingRepository
+    abstraction that adds additional methods to ease paginated access to
+    entities:</para>
+
+    <example>
+      <title>PagingAndSortingRepository</title>
+
+      <programlisting language="java">public interface PagingAndSortingRepository&lt;T, ID extends Serializable&gt; extends Repository&lt;T, ID&gt; {
+
+    List&lt;T&gt; findAll(Sort sort);
+
+    Page&lt;T&gt; findAll(Pageable pageable);
+}</programlisting>
+    </example>
+
+    <para>Accessing the second page of User by a page size of 20 you could
+    simply do something like this:</para>
+
+    <programlisting>PagingAndSortingRepository&lt;User, Long&gt; repository = // … get access to a bean
+Page&lt;User&gt; users = repository.findAll(new PageRequest(1, 20);</programlisting>
   </section>
 
   <section id="repositories.query-methods">
@@ -385,7 +406,7 @@ List&lt;User&gt; findByLastname(String lastname, Pageable pageable);</programlis
         <interfacename>UserRepository</interfacename> would be registered
         under <code>userRepository</code>. The <code>base-package</code>
         attribute allows to use wildcards, so that you can have a pattern of
-        packages parsed. </para>
+        packages parsed.</para>
 
         <simplesect>
           <title>Using filters</title>