小言_互联网的博客

spring springboot springcloud常用注解

536人阅读  评论(0)

@SpringBootApplication

组合注解,用在启动类上,源码:


  
  1. @Retention(RetentionPolicy.RUNTIME)
  2. @SpringBootConfiguration
  3. @EnableAutoConfiguration
  4. @ComponentScan
  5. public @interface SpringBootApplication

========================

@SpringBootConfiguration


  
  1. @Configuration
  2. public @interface SpringBootConfiguration

SpringBootConfiguration标注这个类是一个配置类,是@Configuration注解的派生注解,和@Configuration注解的功能一致,标注这个类是一个配置类,并会将当前类内声明的一个或多个以@Bean注解标记的方法的实例纳入到spring容器中,并且实例名就是方法名。
只不过@SpringBootConfiguration是springboot的注解,而@Configuration是spring的注解,关于@Configuration注解,更详细的,可以参看《spring注解 @Conditional的使用
https://blog.csdn.net/qq_28410283/article/details/91353603

-------------------------------------------- 

@EnableAutoConfiguration


  
  1. @AutoConfigurationPackage
  2. @Import({AutoConfigurationImportSelector.class})
  3. public @interface EnableAutoConfiguration

一般加在主类上,通过此注解,能所有符合自动配置条件的bean的定义加载到spring容器中。

自动载入应用程序所需的所有Bean——这依赖于Spring Boot在类路径中的查找。
从classpath中搜索所有META-INF/spring.factories配置文件然后,将其中org.springframework.boot.autoconfigure.EnableAutoConfiguration key对应的配置项加载到spring容器
只有spring.boot.enableautoconfiguration为true(默认为true)的时候,才启用自动配置
https://blog.csdn.net/l18848956739/article/details/100692163

Spring中也有一种类似与Java SPI的加载机制。它在META-INF/spring.factories文件中配置接口的实现类名称,然后在程序中读取这些配置文件并实例化。这种自定义的SPI机制是Spring Boot Starter实现的基础。
https://blog.csdn.net/lldouble/article/details/80690446

 

@EnableAutoConfiguration注解原理

从classpath中搜索所有META-INF/spring.factories配置文件然后,将其中org.springframework.boot.autoconfigure.EnableAutoConfiguration key对应的配置项加载到spring容器
只有spring.boot.enableautoconfiguration为true(默认为true)的时候,才启用自动配置
@EnableAutoConfiguration还可以进行排除,排除方式有2中,一是根据class来排除(exclude),二是根据class name(excludeName)来排除
其内部实现的关键点有
1)ImportSelector 该接口的方法的返回值都会被纳入到spring容器管理中
2)SpringFactoriesLoader 该类可以从classpath中搜索所有META-INF/spring.factories配置文件,并读取配置

https://www.jianshu.com/p/1fba2f40f7b6

-------------------------------------------- 

@Configuration


  
  1. @Component
  2. public @interface Configuration

用于定义配置类,@Configuation等价于<Beans></Beans>,可替换xml配置文件,被注解的类内部包含有一个或多个被@Bean注解的方法,这些方法将会被AnnotationConfigApplicationContext或AnnotationConfigWebApplicationContext类进行扫描,并用于构建bean定义,初始化Spring容器。

 

@Configuration 和 @Component 区别

实际上表现为@Configuration+@bean和@Component+@bean的区别

一句话概括就是 @Configuration 中所有带 @Bean 注解的方法都会被动态代理,因此调用该方法返回的都是同一个实例。
从定义来看, @Configuration 注解本质上还是 @Component,虽然Component注解也会当做配置类,但是并不会为其生成CGLIB代理Class。

Spring 容器在启动时,会加载默认的一些 PostPRocessor,其中就有 ConfigurationClassPostProcessor,这个后置处理程序专门处理带有 @Configuration 注解的类,这个程序会在 bean 定义加载完成后,在 bean 初始化前进行处理。主要处理的过程就是使用 cglib 动态代理增强类,而且是对其中带有 @Bean 注解的方法进行处理。

@Component 注解并没有通过 cglib 来代理@Bean 方法的调用。有些特殊情况下,我们不希望 MyBeanConfig 被代理(代理后会变成WebMvcConfig

E n h a n c e r B y S p r i n g C G L I B
8bef3235293)时,就得用 @Component。

https://blog.csdn.net/isea533/article/details/78072133

 

