尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
项目规范化:工具类、封装、代码生成
项目规范化工具类、封装、代码生成一个人写项目像写日记——自己能看懂就行团队协作像写公文——格式不统一就乱套。项目规范化不是为了好看是为了让你三个月后回来还能看懂自己写的什么。一、项目规范化的意义可维护性代码结构清晰定位问题快修改影响范围可控团队协作效率新人接手项目不需要猜约定看目录结构就知道代码在哪减少低级错误统一封装减少重复代码魔法值用枚举代替减少手写出错代码审查效率规范统一的代码风格Review时聚焦业务逻辑而非格式问题规范化不是写一堆文档约束人而是通过工程手段让规范自动落地。二、项目分层规范经典的三层架构分层每层职责明确src/main/java/com/example/ ├── controller/ # 控制层接收请求、参数校验、返回结果 ├── service/ # 业务层业务逻辑编排 │ └── impl/ ├── mapper/ # 持久层数据库操作MyBatis接口 ├── entity/ # 实体类与数据库表对应 ├── dto/ # 数据传输对象接口入参出参 │ ├── request/ # 请求DTO │ └── response/ # 响应DTO ├── vo/ # 视图对象返回给前端的对象 ├── utils/ # 工具类 ├── config/ # 配置类 ├── exception/ # 自定义异常 ├── enums/ # 枚举类 └── constant/ # 常量类分层依赖方向Controller → Service → Mapper禁止跨层调用Controller不能直接调Mapper禁止反向依赖Entity不能依赖DTO。三、命名规范类型规范示例类名大驼峰UserController, OrderService方法名小驼峰getUserById, createOrder变量名小驼峰userName, orderList常量名全大写下划线MAX_RETRY_COUNT, DEFAULT_PAGE_SIZE包名全小写com.example.controller数据库表名小写下划线t_user, t_order_detail接口名不加I前缀UserService非IUserService实现类名接口名ImplUserServiceImpl四、统一返回封装所有接口返回统一结构前端只需按固定格式解析。4.1 Result封装DataSchema(description统一返回结构)publicclassResultT{privateIntegercode;privateStringmessage;privateTdata;privateResult(Integercode,Stringmessage,Tdata){this.codecode;this.messagemessage;this.datadata;}publicstaticTResultTsuccess(Tdata){returnnewResult(200,操作成功,data);}publicstaticTResultTsuccess(){returnnewResult(200,操作成功,null);}publicstaticTResultTfail(Stringmessage){returnnewResult(500,message,null);}publicstaticTResultTfail(Integercode,Stringmessage){returnnewResult(code,message,null);}}4.2 分页结果封装DataAllArgsConstructorpublicclassPageResultT{privateListTlist;// 数据列表privateLongtotal;// 总记录数privateIntegerpageNum;// 当前页码privateIntegerpageSize;// 每页条数privateIntegertotalPages;// 总页数publicstaticTPageResultTof(ListTlist,Longtotal,IntegerpageNum,IntegerpageSize){inttotalPages(int)Math.ceil((double)total/pageSize);returnnewPageResult(list,total,pageNum,pageSize,totalPages);}}五、基础实体封装数据库表通常都有公共字段创建时间、更新时间等抽取BaseEntity避免每个实体重复定义。DatapublicclassBaseEntity{TableId(typeIdType.ASSIGN_ID)// 雪花算法生成IDprivateLongid;TableField(fillFieldFill.INSERT)// 插入时自动填充privateLocalDateTimecreateTime;TableField(fillFieldFill.INSERT_UPDATE)// 插入和更新时自动填充privateLocalDateTimeupdateTime;TableField(fillFieldFill.INSERT)privateLongcreateBy;TableField(fillFieldFill.INSERT_UPDATE)privateLongupdateBy;TableLogic// 逻辑删除标记TableField(fillFieldFill.INSERT)privateIntegerdeleted;}MyBatis-Plus自动填充处理器ComponentpublicclassMyMetaObjectHandlerimplementsMetaObjectHandler{OverridepublicvoidinsertFill(MetaObjectmetaObject){this.strictInsertFill(metaObject,createTime,LocalDateTime.class,LocalDateTime.now());this.strictInsertFill(metaObject,updateTime,LocalDateTime.class,LocalDateTime.now());this.strictInsertFill(metaObject,deleted,Integer.class,0);// 当前登录用户ID从ThreadLocal/SecurityContext获取LonguserIdSecurityUtils.getCurrentUserId();this.strictInsertFill(metaObject,createBy,Long.class,userId);this.strictInsertFill(metaObject,updateBy,Long.class,userId);}OverridepublicvoidupdateFill(MetaObjectmetaObject){this.strictUpdateFill(metaObject,updateTime,LocalDateTime.class,LocalDateTime.now());this.strictUpdateFill(metaObject,updateBy,Long.class,SecurityUtils.getCurrentUserId());}}实体类继承BaseEntity即可自动获得这些公共字段DataEqualsAndHashCode(callSupertrue)TableName(t_user)publicclassUserextendsBaseEntity{privateStringusername;privateStringpassword;privateStringemail;privateIntegerstatus;}六、枚举规范代码里到处写012这种魔法值过两个月谁也不记得1是启用还是禁用。用枚举替代。GetterAllArgsConstructorpublicenumUserStatusEnum{DISABLED(0,禁用),ENABLED(1,启用),LOCKED(2,锁定);privatefinalIntegercode;privatefinalStringdesc;publicstaticUserStatusEnumgetByCode(Integercode){for(UserStatusEnume:values()){if(e.getCode().equals(code)){returne;}}thrownewIllegalArgumentException(无效的状态码: code);}}// 反面教材魔法值if(user.getStatus()1){...}// 正面示范枚举if(UserStatusEnum.ENABLED.getCode().equals(user.getStatus())){...}常用枚举场景状态码、性别、订单状态、支付方式、用户角色等。七、工具类封装7.1 自定义工具类publicclassRegexUtils{privatestaticfinalPatternPHONE_PATTERNPattern.compile(^1[3-9]\\d{9}$);privatestaticfinalPatternEMAIL_PATTERNPattern.compile(^[A-Za-z0-9_.-][A-Za-z0-9.-]$);publicstaticbooleanisPhone(Stringphone){returnphone!nullPHONE_PATTERN.matcher(phone).matches();}publicstaticbooleanisEmail(Stringemail){returnemail!nullEMAIL_PATTERN.matcher(email).matches();}}7.2 Hutool工具库推荐自己写工具类容易遗漏边界场景推荐使用Hutool——国内最流行的Java工具库500工具方法覆盖绝大多数场景。dependencygroupIdcn.hutool/groupIdartifactIdhutool-all/artifactIdversion5.8.25/version/dependency// 字符串工具StrUtil.isBlank(str);// 判空StrUtil.format(用户{}已存在,name);// 格式化// 日期工具DateUtil.now();// 当前时间字符串DateUtil.formatDateTime(date);// 格式化日期// 加密工具SecureUtil.md5(password);// MD5加密SecureUtil.sha256(password);// SHA256加密// ID生成IdUtil.getSnowflakeNextId();// 雪花算法ID// HTTP客户端HttpUtil.get(https://api.example.com/data);HttpUtil.post(url,body);// JSON处理JSONUtil.toJsonStr(obj);JSONUtil.parseObj(json).getStr(key);Hutool一个库顶你自己写几十个工具类而且经过大量生产验证比手写更可靠。八、代码生成MyBatisX手动写Entity/Mapper/Service/Controller四件套既枯燥又容易出错。MyBatisX是IDEA插件连接数据库后一键生成整套代码。使用流程IDEA安装MyBatisX插件连接数据库Database面板右键表 → MyBatisX-Generator配置生成选项module选择当前项目模块packagecom.exampleentity勾选继承BaseEntitymapper勾选生成Mapper接口service勾选生成Service接口Implcontroller勾选生成基础CRUD接口点击Generate一键生成生成后只需补充业务逻辑省去80%的重复劳动。九、代码规范检查阿里巴巴Java开发规约插件IDEA安装Alibaba Java Coding Guidelines插件编码时实时检查规范问题命名不规范空指针风险线程安全问题魔法值未提取常量集合未指定初始容量!-- Checkstyle静态检查CI集成 --plugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-checkstyle-plugin/artifactIdversion3.3.0/versionconfigurationconfigLocationcheckstyle-alibaba.xml/configLocation/configuration/plugin十、完整规范化项目结构com.example.shop/ ├── ShopApplication.java ├── config/ │ ├── Knife4jConfig.java │ ├── MyBatisPlusConfig.java │ ├── RedisConfig.java │ └── WebMvcConfig.java ├── common/ │ ├── result/ │ │ ├── Result.java │ │ └── PageResult.java │ ├── entity/ │ │ └── BaseEntity.java │ ├── exception/ │ │ ├── BusinessException.java │ │ └── GlobalExceptionHandler.java │ ├── enums/ │ │ ├── UserStatusEnum.java │ │ └── OrderStatusEnum.java │ └── constant/ │ └── RedisConstant.java ├── controller/ │ ├── user/ │ │ └── UserController.java │ └── order/ │ └── OrderController.java ├── service/ │ ├── user/ │ │ ├── UserService.java │ │ └── impl/UserServiceImpl.java │ └── order/ │ ├── OrderService.java │ └── impl/OrderServiceImpl.java ├── mapper/ │ ├── UserMapper.java │ └── OrderMapper.java ├── entity/ │ ├── User.java │ └── Order.java ├── dto/ │ ├── request/ │ │ ├── UserLoginDTO.java │ │ └── OrderCreateDTO.java │ └── response/ │ ├── UserVO.java │ └── OrderVO.java └── utils/ ├── RegexUtils.java └── SecurityUtils.java项目规范化不是一蹴而就的是在开发过程中逐步沉淀的。前期花时间搭好骨架后期团队所有人都能受益——写代码时有章可循改代码时有迹可循这才是规范化的真正价值。
RELATED

