Add support for deferred import selector group

This commit allows several DeferredImportSelector instances to be
grouped and managed in a centralized fashion. This typically allows
different instances to provide a consistent ordered set of imports to
apply.

Issue: SPR-16589
This commit is contained in:
Stephane Nicoll
2018-03-08 23:01:44 -08:00
parent 5f4d5f17f7
commit cc12afdea2
4 changed files with 403 additions and 18 deletions

View File

@@ -0,0 +1,61 @@
/*
* Copyright 2002-2018 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 org.springframework.context.annotation;
import org.junit.Test;
import org.springframework.context.annotation.DeferredImportSelector.Group;
import org.springframework.core.type.AnnotationMetadata;
import static org.junit.Assert.*;
import static org.mockito.Mockito.*;
/**
* Tests for {@link DeferredImportSelector}.
*
* @author Stephane Nicoll
*/
public class DeferredImportSelectorTests {
@Test
public void entryEqualsSameInstance() {
AnnotationMetadata metadata = mock(AnnotationMetadata.class);
Group.Entry entry = new Group.Entry(metadata, "com.example.Test");
assertEquals(entry, entry);
}
@Test
public void entryEqualsSameMetadataAndClassName() {
AnnotationMetadata metadata = mock(AnnotationMetadata.class);
assertEquals(new Group.Entry(metadata, "com.example.Test"),
new Group.Entry(metadata, "com.example.Test"));
}
@Test
public void entryEqualDifferentMetadataAndSameClassName() {
assertNotEquals(
new Group.Entry(mock(AnnotationMetadata.class), "com.example.Test"),
new Group.Entry(mock(AnnotationMetadata.class), "com.example.Test"));
}
@Test
public void entryEqualSameMetadataAnDifferentClassName() {
AnnotationMetadata metadata = mock(AnnotationMetadata.class);
assertNotEquals(new Group.Entry(metadata, "com.example.Test"),
new Group.Entry(metadata, "com.example.AnotherTest"));
}
}

View File