当使用Configuration注解时,生成当前对象的子类Class,并对方法拦截,第二次调用方法时直接从BeanFactory之中获取对象,所以得到的是同一个对象。https://blog.csdn.net/long476964/article/details/80626930

透过现象看原理:详解Spring中Bean的this调用导致AOP失效的原因

在Spring提供的@Configuration配置类中,就有这种场景的应用,可以看到c1和c2是同一个对象引用,而不是每次调用方法都new一个新的对象。

-------------------------------------------

@Bean

@Bean是一个方法级别上的注解,主要用在@Configuration注解的类里,也可以用在@Component注解的类里。

https://www.cnblogs.com/feiyu127/p/7700090.html

@Component 和 @Bean 的区别

@Component(和@Service和@Repository)用于自动检测和使用类路径扫描自动配置bean。注释类和bean之间存在隐式的一对一映射(即每个类一个bean)。
这种方法对需要进行逻辑处理的控制非常有限,因为它纯粹是声明性的。

@Bean用于显式声明单个bean,而不是让Spring像上面那样自动执行它。它将bean的声明与类定义分离,并允许您精确地创建和配置bean。

而@Bean则常和@Configuration注解搭配使用。

如果想将第三方的类变成组件,你又没有没有源代码,也就没办法使用@Component进行自动配置,这种时候使用@Bean就比较合适了。
https://www.jianshu.com/p/67ed3bdc215c

https://blog.csdn.net/w605283073/article/details/89221522

Spring中的@Bean是否一定要与@Configuration一起用?

使用@Configuration注解,此时调用方法返回的是被Spring管理的单例Bean。
如果换做是@Component 注解,那么调用了方法返回的对象是执行这个方法返回的对象实例,而不是被spring管理的对象。
这就是差别所在。

https://blog.csdn.net/weixin_42749765/article/details/87098790

https://segmentfault.com/a/1190000014119872?utm_source=tag-newest

 

作用对象不同: @Component 注解作用于类,而 @Bean 注解作用于方法;
 @Component 通常是通过类路径扫描来自动侦测,以及自动装配到 Spring 容器中(可以使用 @ComponentScan注解定义要扫描的路径,从中找出标识了需要装配的类,并自动装配到 Spring 的 bean 容器中)。

@Bean 注解通常是在标有该注解的方法中定义产生这个 bean,@Bean告诉了 Spring 这是某个类的示例,当需要用到它的时候还给我;
 @Bean 注解比 Component 注解的更灵活,而且很多地方我们只能通过 @Bean 注解来注册 bean。比如当我们引用第三方库中的类需要装配到 Spring容器时,则只能通过 @Bean来实现。

https://cloud.tencent.com/developer/article/1512755

----------------------------------------

@Scope

@Scope默认是单例模式,即scope="singleton"。

另外scope还有prototype、request、session、global session作用域。scope="prototype"多例

https://blog.csdn.net/tzbugs/article/details/82142286

 

@Lazy懒加载


  
  1. //默认是单实例的
  2. /**
  3. * ConfigurableBeanFactory#SCOPE_PROTOTYPE
  4. * @see ConfigurableBeanFactory#SCOPE_SINGLETON
  5. * @see org.springframework.web.context.WebApplicationContext#SCOPE_REQUEST request
  6. * @see org.springframework.web.context.WebApplicationContext#SCOPE_SESSION sesssion
  7. * @return\
  8. * @Scope:调整作用域
  9. * prototype:多实例的:ioc容器启动并不会去调用方法创建对象放在容器中。
  10. * 每次获取的时候才会调用方法创建对象;
  11. * singleton:单实例的(默认值):ioc容器启动会调用方法创建对象放到ioc容器中。
  12. * 以后每次获取就是直接从容器(map.get())中拿,
  13. * request:同一次请求创建一个实例
  14. * session:同一个session创建一个实例
  15. *
  16. * 懒加载:
  17. * 单实例bean:默认在容器启动的时候创建对象;
  18. * 懒加载:容器启动不创建对象。第一次使用(获取)Bean创建对象,并初始化;
  19. *
  20. */
  21. @Lazy
  22. @Bean
  23. public UserLazy userLazy(){
  24. System.out.println( "给容器中添加UserLazy");
  25. return new UserLazy( "tomcat");
  26. }

----------------------------------------

@Component, @Repository, @Service区别

