• springboot常用注解


    springboot常用注解

    来源:https://blog.lqdev.cn/2018/07/16/springboot/chapter-six/

    @SpringBootApplication

    在系统启动类里面,包含了@SpringBootConfiguration、@EnableAutoConfiguration和@ComponentScan注解;

    • @SpringBootConfiguration 继承至@Configuration,对于熟悉spring的开发者而言,此标注当前类是配置类,并会将当前类内声明的一个或多个以@Bean注解标记的方法的实例纳入到srping容器中,并且实例名就是方法名。
    • @EnableAutoConfiguration 这个注解就是springboot能自动进行配置的魔法所在了。主要是通过此注解,能所有符合自动配置条件的bean的定义加载到spring容器中,比如根据spring-boot-starter-web ,来判断你的项目是否需要添加了webmvc和tomcat,就会自动的帮你配置web项目中所需要的默认配置。具体的使用,会在后期自定义实现一个自动启动类时,会讲解到它的一些机制。此章节就不深入了,只需要它是这个用途即可,一般上也单独使用不要这个注解,但比如需要排除一些无需自动配置的类时,可利用exclude进行排除。
    • @ComponentScan 这个熟悉spring的开发者也应该熟悉,会扫描当前包及其子包下被@Component,@Controller,@Service,@Repository等注解标记的类并纳入到spring容器中进行管理。

    @Controller 和 @RestController

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

    @RequestMapping

    • value, method;

      • value: 指定请求的实际地址,指定的地址可以是URI Template 模式(后面将会说明);
      • method: 指定请求的method类型, GET、POST、PUT、DELETE等;
    • consumes,produces;

      • consumes: 指定处理请求的提交内容类型(Content-Type),例如application/json, text/html;
      • produces: 指定返回的内容类型,仅当request请求头中的(Accept)类型中包含该指定类型才返回;
    • params,headers;

      • params: 指定request中必须包含某些参数值是,才让该方法处理。
      • headers: 指定request中必须包含某些指定的header值,才能让该方法处理请求。
    • 其简化注解有:

    • @GetMapping 等同于 @RequestMapping(method = RequestMethod.GET)

    • @PostMapping 等同于 @RequestMapping(method = RequestMethod.POST)

    • @PutMapping 等同于 @RequestMapping(method = RequestMethod.PUT)

    • @DeleteMapping 等同于 @RequestMapping(method = RequestMethod.DELETE)

    • @PatchMapping 等同于 @RequestMapping(method = RequestMethod.PATCH)

    @RequestBody和@ResponseBody

    • @RequestBody注解允许request的参数在reqeust体中,常常结合前端POST请求,进行前后端交互。
    • @ResponseBody注解支持将返回的参数在reqeust体中,通常返回json格式给前端(一般与@Controller和用,否则返回的结果会被解析为路径)。

    @PathVariable、@RequestParam、@RequestAttribute

    • @PathVariable用来接收参数,如/path/001,可接收001作为参数
    • @RequestParam 用来接收URL中的参数,如/param?id=001,可接收001作为参数
    • @RequestAttribute用于访问由过滤器或拦截器创建的、预先存在的请求属性,效果等同与request.getAttrbute().

    @Component、@Service、@Repository

    这三者都是申明一个单例的bean类并纳入spring容器中,后两者其实都是继承于@Component

    • @Component 最普通的组件,可以被注入到spring容器进行管理

    • @Repository 作用于持久层

      • 若要注入配置文件xml,还需要主类配置:

        @MapperScan(basePackages = {"com.tuyou.user.center.repository.standard"})
        或者
        @MapperScan("cn.qzzg.*.mapper")
        
    • @Service 作用于业务逻辑层

    • @Mapper 作用于持久层,若是使用mybatis需要使用这个注解,而不是@Repository,因为springboot没有集成mybatis,会异常

    通常一些类无法确定是使用@Service还是@Component时,注解使用@Component,比如redis的配置类等

    @ModelAttribute

    主要是绑定请求参数到指定对象上。此注解可被用于方法、参数上。

    • 运用在参数上,会将客户端传递过来的参数按名称注入到指定对象中,并且会将这个对象自动加入ModelMap中,便于View层使用;
    • 运用在方法上,会在每一个@RequestMapping标注的方法前执行,如果有返回值,则自动将该返回值加入到ModelMap中;

    由于现在都采用前后端分离开发,故此注解相对用的较少了,但对于一些在每次请求前需要进行一些额外操作时。使用此注解依然是个选择,比如进行统一的业务校验等,但使用此注解实现类似功能时需要注意,使用异步调用时,比如callable或者DeferredResult时,被此注解的方法会执行两次,因为异步请求时,是挂起另一个线程去重新执行,对于配置了拦截器而已,它们的执行顺序为

    preHandle ---->afterConcurrentHandlingStarted ----> Controller---->preHandler----> postHandler ----> afterCompletion
    
  • 相关阅读:
    JDK线程池原理之一:工作原理
    Hystrix Feign 特定状态码不熔断
    Hystrix熔断的方法级别(自定义commonKey)
    谨慎使用Exception
    FunctionalInterface~一个批量处理数据的类
    keycloak~账号密码认证和授权码认证
    keycloak~OIDC&OAuth2&自定义皮肤
    docker~添加hosts绑定的方法
    docker~产生的IP段与现有IP冲突问题
    高中数学知识要点及解题方法精粹[网摘]
  • 原文地址:https://www.cnblogs.com/ziyue7575/p/14158009.html
Copyright © 2020-2023  润新知