Spring4.2新特性(一)

1. 简介.

前些天spring4.2出来了, 从GA开始就一直在跟了, 前2天看完了所有官方Release Notes, 觉得记录下我比较感兴趣的特性.

我看的是4.2GA, 4.2RC3, 4.2RC2, 4.2RC1。4.0和4.1的新特性, 可以看看涛哥的博客。这里主要是讲照官方文档里面列的, changelog里面太多了 -.-!

2. 核心改进.

1) @Bean能注解在Java8默认方法上了, 例如:

@Configuration
public class Main implements DefaultIface {

    public String name = "main";

    public static void main(String[] args) {
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(Main.class);

        //会有两个Main实例, 一个是config实例, 用来做配置解析, 一个是我们@Bean注解的实例.
        Map<String, Main> bean = context.getBeansOfType(Main.class);
        System.out.println(bean);

        context.close();
    }

    @Override
    public String toString() {
        return "Main [name=" + name + "]";
    }
}

interface DefaultIface {

    @Bean
    default Main getMain() {
        Main main = new Main();
        main.name = "iface";
        return main;
    }
}

输出: {main=Main [name=main], getMain=Main [name=iface]}

可以看到, 我们注解在Java8默认方法上的@Bean注解已经生效了.

2) 配置类上的@Import以前只能引入配置类(注解了@Configuration等的类), 现在可以引入一般的组件了, 比如啥注解都没有的类.

@Import(Main.Dao.class)
@Configuration
public class Main {

    public static void main(String[] args) {
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(Main.class);

        Main.Dao bean = context.getBean(Main.Dao.class);
        System.out.println(bean);

        context.close();
    }

    public static class Dao {}
}

输出: com.haogrgr.test.main.Main$Dao@7f77e91b.

在4.2之前, 会报如下错误:

Exception in thread “main” org.springframework.beans.factory.parsing.BeanDefinitionParsingException: Configuration problem: com.haogrgr.test.main.Main$Dao was @Import’ed but is not annotated with @Configuration nor does it declare any @Bean methods; it does not implement ImportSelector or extend ImportBeanDefinitionRegistrar. Update the class to meet one of these requirements or do not attempt to @Import it.
Offending resource: class com.haogrgr.test.main.Main$Dao
at org.springframework.beans.factory.parsing.FailFastProblemReporter.error(FailFastProblemReporter.java:70)
at org.springframework.context.annotation.ConfigurationClassBeanDefinitionReader.registerBeanDefinitionForImportedConfigurationClass(ConfigurationClassBeanDefinitionReader.java:164)
…

3)配置类上现在可以注解@Order了, 使其能按预期的顺序来处理, 比如(通过名字来覆盖Bean配置等).

@Order(2)
@Configuration
public class Main {

    String name;

    @Bean
    public Main getMain() {
        Main main = new Main();
        main.name = "main";
        return main;
    }

    public static void main(String[] args) {
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(Main.class, SubMain.class);

        Main bean = context.getBean("getMain", Main.class);

        //@Order值大的, 会覆盖值小的, 比如如果submain的order为3, main的order为2时, 输出submain
        System.out.println(bean.name);

        context.close();
    }
}

@Order(3)
@Configuration
class SubMain {

    @Bean
    public Main getMain() {
        Main main = new Main();
        main.name = "submain";
        return main;
    }
}

输出: submain, 可以通过修改Order的值, 来使输出为 main.

注: 4.2之前, 是根据AnnotationConfigApplicationContext(Main.class, SubMain.class) 初始化时参数的顺序来处理的.

4) @Resource注解的元素, 现在可以配合@Lazy, 和@Autowired一样, 注入代理类, 来代理对应bean的请求.

@Import(ScopedBean.class)
@Configuration
public class Main {

    @Lazy @Resource ScopedBean bean;

    public static void main(String[] args) {
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(Main.class);

        Main bean = context.getBean(Main.class);

        //如果bean上没有@Lazy注解, 则2个获取的bean是一个实例, 加了@Lazy注解后, 则2次获取的是2个实例
        System.out.println(bean.bean);
        System.out.println(bean.bean);

        context.close();
    }
}

@Scope(value = ConfigurableBeanFactory.SCOPE_PROTOTYPE)
class ScopedBean {
}

输出:

1. 没加@Lazy时:

com.haogrgr.test.main.ScopedBean@525f1e4e

com.haogrgr.test.main.ScopedBean@525f1e4e

2. 加了@Lazy后:

com.haogrgr.test.main.ScopedBean@6293abcc

com.haogrgr.test.main.ScopedBean@7995092a

可以看到, 主要是为了方便实现Scope代理(或延迟获取, 比如注入时还没初始化等)情况, 也就是当singleton引用prototype时, 就需要@Lazy.