Component是一个通用的Spring容器管理的单例bean组件。而@Repository, @Service, @Controller就是针对不同的使用场景所采取的特定功能化的注解组件。

注解 含义
@Component 最普通的组件,可以被注入到spring容器进行管理
@Repository 作用于持久层
@Service 作用于业务逻辑层
@Controller 作用于表现层(spring-mvc的注解)

有两个注解是不能被其他注解所互换的:

  • @Controller 注解的bean会被spring-mvc框架所使用。
  • @Repository 会被作为持久层操作(数据库)的bean来使用

如果想使用自定义的组件注解,那么只要在你定义的新注解中加上@Component即可。

https://github.com/giantray/stackoverflow-java-top-qa/blob/master/contents/whats-the-difference-between-component-repository-service-annotations-in.md

----------------------------------------

@ComponentScan


  
  1. @Repeatable(ComponentScans.class)
  2. public @interface ComponentScan {
  3. ... ...
  4. String resourcePattern() default "**/*.class";
  5. ... ...
  6. }

组件扫描。如果扫描到有@Component @Controller @Service等这些注解的类,则把这些类注册为bean。


  
  1. //配置类==配置文件
  2. @Configuration //告诉Spring这是一个配置类
  3. @ComponentScans(
  4. value = {
  5. @ComponentScan(value= "com.demo",includeFilters = {
  6. /* @Filter(type=FilterType.ANNOTATION,classes={Controller.class}),
  7. @Filter(type=FilterType.ASSIGNABLE_TYPE,classes={BookService.class}),*/
  8. @Filter(type=FilterType.CUSTOM,classes={MyTypeFilter.class})
  9. },useDefaultFilters = false)
  10. }
  11. )
  12. //@ComponentScan value:指定要扫描的包
  13. //excludeFilters = Filter[] :指定扫描的时候按照什么规则排除那些组件
  14. //includeFilters = Filter[] :指定扫描的时候只需要包含哪些组件
  15. //FilterType.ANNOTATION:按照注解
  16. //FilterType.ASSIGNABLE_TYPE:按照给定的类型;
  17. //FilterType.ASPECTJ:使用ASPECTJ表达式
  18. //FilterType.REGEX:使用正则指定
  19. //FilterType.CUSTOM:使用自定义规则
  20. public class MainConfig {
  21. //给容器中注册一个Bean;类型为返回值的类型,id默认是用方法名作为id
  22. @Bean( "user")
  23. public User user01(){
  24. return new User( "Tom", 12);
  25. }
  26. }

----------------------------------------

@Import

注解可以把普通类导入到 IoC容器中

想要让一个普通类接受 Spring 容器管理,有3种方法

  • 使用 @Bean 注解
  • 使用 @Controller @Service @Repository @Component 注解标注该类,然后再使用 @ComponentScan 扫描包
  • @Import 方法

https://www.jianshu.com/p/afd2c49394c2

 

未用@componscan注解指定扫描的包时,默认扫描的是@import注解所在的包。

可以再次添加一个配置文件,在配置文件指定我们需要扫描的包,在代码中加入逻辑:若@component不存在或未指定,则使用配置文件中指定的路径进行扫描。

https://www.cnblogs.com/heliusKing/p/11774253.html

https://www.cnblogs.com/heliusKing/p/11372014.html

 


  
  1. 给容器中注册组件;
  2. 1)、包扫描+组件标注注解(@Controller/@Service/@Repository/@Component)[自己写的类]
  3. 2)、@Bean[导入的第三方包里面的组件]
  4. 3)、@Import[快速给容器中导入一个组件]
  5. 1)、@Import(要导入到容器中的组件);容器中就会自动注册这个组件,id默认是全类名
  6. 2)、ImportSelector:返回需要导入的组件的全类名数组;
  7. 3)、ImportBeanDefinitionRegistrar:手动注册bean到容器中
  8. 4)、使用Spring提供的 FactoryBean(工厂Bean);
  9. 1)、默认获取到的是工厂bean调用getObject创建的对象
  10. 2)、要获取工厂Bean本身,我们需要给id前面加一个&&colorFactoryBean

Import注解在4.2之前只支持导入配置类 在4.2,@Import注解支持导入普通的java类,并将其声明成一个bean。

