SGF-113 - Added support to return single entities from query methods.

If a query method returns a single entity it is now correctly unwrapped from the result collection returned by the query. No entities being found will result in null returned, more than one entity being found results in an IncorrectResultSizeDataAccessException to align with the other repository implementations.

src/test/java/org/springframework/data/gemfire/repository/sample/PersonRepository.java

@@ -42,4 +42,6 @@ public interface PersonRepository extends CrudRepository<Person, Long> {
 	Collection<Person> findByFirstnameAndLastname(String firstname, String lastname);
 
 	Collection<Person> findByFirstnameOrLastname(String firstname, String lastname);
+
+	Person findByLastname(String lastname);
 }

src/test/java/org/springframework/data/gemfire/repository/support/AbstractGemfireRepositoryFactoryIntegrationTests.java

@@ -26,6 +26,7 @@ import org.junit.Before;
 import org.junit.Test;
 import org.junit.runner.RunWith;
 import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.dao.IncorrectResultSizeDataAccessException;
 import org.springframework.data.gemfire.GemfireTemplate;
 import org.springframework.data.gemfire.mapping.GemfireMappingContext;
 import org.springframework.data.gemfire.mapping.Regions;
@@ -46,7 +47,7 @@ public abstract class AbstractGemfireRepositoryFactoryIntegrationTests {
 	@Autowired
 	List<Region<?, ?>> regions;
 
-	Person dave, carter, boyd, stefan, leroi, jeff;
+	Person dave, carter, boyd, stefan, leroi, jeff, oliverAugust;
 	PersonRepository repository;
 
 	@Before
@@ -58,6 +59,7 @@ public abstract class AbstractGemfireRepositoryFactoryIntegrationTests {
 		stefan = new Person(4L, "Stefan", "Lessard");
 		leroi = new Person(5L, "Leroi", "Moore");
 		jeff = new Person(6L, "Jeff", "Coffin");
+		oliverAugust = new Person(7L, "Oliver August", "Matthews");
 
 		GemfireMappingContext context = new GemfireMappingContext();
 
@@ -70,6 +72,7 @@ public abstract class AbstractGemfireRepositoryFactoryIntegrationTests {
 		template.put(stefan.id, stefan);
 		template.put(leroi.id, leroi);
 		template.put(jeff.id, jeff);
+		template.put(oliverAugust.id, oliverAugust);
 
 		repository = getRepository(regions);
 	}
@@ -105,7 +108,7 @@ public abstract class AbstractGemfireRepositoryFactoryIntegrationTests {
 
 	@Test
 	public void executesDerivedQueryWithOrCorrectly() {
-		assertResultsFound(repository.findByFirstnameOrLastname("Carter", "Matthews"), carter, dave);
+		assertResultsFound(repository.findByFirstnameOrLastname("Carter", "Matthews"), carter, dave, oliverAugust);
 	}
 
 	/**
@@ -119,6 +122,37 @@ public abstract class AbstractGemfireRepositoryFactoryIntegrationTests {
 		assertResultsFound(repository.findAll());
 	}
 
+	/**
+	 * @see SGF-113
+	 */
+	@Test
+	public void findsPersonByLastname() {
+		assertThat(repository.findByLastname("Beauford"), is(carter));
+	}
+
+	/**
+	 * @see SGF-113
+	 */
+	@Test
+	public void returnsNullForEmptyResultForSingleEntityQuery() {
+		assertThat(repository.findByLastname("Foo"), is(nullValue()));
+	}
+
+	/**
+	 * @see SGF-113
+	 */
+	@Test
+	public void throwsExceptionForMoreThanOneResultForSingleEntityQuery() {
+
+		try {
+			repository.findByLastname("Matthews");
+			fail("Exception expected!");
+		} catch (IncorrectResultSizeDataAccessException e) {
+			assertThat(e.getExpectedSize(), is(1));
+			assertThat(e.getActualSize(), is(2));
+		}
+	}
+
 	private <T> void assertResultsFound(Iterable<T> result, T... expected) {
 
 		assertThat(result, is(notNullValue()));

src/test/java/org/springframework/data/gemfire/repository/support/GemfireRepositoryFactoryIntegrationTests.java

@@ -38,7 +38,7 @@ public class GemfireRepositoryFactoryIntegrationTests extends AbstractGemfireRep
 	}
 
 	@Test(expected = IllegalStateException.class)
-	@SuppressWarnings("unchecked")
+	@SuppressWarnings({ "unchecked", "rawtypes" })
 	public void throwsExceptionIfReferencedRegionIsNotConfigured() {
 
 		GemfireRepositoryFactory factory = new GemfireRepositoryFactory((Iterable) Collections.emptySet(), null);