[ERP]SpringBoot集成Swagger技术(☆

简介: 克隆或下载代码至Idea,配置JDK、Maven等环境,善用同事资源解决配置问题。项目运行后,为三层架构集成Swagger,实现接口文档可视化,添加注解完成参数校验。注意分支规范(feature-hb-xxx)与提交格式(feat/fix/refactor)。掌握git、maven、SpringBoot、Swagger应用。

1.代码运行
git仓库地址:https://gitee.com/Herbbbb/erphome-work
请你完成以下步骤
方案一:
● 克隆代码到Idea,如果你时间允许不妨试试SSH拉取方式
方案二:
● 下载Zip包,不建议,但如果上班后短时间拉不下来优先这种方式让代码跑起来
入职后,对于JDK、Maven、Git、Idea....软件安装类你应该请教谁?
● 以上问题,是大家面临的第一道坎,15K大佬一样一天配置不好maven仓库,请认真思考该请教谁?
当你意识到,公司的环境配置类问题都可以问同事、组长的时候你应该怎么问?
● 不知道该不该问?不敢问?这是多数新人最纠结的一个点,请认真思考你会怎么问?
当你把项目运行起来之后,此时一个全新的工程在你面试,组长立马就给你如下的需求,你会怎么处理?
● 现在的公司愈发需要即战力,一个陌生的环境、工程、团队,紧急的任务,请认真思考你将怎么着手?
2.需求描述
现有的三层架构代码,前端反馈看不懂,需要通过swagger包装一下,请你完成
● 所有接口的入参、出参都能够看懂
● 所有接口都有功能描述
● 所有请求入参,做好非空校验
○ 注意,不是自己手动if-else,而是借助于@NotNull或者@NotEmpty注解
以上这句话你可能不理解,上班也存在大量这样一句话需求,怎么保证自己能知道做什么是很重要的。
最终参考实现效果:

2.1 多说一句(做完再看)
● 你是否考虑过此次修改需要创建新的分支
● 你是否知道创建分支、代码提交的规范
○ 分支创建默认:
■ feature-姓名缩写-需求描述
■ 如:feature-hb-addSwaggerDoc
○ 代码提交规范
■ 新增功能提交注释:feat:需求描述
● 如:feat:新增swagger
■ 修改功能提交注释:fix:需求描述【最常用】
● 如:fix:修改原订单逻辑,增加Redis缓存
■ 重构功能提交注释:refactor:需求描述
● 如:refactor:重构商品模块
3.涉及技术点
阶段二核心:git、maven、springboot、swagger

目录
相关文章
|
7月前
|
前端开发 Java API
Spring Boot中使用Swagger3.0.0注解案例
Spring Boot中使用Swagger3.0.0注解案例
565 3
|
5月前
|
人工智能 自然语言处理 安全
阿里云百炼平台介绍:官网入口链接、免费AI大模型领取及常见问题解答FAQ
阿里云百炼(Bailian)是一站式大模型服务平台,支持文本、图像、视频生成及智能体开发,集成通义系列与主流开源模型,提供企业级安全与低代码应用。新用户可免费领取超7000万Tokens、100张图与50秒视频额度,30秒注册,快速上手AI创作。
11572 7
|
9月前
|
安全 IDE Java
Spring 的@FieldDefaults和@Data:Lombok 注解以实现更简洁的代码
本文介绍了如何在 Spring 应用程序中使用 Project Lombok 的 `@Data` 和 `@FieldDefaults` 注解来减少样板代码,提升代码可读性和可维护性,并探讨了其适用场景与限制。
317 0
Spring 的@FieldDefaults和@Data:Lombok 注解以实现更简洁的代码
|
6月前
|
缓存 算法 C++
⚡ 模型推理加速
大模型推理加速涵盖KV-Cache优化、连续批处理、投机解码、模型并行等技术,通过算法与系统协同优化,提升推理效率。vLLM等框架实现高效部署,兼顾吞吐与延迟,助力大模型落地。
276 0
 ⚡ 模型推理加速
|
8月前
|
机器学习/深度学习 人工智能 JSON
AI编程时代,对应的软件需求文档(SRS、SRD、PRD)要怎么写
对于AI编程来说,需要使用全新的面向提示词的需求文档来和AI+人类沟通,构建共同的单一事实来源文档知识库是重中之重。
1359 7
|
前端开发 JavaScript API
前端代码书写规范
前端代码规范提升项目可维护性和团队协作效率。关注项目命名清晰简洁、一致性,组件命名使用驼峰式且具描述性。JS遵循4空格缩进,分号结束语句,CSS按逻辑排序,HTML注重语义化。注释要功能性、文档化且简洁。遵循规范能减少错误,增强团队沟通。
838 3
|
机器学习/深度学习 人工智能 缓存
最佳实践!使用 GraphRAG + GLM-4 对《红楼梦》全文构建中文增强检索
特别介绍`graphrag-practice-chinese`项目,这是一个针对中文优化的GraphRAG应用实例,通过改进文本切分策略、使用中文提示词及选择更适合中文的模型等手段,显著提升了处理中文内容的能力。项目不仅包括详细的搭建指南,还提供了《红楼梦》全文的索引构建与查询测试示例,非常适合个人学习和研究。
2806 1
|
Java API 数据库
使用Spring Boot构建RESTful API
使用Spring Boot构建RESTful API
|
程序员 开发者
IDEA插件-Power Mode II键盘炫酷效果
Power Mode II 是一款为 IntelliJ IDEA 设计的插件,旨在为编码过程增添动感和趣味性。这款插件通过在代码编写时添加视觉特效、声音效果和其他动态元素,为开发者提供了一个独特且富有创意的编程体验。
1784 0
IDEA插件-Power Mode II键盘炫酷效果
|
缓存 Java 微服务
Spring Boot中的跨域请求处理
Spring Boot中的跨域请求处理