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

简介: 本文介绍如何从Gitee克隆项目并运行代码,涵盖JDK、Maven等环境配置问题的应对策略,强调新人应主动请教同事。要求使用Swagger优化接口文档,实现参数校验与功能描述,并遵循Git分支命名及提交规范,提升开发效率。

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


相关文章
|
2天前
|
机器学习/深度学习 存储 搜索推荐
第二章 基础算法
本文系统介绍了加密算法、排序算法及字符串处理等核心技术。涵盖对称与非对称加密、哈希摘要、电子签名原理,详解冒泡、快排、归并等排序算法的实现与优化,并结合实际场景讲解正则匹配与二分查找的应用,内容全面,适合技术学习与面试准备。
 第二章 基础算法
|
1天前
|
Dubbo Java 应用服务中间件
2.搭建dubbo-zk应用
基于Spring Boot 2.2.2与Dubbo 2.0.0,构建ZooKeeper注册中心的分布式服务架构,实现Provider与Consumer模块间高效RPC通信,附完整项目结构及配置示例。
|
2天前
|
NoSQL Java 数据库连接
第七章 SpringBoot框架
SpringBoot简化了Spring开发,核心功能包括starter起步依赖、自动配置和内嵌服务器支持。通过条件注解实现Bean的自动化加载,支持自定义starter,并提供多种外部配置方式,提升开发效率与项目可维护性。(238字)
|
1天前
|
存储 安全 网络协议
第三章 web阶段
HTTP协议是超文本传输协议,基于TCP实现,规定了客户端与服务器间的数据通信规则。常见请求方式有GET和POST,前者用于获取数据,后者用于提交数据。HTTPS在HTTP基础上通过SSL加密提升安全性。常见状态码如200(成功)、404(未找到)、500(服务器错误)等。转发是服务器内部跳转,重定向则由浏览器发起新请求。Cookie和Session用于会话跟踪,前者存于客户端,后者依赖服务器存储,底层仍借助Cookie传递ID。
|
1天前
|
数据可视化 Java 关系型数据库
01-认识Activiti
工作流指具有审批流程的业务(如请假、报销等),通过流程引擎实现可视化管理。它支持单/多节点审批,广泛应用于CRM、TMS、WMS等系统。主流技术包括BPMN、Activiti、Flowable等,推动了泛微、金蝶、用友等企业的发展。
|
1天前
|
SQL 数据库连接 数据库
03-Activity代码实现
本文介绍了基于Activiti工作流引擎的入门实践,涵盖BPMN流程创建、部署、启动实例、任务查询与完成等核心操作。通过代码示例演示了流程定义部署、运行时实例管理及任务处理全过程,并结合数据库表变化说明执行效果,帮助开发者快速掌握工作流基本开发流程。
 03-Activity代码实现
|
1天前
|
Java Maven 数据库
02-Activiti工程搭建
本教程介绍如何在Idea中创建Maven工程并安装ActiBPM插件,包含插件下载、版本兼容性修复、手动修改JAR配置及验证安装等步骤,同时引入Activiti相关依赖,完成Spring Boot项目集成流程引擎的初步搭建。
02-Activiti工程搭建
|
1天前
|
监控 Java 测试技术
OOM排查之路:一次曲折的线上故障复盘
本文记录了一次Paimon数据湖与RocksDB集成服务中反复出现的内存溢出(OOM)问题排查全过程。通过MAT、NMT、async-profiler等工具,结合监控分析与专家协作,最终定位到RocksDB通过JNI申请的堆外内存未释放是根因,并分享了转向Flink写入Paimon的解决方案及排查思路,为类似技术栈提供借鉴。(239字)
|
1天前
|
缓存
QLExpress使用及源码分析
QLExpress是阿里巴巴开源的轻量级规则引擎,支持通过注解与YAML配置实现业务逻辑与代码解耦。提供AST语法树解析、上下文构建及高效执行机制,适用于动态规则场景。GitHub地址:https://github.com/alibaba/QLExpress
|
1天前
|
Java
HUTOOL-Word生成-Word07Writer
Hutool封装POI实现Word(docx)生成,提供Word07Writer类,支持字体、段落添加,简化文档创建。需引入hutool-all与poi-ooxml依赖,适用于Java环境下的简单Word操作。