SpringBoot 集成接口文档，老鸟们也被打脸了！

有的开发人员直接在idea中使用【Open In Browser】打开smart-doc生成的debug页面，如果非要这做，前端js请求后台接口时就出现了跨域。因此你需要在后端配置跨域。

这里以 SpringBoot2.3.x 为例配置后端跨域：

@Configuration

public class WebMvcAutoConfig implements WebMvcConfigurer {

@Bean

public CorsFilter corsFilter() {

final UrlBasedCorsConfigurationSource urlBasedCorsConfigurationSource = new UrlBasedCorsConfigurationSource();

final CorsConfiguration corsConfiguration = new CorsConfiguration();

/* 是否允许请求带有验证信息 */

corsConfiguration.setAllowCredentials(true);

/* 允许访问的客户端域名 */

corsConfiguration.addAllowedOrigin(“*”);

/* 允许服务端访问的客户端请求头 */

corsConfiguration.addAllowedHeader(“*”);

/* 允许访问的方法名,GET POST等 */

corsConfiguration.addAllowedMethod(“*”);

urlBasedCorsConfigurationSource.registerCorsConfiguration(“/**”, corsConfiguration);

return new CorsFilter(urlBasedCorsConfigurationSource);

}

}

开启跨域后我们就可以直接在静态接口页面中进行调试了。

2. 通用响应体

在 “SpringBoot 如何统一后端返回格式？老鸟们都是这样玩的！”一文中我们通过实现 ResponseBodyAdvice对所有返回值进行了包装，给前端返回统一的数据结构ResultData，我们需要让其在接口文档中也有此功能，在配置文件追加配置内容：

{

“responseBodyAdvice”:{ – 通用响应体

“className”:“com.jianzh5.blog.base.ResultData”

}

}

3. 自定义Header

在前后端分离项目中我们一般需要在请求接口时设置一个请求头，如token，Authorization等…后端根据请求头判断是否为系统合法用户，目前smart-doc也对其提供了支持。

在smart-doc配置文件 smart-doc.json中继续追加如下配置内容：

“requestHeaders”: [ //设置请求头，没有需求可以不设置

{

“name”: “token”,//请求头名称

“type”: “string”,//请求头类型

“desc”: “自定义请求头 - token”,//请求头描述信息

“value”:“123456”,//不设置默认null

“required”: false,//是否必须

“since”: “-”,//什么版本添加的改请求头

“pathPatterns”: “/smart/say”,//只有以/smart/say 开头的url才会有此请求头

“excludePathPatterns”:“/smart/add,/smart/edit” // url=/app/page/将不会有该请求头

}

]

效果如下：

4. 参数分组

演示一下smart-doc对于参数分组的支持

新增操作时，age、level为必填项，sex为非必填。

编辑操作时，id，appid，leven为必填项，sex为非必填。

通过上面的效果可以看出smart-doc对于参数分组是完全支持的。

5. idea配置doc

自定义的tag默认是不会自动提示的，需要用户在idea中进行设置。设置好后即可使用，下面以设置smart-doc自定义的mock tag为例，设置操作如下：

### 6. 完整配置

附上完整配置，如果还需要其他配置大家可以参考wiki自行引入。

{

“serverUrl”: “http://localhost:8080”,

“allInOne”: true,

“outPath”: “src/main/resources/static/doc”,

“createDebugPage”: true,

“allInOneDocFileName”:“index.html”,

“projectName”: “初识smart-doc”,

“packageFilters”: “com.jianzh5.blog.smartdoc.*”,

“errorCodeDictionaries”: [{

“title”: “title”,

“enumClassName”: “com.jianzh5.blog.base.ReturnCode”,

“codeField”: “code”,

“descField”: “message”

}],

“responseBodyAdvice”:{

“className”:“com.jianzh5.blog.base.ResultData”

},

“requestHeaders”: [{

“name”: “token”,

“type”: “string”,

“desc”: “自定义请求头 - token”,

“value”:“123456”,

“required”: false,

“since”: “-”,

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数Java工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Java开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Java开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！

如果你觉得这些内容对你有帮助，可以扫码获取！！（备注Java获取）

Spring全套教学资料

Spring是Java程序员的《葵花宝典》，其中提供的各种大招，能简化我们的开发，大大提升开发效率！目前99%的公司使用了Spring，大家可以去各大招聘网站看一下，Spring算是必备技能，所以一定要掌握。

目录：

部分内容：

Spring源码

• 第一部分 Spring 概述
• 第二部分 核心思想
• 第三部分 手写实现 IoC 和 AOP（自定义Spring框架）
• 第四部分 Spring IOC 高级应用
  基础特性
  高级特性
• 第五部分 Spring IOC源码深度剖析
  设计优雅
  设计模式
  注意：原则、方法和技巧
• 第六部分 Spring AOP 应用
  声明事务控制
• 第七部分 Spring AOP源码深度剖析
  必要的笔记、必要的图、通俗易懂的语言化解知识难点

脚手框架：SpringBoot技术

它的目标是简化Spring应用和服务的创建、开发与部署，简化了配置文件，使用嵌入式web服务器，含有诸多开箱即用的微服务功能，可以和spring cloud联合部署。

Spring Boot的核心思想是约定大于配置，应用只需要很少的配置即可，简化了应用开发模式。

• SpringBoot入门
• 配置文件
• 日志
• Web开发
• Docker
• SpringBoot与数据访问
• 启动配置原理
• 自定义starter

微服务架构：Spring Cloud Alibaba

同 Spring Cloud 一样，Spring Cloud Alibaba 也是一套微服务解决方案，包含开发分布式应用微服务的必需组件，方便开发者通过 Spring Cloud 编程模型轻松使用这些组件来开发分布式应用服务。

• 微服务架构介绍
• Spring Cloud Alibaba介绍
• 微服务环境搭建
• 服务治理
• 服务容错
• 服务网关
• 链路追踪
• ZipKin集成及数据持久化
• 消息驱动
• 短信服务
• Nacos Confifig—服务配置
• Seata—分布式事务
• Dubbo—rpc通信

Spring MVC

目录：

部分内容：

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！
片转存中…(img-oz177WJv-1712680973405)]

[外链图片转存中…(img-bI32lLxH-1712680973405)]

[外链图片转存中…(img-fmWXS3Bp-1712680973405)]

部分内容：

[外链图片转存中…(img-Gjw0H4Jl-1712680973405)]

[外链图片转存中…(img-O3pZp2sw-1712680973405)]

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！