5) application event那套现在提供注解支持了, 比如以前常用的AppContextUtil(获取Context, 提供静态方法获取bean)现在可以这么写.

具体可以看这篇文章: http://spring.io/blog/2015/02/11/better-application-events-in-spring-framework-4-2

@Import(AppContextUtil.class)
@Configuration
public class Main {

    public static void main(String[] args) {
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(Main.class);

        Main bean = AppContextUtil.getBean(Main.class);
        System.out.println(bean);//输出:com.haogrgr.test.main.Main$$EnhancerBySpringCGLIB$$10ba9cf8@4ae3c1cd

        context.close();
    }
}

@Component
class AppContextUtil {

    private static ApplicationContext context = null;

    @EventListener
    public void setApplicationContext(ContextRefreshedEvent eve) {
        context = eve.getApplicationContext();
    }

    public static <T> T getBean(Class<T> clazz) {
        return context.getBean(clazz);
    }
}

EventListener的属性value和classes一样, 都是用来指定要处理的事件, condition属性可以使用spel来过滤event

还一个就是@TransactionalEventListener, 可以方便我在事务周期内处理一些事情, 比如事务提交后触发某一事件.

一个场景就是, 当插入记录提交事务后, 异步发送消息到其他系统, 或本地记录日志等操作, 现在可以通过TransactionalEventListener来做了.

注: 下面的代码仅供参考, 如果要运行, 自己搭一个数据库环境吧, 这里只贴了相关的代码.

@Service
public class TransactionEventTestService {

    @Resource
    private TestMapper mapper;

    @Resource
    private ApplicationEventPublisher publisher;

    @Transactional
    public void addTestModel() {
        TestModel model = new TestModel();
        model.setName("haogrgr");
        mapper.insert(model);

        //如果model没有继承ApplicationEvent, 则内部会包装为PayloadApplicationEvent
        //对于@TransactionalEventListener, 会在事务提交后才执行Listener处理逻辑.
        //
        //发布事件, 事务提交后, 记录日志, 或发送消息等操作
        publisher.publishEvent(model);
    }
    //当事务提交后, 才会真正的执行@TransactionalEventListener配置的Listener, 如果Listener抛异常, 方法返回失败, 但事务不会回滚.

}

@Component
public class TransactionEventListener {

    @TransactionalEventListener
    public void handle(PayloadApplicationEvent<TestModel> event) {
        System.out.println(event.getPayload().getName());
        //这里可以记录日志, 发送消息等操作.
        //这里抛出异常, 会导致addTestModel方法异常, 但不会回滚事务.
        //注意, ApplicationEventPublisher不能使用线程池, 否则不会执行到这里
        //因为, 包装类是通过ThreadLocal来判断当前是否有活动的事务信息.
        //TransactionalEventListener.fallbackExecution就是为了决定当当前线程没有事务上下文时,
        //是否还调用 handle 方法, 默认不调用.
    }
}

结果, 当调用addTestModel() 时, 会输出”haogrgr”。官方说的比较少, 看了下源码才知道怎么用, 内部是包装一下@TransactionalEventListener注解的方法,添加了一个适配器, ApplicationListenerMethodTransactionalAdapter，内部通过TransactionSynchronizationManager.registerSynchronization 注册一个同步器发布事务时, 记下event, 然后注册一个同步器TransactionSynchronizationEventAdapter,当事务提交后, TransactionSynchronizationManager会回调上面注册的同步适配器,这里注册就是放入到一个ThreadLocal里面, 通过它来透传参数。这时,TransactionSynchronizationEventAdapter内部才会真正的去调用handle方法.

6) 提供@AliasFor注解, 来给注解的属性起别名, 让使用注解时, 更加的容易理解(比如给value属性起别名, 更容易让人理解).

@MainBean(beanName = "mainbean")
public class Main {

    public static void main(String[] args) {
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(Main.class);

        String[] beannames = context.getBeanNamesForType(Main.class);

        //当加上@AliasFor时, 输出"mainbean"
        //当去掉@AliasFor注解后, 输出"main"
        System.out.println(beannames[0]);

        context.close();
    }
}

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Configuration
@interface MainBean {

    @AliasFor(annotation = Component.class, attribute = "value")
    String beanName() default "";
}

可以看到, 可以让注解中让人困惑的value更加让人理解, Spring4.2中大量的注解都为value添加了别名.

7) 其他一些的改进, 不细说了, 主要是内部的改进, Java8的Stream, 日期等支持, javax.money等支持,

commons-pool2支持, 脚本加强等, Hibernate5支持, JMS增强 等等等等.

​

4. 总结

Spring4.2提供了更多的注解支持。