一、当用getBeansOfType从IOC容器中获取某种类型的bean时,若IOC容器中同时存在多于一个,则会把所有满足条件的bean都找出来。如下实例:创建一个接口EncodingConvert,创建该接口的两个实现类GBKEncodingConvert和UTF8EncodingConvert,并把两个实现类注入到IOC容器中,当从IOC容器中获取EncodingConvert类型的bean时,会同时获取到两个bean。代码如下:

EncodingConvert 接口:

package com.xi.springbootdemo.conditional;

public interface EncodingConvert {
}

GBKEncodingConvert 实现类:

package com.xi.springbootdemo.conditional;

public class GBKEncodingConvert implements EncodingConvert{
}

UTF8EncodingConvert 实现类:

package com.xi.springbootdemo.conditional;

public class UTF8EncodingConvert implements EncodingConvert{
}

EncodingConvertConfiguration 配置类,用来把上面的两个实现类注入到IOC容器中

package com.xi.springbootdemo.conditional;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class EncodingConvertConfiguration {

    @Bean
    public EncodingConvert createGBKEncodingConvert(){
        return new GBKEncodingConvert();
    }

    @Bean
    public EncodingConvert createUTF8EncodingConvert(){
        return new UTF8EncodingConvert();
    }
}

启动类:

package com.xi.springbootdemo.conditional;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.ConfigurableApplicationContext;
import org.springframework.context.annotation.Configuration;

@SpringBootApplication
public class App {
    public static void main(String[] args){
        SpringApplication app=new SpringApplication(App.class);
        ConfigurableApplicationContext context = app.run(args);
        System.out.println(context.getBeansOfType(EncodingConvert.class));
    }
}

输出结果为:

{createGBKEncodingConvert=com.xi.springbootdemo.conditional.GBKEncodingConvert@9255c05, createUTF8EncodingConvert=com.xi.springbootdemo.conditional.UTF8EncodingConvert@5da7cee2}

从输出结果可以看出,同时或得了两个实现类的bean。

二、当IOC容器中有多于一个同类型的bean时,有时我们需要根据某种条件去选择加载其中的某个bean,此时可以通过@Conditional注解去条件化的加载某个bean。代码如下:

EncodingConvert 接口与GBKEncodingConvert实现类和UTF8EncodingConvert实现类代码相同。

下面定义加载GBKEncodingConvert类的条件类GBKCondition ,当类中的matches方法返回true时,就把GBKEncodingConvert的bean注入到IOC容器中(注入的时候还要用@Conditional来指定),反之,则不注入。 
GBKCondition 类:

package com.xi.springbootdemo.conditional;

import org.springframework.context.annotation.Condition;
import org.springframework.context.annotation.ConditionContext;
import org.springframework.core.type.AnnotatedTypeMetadata;

public class GBKCondition implements Condition {
    /*判断编码方式是否为gbk*/
    @Override
    public boolean matches(ConditionContext conditionContext, AnnotatedTypeMetadata annotatedTypeMetadata) {
        String encoding = System.getProperty("file.encoding");
        if(encoding != null){
            return "UTF-8".equals(encoding.toLowerCase());
        }
        return false;
    }
}

同理,UTF8EncodingConvert的条件类UTF8Condition 为:

package com.xi.springbootdemo.conditional;

import org.springframework.context.annotation.Condition;
import org.springframework.context.annotation.ConditionContext;
import org.springframework.core.type.AnnotatedTypeMetadata;

public class UTF8Condition implements Condition {

    @Override
    /*判断编码方式是否为utf-8*/
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        String encoding = System.getProperty("file.encoding");
        if(encoding != null){
            return "utf-8".equals(encoding.toLowerCase());
        }
        return false;
    }

}

EncodingConvertConfiguration 配置类,用来把UTF8EncodingConvert和GBKEncodingConvert两个实现类根据@Conditional注解中的条件类进行注入bean。如果条件类中的matches方法为true,则把标注的bean注入到IOC容器中,反之不注入。

package com.xi.springbootdemo.conditional;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Conditional;
import org.springframework.context.annotation.Configuration;

