java注解学习

@api注解

@Api：用在请求的类上，表示对类的说明
tags=“说明该类的作用，可以在UI界面上看到的注解”
value=“该参数没什么意义，在UI界面上也看到，所以不需要配置”

@ApiOperation：用在请求的方法上，说明方法的用途、作用
value=“说明方法的用途、作用”
notes=“方法的备注说明”

@ApiImplicitParams：用在请求的方法上，表示一组参数说明
@ApiImplicitParam：用在@ApiImplicitParams注解中，指定一个请求参数的各个方面
name：参数名
value：参数的汉字说明、解释
required：参数是否必须传
paramType：参数放在哪个地方
· header --> 请求参数的获取：@RequestHeader
· query --> 请求参数的获取：@RequestParam
· path（用于restful接口）–> 请求参数的获取：@PathVariable
· body（不常用）
· form（不常用）
dataType：参数类型，默认String，其它值dataType=“Integer”
defaultValue：参数的默认值

@ApiResponses：用在请求的方法上，表示一组响应
@ApiResponse：用在@ApiResponses中，一般用于表达一个错误的响应信息
code：数字，例如400
message：信息，例如"请求参数没填好"
response：抛出异常的类

@ApiModel：用于响应类上，表示一个返回响应数据的信息
（这种一般用在post创建的时候，使用@RequestBody这样的场景，
请求参数无法使用@ApiImplicitParam注解进行描述的时候）

@Valid

版权声明：本文为CSDN博主「笙南」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/weixin_38118016/article/details/80977207

@Valid
用于验证注解是否符合要求，直接加在变量user之前，在变量中添加验证信息的要求，当不符合要求时就会在方法中返回message 的错误提示信息。
例如：若传入待核查自动出案周期为空时（不满足注解@NotNull）则抛出异常信息。

public ResponseMessage addOrUpdateGlZdcapz(@RequestBody  @Valid 	ZiDongCapzDTO ziDongCapzDTO) {
	fmcsGlZdcapzTService.addOrUpdateGlZdcapz(ziDongCapzDTO);
	return ResponseMessage.ok()}



public class ZiDongCapzDTO implements Serializable {
private static final long serialVersionUID = 1L;

@Tolerate
public ZiDongCapzDTO() {
}

@ApiModelProperty(value = "主键")
private Long rid;

@ApiModelProperty(value = "待核查自动出案周期")
@Range(max = 999, min = 0)
@NotNull
private Integer daihechazdcazq;
}

类似@NotNull注解有：

项目	Value
限制	说明
@Null	限制只能为null
@NotNull	限制必须不为null
@AssertFalse	限制必须为false
@AssertTrue	限制必须为true
@DecimalMax(value)	限制必须为一个不大于指定值的数字
@DecimalMin(value)	限制必须为一个不小于指定值的数字
@Digits(integer,fraction)	限制必须为一个小数，且整数部分的位数不能超过integer，小数部分的位数不能超过fraction
@Future	限制必须是一个将来的日期
@Max(value)	限制必须为一个不大于指定值的数字
@Min(value)	限制必须为一个不小于指定值的数字
@Past	限制必须是一个过去的日期
@Pattern(value)	限制必须符合指定的正则表达式
@Size(max,min)	限制字符长度必须在min到max之间
@Past	验证注解的元素值（日期类型）比当前时间早
@NotEmpty	验证注解的元素值不为null且不为空（字符串长度不为0、集合大小不为0）
@NotBlank	验证注解的元素值不为空（不为null、去除首位空格后长度为0），不同于@NotEmpty，@NotBlank
@Email	验证注解的元素值是Email，也可以通过正则表达式和flag指定自定义的email格式

@Builder注解使用详解

转载于:https://juejin.im/post/5cdb8422e51d453adf1fa72d

Lombok大家都知道，在使用POJO过程中，它给我们带来了很多便利，省下大量写get、set方法、构造器、equal、toString方法的时间。除此之外，通过@Builder注解，lombok还可以方便的时间建造者模式。

如果项目中有使用lombok的话，可以直接使用@Builder注解来实现

改造上面的类如下：

import lombok.Builder;
import lombok.ToString;
 
/**
 * @author wulongtao
 */
@ToString
@Builder
public class UserExample {
    private Integer id;
    private String name;
    private String address;
}

如何使用：

	UserExample userExample = UserExample.builder()
                .id(1)
                .name("aaa")
                .address("bbb")
                .build();
 
	System.out.println(userExample);
	

QueryWrapper中常用方法

转载：链接: https://blog.csdn.net/zcxbd/article/details/107974723.
比较全的常用方法，基本涵盖了，自己经常用到，就留存一下
在这里插入图片描述