当前位置： 移动技术网 > IT编程>开发语言>Java > swagger知识点补充

swagger知识点补充

2019年04月30日  | 移动技术网IT编程  | 我要评论

卫星电视锅,蔡玥,卫星机顶盒

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));

您可能感兴趣的文章:

如对本文有疑问，请在下面进行留言讨论，广大热心网友会与你互动！！ 点击进行留言回复

相关文章:

验证码：
最近更新的文章
大家感兴趣的文章
移动技术网