自己动手造轮子:如何创建JAR并通过Maven在Spring Boot中引用
让代码复用变得简单优雅——3分钟学会封装专属工具库
作为Java开发者,你是否遇到过这些痛点?
多个项目重复编写相同工具类
工具代码分散难以统一维护
团队协作缺乏标准化工具库
本文将手把手教你创建自己的JAR包,并优雅地集成到Spring Boot项目中,从此告别CV大法!
一、5分钟创建你的专属JAR
第一步:初始化Maven项目
1.File》New》Project
选择java
1. 语义化版本控制
在pom.xml
中采用标准版本格式:
<!-- pom.xml -->
<project><groupId>com.dafu</groupId><artifactId>my-utils</artifactId><version>1.0.0</version> <!-- 主版本.次版本.修订号 --><properties><java.version>1.8</java.version><maven.compiler.source>${java.version}</maven.compiler.source><maven.compiler.target>${java.version}</maven.compiler.target></properties>
</project>
第二步:编写核心工具类
创建文件:src/main/java/com/dafu/utils/StringUtils.java
package com.dafu.utils;/*** @author:DaFu* @date: 2025/7/24 11:17*/
public class StringUtils {// 首字母大写转换public static String capitalize(String str) {if (str == null || str.isEmpty()) {return str;}return str.substring(0, 1).toUpperCase() + str.substring(1);}// 生成随机字符串public static String randomString(int length) {String chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";StringBuilder sb = new StringBuilder();for (int i = 0; i < length; i++) {sb.append(chars.charAt((int) (Math.random() * chars.length())));}return sb.toString();}public static String toUpperCase(String input) {return input != null ? input.toUpperCase() : "";}}
第三步:打包并安装到本地仓库
3.1命令打包
# 进入项目目录
cd my-utils# 打包并安装到本地Maven仓库
mvn clean install
3.2在 IDE 中安装(IntelliJ IDEA 示例)
打开右侧 Maven 工具窗口
展开你的自定义项目
双击执行 Lifecycle →
clean
双击执行 Lifecycle →
install
控制台看到如下输出即表示成功:
[INFO] --- install:3.1.2:install (default-install) @ my-utils ---
[INFO] Installing D:\我的文件\专属JAR\my-utils\pom.xml to C:\Users\Administrator\.m2\repository\com\dafu\my-utils\1.0.0\my-utils-1.0.0.pom
[INFO] Installing D:\我的文件\专属JAR\my-utils\target\my-utils-1.0.0.jar to C:\Users\Administrator\.m2\repository\com\dafu\my-utils\1.0.0\my-utils-1.0.0.jar
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 0.874 s
[INFO] Finished at: 2025-07-24T11:36:39+08:00
[INFO] ------------------------------------------------------------------------
安装后的文件位置:
安装后的文件会出现在以下路径:
~/.m2/repository/你的groupId/你的artifactId/版本号/
例如:
~/.m2/repository/com/dafu/my-utils/1.0.0/
├── my-utils-1.0.0.jar
├── my-utils-1.0.0.pom
└── 其他元数据文件
验证安装是否成功:
检查本地仓库:
# Linux/macOS ls ~/.m2/repository/com/dafu/my-utils/1.0.0# Windows dir %USERPROFILE%\.m2\repository\com\dafu\my-utils\1.0.0
二、Spring Boot项目中的优雅集成
第一步:添加依赖到pom.xml
<!--引用自定义 my-utils JAR --><dependency><groupId>com.dafu</groupId><artifactId>my-utils</artifactId><version>1.0.0</version></dependency>
引用自定义 my-utils JAR 刷新Maven
第二步:在Spring Boot中调用工具类
创建测试: src/test/java/com/dafu/springboottest/SpringBootTestApplicationTests.java
四、常见问题排雷指南
问题1:依赖找不到(ClassNotFound)
✅ 解决方案:
# 1. 检查本地仓库是否存在该JAR
ls ~/.m2/repository/com/dafu/my-utils# 2. 强制更新依赖
mvn clean install -U
五、为什么值得封装自己的JAR?
代码复用率提升:一次封装,终身受益
统一技术栈:团队共享标准化工具库
持续演进能力:独立更新不影响主项目
专业度提升:展现架构设计能力
优秀的开发者不仅是工具的使用者,更是工具的创造者。