From f8b37b8501364a2c7aa2aadfc2b07fd2cee69b1e Mon Sep 17 00:00:00 2001
From: Oliver Gierke <info@olivergierke.de>
Date: Fri, 2 Dec 2011 13:31:02 +0100
Subject: [PATCH] DATACMNS-91 - Clarify contract for CrudRepository.

Added JavaDoc to document expected exceptions for null parameters.
---
 .../org/springframework/data/repository/CrudRepository.java  | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/spring-data-commons-core/src/main/java/org/springframework/data/repository/CrudRepository.java b/spring-data-commons-core/src/main/java/org/springframework/data/repository/CrudRepository.java
index 675f877c0..1e3a683df 100644
--- a/spring-data-commons-core/src/main/java/org/springframework/data/repository/CrudRepository.java
+++ b/spring-data-commons-core/src/main/java/org/springframework/data/repository/CrudRepository.java
@@ -39,7 +39,8 @@ public interface CrudRepository<T, ID extends Serializable> extends Repository<T
 	 * Saves all given entities.
 	 * 
 	 * @param entities
-	 * @return
+	 * @return the saved entities
+	 * @throws IllegalArgumentException in case the given entity is (@literal null}.
 	 */
 	Iterable<T> save(Iterable<? extends T> entities);
 
@@ -87,6 +88,7 @@ public interface CrudRepository<T, ID extends Serializable> extends Repository<T
 	 * Deletes a given entity.
 	 * 
 	 * @param entity
+	 * @throws IllegalArgumentException in case the given entity is (@literal null}.
 	 */
 	void delete(T entity);
 
@@ -94,6 +96,7 @@ public interface CrudRepository<T, ID extends Serializable> extends Repository<T
 	 * Deletes the given entities.
 	 * 
 	 * @param entities
+	 * @throws IllegalArgumentException in case the given {@link Iterable} is (@literal null}.
 	 */
 	void delete(Iterable<? extends T> entities);