Spring Boot常用注解

1.Spring Boot常用注解

分类	注解	位置	对应的XML标签	作用
读取配置	@ConfigurationProperties	类		通过一次性读取到一个 Java 配置类，相当于一次性使用多个@Value注解
	@PropertySource		<context:property-placeholder>	用来指定读取自定义的配置文件的
	@Import		<import>	用来导入配置类或者一些需要前置加载的类
	@Value	属性	<property>	注入普通字符，操作系统属性，表达式结果， 其它bean属性，文件资源，网站资源，配置文件等
配置启动	@SpringBootApplication	类		此注解相当于@Configuration、@EnableAutoConfiguration、@ComponentScan的组合
	@Configuration			声明当前类为配置类，相当于xml形式的Spring配置
	@EnableAutoConfiguration			启用SpringBoot的自动化配置
	@ComponentScan		<context:component-scan>	启用SpringBoot的组件扫描功能
全局异常处理	@ControllerAdvice	类		常与@ExceptionHandler注解一起使用，用于捕获全局异常，能作用于所有controller中。
	@ExceptionHandler	类/方法		修饰方法时，表示该方法为处理全局异常的方法
数据库事务相关注解	@EnableTransactionManagement	类		启用Spring基于注解的事务管理功能，需要和@Configuration注解一起使用
	@Transactional	类/方法		表示方法和类需要开启事务

Spring相关注解可参考：Spring常用注解

2.读取配置

@Import

@Import注解是用来导入配置类或者一些需要前置加载的类。作用和在spring的xml配置文件中的：<import resource=""></import>是一样.

value[]：用于指定其他配置类的字节码。

@Configuration
@ComponentScan(basePackages = "com.by")
@Import({Configuration_Other.class})
public class SpringConfiguration {

}

@PropertySource("classpath:config.properties")
public class Configuration_Other {

}

@value

可以在任意 Spring 管理的 Bean 中通过这个注解获取任何来源配置的属性值。
比如 application.properties 或者 application.yml 配置文件中配置的属性值，当然也可以是 JVM 属性配置或者系统环境变量配置的值.

@Component
public class MyComponent {
 
    @Value("${my.property}")
    private String myProperty;
 
    // 其他方法
}

在属性级别上，@Value注解指定了需要注入的属性值，这个属性值可以通过${...}的方式引用配置文件中的属性值。

@ConfigurationProperties

上面 @Value 在每个类中获取属性配置值的做法其实是不推荐的，一般在企业项目开发中，不会使用那么杂乱无章的写法而且维护也麻烦。

通过一次性读取到一个 Java 配置类，相当于一次性使用多个@Value注解，需要使用的地方直接引用这个类就可以多次访问了，方便维护。

@Component
@Data
@ConfigurationProperties(prefix = "servers")
public class ServerConfig {
    private String ipAddress;
    private int port;
    private long timeout;
}

@PropertySource

这个注解是用来指定读取自定义的配置文件的。

@Component
@ConfigurationProperties(prefix= "my" )
@PropertySource(value = {"classpath:my.properties"})
@Data
public class MyProperties {
    private int maxValue= 0;
}

搭配@Bean使用：

@PropertySource("classpath:db.properties")
public class JdbcConfig {
    @Value("${jdbc.driver}")
    private String driver;
    @Value("${jdbc.url}")
    private String url;
    @Value("${jdbc.username}")
    private String userName;
    @Value("${jdbc.password}")
    private String password;

    @Bean("dataSource")
    public DataSource getDatasource() {
        DruidDataSource ds = new DruidDataSource();
        ds.setDriverClassName(driver);
        ds.setUrl(url);
        ds.setUsername(userName);
        ds.setPassword(password);
        return ds;
    }
}

3.配置启动

@SpringBootApplication

@SpringBootApplication注解是一个快捷的配置注解，在被它标注的类中，可以定义一个或多个Bean，并自动触发自动配置Bean和自动扫描组件。此注解相当于@Configuration、@EnableAutoConfiguration和@ComponentScan的组合。

在Spring Boot应用程序的主类中，就使用了此注解。示例代码如下：

@SpringBootApplicationpublic 
class Application{ 
	public static void main(String [] args){   		
		SpringApplication.run(Application.class,args); 
	}
}

@Configuration

用于声明一个Java形式的配置类，SpringBoot推荐使用Java配置，在该类中声明的Bean等配置将被SpringBoot的组件扫描功能扫描到。

@Configuration
@MapperScan({"com.by.mapper"})
public class MyBatisConfig {
}

@EnableAutoConfiguration

启用SpringBoot的自动化配置，会根据你在pom.xml添加的依赖和application-dev.yml中的配置自动创建你需要的配置。

 @Configuration
@EnableAutoConfiguration
public class AppConfig {
}

@ComponentScan

启用SpringBoot的组件扫描功能，标注哪些路径下的类需要被Spring扫描。将自动装配和注入指定包下的Bean实例。

@Configuration
@ComponentScan({"com.by.mapper"})
public class EruptConfig {
}

4.全局异常处理

@ControllerAdvice

包含@Component。可以被扫描到。统一处理异常。

常与@ExceptionHandler注解一起使用，用于捕获全局异常，能作用于所有controller中。

@ExceptionHandler

修饰方法时，表示该方法为处理全局异常的方法。

@ControllerAdvice
public class GlobalExceptionHandler {

    @ResponseBody
    @ExceptionHandler(value = ApiException.class)
    public CommonResult handle(ApiException e) {
        if (e.getErrorCode() != null) {
            return CommonResult.failed(e.getErrorCode());
        }
        return CommonResult.failed(e.getMessage());
    }
}

5.数据库事务相关注解

@EnableTransactionManagement

启用Spring基于注解的事务管理功能，需要和@Configuration注解一起使用。

@Configuration
@EnableTransactionManagement
@MapperScan({"com.by.mapper"})
public class MyBatisConfig {
}

@Transactional

表示方法和类需要开启事务

当作用与类上时，类中所有方法均会开启事务

当作用于方法上时，方法开启事务，方法上的注解无法被子类所继承。

@Service
@Transactional
public class CheckItemServiceImpl implements CheckItemService {

    @Autowired
    private CheckItemMapper checkItemMapper;
    @Override
    public void add(CheckItem checkItem) {
        checkItemMapper.add(checkItem);
    }