快捷導(dǎo)航

Spring條件注解@Conditional示例詳解

更新時間：2019年08月06日 08:37:16 作者：java_lover

這篇文章主要給大家介紹了關(guān)于Spring條件注解@Conditional的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對大家學(xué)習(xí)或者使用Spring具有一定的參考學(xué)習(xí)價值，需要的朋友們下面來一起學(xué)習(xí)學(xué)習(xí)吧

前言

@Conditional是Spring4新提供的注解，它的作用是根據(jù)某個條件創(chuàng)建特定的Bean，通過實(shí)現(xiàn)Condition接口，并重寫matches接口來構(gòu)造判斷條件?？偟膩碚f，就是根據(jù)特定條件來控制Bean的創(chuàng)建行為，這樣我們可以利用這個特性進(jìn)行一些自動的配置。

本文將分為三大部分，@Conditional源碼的介紹、Condition的使用示例和@Conditional的擴(kuò)展注解的介紹。

一、@Conditional的源碼

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Conditional {

  /**
   * All {@link Condition Conditions} that must {@linkplain Condition#matches match}
   * in order for the component to be registered.
   */
  Class<? extends Condition>[] value();

}

從源碼中可以看到，@Conditional注解可以用在類和方法上，需要傳入一個實(shí)現(xiàn)了Condition接口class數(shù)組。

二、代碼示例

下面將以不同的操作系統(tǒng)為條件，通過實(shí)現(xiàn)Condition接口，并重寫其matches方法來構(gòu)造判斷條件。若在Windows系統(tǒng)下運(yùn)行程序，則輸出列表命令為dir；若在Linux系統(tǒng)下運(yùn)行程序，則輸出列表命令為ls。

1.判斷條件類的定義

(1).判斷Windows的條件

package com.study.day01;

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

/**
 * @Auther: lifq
 * @Description:
 */
public class WindowsCondition implements Condition {
  public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
    return context.getEnvironment().getProperty("os.name").contains("Windows");
  }
}

(2).判斷Linux的條件

package com.study.day01;

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

/**
 * @Auther: lifq
 * @Description:
 */
public class LinuxCondition implements Condition {
  public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
    return context.getEnvironment().getProperty("os.name").contains("Linux");
  }
}

2.不同系統(tǒng)下的Bean的類

(1).接口代碼

package com.study.day01;

import org.springframework.stereotype.Service;

/**
 * @Auther: lifq
 * @Description:
 */
public interface ListService {

  public String showListCmd();

}

(2).Windows實(shí)現(xiàn)類代碼

package com.study.day01;

/**
 * @Auther: lifq
 * @Description:
 */
public class WindowsService implements ListService {
  public String showListCmd() {
    return "dir";
  }
}

(3).Linux實(shí)現(xiàn)類代碼

package com.study.day01;

/**
 * @Auther: lifq
 * @Description:
 */
public class LinuxService implements ListService {
  public String showListCmd() {
    return "ls";
  }
}

3.配置類

package com.study.day01;

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

/**
 * @Auther: lifq
 * @Description:
 */
@Configuration
public class Config {

  @Bean
  @Conditional(WindowsCondition.class)
  public ListService window() {
    return new WindowsService();
  }

  @Bean
  @Conditional(LinuxCondition.class)
  public ListService linux() {
    return new LinuxService();
  }
}

4.運(yùn)行類

package com.study.day01;

import org.springframework.context.annotation.AnnotationConfigApplicationContext;

/**
 * @Auther: lifq
 * @Description:
 */
public class Main01 {

  public static void main (String []args) {

    AnnotationConfigApplicationContext applicationContext = new AnnotationConfigApplicationContext(Config.class);

    ListService listService = applicationContext.getBean(ListService.class);

    System.out.println(applicationContext.getEnvironment().getProperty("os.name") + "系統(tǒng)下的列表命令為：" + listService.showListCmd());
  }
}

我的是Windows操作系統(tǒng)，輸出結(jié)果為dir，運(yùn)行截圖如下：

運(yùn)行截圖

@Conditional注解例子演示完成，有問題歡迎留言溝通哦！

完整源碼地址：https://github.com/suisui2019/springboot-study

三、@Conditional的擴(kuò)展注解

@ConditionalOnBean：僅僅在當(dāng)前上下文中存在某個對象時，才會實(shí)例化一個Bean。
@ConditionalOnClass：某個class位于類路徑上，才會實(shí)例化一個Bean。
@ConditionalOnExpression：當(dāng)表達(dá)式為true的時候，才會實(shí)例化一個Bean。
@ConditionalOnMissingBean：僅僅在當(dāng)前上下文中不存在某個對象時，才會實(shí)例化一個Bean。
@ConditionalOnMissingClass：某個class類路徑上不存在的時候，才會實(shí)例化一個Bean。
@ConditionalOnNotWebApplication：不是web應(yīng)用，才會實(shí)例化一個Bean。
@ConditionalOnBean：當(dāng)容器中有指定Bean的條件下進(jìn)行實(shí)例化。
@ConditionalOnMissingBean：當(dāng)容器里沒有指定Bean的條件下進(jìn)行實(shí)例化。
@ConditionalOnClass：當(dāng)classpath類路徑下有指定類的條件下進(jìn)行實(shí)例化。
@ConditionalOnMissingClass：當(dāng)類路徑下沒有指定類的條件下進(jìn)行實(shí)例化。
@ConditionalOnWebApplication：當(dāng)項(xiàng)目是一個Web項(xiàng)目時進(jìn)行實(shí)例化。
@ConditionalOnNotWebApplication：當(dāng)項(xiàng)目不是一個Web項(xiàng)目時進(jìn)行實(shí)例化。
@ConditionalOnProperty：當(dāng)指定的屬性有指定的值時進(jìn)行實(shí)例化。
@ConditionalOnExpression：基于SpEL表達(dá)式的條件判斷。
@ConditionalOnJava：當(dāng)JVM版本為指定的版本范圍時觸發(fā)實(shí)例化。
@ConditionalOnResource：當(dāng)類路徑下有指定的資源時觸發(fā)實(shí)例化。
@ConditionalOnJndi：在JNDI存在的條件下觸發(fā)實(shí)例化。
@ConditionalOnSingleCandidate：當(dāng)指定的Bean在容器中只有一個，或者有多個但是指定了首選的Bean時觸發(fā)實(shí)例化。