added documeting test for derived queries

spring-data-neo4j/src/test/java/org/springframework/data/test/snippets/SnippetRepositoryDerivedFinderTest.java

@@ -0,0 +1,104 @@
+/**
+ * Copyright 2011 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.test.snippets;
+
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.neo4j.graphdb.Direction;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.data.neo4j.annotation.GraphId;
+import org.springframework.data.neo4j.annotation.NodeEntity;
+import org.springframework.data.neo4j.annotation.RelatedTo;
+import org.springframework.data.neo4j.support.GraphDatabaseContext;
+import org.springframework.data.test.DocumentingTestBase;
+import org.springframework.test.context.ContextConfiguration;
+import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.HashSet;
+import java.util.Set;
+
+import static java.util.Arrays.asList;
+import static org.hamcrest.core.Is.is;
+import static org.junit.Assert.assertThat;
+
+@RunWith(SpringJUnit4ClassRunner.class)
+@ContextConfiguration(locations = {"classpath*:DocumentingTest-context.xml"})
+public class SnippetRepositoryDerivedFinderTest extends DocumentingTestBase {
+    @Autowired GraphDatabaseContext graphDatabaseContext;
+    // SNIPPET derived
+    @NodeEntity
+    public static class Person {
+        @GraphId Long id;
+        private String name;
+        private Group group;
+
+        private Person(){}
+        public Person(String name) {
+            this.name = name;
+        }
+    }
+    @NodeEntity
+    public static class Group {
+        @GraphId Long id;
+        private String title;
+        // incoming relationship for the person -> group
+        @RelatedTo(type = "group", direction = Direction.INCOMING)
+        private Set<Person> members=new HashSet<Person>();
+
+        private Group(){}
+        public Group(String title, Person...people) {
+            this.title = title;
+            members.addAll(asList(people));
+        }
+    }
+    // SNIPPET derived
+    /*
+    // SNIPPET derived
+    public interface PersonRepository extends GraphRepository<Person> {
+        Iterable<Person> findByGroupTitle(String name);
+    }
+
+    // SNIPPET derived
+    */
+    // SNIPPET derived
+    @Autowired PersonRepository personRepository;
+
+    // SNIPPET derived
+    @Autowired GroupRepository groupRepository;
+
+    @Test
+    @Transactional
+    public void documentDerivedFinders() {
+        title ="Derived Finder Methods";
+        paragraphs = new String[] {"Use the meta information of your domain model classes to declare repository finders " +
+                "that navigate along relationships and compare properties. The path defined with the method name is used to " +
+                "create a cypher query that is executed on the graph."};
+
+        snippetTitle = "Repository and usage of derived finder methods";
+        snippet = "derived";
+
+        // SNIPPET derived
+        Person oliver=personRepository.save(new Person("Oliver"));
+        final Group springData = new Group("spring-data",oliver);
+        groupRepository.save(springData);
+
+        final Iterable<Person> members = personRepository.findByGroupTitle("spring-data");
+        assertThat(members.iterator().next().name, is(oliver.name));
+        // SNIPPET derived
+    }
+
+}

spring-data-neo4j/src/test/resources/DocumentingTest-context.xml

@@ -10,6 +10,7 @@
 
     <context:annotation-config/>
     <neo4j:config graphDatabaseService="graphDatabaseService"/>
-    <neo4j:repositories base-package="org.springframework.data.neo4j"/>
+    <neo4j:repositories base-package="org.springframework.data.test.snippets"/>
     <bean id="graphDatabaseService" class="org.neo4j.test.ImpermanentGraphDatabase"/>
+    <tx:annotation-driven/>
 </beans>

src/docbkx/reference/programming-model/repositories.xml

@@ -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:repositories">
+<section id="reference:programming-model:repositories" xmlns:xi="http://www.w3.org/2001/XInclude">
     <title>CRUD with repositories</title>
     <para>
         The repositories provided by Spring Data Neo4j build on the composable repository infrastructure
@@ -189,6 +189,7 @@
                 </variablelist>
             </para>
         </section>
+        <xi:include href="../../snippets/SnippetRepositoryDerivedFinder.xml"/>
     </section>
 
     <section>