一、@Slf4j
@Slf4j是用作日志输出的,一般会在项目每个类的开头加入该注解,如果不写下面这段代码,并且想用log
private final Logger logger = LoggerFactory.getLogger(当前类名.class);
就可以用@Slf4来代替;这样就省去这段很长的代码。 直接可以在代码中使用log.info()来打印日志
如果不写注解就要使用上面这行代码定义一个logger对象,然后使用logger.info()来打印日志,用了注解默认的对象log和未用注解自己定义的logger是一样的
二、@Api
使用在类上,表明是swagger资源,@API拥有两个属性:value、tags,源码如下
//If tags is not used,this value will be used to set the tag for the operations described by this resource. Otherwise, the value will be ignored.
String value() default "";
//Tags can be used for logical grouping of operations by resources or any other qualifier.
String[] tags() default {""};
生成的api文档会根据tags分类,直白的说就是这个controller中的所有接口生成的接口文档都会在tags这个list下;tags如果有多个值,会生成多个list,每个list都显示所有接口
@Api(tags = "列表1")
@Api(tags = {"列表1","列表2"})
value的作用类似tags,但是不能有多个值
三、@Validated
@Validation是一套帮助我们继续对传输的参数进行数据校验的注解,通过配置Validation可以很轻松的完成对数据的约束。
@Validated作用在类、方法和参数上
@Target({ElementType.TYPE, ElementType.METHOD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Validated {
Class>[] value() default {};
}
错误的状态码
返回的响应码推荐使用400 bad request.
所有参数注解含义
@Valid:没有分组的功能。
@Valid:可以用在方法、构造函数、方法参数和成员属性(字段)上
@Validated:提供了一个分组功能,可以在入参验证时,根据不同的分组采用不同的验证机制
@Validated:可以用在类型、方法和方法参数上。但是不能用在成员属性(字段)上
两者是否能用于成员属性(字段)上直接影响能否提供嵌套验证的功能
原文链接:https://blog.csdn.net/qq_32352777/article/details/108424932
@Target({ElementType.METHOD, ElementType.FIELD, ElementType.CONSTRUCTOR, ElementType.PARAMETER, ElementType.TYPE_USE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Valid {
}
@Target({ElementType.TYPE, ElementType.METHOD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Validated {
Class>[] value() default {};
}
四、@DateTimeFormat和@JsonFormat
@DateTimeFormat用在项目传参数时将指定字符串形式的日期形式转换为Date形式的日期
@JsonFormat用在项目中从数据库中查到的日期时间,防止返回后变成时间戳形式,所以此注解加载数据库表对应的实体类的日期属性上,同时为了使日期不会应时区发生改变,需要加timezone = "GMT+8"表示东八区,否则会按照国际标准时间进行转换,两者相差8小时
示例:
public class DateVo {
@DateTimeFormat(pattern="yyyy-MM-dd")
private Date date;//参数传递
}
表示将pattern模式的string类型的日期形式传递位pattern模式的Date类型日期(没问题),必须传pattern类型的String类型,否则会报错
五、@Controller和@RestController
@Controller必须配合模版来使用,用来响应页面,在项目中减少使用
@RestController注解由@Controller 与@ResponseBody组成,以前需要使用这两个注解配合返回json,现在合在一起,在项目中直接使用@RestController注解
六、@RequestMapping
此注解用来配置url,配置在类上时,这个注解会应用到类中的所有方法上,配置在方法上时对类级别上的@RequestMapping的补充,所以需要先配置类然后配置方法,但是方法在项目中最好使用Get,Post,Update,Delete对象的请求方式(在方法上用@RequestMapping会被骂的吆)
七、@RequestBody
主要作用是用来接受前端传来的json中的数据(请求体中的数据)
原理:将此注解所作用参数类对象(就是方法中参数前面,不过这个参数一般位类对象)接受http请求中的请求体中的参数,会根据json中的key来匹配参数实体类中的属性,若key匹配成功,会调用类中的set方法将对应的value值赋给对应的属性,补充:json中空串"",String接受位"",其他类型接受为null,value没有时,不需要再json中写key,如果写了key,必须写value,没有可以写null或者""
八、@RequestParam
用来将请求参数绑定到控制器的方法参数上,语法:@RequestParam(value=”参数名”,required=”true/false”,defaultValue=””)
value:参数名(url中的参数名必须与value一致)
required:是否包含该参数,默认为true,表示该请求路径中必须包含该参数,如果不包含就报错。required为false,不包含该参数不会报错,有就显示出来
defaultValue:默认参数值,如果设置了该值,required=true将失效,自动为false,如果没有传该参数,就使用默认值
九、@Autowired
作用:完成自动装配,可以作用于类成员变量,方法及构造函数上(最常用是类常量),会自动再容器中查找对应的bean,并装配给该对象的属性
@Autowired由Spring提供,只按照byType注入
@Autowired只有一个属性required,默认值为true,为true时,找不到就抛异常,为false时,找不到就赋值为null
@Autowired按类型查找,如果该类型的bean不唯一,则抛出异常;可通过组合注解解决@Autowired()@Qualifier("baseDao")
十、@Resource
与@Autowired一样,可以实现自动装配
有两个常用属性name、type,所以分4种情况
- 指定name和type:通过name找到唯一的bean,找不到抛出异常;如果type和字段类型不一致,也会抛出异常
- 指定name:通过name找到唯一的bean,找不到抛出异常
- 指定type:通过tpye找到唯一的bean,如果不唯一,则抛出异常:NoUniqueBeanDefinitionException
- 都不指定:通过字段名作为key去查找,找到则赋值;找不到则再通过字段类型去查找,如果不唯一,则抛出异常NoUniqueBeanDefinitionException
- 详情可以点击一下看看大佬详细的解决方法,里面有多个bean出现的情况以及注解的详细使用
@Autowired和@Resource的区别 - aixueforever - 博客园 (cnblogs.com)">Springboot笔记<4>@Autowired和@Resource的区别 - aixueforever - 博客园 (cnblogs.com)
十一、@Value
1、@Value(“xiaoxiong”)
直接将字符串"xiaoxiong"赋值给属性,如果属性类型不是String,或无法进行类型转换,则报错
2、@Value("$ {xiaoxiong}")
将会把{}中的字符当做key从Properties文件或者配置文件中找出对应的Value赋值给属性
3、@Value(”#{xiaoxiong}")
会将#{}中的字符串当做Spring表达式进行解析,Spring会把xiaoxiong当做beanName,并从Spring容器中找到对应的Bean,如果找到则进行属性注入,没有找到则报错
持续更新中。。。



