CRMEB小程序商城Java版Swagger界面丑、功能弱怎么破?——CRMEB开源商城系统
全国统一咨询热线:

15817498839

当前位置: 网站首页 > CRMEB小程序商城Java版Swagger界面丑、功能弱怎么破?

CRMEB小程序商城Java版Swagger界面丑、功能弱怎么破?

2023年06月27日 01:43:16  来源:每日必看    

CRMEB小程序商城Java版Swagger界面丑、功能弱怎么破?

在做CRMEB-JAVA开源商城系统时,我们团队用到了uni-app,也是时下比较流行的移动端开发技术,这里边就牵扯到了前后端全部分离的问题,一般在使用java开发前后端分离项目的时候,都会用到Swagger,Swagger 是一个用于生成、描述、调用和可视化 RESTful 风格的 Web api 服务的框架,Swagger 让部署管理和使用功能强大的 API变得简单,但这仅仅是在小型项目里,API接口不多的情况下。

微信号:15889440095
添加微信好友, 获取更多信息
复制微信号


随着,CRMEB-JAVA开源商城系统的不断优化,功能的不断增加,并且前后台都做到了前后端分离,接口数量一度超过了200多个,这就使得系统中一些使用体验变的越来越差,例如: 提交参数为JSON没法格式化,参数错了查找麻烦,返回结果没法折叠,太长了没法看,真是非常的痛苦呀!


但是,作为程序员一定要知道,你遇到的问题别人也一定遇到过,也肯定有热心的大牛解决了这个问题,所以,一个叫knife4j的增强版本Swagger诞生了,他帮我们很好地解决了以上问题,引用一下原作者的话来简单了解下knife4j:


希望knife4j像一把匕首一样小巧,轻量,并且功能强悍,也希望把她做成一个为Swagger接口文档服务的通用性解决方案,而不仅仅只是专注于前端Ui前端.


先上一张项目刚上的knife4j优化过的Swagger的剧照,先睹为快:


看上图是不是一目了然,最重要的是搜索框可以搜索相关api接口快速查询,并且可以在线调试接口,再来张图展示!


knife4j开源项目说明:


Spring Boot 项目使用knife4j

  • 研究CRMEB_JAVA开源商城系统,学习看在实际开发当中,如何集成进项目!

# 帮助文档https://doc.xiaominfo.com/knife4j/springboot.html#maven%E5%BC%95%E7%94%A8

CRMEB_JAVA开源商城地址:

https://gitee.com/ZhongBangKeJi/crmeb_java

maven引用

第一步: 是在项目的pom.xml文件中引入knife4j的依赖,如下:

>
    >
        >com.github.xiaoymingroupId>
        >knife4j-spring-boot-starterartifactId>
        
        >2.0.2version>
    dependency>dependencies>

如果你想使用bom的方式引入,请参考Maven Bom方式引用


创建Swagger配置文件

新建Swagger的配置文件SwaggerConfiguration.java文件,创建springfox提供的Docket分组对象,代码如下:

@Configuration@EnableSwagger2@EnableKnife4j@Import(BeanValidatorPluginsConfiguration.class)public class SwaggerConfiguration { 

    @Bean(value = "defaultApi2")
    public Docket defaultApi2() {
        Docket docket=new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())                //分组名称
                .groupName("2.X版本")
                .select()                //这里指定Controller扫描包路径
                .apis(RequestHandlerSelectors.basePackage("com.swagger.bootstrap.ui.demo.new2"))
                .paths(PathSelectors.any())
                .build();        return docket;
    }

}

访问

  • 在浏览器输入地址:http://host:port/doc.html





每日必看相关文章

热门Tags标签
分销商城系统
O2O商城系统
新零售商城系统
APP商城系统
每日必看
已复制微信号

微信号: 15817498839
长按二维码保存到手机!

立即添加微信
复制成功
微信号: 15889440095
添加微信好友, 获取更多信息
我知道了