swagger知识点补充

1. swagger知识点补充

1.1. 概述

1. 在swagger的使用过程中，除了网上常见的例子，还会有很多细节上的东西需要注意和改写，这里我列几点我使用过程中遇到的问题和改进方式

1.2. 知识点

1.2.1. 模型例子

1. 我们在进行POST的请求的时候，尤其是增加一条数据，我们往往会有很多字段是不需要我们手动填写的，比如逻辑删除，创建时间，修改时间等等，我的需求就是再swagger界面的Example中不显示这些字段
2. 实现方式

1.2.2. 判空

1. 如上图所示，这不是swagger知识点，这里顺带讲下，需要在controller层入参加上@Vaild
   
   
2. 输入参数有误，效果如下
   
   

1.2.3. controller层中文字标注

1. 效果如下，网上的例子大多没有设该属性
   
   
2. 实现方式
   
   

1.2.4. 模型填充默认值

1. 如下例子：swagger打开该接口的默认配置就是example配的
   
   
   
   

1.2.5. 激活测试dev模式

1. 再补充个非swagger的知识点，激活dev模式，在测试时比较好用

@RunWith(SpringRunner.class)
@SpringBootTest
@ActiveProfiles("dev")
@Slf4j
public class FundApplicationTests {

    @Test
    public void contextLoads() {
        log.info("adafdafds");
    }

}

1.2.6. schedule的cron定时任务

1. 再补充个，定时任务的要求有时候可能觉得一个cron满足不了，不要执着于怎么写cron了，注解时可以注多个的

@Target({ElementType.METHOD, ElementType.ANNOTATION_TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Repeatable(Schedules.class)
public @interface Scheduled {

1. @Repeatable注解就是表明了这个注解可以重复注

1.2.7. transient和@TableField(select = false)

1. 虽然前面有讲到过，这里在重复声明一次，连我也觉得容易忘记，属性用transient修饰，在配合jackson或fastjson的fj.setSerializerFeatures(SerializerFeature.SkipTransientField）配置，表示对controller层做切面，返回数据的json序列化会去掉该字段；而@TableField(select = false)注解的属性字段，表示用mybatis的sql查询，默认查全量字段时，该字段不查询
2. 逻辑删除字段，添加transient会导致逻辑删除模式失效

1.2.8. 逻辑删除

1. 前面也讲到过逻辑删除的功能，它除了可以使得我们用deleteById这样的操作变成逻辑删除，还可以使除了自定义语句的查询默认加上逻辑删除=未删除的条件，也就是说，像下列这样的查询操作，默认会加上del_flag=0，我们无需再多写这个字段的条件

User user = this.baseMapper.selectOne(Wrappers.<User>lambdaQuery().
                select(User::getUsername, User::getSex, User::getNickName).eq(User::getUserId, userId));