[ERP]SpringBoot集成Swagger技术(☆)

简介: 本文介绍了入职后如何快速运行项目代码并完成Swagger接口文档集成的需求。涵盖代码克隆、环境配置、分支管理、提交规范及技术要点(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

相关文章
|
22小时前
|
人工智能 easyexcel Java
[Blog]SpringBootExcel导入(☆☆☆)
本任务要求基于SpringBoot等技术实现博客系统的Excel批量导入功能,涉及POI或EasyExcel应用。需结合AI工具、自学能力与团队协作,提升独立开发和需求分析能力,为转正积累实战经验。(238字)
[Blog]SpringBootExcel导入(☆☆☆)
|
20小时前
|
SQL 运维 分布式计算
如何做好SQL质量监控
SLS推出用户级SQL质量监控功能,集成于CloudLens for SLS,提供健康分、服务指标、运行明细、SQL Pattern分析及优化建议五大维度,助力用户全面掌握SQL使用情况,提升日志分析效率与治理能力。
如何做好SQL质量监控
|
22小时前
|
Java 数据库连接 调度
xxljob执行源码分析
本文深入解析XXL-JOB源码,涵盖架构设计、核心执行流程与关键线程机制。包括任务调度、快慢线程池分离、注册与心跳检测、失败重试告警、日志清理及时间轮原理,结合图文详解各组件实现逻辑,助你全面掌握分布式任务调度底层机制。
 xxljob执行源码分析
|
22小时前
|
存储 算法 BI
xxljob本地运行
本文介绍XXL-JOB分布式任务调度框架的部署与使用,涵盖源码获取、服务端数据库初始化、配置启动、客户端注册及定时任务测试全过程,助您快速搭建并运行调度系统。
|
22小时前
6.Watcher机制(三)之ZooKeeper
本文深入分析ZooKeeper类的源码,重点解析其内部类结构、核心属性与构造函数,并详细探讨create、delete、multi、exists等核心方法的同步与异步实现机制,揭示其基于Watcher机制的事件注册与客户端通信原理。
 6.Watcher机制(三)之ZooKeeper
|
22小时前
4.Watcher机制(一)
本文深入分析Zookeeper的Watcher机制,涵盖核心类与源码实现。重点解析Watcher、Event、KeeperState、EventType等接口与枚举,梳理ZKWatchManager对事件的管理及通知流程,帮助理解Zookeeper的监听机制工作原理。
|
22小时前
|
存储 算法 API
2.持久化FileTxnLog
本文深入分析Zookeeper持久化核心源码,重点解析TxnLog与FileTxnLog实现机制,涵盖事务日志追加、校验、读取、提交及截断等关键流程,揭示其数据存储与一致性保障原理。
 2.持久化FileTxnLog
|
22小时前
|
存储
1.序列化
该文章内容丰富且详细
 1.序列化
|
22小时前
|
存储 关系型数据库 调度
|
22小时前
|
缓存 NoSQL 关系型数据库
微服务原理篇(Canal-Redis)
该文章内容详细且实用
 微服务原理篇(Canal-Redis)