Defer MappingContext access inPersistentEntities.

We now fetch mapping contexts from Iterable<MappingContext> later, when accessing PersistentEntities API to defer potential resolution when e.g. obtaining beans from a BeanFactory.

Closes #3310

Author: mp911de

src/main/java/org/springframework/data/mapping/context/PersistentEntities.java

@@ -30,6 +30,7 @@
 import org.springframework.data.mapping.MappingException;
 import org.springframework.data.mapping.PersistentEntity;
 import org.springframework.data.mapping.PersistentProperty;
+import org.springframework.data.util.Lazy;
 import org.springframework.data.util.Streamable;
 import org.springframework.data.util.TypeInformation;
 import org.springframework.lang.Nullable;
@@ -46,7 +47,7 @@
  */
 public class PersistentEntities implements Streamable<PersistentEntity<?, ? extends PersistentProperty<?>>> {
 
-	private final Collection<? extends MappingContext<?, ? extends PersistentProperty<?>>> contexts;
+	private final Lazy<Collection<? extends MappingContext<?, ? extends PersistentProperty<?>>>> contexts;
 
 	/**
 	 * Creates a new {@link PersistentEntities} for the given {@link MappingContext}s.
@@ -58,9 +59,9 @@ public PersistentEntities(Iterable<? extends MappingContext<?, ?>> contexts) {
 
 		Assert.notNull(contexts, "MappingContexts must not be null");
 
-		this.contexts = contexts instanceof Collection
+		this.contexts = Lazy.of(() -> contexts instanceof Collection
 				? (Collection<? extends MappingContext<?, ? extends PersistentProperty<?>>>) contexts
-				: StreamSupport.stream(contexts.spliterator(), false).collect(Collectors.toList());
+				: StreamSupport.stream(contexts.spliterator(), false).toList());
 	}
 
 	/**
@@ -88,7 +89,7 @@ public static PersistentEntities of(MappingContext<?, ?>... contexts) {
 	 */
 	public Optional<PersistentEntity<?, ? extends PersistentProperty<?>>> getPersistentEntity(Class<?> type) {
 
-		for (MappingContext<?, ? extends PersistentProperty<?>> context : contexts) {
+		for (MappingContext<?, ? extends PersistentProperty<?>> context : getMappingContexts()) {
 			if (context.hasPersistentEntityFor(type)) {
 				return Optional.of(context.getRequiredPersistentEntity(type));
 			}
@@ -112,14 +113,16 @@ public static PersistentEntities of(MappingContext<?, ?>... contexts) {
 
 		Assert.notNull(type, "Domain type must not be null");
 
-		if (contexts.size() == 1) {
-			return contexts.iterator().next().getRequiredPersistentEntity(type);
+		Collection<? extends MappingContext<?, ? extends PersistentProperty<?>>> mappingContexts = getMappingContexts();
+
+		if (mappingContexts.size() == 1) {
+			return mappingContexts.iterator().next().getRequiredPersistentEntity(type);
 		}
 
 		return getPersistentEntity(type).orElseThrow(() -> {
 			return new MappingException(String.format(
 					"Cannot get or create PersistentEntity for type %s; PersistentEntities knows about %s MappingContext instances and therefore cannot identify a single responsible one; Please configure the initialEntitySet through an entity scan using the base package in your configuration to pre initialize contexts",
-					type.getName(), contexts.size()));
+					type.getName(), mappingContexts.size()));
 		});
 	}
 
@@ -138,14 +141,16 @@ public <T> Optional<T> mapOnContext(Class<?> type,
 		Assert.notNull(type, "Type must not be null");
 		Assert.notNull(combiner, "Combining BiFunction must not be null");
 
-		if (contexts.size() == 1) {
-			return contexts.stream() //
+		Collection<? extends MappingContext<?, ? extends PersistentProperty<?>>> mappingContexts = getMappingContexts();
+
+		if (mappingContexts.size() == 1) {
+			return mappingContexts.stream() //
 					.filter(it -> it.getPersistentEntity(type) != null) //
 					.map(it -> combiner.apply(it, it.getRequiredPersistentEntity(type))) //
 					.findFirst();
 		}
 
-		return contexts.stream() //
+		return mappingContexts.stream() //
 				.filter(it -> it.hasPersistentEntityFor(type)) //
 				.map(it -> combiner.apply(it, it.getRequiredPersistentEntity(type))) //
 				.findFirst();
@@ -160,7 +165,7 @@ public Streamable<TypeInformation<?>> getManagedTypes() {
 
 		Set<TypeInformation<?>> target = new HashSet<>();
 
-		for (MappingContext<?, ? extends PersistentProperty<?>> context : contexts) {
+		for (MappingContext<?, ? extends PersistentProperty<?>> context : getMappingContexts()) {
 			target.addAll(context.getManagedTypes());
 		}
 
@@ -172,7 +177,7 @@ public Streamable<TypeInformation<?>> getManagedTypes() {
 
 		List<PersistentEntity<?, ? extends PersistentProperty<?>>> target = new ArrayList<>();
 
-		for (MappingContext<?, ? extends PersistentProperty<?>> context : contexts) {
+		for (MappingContext<?, ? extends PersistentProperty<?>> context : getMappingContexts()) {
 			target.addAll(context.getPersistentEntities());
 		}
 
@@ -236,7 +241,7 @@ public TypeInformation<?> getTypeUltimatelyReferredToBy(PersistentProperty<?> pr
 	private PersistentEntity<?, ?> getEntityIdentifiedBy(TypeInformation<?> type) {
 
 		Collection<PersistentEntity<?, ?>> entities = new ArrayList<>();
-		for (MappingContext<?, ? extends PersistentProperty<?>> context : contexts) {
+		for (MappingContext<?, ? extends PersistentProperty<?>> context : getMappingContexts()) {
 
 			for (PersistentEntity<?, ? extends PersistentProperty<?>> persistentProperties : context
 					.getPersistentEntities()) {
@@ -261,4 +266,9 @@ public TypeInformation<?> getTypeUltimatelyReferredToBy(PersistentProperty<?> pr
 
 		return entities.isEmpty() ? null : entities.iterator().next();
 	}
+
+	private Collection<? extends MappingContext<?, ? extends PersistentProperty<?>>> getMappingContexts() {
+		return this.contexts.get();
+	}
+
 }

src/test/java/org/springframework/data/mapping/context/PersistentEntitiesUnitTests.java

@@ -35,7 +35,7 @@
  *
  * @author Oliver Gierke
  * @author Christoph Strobl
- * @author Mar Paluch
+ * @author Mark Paluch
  */
 @ExtendWith(MockitoExtension.class)
 class PersistentEntitiesUnitTests {
@@ -48,6 +48,16 @@ void rejectsNullMappingContexts() {
 		assertThatIllegalArgumentException().isThrownBy(() -> new PersistentEntities(null));
 	}
 
+	@Test // GH-3310
+	@SuppressWarnings({ "unchecked", "rawtypes" })
+	void lazilyAccessesIterableOfMappingContext() {
+
+		Iterable iterable = mock(Iterable.class);
+		new PersistentEntities(iterable);
+
+		verifyNoInteractions(iterable);
+	}
+
 	@Test // DATACMNS-458
 	void returnsPersistentEntitiesFromMappingContexts() {