1. 09 4月, 2023 1 次提交
    • 查尔斯-BUG万象集's avatar
      refactor: 优化 springdoc-openapi 对象型参数处理 · ae8d2947
      查尔斯-BUG万象集 提交于
      1.使用 default-flat-param-object 全局设置对象型参数展示形式。此设置是在 springdoc-openapi v1.6.11 版本开始添加的新特性(详情请参阅:https://github.com/springdoc/springdoc-openapi/pull/1805),在此之前,只能在所有需要处理的对象型参数类上使用 @ParameterObject,工作量较大。
      2.作者在使用上方这个配置时还遇到了一个 Bug,那就是只要在对象型参数前使用了注解,例如:@Validated PageQuery pageQuery,这个配置就不会生效了。此问题已在 GitHub 提交了相应 issue(详情请参阅:https://github.com/springdoc/springdoc-openapi/issues/2181),并且 springdoc-openapi 社区某个小伙伴儿已在当前最新发布的 v2.1.0 和 v1.7.0 中修复。
      注意:由于当前使用的 Knife4j 版本其内部引入的 springdoc-openapi 相关依赖非最新版本,所以为了解决配置不生效问题,暂时将部分对象型参数移除了 @Validated 注解(除了 PageQuery,其他类当前也未实际添加校验,所以直接移除了)。当然如果不想移除的话,也可以从依赖上功夫,即移除 Knife4j 内引入的 springdoc-openapi 相关依赖,然后自行添加 springdoc-openapi 相关依赖并指定最新版本即可。
      ae8d2947
  2. 04 3月, 2023 1 次提交
  3. 03 3月, 2023 2 次提交
    • 查尔斯-BUG万象集's avatar
      优化:基于阿里巴巴 Java 开发手册(黄山版)优化部分方法使用 · dc751fc3
      查尔斯-BUG万象集 提交于
      1.编程规约>OOP规约>第12条:
      【强制】禁止使用构造方法 BigDecimal(double) 的方式把 double 值转化为 BigDecimal 对象。
      说明:BigDecimal(double) 存在精度损失风险,在精确计算或值比较的场景中可能会导致业务逻辑异常。
      如:BigDecimal g = new BigDecimal(0.1F);实际的存储值为:0.100000001490116119384765625
      正例:优先推荐入参为 String 的构造方法,或使用 BigDecimal 的 valueOf 方法,此方法内部其实执行了 Double 的
      toString,而 Double 的 toString 按 double 的实际能表达的精度对尾数进行了截断。
      BigDecimal recommend1 = new BigDecimal("0.1");
      BigDecimal recommend2 = BigDecimal.valueOf(0.1);
      2.编程规约>OOP规约>第19条:
      【推荐】使用索引访问用 String 的 split 方法得到的数组时,需做最后一个分隔符后有无内容的检查,
      否则会有抛 IndexOutOfBoundsException 的风险。
      说明:
        String str = "a,b,c,,";
        String[] ary = str.split(",");
        // 预期大于 3,结果等于 3
        System.out.println(ary.length);
      dc751fc3
    • 查尔斯-BUG万象集's avatar
      优化:基于阿里巴巴 Java 开发手册(黄山版)优化常量及包命名 · 1257a4bc
      查尔斯-BUG万象集 提交于
      1.编程规约>常量定义>第4条:
      【推荐】不要使用一个常量类维护所有常量,要按常量功能进行归类,分开维护。
      说明:大而全的常量类,杂乱无章,使用查找功能才能定位到要修改的常量,不利于理解,也不利于维护。
      正例:缓存相关常量放在类 CacheConsts 下;系统配置相关常量放在类 SystemConfigConsts 下。
      2.编程规约>常量定义>第5条:
      【推荐】常量的复用层次有五层:跨应用共享常量、应用内共享常量、子工程内共享常量、包内共享常
      量、类内共享常量。
        1)跨应用共享常量:放置在二方库中,通常是 client.jar 中的 constant 目录下。
        2)应用内共享常量:放置在一方库中,通常是子模块中的 constant 目录下。
        反例:易懂常量也要统一定义成应用内共享常量,两个程序员在两个类中分别定义了表示“是”的常量:
        类 A 中:public static final String YES = "yes";
        类 B 中:public static final String YES = "y";
        A.YES.equals(B.YES),预期是 true,但实际返回为 false,导致线上问题。
        3)子工程内部共享常量:即在当前子工程的 constant 目录下。
        4)包内共享常量:即在当前包下单独的 constant 目录下。
        5)类内共享常量:直接在类内部 private static final 定义。
      1257a4bc
  4. 13 2月, 2023 1 次提交
  5. 01 2月, 2023 1 次提交
  6. 21 1月, 2023 1 次提交
  7. 16 1月, 2023 1 次提交