Added example for multi-store configuration.

multi-store/README.md

@@ -0,0 +1,18 @@
+# Spring Data - Multi-store example
+
+This sample shows a project working with multiple Spring Data modules and how the repository auto-detection has become more strict with the Evans release train.
+
+If you run `ApplicationConfigurationTest` you should see the following output:
+
+```
+… DEBUG … - Multiple Spring Data modules found, entering strict repository configuration mode!
+… 
+… DEBUG … - Spring Data JPA - Could not safely identify store assignment for repository candidate interface example.springdata.multistore.shop.OrderRepository.
+… DEBUG … - Spring Data JPA - Registering repository: customerRepository - Interface: example.springdata.multistore.customer.CustomerRepository - Factory: org.springframework.data.jpa.repository.support.JpaRepositoryFactoryBean
+… DEBUG … - Multiple Spring Data modules found, entering strict repository configuration mode!
+…
+… DEBUG … - Spring Data MongoDB - Could not safely identify store assignment for repository candidate interface example.springdata.multistore.customer.CustomerRepository.
+… DEBUG … - Spring Data MongoDB - Registering repository: orderRepository - Interface: example.springdata.multistore.shop.OrderRepository - Factory: org.springframework.data.mongodb.repository.support.MongoRepositoryFactoryBean
+```
+
+As you can see, Spring Data detects the fact that the application runs on multiple Spring Data modules. This triggers the strict configuration mode in which only repository interfaces will be detected that can be uniquely can be assigned to the module currently scanning. By default this is assignment is detected by inspecting the managed domain type for store specific annotations (e.g. `@Entity` for JPA or `@Document` for MongoDB).  

multi-store/pom.xml

@@ -0,0 +1,39 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+
+	<artifactId>spring-data-multi-store-example</artifactId>
+
+	<name>Spring Data MongoDB - Example</name>
+
+	<parent>
+		<groupId>org.springframework.data.examples</groupId>
+		<artifactId>spring-data-examples</artifactId>
+		<version>1.0.0.BUILD-SNAPSHOT</version>
+	</parent>
+	
+	<properties>
+		<spring-data-releasetrain.version>Evans-BUILD-SNAPSHOT</spring-data-releasetrain.version>
+	</properties>
+
+	<dependencies>
+
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-data-mongodb</artifactId>
+		</dependency>
+
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-data-jpa</artifactId>
+		</dependency>
+		
+		<dependency>
+			<groupId>org.hsqldb</groupId>
+			<artifactId>hsqldb</artifactId>
+			<scope>test</scope>
+		</dependency>
+
+	</dependencies>
+
+</project>

multi-store/src/main/java/example/springdata/multistore/ApplicationConfiguration.java

@@ -0,0 +1,36 @@
+/*
+ * Copyright 2014 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 example.springdata.multistore;
+
+import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.data.jpa.repository.config.EnableJpaRepositories;
+import org.springframework.data.mongodb.repository.config.EnableMongoRepositories;
+
+import com.mongodb.MongoClient;
+
+/**
+ * Test configuration to connect to a MongoDB named "test" and using a {@link MongoClient}. Also enables Spring Data
+ * repositories for MongoDB.
+ * 
+ * @author Oliver Gierke
+ */
+@Configuration
+@EnableAutoConfiguration
+// TODO: Remove explicit activation once Spring Boot has a more lenient repository detection
+@EnableJpaRepositories
+@EnableMongoRepositories
+public class ApplicationConfiguration {}

multi-store/src/main/java/example/springdata/multistore/customer/Address.java

@@ -0,0 +1,38 @@
+/*
+ * Copyright 2014 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 example.springdata.multistore.customer;
+
+import javax.persistence.Embeddable;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import org.springframework.data.geo.Point;
+
+/**
+ * A domain object to capture addresses.
+ * 
+ * @author Oliver Gierke
+ */
+@Getter
+@RequiredArgsConstructor
+@Embeddable
+public class Address {
+
+	private final Point location;
+	private String street;
+	private String zipCode;
+}

multi-store/src/main/java/example/springdata/multistore/customer/Customer.java

@@ -0,0 +1,57 @@
+/*
+ * Copyright 2014 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 example.springdata.multistore.customer;
+
+import javax.persistence.Entity;
+import javax.persistence.GeneratedValue;
+import javax.persistence.Id;
+
+import lombok.Data;
+
+import org.springframework.util.Assert;
+
+/**
+ * An entity to represent a customer.
+ * 
+ * @author Oliver Gierke
+ */
+@Data
+@Entity
+public class Customer {
+
+	private @Id @GeneratedValue Long id;
+	private String firstname, lastname;
+
+	private Address address;
+
+	/**
+	 * Creates a new {@link Customer} with the given firstname and lastname.
+	 * 
+	 * @param firstname must not be {@literal null} or empty.
+	 * @param lastname must not be {@literal null} or empty.
+	 */
+	public Customer(String firstname, String lastname) {
+
+		Assert.hasText(firstname, "Firstname must not be null or empty!");
+		Assert.hasText(lastname, "Lastname must not be null or empty!");
+
+		this.firstname = firstname;
+		this.lastname = lastname;
+	}
+
+	// Required by JPA
+	protected Customer() {}
+}