相关推荐

服务监控:Actuator + Prometheus + Grafana

服务监控:Actuator + Prometheus + Grafana

服务监控:Actuator Prometheus Grafana线上服务就像一辆行驶中的汽车——没有仪表盘你不知道油量、不知道速度、不知道发动机温度,等真抛锚了才发现问题,那就晚了。一、为什么需要监控 线上服务跑着跑着突然卡了、内存满了、响应慢了——如…

📅 2026/9/27 11:45:55
SAP财务核心技能:FAGLB03科目余额查询深度解析与实战指南

SAP财务核心技能:FAGLB03科目余额查询深度解析与实战指南

1. 项目概述:为什么科目余额查询是SAP财务的“定盘星”?干了十几年SAP财务顾问,我见过太多刚入行的朋友,一上来就急着学复杂的凭证过账、月结流程,结果在第一个月结日就卡壳了。老板问“这个月利润多少?”&…

📅 2026/10/19 23:00:06
第48讲:RTOS任务Spec——优先级、堆栈大小、阻塞逻辑、互斥规则

第48讲:RTOS任务Spec——优先级、堆栈大小、阻塞逻辑、互斥规则

CSDN专栏: 嵌入式程序开发实战嵌入式双范式AI编程嵌入式开发必掌握嵌入式求职面试技术资料 第48讲:RTOS任务Spec——优先级、堆栈大小、阻塞逻辑、互斥规则 一、RTOS任务Spec的重要性 RTOS任务是嵌入式多任务系统的核心,必须严格规范&…

