0


Spring Boot 常用注解汇总

Spring Boot 常用注解


一、启动注解@SpringBootApplication

SpringBoot最核心的注解,用于SpringBoot的主类,标识这是一个 SpringBoot 应用,用来开启 Spring Boot 的各项能力。

@SpringBootConfiguration,@EnableAutoConfiguration,@ComponentScan三个注解的组合。由于这些注解一般一起使用,所以干脆整合成了一个统一的注解@SpringBootApplication。

@SpringBootConfiguration 注解

继承@Configuration注解,主要用于加载配置文件,二者功能致,标注当前类为配置类, 将当前类内声明的一个或多个以@Bean注解标记的方法的实例纳入到spring容器中,且实例名为方法名。


@EnableAutoConfiguration 注解

开启自动配置功能,帮助SpringBoot应用将所有符合条件的@Configuration配置都加载到当前SpringBoot创建并使用的IoC容器。智能的自动配置功效借助于Spring框架原有的一个工具类:SpringFactoriesLoader的支持。


@ComponentScan 注解

主要用于组件扫描自动装配,自动扫描并加载符合条件的组件或bean定义,最终将这些bean定义加载到容器中。可以通过basePackages等属性指定@ComponentScan自动扫描的范围,若不指定,则Spring框架实现默认从声明@ComponentScan所在类的package进行扫描,SpringBoot的启动类最好放在root package下。


二、配置文件相关注解

@Configuration

用于定义配置类,指出该类是 Bean 配置的信息源,相当于传统的xml配置文件,一般加在主类上。如果有些第三方库需要用到xml文件,建议仍然通过@Configuration类作为项目的配置主类——可以使用@ImportResource注解加载xml配置文件。


@ComponentScan

组件扫描。让spring Boot扫描到Configuration类并把它加入到程序上下文。

@ComponentScan注解默认就会装配标识了@Controller,@Service,@Repository,@Component注解的类到spring容器中。


三、Controller 相关注解

@Controller

控制器,处理http请求。后面[注入bean相关注解]会细说


@RestController 复合注解

@RestController注解= @ResponseBody+@Controller,效果是将方法返回的对象直接在浏览器上展示成json格式。


@RequestBody

通过HttpMessageConverter读取Request Body并反序列化为Object(泛指)对象

@RequestBody主要用来接收前端传递给后端的json字符串中的数据的(请求体中的数据的);而最常用的使用请求体传参是POST请求,所以使用@RequestBody接收数据时,一般都用POST方式进行提交。在后端的同一个接收方法里,@RequestBody与@RequestParam()可以同时使用,@RequestBody最多只能有一个,而@RequestParam()可以有多个。


@ResponseBody

  • @ResponseBody这个注解通常使用在控制层(controller)的方法上,其作用是将方法的返回值以特定的格式写入到response的body区域,进而将数据返回给客户端。当方法上面没有写ResponseBody,底层会将方法的返回值封装为ModelAndView对象。
  • 字符串则直接将字符串写到客户端。
  • 是一个对象,此时会将对象转化为json串然后写到客户端。这里需要注意的是,如果返回对象,按utf-8编码。如果返回String,默认按iso8859-1编码,页面可能出现乱码。因此在注解中我们可以手动修改编码格式,比如@RequestMapping(value=“/cat/query”,produces=“text/html;charset=utf-8”),前面是请求的路径,后面是编码格式。
  • 转化为json格式的字符串是通过HttpMessageConverter中的方法实现的,因为它是一个接口,因此由其实现类完成转换。如果是bean对象,会调用对象的getXXX()方法获取属性值并且以键值对的形式进行封装,进而转化为json串。如果是map集合,采用get(key)方式获取value值,然后进行封装。
  • 一般在异步获取数据时使用,在使用@RequestMapping 后,返回值通常解析为跳转路径,加上@responsebody 后返回结果不会被解析为跳转路径,而是直接写入 HTTP response body 中。比如异步获取json 数据,加上 @responsebody 后,会直接返回 json 数据。

@RequestMapping

将 HTTP 请求映射到 MVC 和 REST 控制器的处理方法上,提供路由信息,负责URL到Controller中的具体函数的映射。


@GetMapping

将HTTP get请求映射到特定处理程序的方法注解


@PostMapping

将HTTP post请求映射到特定处理程序的方法注解


@RequestMapping 和 @GetMapping @PostMapping 区别

  • @GetMapping是组合注解,是@RequestMapping(method = RequestMethod.GET)的缩写。
  • @PostMapping是组合注解,是@RequestMapping(method = RequestMethod.POST)的缩写。

四、取请求参数值

@PathVariable

获取url中的数据


@Value

注入 application.properties 或 application.yml 配置的属性的值;


@RequestParam

获取请求参数的值


@RequestHeader

把Request请求header部分的值绑定到方法的参数上


@CookieValue

把Request header中关于cookie的值绑定到方法的参数上


五、注入bean相关

@Bean

产生一个bean的方法,交给Spring容器管理。支持别名@Bean(“xx-name”)


@Component

把普通pojo实例化到spring容器,虽然有了@Autowired,但是我们还是要写一堆bean的配置文件,相当麻烦,而@Component就是告诉spring,我是pojo类,把我注册到容器中吧,spring会自动提取相关信息。那么我们就不用写麻烦的xml配置文件了

注:@Component是最通用的 Spring 注解。 在类路径扫描期间找到装饰有@Component的 Java 类,并在上下文中注册为 Bean。也泛指各种组件,就是说当我们的类不属于各种归类的时候(不属于@Controller、@Services等的时候),使用@Component来标注这个类。


@controller