multi-store/src/main/java/example/springdata/multistore/customer/CustomerRepository.java

@@ -0,0 +1,25 @@
+/*
+ * Copyright 2014 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 example.springdata.multistore.customer;
+
+import org.springframework.data.repository.CrudRepository;
+
+/**
+ * Repository interface to manage {@link Customer} instances.
+ * 
+ * @author Oliver Gierke
+ */
+public interface CustomerRepository extends CrudRepository<Customer, Long> {}

multi-store/src/main/java/example/springdata/multistore/shop/LineItem.java

@@ -0,0 +1,43 @@
+/*
+ * Copyright 2013-2014 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 example.springdata.multistore.shop;
+
+import lombok.Data;
+import lombok.RequiredArgsConstructor;
+
+import org.springframework.data.annotation.PersistenceConstructor;
+
+/**
+ * A line item.
+ * 
+ * @author Thomas Darimont
+ * @author Oliver Gierke
+ */
+@Data
+@RequiredArgsConstructor(onConstructor = @__(@PersistenceConstructor))
+public class LineItem {
+
+	private final String caption;
+	private final double price;
+
+	int quantity = 1;
+
+	public LineItem(String caption, double price, int quantity) {
+
+		this(caption, price);
+		this.quantity = quantity;
+	}
+}

multi-store/src/main/java/example/springdata/multistore/shop/Order.java

@@ -0,0 +1,66 @@
+/*
+ * Copyright 2013-2014 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 example.springdata.multistore.shop;
+
+import java.util.ArrayList;
+import java.util.Date;
+import java.util.List;
+
+import lombok.Data;
+import lombok.RequiredArgsConstructor;
+
+import org.springframework.data.annotation.PersistenceConstructor;
+import org.springframework.data.mongodb.core.mapping.Document;
+
+/**
+ * An entity representing an {@link Order}. Note how we don't need any MongoDB mapping annotations as {@code id} is
+ * recognized as the id property by default.
+ * 
+ * @author Thomas Darimont
+ * @author Oliver Gierke
+ */
+@Data
+@RequiredArgsConstructor(onConstructor = @__(@PersistenceConstructor))
+@Document
+public class Order {
+
+	private final String id;
+	private final String customerId;
+	private final Date orderDate;
+	private final List<LineItem> items;
+
+	/**
+	 * Creates a new {@link Order} for the given customer id and order date.
+	 * 
+	 * @param customerId
+	 * @param orderDate
+	 */
+	public Order(String customerId, Date orderDate) {
+		this(null, customerId, orderDate, new ArrayList<LineItem>());
+	}
+
+	/**
+	 * Adds a {@link LineItem} to the {@link Order}.
+	 * 
+	 * @param item
+	 * @return
+	 */
+	public Order addItem(LineItem item) {
+
+		this.items.add(item);
+		return this;
+	}
+}

multi-store/src/main/java/example/springdata/multistore/shop/OrderRepository.java

@@ -0,0 +1,26 @@
+/*
+ * Copyright 2013-2014 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 example.springdata.multistore.shop;
+
+import org.springframework.data.repository.CrudRepository;
+
+/**
+ * A repository interface assembling CRUD functionality as well as the API to invoke the methods implemented manually.
+ * 
+ * @author Thomas Darimont
+ * @author Oliver Gierke
+ */
+public interface OrderRepository extends CrudRepository<Order, String> {}

multi-store/src/test/java/example/springdata/multistore/ApplicationConfigurationTest.java

@@ -0,0 +1,53 @@
+/*
+ * Copyright 2014 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 example.springdata.multistore;
+
+import static org.hamcrest.Matchers.*;
+import static org.junit.Assert.*;
+
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.SpringApplicationConfiguration;
+import org.springframework.context.ApplicationContext;
+import org.springframework.data.jpa.repository.support.JpaEntityInformation;
+import org.springframework.data.mongodb.repository.query.MongoEntityInformation;
+import org.springframework.data.repository.support.Repositories;
+import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
+
+import example.springdata.multistore.customer.Customer;
+import example.springdata.multistore.shop.Order;
+
+/**
+ * Integration test to check repository interfaces are assigned to the correct store modules.
+ * 
+ * @author Oliver Gierke
+ */
+@RunWith(SpringJUnit4ClassRunner.class)
+@SpringApplicationConfiguration(classes = ApplicationConfiguration.class)
+public class ApplicationConfigurationTest {
+
+	@Autowired ApplicationContext context;
+
+	@Test
+	public void repositoriesAreAssignedToAppropriateStores() {
+
+		Repositories repositories = new Repositories(context);
+
+		assertThat(repositories.getEntityInformationFor(Customer.class), is(instanceOf(JpaEntityInformation.class)));
+		assertThat(repositories.getEntityInformationFor(Order.class), is(instanceOf(MongoEntityInformation.class)));
+	}
+}

multi-store/src/test/resources/logback.xml

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+
+	<appender name="console" class="ch.qos.logback.core.ConsoleAppender">
+		<encoder>
+			<pattern>%d %5p %40.40c:%4L - %m%n</pattern>
+		</encoder>
+	</appender>
+
+	<logger name="org.springframework.data" level="debug" />
+
+	<root level="error">
+		<appender-ref ref="console" />
+	</root>
+
+</configuration>