From 5444e140176ad97cf6cb119c691fb90e9b9be996 Mon Sep 17 00:00:00 2001
From: Oliver Drotbohm <odrotbohm@pivotal.io>
Date: Fri, 22 Nov 2019 12:00:15 +0100
Subject: [PATCH] #1122 - Polishing.

---
 .../RepresentationModelAssemblerSupport.java  | 20 +++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

diff --git a/src/main/java/org/springframework/hateoas/server/mvc/RepresentationModelAssemblerSupport.java b/src/main/java/org/springframework/hateoas/server/mvc/RepresentationModelAssemblerSupport.java
index 4510c3f9..5c7a889c 100755
--- a/src/main/java/org/springframework/hateoas/server/mvc/RepresentationModelAssemblerSupport.java
+++ b/src/main/java/org/springframework/hateoas/server/mvc/RepresentationModelAssemblerSupport.java
@@ -64,7 +64,17 @@ public abstract class RepresentationModelAssemblerSupport<T, D extends Represent
 		return this.map(entities).toResources();
 	}
 
+	/**
+	 * Maps the given {@link Iterable} of entities to either a {@link CollectionModel} or simple List of
+	 * {@link RepresentationModel}s.
+	 *
+	 * @param entities must not be {@literal null}.
+	 * @return
+	 */
 	public Builder<T, D> map(Iterable<? extends T> entities) {
+
+		Assert.notNull(entities, "Entities must not be null!");
+
 		return new Builder<>(entities, this);
 	}
 
@@ -109,6 +119,13 @@ public abstract class RepresentationModelAssemblerSupport<T, D extends Represent
 		return BeanUtils.instantiateClass(this.resourceType);
 	}
 
+	/**
+	 * Intermediate type to allow the creation of either a {@link CollectionModel} or List of
+	 * {@link RepresentationModel}s.
+	 *
+	 * @author Greg Turnquist
+	 * @author Oliver Drotbohm
+	 */
 	static class Builder<T, D extends RepresentationModel<?>> {
 
 		private final Iterable<? extends T> entities;
@@ -138,8 +155,7 @@ public abstract class RepresentationModelAssemblerSupport<T, D extends Represent
 		}
 
 		/**
-		 * Converts all given entities into resources and wraps the result in a {@link CollectionModel}
-		 * instance.
+		 * Converts all given entities into resources and wraps the result in a {@link CollectionModel} instance.
 		 *
 		 * @see #toListOfResources() and {@link RepresentationModelAssembler#toModel(Object)}
 		 * @return