https://cloud.tencent.com/developer/article/1455362


  
  1. public class ImportDemo {
  2. public void doSomething () {
  3. System.out.println( "ImportDemo.doSomething()");
  4. }
  5. }
  6. @Configuration
  7. @Import(ImportDemo.class)
  8. public class ImportConfig {}
  9. public class ImportDemo {
  10. public void doSomething () {
  11. System.out.println( "ImportDemo.doSomething()");
  12. }
  13. }
  14. public class TestMain {
  15. public static void main(String[] args) {
  16. AnnotationConfigApplicationContext context =
  17. new AnnotationConfigApplicationContext( "com.springboot.importtest");
  18. ImportDemo importDemo = context.getBean(ImportDemo.class);
  19. importDemo.doSomething();
  20. }
  21. }

在实例中使用,比如@Component


  
  1. package com.paopaoedu.springboot.controller;
  2. import com.paopaoedu.springboot.service.ImportDemo;
  3. import org.springframework.beans.factory.annotation.Autowired;
  4. import org.springframework.web.bind.annotation.RequestMapping;
  5. import org.springframework.web.bind.annotation.RestController;
  6. import java.util.List;
  7. @RestController
  8. public class TestController {
  9. @Autowired
  10. private ImportDemo importDemo;
  11. @RequestMapping( "/")
  12. public String sayHello() {
  13. return importDemo.doSomething();
  14. }
  15. }

---------------------------------------

@ConditionalOnClass和ConditionalOnMissingBean

@ConditionalOnClass是Springboot实现自动配置的重要支撑之一。其用途是判断当前classpath下是否存在指定类,若是则将当前的配置装载入spring容器。https://blog.csdn.net/lucyTheSlayer/article/details/80430912

@ConditionalOnMissingBean注解后,就知道如果Spring容器中有了RedisTemplate对象了,这个自动配置的RedisTemplate不会实例化。因此我们可以直接自己写个配置类,配置RedisTemplate。


  
  1. @Configuration(proxyBeanMethods = false)
  2. @ConditionalOnClass(RedisOperations.class)
  3. @EnableConfigurationProperties(RedisProperties.class)
  4. @Import({ LettuceConnectionConfiguration.class, JedisConnectionConfiguration.class })
  5. public class RedisAutoConfiguration {
  6. @Bean
  7. @ConditionalOnMissingBean(name = "redisTemplate")
  8. public RedisTemplate<Object, Object> redisTemplate(RedisConnectionFactory redisConnectionFactory)
  9. throws UnknownHostException {
  10. RedisTemplate<Object, Object> template = new RedisTemplate<>();
  11. template.setConnectionFactory(redisConnectionFactory);
  12. return template;
  13. }
  14. @Bean
  15. @ConditionalOnMissingBean
  16. public StringRedisTemplate stringRedisTemplate(RedisConnectionFactory redisConnectionFactory)
  17. throws UnknownHostException {
  18. StringRedisTemplate template = new StringRedisTemplate();
  19. template.setConnectionFactory(redisConnectionFactory);
  20. return template;
  21. }
  22. }

https://www.cnblogs.com/zeng1994/p/03303c805731afc9aa9c60dbbd32a323.html

=======================

@Value

三种方式


  
  1. //使用@Value赋值;
  2. //1、基本数值
  3. //2、可以写SpEL; #{}
  4. //3、可以写${};取出配置文件【properties】中的值(在运行环境变量里面的值)
  5. @Value( "TomCat")
  6. private String name;
  7. @Value( "#{12-2}")
  8. private Integer age;
  9. @Value( "${person.tomName}")
  10. private String tomName;

https://blog.csdn.net/a546835886/article/details/81287825

 

@Value一个一个注入,单个配置项
https://blog.csdn.net/clmmei_123/article/details/81871836

-------------------------------------

@ConfigurationProperties

想把配置文件的信息,读取并自动封装成实体类,批量注入配置文件中的属性,多个配置项用一个配置类。

https://blog.csdn.net/yingxiake/article/details/51263071

--------------------------------------------

@Qualifier
在Controller中需要注入service那么我的这个server有两个实现类如何区分开这两个impl呢?
Qualifier的意思是合格者,通过这个标示,表明了哪个实现类才是我们所需要的,添加@Qualifier注解,需要注意的是@Qualifier的参数名称为我们之前定义@Service注解的名称之一。
使用@resource注入时比较简单了注解自带了“name”的val就是@Service注解的名称之一。
https://blog.csdn.net/qq_36567005/article/details/80611139