@Configuration
public class EncodingConvertConfiguration {

    @Bean
//    判断条件
    @Conditional(GBKCondition.class)
    public EncodingConvert createGBKEncodingConvert(){
        return new GBKEncodingConvert();
    }

    @Bean
    @Conditional(UTF8Condition.class)
    public EncodingConvert createUTF8EncodingConvert(){
        return new UTF8EncodingConvert();
    }
}

启动类为:

--UTF-8
{createUTF8EncodingConvert=com.xi.springbootdemo.conditional.UTF8EncodingConvert@3fae596}

从结果可以看出,当前编码方式为UTF-8,所以只把UTF8EncodingConvert类的bean注入到了IOC容器中。

三、@Conditional注解的其它用法 
1、@Conditional的注解不只用在方法上,还可以用在类上,这点从源码中可以看出:

/*@Target表明Conditional注解可以用在类或者方法上*/
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Conditional {
    ......
}

当@Conditional注解用在类上时,表示@Conditional中指定的条件返回true时,就把@Conditional注解标注类中的所有bean都注入到IOC容器中。

package com.xi.springbootdemo.conditional;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Conditional;
import org.springframework.context.annotation.Configuration;

@Configuration
/*表示只要UTF8Condition中的match方法返回true时,就把GBKEncodingConvert和UTF8EncodingConvert的bean注入到IOC容器中*/
@Conditional(UTF8Condition.class)
public class EncodingConvertConfiguration {

    @Bean
    public EncodingConvert createGBKEncodingConvert(){
        return new GBKEncodingConvert();
    }

    @Bean
    public EncodingConvert createUTF8EncodingConvert(){
        return new UTF8EncodingConvert();
    }
}

执行App输出如下:

--UTF-8
{createGBKEncodingConvert=com.xi.springbootdemo.conditional.GBKEncodingConvert@4a5905d9, createUTF8EncodingConvert=com.xi.springbootdemo.conditional.UTF8EncodingConvert@1a3e5f23}

2、可以在类上或者方法上用注解@Conditional标注时,可以同时指定多个条件类,表示多个条件同时返回true时,才会把标注的bean注入到容器中。例如:

package com.xi.springbootdemo.conditional;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Conditional;
import org.springframework.context.annotation.Configuration;

@Configuration
/*表示只要UTF8Condition中的match方法返回true时,就把GBKEncodingConvert和UTF8EncodingConvert的bean注入到IOC容器中*/
@Conditional({UTF8Condition.class,GBKCondition.class})
public class EncodingConvertConfiguration {

    @Bean
    public EncodingConvert createGBKEncodingConvert(){
        return new GBKEncodingConvert();
    }

    @Bean
    public EncodingConvert createUTF8EncodingConvert(){
        return new UTF8EncodingConvert();
    }
}

执行App输出如下:

--UTF-8
{}

四、其他注解

spring.factories文件里每一个xxxAutoConfiguration文件一般都会有下面的条件注解:

@ConditionalOnBean:当容器里有指定Bean的条件下

@ConditionalOnClass:当类路径下有指定类的条件下

@ConditionalOnExpression:基于SpEL表达式作为判断条件

@ConditionalOnJava:基于JV版本作为判断条件

@ConditionalOnJndi:在JNDI存在的条件下差在指定的位置

@ConditionalOnMissingBean:当容器里没有指定Bean的情况下

@ConditionalOnMissingClass:当类路径下没有指定类的条件下

@ConditionalOnNotWebApplication:当前项目不是Web项目的条件下

@ConditionalOnProperty:指定的属性是否有指定的值

@ConditionalOnResource:类路径是否有指定的值

@ConditionalOnSingleCandidate:当指定Bean在容器中只有一个,或者虽然有多个但是指定首选Bean

@ConditionalOnWebApplication:当前项目是Web项目的条件下。

上面@ConditionalOnXXX都是组合@Conditional元注解,使用了不同的条件Condition

Logo

权威|前沿|技术|干货|国内首个API全生命周期开发者社区

更多推荐