@@ -20,13 +20,19 @@ import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import java.util.Arrays;
import java.util.Collections;
import java.util.HashMap;
import java.util.Iterator;
import java.util.LinkedList;
import java.util.Map;
import java.util.concurrent.atomic.AtomicInteger;
import org.hamcrest.Matcher;
import org.junit.BeforeClass;
import org.junit.Before;
import org.junit.Test;
import org.mockito.InOrder;
import org.springframework.beans.BeansException;
import org.springframework.beans.factory.BeanClassLoaderAware;
import org.springframework.beans.factory.BeanFactory;
@@ -39,15 +45,20 @@ import org.springframework.core.annotation.Order;
import org.springframework.core.env.Environment;
import org.springframework.core.io.ResourceLoader;
import org.springframework.core.type.AnnotationMetadata;
import org.springframework.lang.Nullable;
import org.springframework.util.LinkedMultiValueMap;
import org.springframework.util.MultiValueMap;
import static org.hamcrest.CoreMatchers.*;
import static org.junit.Assert.*;
import static org.mockito.Mockito.any;
import static org.mockito.Mockito.*;
/**
* Tests for {@link ImportSelector} and {@link DeferredImportSelector}.
*
* @author Phillip Webb
* @author Stephane Nicoll
*/
@SuppressWarnings("resource")
public class ImportSelectorTests {
@@ -55,9 +66,11 @@ public class ImportSelectorTests {
static Map<Class<?>, String> importFrom = new HashMap<>();
@BeforeClass
public static void clearImportFrom() {
@Before
public void cleanup() {
ImportSelectorTests.importFrom.clear();
SampleImportSelector.cleanup();
TestImportGroup.cleanup();
}
@@ -94,6 +107,48 @@ public class ImportSelectorTests {
assertThat(importFrom.get(DeferredImportSelector2.class), isFromIndirect);
}
@Test
public void importSelectorsWithGroup() {
DefaultListableBeanFactory beanFactory = spy(new DefaultListableBeanFactory());
AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(beanFactory);
context.register(GroupedConfig.class);
context.refresh();
InOrder ordered = inOrder(beanFactory);
ordered.verify(beanFactory).registerBeanDefinition(eq("a"), any());
ordered.verify(beanFactory).registerBeanDefinition(eq("b"), any());
ordered.verify(beanFactory).registerBeanDefinition(eq("c"), any());
ordered.verify(beanFactory).registerBeanDefinition(eq("d"), any());
assertThat(TestImportGroup.instancesCount.get(), equalTo(1));
assertThat(TestImportGroup.imports.size(), equalTo(1));
assertThat(TestImportGroup.imports.values().iterator().next().size(), equalTo(2));
}
@Test
public void importSelectorsSeparateWithGroup() {
DefaultListableBeanFactory beanFactory = spy(new DefaultListableBeanFactory());
AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(beanFactory);
context.register(GroupedConfig1.class);
context.register(GroupedConfig2.class);
context.refresh();
InOrder ordered = inOrder(beanFactory);
ordered.verify(beanFactory).registerBeanDefinition(eq("c"), any());
ordered.verify(beanFactory).registerBeanDefinition(eq("d"), any());
assertThat(TestImportGroup.instancesCount.get(), equalTo(1));
assertThat(TestImportGroup.imports.size(), equalTo(2));
Iterator<AnnotationMetadata> iterator = TestImportGroup.imports.keySet().iterator();
assertThat(iterator.next().getClassName(), equalTo(GroupedConfig2.class.getName()));
assertThat(iterator.next().getClassName(), equalTo(GroupedConfig1.class.getName()));
}
@Test
public void invokeAwareMethodsInImportGroup() {
AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(GroupedConfig1.class);
assertThat(TestImportGroup.beanFactory, is(context.getBeanFactory()));
assertThat(TestImportGroup.classLoader, is(context.getBeanFactory().getBeanClassLoader()));
assertThat(TestImportGroup.resourceLoader, is(notNullValue()));
assertThat(TestImportGroup.environment, is(context.getEnvironment()));
}
@Configuration
@Import(SampleImportSelector.class)
@@ -109,6 +164,13 @@ public class ImportSelectorTests {
static BeanFactory beanFactory;
static Environment environment;
static void cleanup() {
SampleImportSelector.classLoader = null;
SampleImportSelector.beanFactory = null;
SampleImportSelector.resourceLoader = null;
SampleImportSelector.environment = null;
}
@Override
public void setBeanClassLoader(ClassLoader classLoader) {
SampleImportSelector.classLoader = classLoader;
@@ -255,4 +317,107 @@ public class ImportSelectorTests {
public static class IndirectImport {
}
@GroupedSample
@Configuration
static class GroupedConfig {
}
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Import({GroupedDeferredImportSelector1.class, GroupedDeferredImportSelector2.class, ImportSelector1.class, ImportSelector2.class})
public @interface GroupedSample {
}
@Configuration
@Import(GroupedDeferredImportSelector1.class)
static class GroupedConfig1 {
}
@Configuration
@Import(GroupedDeferredImportSelector2.class)
static class GroupedConfig2 {
}
public static class GroupedDeferredImportSelector1 extends DeferredImportSelector1 {
@Nullable
@Override
public Class<? extends Group> getImportGroup() {
return TestImportGroup.class;
}
}
public static class GroupedDeferredImportSelector2 extends DeferredImportSelector2 {
@Nullable
@Override
public Class<? extends Group> getImportGroup() {
return TestImportGroup.class;
}
}
public static class TestImportGroup implements DeferredImportSelector.Group,
BeanClassLoaderAware, ResourceLoaderAware, BeanFactoryAware, EnvironmentAware {
static ClassLoader classLoader;
static ResourceLoader resourceLoader;
static BeanFactory beanFactory;
static Environment environment;
static AtomicInteger instancesCount = new AtomicInteger();
static MultiValueMap<AnnotationMetadata, String> imports = new LinkedMultiValueMap<>();
public TestImportGroup() {
TestImportGroup.instancesCount.incrementAndGet();
}
static void cleanup() {
TestImportGroup.classLoader = null;
TestImportGroup.beanFactory = null;
TestImportGroup.resourceLoader = null;
TestImportGroup.environment = null;
TestImportGroup.instancesCount = new AtomicInteger();
TestImportGroup.imports.clear();
}
@Override
public void process(AnnotationMetadata metadata, DeferredImportSelector selector) {
TestImportGroup.imports.addAll(metadata,
Arrays.asList(selector.selectImports(metadata)));
}
@Override
public Iterable<Entry> selectImports() {
LinkedList<Entry> content = new LinkedList<>();
TestImportGroup.imports.forEach((metadata, values) ->
values.forEach(value -> content.add(new Entry(metadata, value))));
Collections.reverse(content);
return content;
}
@Override
public void setBeanClassLoader(ClassLoader classLoader) {
TestImportGroup.classLoader = classLoader;
}
@Override
public void setBeanFactory(BeanFactory beanFactory) throws BeansException {
TestImportGroup.beanFactory = beanFactory;
}
@Override
public void setResourceLoader(ResourceLoader resourceLoader) {
TestImportGroup.resourceLoader = resourceLoader;
}
@Override
public void setEnvironment(Environment environment) {
TestImportGroup.environment = environment;
}
}
}