Qualifier多数据源实现:

http://blog.didispace.com/springbootmultidatasource/

------------------------------------

@PropertySource

加载指定配置文件。

如果应用比较大的时候,如果所有的内容都当在一个文件中,如“application.properties”或者“application.yml”中时,就会显得比较臃肿,同时也不太好理解和维护

可以将一个文件拆分为多个,此时使用@PropertySource即可解决问题。

https://blog.csdn.net/wangmx1993328/article/details/81005170

---------------------

@importSource

通过@importSource来加载.xml文件将配置加载到spring环境中

https://blog.csdn.net/abc_123456___/article/details/91126042

----------------------------

@EnableTransactionManagement
Spring Boot的事务管理注解@EnableTransactionManagement的使用

----------------------------------

@RefreshScope

是spring cloud提供的一种特殊的scope实现,用来实现配置、实例热加载。
https://www.jianshu.com/p/188013dd3d02
需要热加载的bean需要加上@RefreshScope注解,当配置发生变更的时候可以在不重启应用的前提下完成bean中相关属性的刷新。
https://blog.csdn.net/weixin_40318210/article/details/87954179

---------------------------------

@EnableDiscoveryClient和@EnableEurekaClient
共同点就是:都是能够让注册中心能够发现,扫描到改服务。
不同点:@EnableEurekaClient只适用于Eureka作为注册中心,@EnableDiscoveryClient 可以是其他注册中心。
https://blog.csdn.net/zheng199172/article/details/82466139


-----------------

@id

mongodb要注意,java class中增加一个id属性,它会自动映射成"_id",如果数据库中本来就是id,那么就读不到了

https://www.cnblogs.com/zdkjob/p/10038746.html

---------------

@RestController

是Spring4之后加入的注解,原来在@Controller中返回json需要@ResponseBody来配合,如果直接用@RestController替代@Controller就不需要再配置@ResponseBody,默认返回json格式。而@Controller是用来创建处理http请求的对象,一般结合@RequestMapping使用。

----------------------

@RequestMapping

RequestMapping是一个用来处理请求地址映射的注解,可用于类或方法上。用于类上,表示类中的所有响应请求的方法都是以该地址作为父路径。

https://www.cnblogs.com/Fooo/p/11724709.html

------------------

@PostConstruct


@PostContruct是spring框架的注解,在方法上加该注解会在项目启动的时候执行该方法,也可以理解为在spring容器初始化的时候执行该方法。
@PostConstruct在项目中的用处
1.spring项目加载数据字典
@PostConstruct注解的方法在项目启动的时候执行这个方法,也可以理解为在spring容器启动的时候执行,可作为一些数据的常规化加载,比如数据字典之类的。

2.spring项目的定时任务
spring自带的@schedule,没有开关,项目启动总会启动一个线程;
做项目的时候就使用Java的timer,这个设置开关即可自由的控制,关闭的时候,不会启动线程;
Java的timer也需要找到一个启动类,可以放到main函数里面启动,这样的话,代码的耦合性太高了,而使用PostConstruct是很干净的。

spring中Constructor、@Autowired、@PostConstruct的顺序
其实从依赖注入的字面意思就可以知道,要将对象p注入到对象a,那么首先就必须得生成对象p与对象a,才能执行注入。所以,如果一个类A中有个成员变量p被@Autowired注解,那么@Autowired注入是发生在A的构造方法执行完之后的。

如果想在生成对象时候完成某些初始化操作,而偏偏这些初始化操作又依赖于依赖注入,那么就无法在构造函数中实现。为此,可以使用@PostConstruct注解一个方法来完成初始化,@PostConstruct注解的方法将会在依赖注入完成后被自动调用。

Constructor >> @Autowired >> @PostConstruct

https://blog.csdn.net/qq_37636695/article/details/84791468
 

@PostConstruct和 @PreDestroy注解位于 java.xml.ws.annotation包是Java EE的模块的一部分。J2EE已经在Java 9中被弃用,并且计划在Java 11中删除它

为pom.xml或build.gradle添加必要的依赖项
(Java 9+中的Spring @PostConstruct和@PreDestroy替代品)

https://blog.csdn.net/weixin_36048246/article/details/84394539


转载:https://blog.csdn.net/21aspnet/article/details/104042826
查看评论
* 以上用户言论只代表其个人观点,不代表本网站的观点或立场