[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


相关文章
|
7月前
|
监控 Java 测试技术
OOM排查之路:一次曲折的线上故障复盘
本文记录了一次Paimon数据湖与RocksDB集成服务中反复出现的内存溢出(OOM)问题排查全过程。通过MAT、NMT、async-profiler等工具,结合监控分析与专家协作,最终定位到RocksDB通过JNI申请的堆外内存未释放是根因,并分享了转向Flink写入Paimon的解决方案及排查思路,为类似技术栈提供借鉴。(239字)
|
7月前
|
存储 缓存 运维
一场FullGC故障排查
本文记录了一次由Full GC引发的CPU使用率飙升至104%的问题排查过程。通过分析JVM堆内存,发现大对象(List<Map>)导致老年代频繁被占满,进而触发Full GC。利用JProfiler定位到问题根源:Excel数据以低效结构加载至内存且长期驻留,造成内存膨胀。最终提出“治本”与“治标”两类解决方案,并总结了线上高CPU问题的排查思路与经验。
 一场FullGC故障排查
|
7月前
|
负载均衡 算法 Java
5-微服务篇
本文详解SpringBoot自动装配原理、启动流程、核心注解@SpringBootApplication组成,以及SpringCloud微服务中注册发现、负载均衡、限流熔断等机制,涵盖常用组件如Nacos、Ribbon、Feign、Sentinel及Gateway的使用与配置,适用于面试与实战。
|
7月前
|
缓存 安全 Java
第五章 Spring框架
Spring的IOC(控制反转)指将对象创建交给容器管理,DI(依赖注入)则实现对象间的依赖关系自动注入。Bean默认单例非线程安全,作用域可设为singleton、prototype等,通过@Scope注解配置。Bean生命周期包括实例化、初始化、销毁等阶段,循环依赖通过三级缓存解决,但构造函数循环依赖需@Lazy解决。AOP基于动态代理实现日志、事务等横切关注点,事务通过@Transactional注解管理,支持传播行为如REQUIRED、REQUIRES_NEW。常用注解涵盖声明、注入、配置及AOP等方面。
|
7月前
|
存储 SQL 关系型数据库
3-MySQL篇
本文系统梳理MySQL核心知识点,涵盖查询语句的书写与执行顺序、多表连接方式、索引类型及底层结构(B+树)、聚簇与非聚簇索引区别、回表查询与覆盖索引优化、最左前缀原则、索引失效场景、SQL性能分析(EXPLAIN)及慢查询定位等,助力高效数据库开发与调优。
|
7月前
|
存储 缓存 安全
1-Java基础篇
本文系统讲解Java核心知识,涵盖final关键字、重载与重写、==与equals区别、反射机制、String类对比、集合框架、线程安全类、HashMap原理、ConcurrentHashMap实现、线程池使用与参数配置、JVM组成及运行时数据区、类加载器与双亲委派模型等,结合项目实践解析技术应用。
|
7月前
|
NoSQL Java 数据库连接
第七章 SpringBoot框架
SpringBoot简化了Spring开发,核心功能包括starter起步依赖、自动配置和内嵌服务器支持。通过条件注解实现Bean的自动化加载,支持自定义starter,并提供多种外部配置方式,提升开发效率与项目可维护性。(238字)
|
7月前
|
安全 算法 Java
第一章 Java基础
本文系统讲解Java核心知识,涵盖基础语法、面向对象、集合类、异常处理、IO流、多线程并发、JVM原理、反射泛型、Lambda表达式及Tomcat优化等内容,结合代码示例与底层机制分析,助力深入理解Java编程与面试要点。
|
7月前
|
消息中间件 运维 物联网
语音通知
适用于科技公司服务器及物联网设备异常时的语音告警通知。开通语音服务后,可申请资质、话术与模板,通过API调用实现自动外呼,支持变量替换与实时结果查询,提升运维响应效率。(238字)
|
7月前
|
Java 开发工具 数据安全/隐私保护
项目《中州养老》
《中州养老》是一个为养老院打造的单体后台管理系统,涵盖预约、入住、健康监测等核心功能,包含员工管理端与家属小程序端。项目采用SpringBoot+Vue3技术栈,集成Redis缓存、阿里云IoT及OSS存储,实现护理等级、床位管理、智能设备监测等模块,并通过RBAC权限控制、定时任务与WebSocket报警推送,提升系统安全性与实时性。
 项目《中州养老》

热门文章

最新文章