📅 2026/11/13 4:31:42
MORE NEWS

更多资讯

📰

充电站需要电工证吗官方回应来了,外省证书怎么转过来

充电站需要电工证吗官方回应来了,外省证书怎么转过来 之前考的证在外省能不能转过来?这事儿其实很多人都关心,特别是那些已经拿到特种作业操作证,但换城市工作或换行业发展的朋友。 官方回应…

📰

电工证收证通过率揭秘:实操考试心里没底怕挂科?手把手教你搞定

电工证收证通过率揭秘:实操考试心里没底怕挂科?手把手教你搞定 实操考试心里没底怕挂科?特别是第一次报考电工证的你,面对高压电、接线板、绝缘工具这些专业设备,心里肯定打鼓。别急,本文以郑州初次报考人员的视角,结合河南省安全生产监督管理局的官方…

📰

嘉兴考电工证价格表全国通用怎么复审?电工证过期了怎么办?

嘉兴考电工证价格表全国通用怎么复审?电工证过期了怎么办? 证书过期了不知道怎么复审延期,这个问题在电工行业非常常见,尤其是像商丘这样的工程类毕业生,刚入行不久就可能遇到证书过期、复审流程不熟悉等现实问题。你可能会发现,有些电工证明明是全国通…

📰

河北区电工证怎样考取真实经历分享:新乡人考电工证全流程揭秘

河北区电工证怎样考取真实经历分享:新乡人考电工证全流程揭秘 我就是去年在新乡考电工证的,当时也是手忙脚乱,差点因为资料不全耽误了入职。现在回想起来,很多人和我一样, 急需特种作业证才能上岗找工作 ,但又对流程一知半解,导致跑了不少冤枉路。…

📰

黑河建筑电工证在哪办与通过率揭秘:证书过期了不知道怎么复审延期怎么办?

黑河建筑电工证在哪办与通过率揭秘:证书过期了不知道怎么复审延期怎么办? 证书过期了不知道怎么复审延期,这种事真的会让人慌了神。你不是不想考证,而是怕考证后又因为各种原因过期,耽误工作进度。特别是黑河建筑电工证在哪办,很多人连报考流程都不清楚…

📰

电工证上岗证年审复审别被中介坑 一文教你官方报名入口

电工证上岗证年审复审别被中介坑 一文教你官方报名入口 你是不是也这样,想给电工证年审复审,却不知道去哪里报?怕被中介骗钱?别急,这篇文章就是为你准备的。我来告诉你, 官方报名入口 到底在哪,怎么避开那些坑,还能顺利把证续上。…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