用于标注控制层。这里控制层里面的每个方法,都可以去调用@Service标识的类(业务逻辑层),
@Service标识的类中的方法可以继续调用@Resposity标识的接口实现类(Dao层/持久层)。


@Service

注入dao,用于标注服务层(业务逻辑层),主要用来进行业务的逻辑处理

  • @Component注解的一个特例,作用在类上,使用注解配置和类路径扫描时,被@Service注解标注的类会被Spring扫描并注册为Bean,用于标注服务层组件,表示定义一个bean
  • 注解作用域默认单例
  • 使用时没有传参数,Bean名称默认为当前类的类名,首字母小写
  • @Service(“serviceBeanId”)或@Service(value=”serviceBeanId”)使用时传参数,使用value作为Bean名字

@Repository

实现dao访问,用于标注数据访问层(Dao层/持久层),也可以说用于标注数据访问组件,即DAO组件.


@Scope作用域注解

  • @Scope在和@Component注解一起修饰在类上,作为类级别注解时,@Scope表示该类实例的范围
  • 在和@Bean一起修饰在方法上,作为方法级别注解时,@Scope表示该方法返回的实例的范围。
  • 对于@Scope注解,我们常用的属性一般就是:valueproxyMode,value就是指明作用域范围,proxyMode指明哪种作用域代理。
value
    singleton   表示该bean是单例的。(默认)
    prototype   表示该bean是多例的,即每次使用该bean时都会新建一个对象。
    request     在一次http请求中,一个bean对应一个实例。
    session     在一个httpSession中,一个bean对应一个实例。
    
proxyMode
    DEFAULT         不使用代理。(默认)
    NO              不使用代理,等价于DEFAULT。
    INTERFACES      使用基于接口的代理(jdk dynamic proxy)。
    TARGET_CLASS    使用基于类的代理(cglib)。

@Entity

实体类注解
@Table(name =“数据库表名”),这个注解也注释在实体类上,对应数据库中相应的表。
@Id、@Column注解用于标注实体类中的字段,pk字段标注为@Id,其余@Column。


@Autowired

自动导入
@Autowired注解作用在构造函数、方法、方法参数、类字段以及注解上
@Autowired注解可以实现Bean的自动注入


@Qualifier

当有多个同一类型的Bean时,可以用@Qualifier(“name”)来指定。与@Autowired配合使用


六、导入配置文件

@PropertySource注解

引入单个properties文件:

@PropertySource(value ={"classpath : xxxx/xxx.properties"})

引入多个properties文件:

@PropertySource(value ={"classpath : xxxx/xxx.properties","classpath : xxxx.properties"})

@ImportResource导入xml配置文件

可以额外分为两种模式 相对路径classpath,绝对路径(真实路径)file

注意:单文件可以不写value或locations,value和locations都可用

相对路径(classpath)

引入单个xml配置文件:

@ImportSource("classpath : xxx/xxxx.xml")

引入多个xml配置文件:

@ImportSource(locations={"classpath : xxxx.xml","classpath : yyyy.xml"})

绝对路径(file)

引入单个xml配置文件:

@ImportSource(locations={"file : d:/hellxz/dubbo.xml"})

引入多个xml配置文件:

@ImportSource(locations={"file : d:/hellxz/application.xml","file : d:/hellxz/dubbo.xml"})

取值:使用@Value注解取配置文件中的值

@Value("${properties中的键}")privateString xxx;

@Import 导入额外的配置信息

功能类似XML配置的,用来导入配置类,可以导入带有@Configuration注解的配置类或实现了ImportSelector/ImportBeanDefinitionRegistrar。


七、事务注解 @Transactional

在Spring中,事务有两种实现方式,分别是编程式事务管理声明式事务管理两种方式

  • 编程式事务管理: 编程式事务管理使用TransactionTemplate或者直接使用底层的PlatformTransactionManager。对于编程式事务管理,spring推荐使用TransactionTemplate。
  • 声明式事务管理: 建立在AOP之上的。其本质是对方法前后进行拦截,然后在目标方法开始之前创建或者加入一个事务,在执行完目标方法之后根据执行情况提交或者回滚事务,通过@Transactional就可以进行事务操作,更快捷而且简单。推荐使用

八、全局异常处理

@ControllerAdvice 统一处理异常

  • 注解定义全局异常处理类,本质上是一个Component,因此也会被当成组建扫描。
  • 这个类(加了@ControllerAdvice的类)是为那些声明了(@ExceptionHandler、@InitBinder 或 @ModelAttribute注解修饰的)方法的类而提供的专业化的@Component , 以供多个 Controller类所共享。
  • 即通过AOP拦截异常,具体你想做更细致的拦截筛选和拦截之后的处理,你自己通过@ExceptionHandler、@InitBinder 或 @ModelAttribute这三个注解以及被其注解的方法来自定义
@ControllerAdvice(annotations ={RestController.class,Controller.class})//拦截加了RestController和Controller的类

@ExceptionHandler 声明异常处理方法

  • @ControllerAdvice 配合 @ExceptionHandler 实现全局异常处理
  • 比如在方法上加:@ExceptionHandler(IllegalArgumentException.class),则表明此方法处理IllegalArgumentException 类型的异常,如果参数为空,将默认为方法参数列表中列出的任何异常(方法抛出什么异常都接得住)。

@ModelAttribute

  • @ControllerAdvice 配合 @ModelAttribute 预设全局数据

@InitBinder

@ControllerAdvice 配合 @InitBinder 实现对请求参数的预处理

标签: spring boot spring java

本文转载自: https://blog.csdn.net/weixin_48063660/article/details/127820917
版权归原作者 Locus- 所有, 如有侵权,请联系我们删除。

“Spring Boot 常用注解汇总”的评论:

还没有评论