网站建设目的确定,wordpress参数,跨境电商单页网站的详情页怎么做的,企业门户网站建设方案怎么写亲兄弟篇#xff1a; SpringBoot注解大全#xff08;超详细#xff09;_Maiko Star的博客-CSDN博客
一、SpringBoot常用注解 二、Bean处理注解 2.1 Resource 依赖注入#xff0c;自动导入标注的对象到当前类中#xff0c;比如我们的 Controller 类通常要导入 Service 类…亲兄弟篇 SpringBoot注解大全超详细_Maiko Star的博客-CSDN博客
一、SpringBoot常用注解 二、Bean处理注解 2.1 Resource 依赖注入自动导入标注的对象到当前类中比如我们的 Controller 类通常要导入 Service 类需要注意这里 Service 类要被 Spring 容器管理。 2.2 Component、Repository、Service、Controller、RestController 我们一般使用 Resource 注解让 Spring 容器帮我们自动装配 bean。要想把类标识成可用于 Resource 注解自动装配的 bean 就需要我们使用这几个注解了它们表示对应的类将被 Spring 容器管理。 Component 通用的注解可标注任意类为 Spring 组件。如果一个 Bean 不知道属于哪个层可以使用Component 注解标注 Repository : 对应持久层即 Dao 层主要用于数据库相关操作 Service : 对应服务层主要涉及一些复杂的逻辑需要用到 Dao 层 Controller : 对应 Spring MVC 控制层一般需要注入 Service 类返回结果数据 RestController : 继承于 Controller区别在于标注后整个类所有方法将直接返回 JSON 数据不再需要视图解析处理目前前后端分离的项目后端都是直接用这个注解的 2.3 Configuration 标注是 Java 代码的配置类 Spring Boot 中推荐这种做法不再使用 xml 配置了 2.4 Scope 声明 Spring Bean 的作用域,作用于一共有以下几种 singleton唯一 bean 实例Spring 中的 bean 默认都是单例的。 prototype每次请求都会创建一个新的 bean 实例。 request每一次 HTTP 请求都会产生一个新的 bean该 bean 仅在当前 HTTP request 内有效。 session每一次 HTTP 请求都会产生一个新的 bean该 bean 仅在当前 HTTP session 内有效。 三、HTTP请求注解 3.1 GetMapping 等价于 RequestMapping(value/test,methodRequestMethod.GET) 3.2 PostMapping 3.3 PutMapping put 方式的请求常用语更新服务器上的资源。举个例子PUT /users/7更新编号为 7 的学生 3.4 DeleteMapping DELETE 请求从服务器删除特定的资源。 四、前后端参数传递注解 4.1 RequestParam PathVariable RequestParam 用在方法的参数前面获取请求中表单类型的keyvalue格式的数据。 PathVariable 用于获取请求路径中的参数。 4.2 RequestBody 获取请求 body 中的数据常用于搭配 PostMapping 请求来提交对象数据. 请求体 的Content-Type 必须为 application/json 格式的数据接收到数据之后会自动将数据绑定到 Java 对象上去。 系统会使用 HttpMessageConverter 或者自定义的 HttpMessageConverter将请求的 body 中的 json 字符串转换为 java 对象。 强调一下请求方法只可以有一个RequestBody但是可以有多个 RequestParam 和 PathVariable。 如果你的方法必须要用两个 RequestBody 来接受数据的话那你就只思考下你的设计了或者套娃形式的。 4.3 ResponseBody 表示该方法的返回结果直接写入 HTTP response body 中格式为 json。上面我们提到的 RestController 其实就是 Controller 和 ResponseBody 两个结合起来的。 五、读取配置注解 5.1 value 可以在任意 Spring 管理的 Bean 中通过这个注解获取任何来源配置的属性值。比如我们的 application.properties 或者 application.yml 配置文件中配置的属性值当然也可以是 JVM 属性配置或者系统环境变量配置的值如果对 Spring Boot 应用程序都有哪些属性配置源以及它们之间的优先级不了解的小伙伴可以看我之前的文章Spring Boot 属性配置你所不知道的细节。 5.2 ConfigurationProperties(重点) 上面 Value 在每个类中获取属性配置值的做法其实是不推荐的我们一般在企业项目开发中不会使用那么杂乱无章的写法而且维护也麻烦通过就是一次性读取到一个 Java 配置类然后需要使用的地方直接引用这个类就可以多次访问了方便维护。 5.3 PropertySource 这个注解是用来指定读取我们自定义的配置文件的。 六、参数校验注解 数据的校验的重要性就不用说了即使在前端对数据进行校验的情况下我们还是要对传入后端的数据再进行一遍校验避免用户绕过浏览器直接通过一些 HTTP 工具直接向后端请求一些违法数据。
JSR(Java Specification Requests 是一套 JavaBean 参数校验的标准它定义了很多常用的校验注解我们可以直接将这些注解加在我们 JavaBean 的属性上面这样就可以在需要校验的时候进行校验了非常方便
校验的时候我们实际用的是 Hibernate Validator 框架。Hibernate Validator 是 Hibernate 团队最初的数据校验框架Hibernate Validator 4.x 是 Bean Validation 1.0JSR 303的参考实现Hibernate Validator 5.x 是 Bean Validation 1.1JSR 349的参考实现目前最新版的 Hibernate Validator 6.x 是 Bean Validation 2.0JSR 380的参考实现。
需要注意的是从 Spring Boot 2.3开始我们还需要显式地添加 spring-boot-starter-validation 依赖项在此之前的 Spring Boot 版本是在 spring-boot-starter-web 依赖项中包含的不需要额外引入。
我现在使用的是 Spring Boot 2.5.2 版本了所以手动增加依赖 需要注意的是 所有的注解推荐使用 JSR 注解即 javax.validation.constraints而不是 org.hibernate.validator.constraints
6.1 Bean字段验证注解 NotEmpty 被注释的字符串的不能为 null 也不能为空 NotBlank 被注释的字符串非 null并且必须包含一个非空白字符 Null 被注释的元素必须为 null NotNull 被注释的元素必须不为 null AssertTrue 被注释的元素必须为 true AssertFalse 被注释的元素必须为 false Pattern(regex,flag)被注释的元素必须符合指定的正则表达式 Email 被注释的元素必须是 Email 格式。 Min(value)被注释的元素必须是一个数字其值必须大于等于指定的最小值 Max(value)被注释的元素必须是一个数字其值必须小于等于指定的最大值 DecimalMin(value)被注释的元素必须是一个数字其值必须大于等于指定的最小值 DecimalMax(value) 被注释的元素必须是一个数字其值必须小于等于指定的最大值 Size(max, min)被注释的元素的大小必须在指定的范围内 Digits (integer, fraction)被注释的元素必须是一个数字其值必须在可接受的范围内 Past被注释的元素必须是一个过去的日期 Future 被注释的元素必须是一个将来的日期
验证请求体(RequestBody) 只需要在请求处理方法中需要验证的参数前加上 Valid 注解就会开启校验了如果验证失败将抛出异常MethodArgumentNotValidException。 6.2 Validated 如果你的入参不是用一个 Java 对象来接收的话比如用 PathVariables 和 RequestParam 注解来获取入参这种情况下要校验参数不要忘记在类的头上加 Validated 注解这个参数可以告诉 Spring 去校验方法参数。 七、统一异常处理注解 异常处理通常也是我们在开发中一定要做的因为不可能将一些程序员才能看懂的异常抛出到前端去总会有不靠谱的同事忘记捕获异常的所以一般都会加上统一的异常处理在对用户不友好的错误堆栈转换为普通用户可以看懂的文案提示。 这里涉及到的注解只有两个 ControllerAdvice : 定义全局异常处理类包含 Component 所以可以被 Spring 扫描到。 ExceptionHandler : 声明异常处理方法表示遇到这个异常就执行标注的方法。 八、JPA数据持久化注解 上面是百度百科给的概念只能说在实际项目开发中还是用的不多大家还是喜欢用 Mybatis不过相比更加简洁的技术还是要学习下的。 创建表 Entity Table
这俩是放在 Java Bean 上面用来标注数据库实体对象和表明之间的映射关系的。 创建主键 Id GeneratedValue
这俩主键放在 Bean 的字段上用来标识数据库的主键以及主键自动生成的。通过 GeneratedValue直接使用 JPA 内置提供的四种主键生成策略来指定。 GenerationType.TABLE 持久化引擎通过关系数据库的一张特定的表格来生成主键 GenerationType.SEQUENCE 随机序列 GenerationType.IDENTITY 主键自增长 GenerationType.AUTO 持久化引擎会根据数据库在以上三种主键生成策略中选择默认选择的就是这个策略 设置字段类型
Column 声明字段。
比如Java Bean 属性名为 nickName 对应的数据库字段名为 user_name长度为 32非空。 设置字段类型并且加默认值这个还是挺常用的。 指定不持久化特定字段
Transient 有一些字段我们有时间不需要落库就可以加上这个注解就好了。
声明事务
这个注解可以作用于类上也可以作用于方法上。前者表示所有该类的 public 方法都配置相同的事务属性信息后者表示当类配置了Transactional方法也配置了Transactional方法的事务会覆盖类的事务配置信息。
Exception 分为运行时异常 RuntimeException 和非运行时异常。在 Transactional 注解中如果不配置 rollbackFor 属性,那么事物只会在遇到 RuntimeException 的时候才会回滚,加上 rollbackForException.class ,可以让事物在遇到非运行时异常时也回滚。 九、 JSON格式处理注解 9.1 指定过滤字段 JsonIgnoreProperties 作用在类上用于过滤掉特定字段不返回或者不解析。 JsonIgnore一般用于类的属性上作用和上面的JsonIgnoreProperties 一样。 9.2 格式化 json 数据 要注意的是它只会在类似 ResponseBody 返回 json 数据的时候才会返回格式化的 yyyy-MM-dd HH:mm:ss 时间你直接使用System.out.println()输出的话仍然是类似 Fri Dec 01 21:05:20 CST 2017 这样的时间样式。 9.3 扁平化对象
JsonUnwrapped
这个可能不太好说大家直接看代码就懂了 未扁平化之前 使用 JsonUnwrapped 扁平对象之后 十、测试处理注解 ActiveProfiles一般作用于测试类上 用于声明生效的 Spring 配置文件。
Test声明一个方法为测试方法。
Transactional被声明的测试方法执行后数据会被回滚避免污染测试数据。
WithMockUser Spring Security 提供的用来模拟一个真实用户并且可以赋予权限。 十一、配置启动注解 SpringBootApplication : 等价于使用 Configuration、EnableAutoConfiguration、ComponentScan 三个注解。
Configuration声明是是一个 Java 形式的配置类Spring Boot 提倡基于 Java 的配置相当于你之前在 xml 中配置 bean
EnableAutoConfiguration类级别的注解这个注解告诉 Spring Boot 根据添加的 jar 依赖猜测你想如何配置 Spring也就是 Spring 实现自动配置的开关。
ComponentScan标注哪些路径下的类需要被Spring扫描。
ConditionalSpring4 新提供的注解通过 Conditional 注解可以根据代码中设置的条件装载不同的 bean也是SpringBoot实现自动配置的基石。
Spring Boot 源码中大量扩展了 Condition 注解用于实现智能的自动化配置满足各种使用场景。下面我给大家列举下 ConditionalOnBean 配置了某个特定的Bean时条件为真。 ConditionalOnMissingBean 没有配置特定的Bean时条件为真。 ConditionalOnClassClasspath里有指定的类时条件为真。 ConditionalOnMissingClassClasspath里没有指定的类时条件为真。 ConditionalOnExpression给定的SpEL表达式计算结果为true。 ConditionalOnJavaJava的版本匹配特定值或者一个范围值。 ConditionalOnJndi参数中给定的 JNDI 位置必须存在一个如果没有给参数则要有 JNDI InitialContext。 ConditionalOnProperty指定的配置属性要有一个明确的值。 ConditionalOnResourceClasspath里没有指定的资源。 ConditionalOnWebApplication这是一个Web应用程序。 ConditionalOnNotWebApplication这不是一个Web应用程序。
