如何将外部Jar包加载到可执行的Jar包或War包中

柔光的暖阳◎ 2022-09-11 10:21 855阅读 0赞

> 版权声明：本文为 小异常 原创文章，非商用自由转载-保持署名-注明出处，谢谢！  
> 本文网址：[https://sunkuan.blog.csdn.net/article/details/120317668][https_sunkuan.blog.csdn.net_article_details_120317668]

### 文章目录 ###

*  一、准备工作
 *   *  1、外部 Jar 包
     *   *  1）第一个外部Jar包
         *  2）第二个外部Jar包
         *  3）目录结构
         *  4）打成 Jar 包
     *  2、可执行的 War 包
     *   *  1）控制器
         *  2）Pom.xml
         *  3）目录结构
         *  4）打成War包
     *  3、可执行的 Jar 包
     *   *  1）Main方法
         *  2）Pom.xml
         *  3）目录结构
         *  4）打成Jar包
 *  二、两种启动方式
 *   *  1、War 包启动方式（Tomcat 启动）
     *  2、Jar 包启动方式（\`java -jar\` 启动）
 *  三、jar 命令参数说明
 *  四、测试代码

> 有这么一个项目场景，项目中有一个模块的 Jar 包是由甲方提供的，而这个 Jar 包日后还可能会更新它。甲方想要的效果是将来他可以自己手动替换这个 Jar，不想经过我们重新编译。  
> 　  
> 一般情况下，我们都会把这个 Jar 包同我们的项目打包在一起，如果这个 Jar 包发生改变，就需要重新编译打包。显然甲方是想跳过我们，更不会同意这样做。  
> 　  
> 商务上妥协了这个需求，所以为了解决这个问题，我是这样想的，在打包编译的时候，如果不将这个 Jar 包和我们的项目打包在一起，而在运行的时候指定这个外部 Jar 包的运行路径是否可以解决这个问题？也就是说将来这个 Jar 包发生了改变，只需要重新启动一下项目就可以了。  
> 　  
> 于是我就开始了我的大胆假设，顺着这个假设进行小心求证，我们还需要考虑到项目的启动方式，一般情况下项目会打成可执行的 Jar 包或 War 包。  
> 　  
> 我习惯的实践方式是这样的，先用一个 Demo 进行实践，如果 Demo 可以测试成功，那就说明这个想法没问题，我就可以把 Demo 中的相关代码嵌入到项目中。

--------------------

# 一、准备工作 #

> 需要先准备两个不同的外部 Jar 包，再准备一个可执行的 Jar 包和 一个 War 包。

## 1、外部 Jar 包 ##

> 我们要准备两个外部 Jar 包，可以写的简单一些，比如只写一个类一个方法，然后在方法中随便打印一句话。

### 1）第一个外部Jar包 ###

public class NumUtil {
        
    	public static void num() {
        
    		System.out.println(123);
    	}
    }

### 2）第二个外部Jar包 ###

public class NumUtil {
        
    	public static void num() {
        
    		System.out.println(456);
    	}
    }

### 3）目录结构 ###

![目录结构][9209c652ce684cc8b9c5b45912478c03.png_pic_center]

### 4）打成 Jar 包 ###

![导出Jar1][Jar1]

![导出Jar2][Jar2]

![导出Jar3][Jar3]

> 然后一直点 Next，直到完成。

![打包完成][2bc4520a37dc40e3888e8d2cf3377048.png_pic_center]

## 2、可执行的 War 包 ##

> 随便写一个控制器，控制器里调用刚才外部 Jar 包中写好的方法，然后打成 War 包，记住不要包含外部 Jar 包依赖。

### 1）控制器 ###

@Controller
    public class MyController {
        
    
    	@RequestMapping("/hello")
    	public void test() {
        
    		NumUtil.num();
    	}
    	
    }

### 2）Pom.xml ###

<?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    	<modelVersion>4.0.0</modelVersion>
    	<parent>
    		<groupId>org.springframework.boot</groupId>
    		<artifactId>spring-boot-starter-parent</artifactId>
    		<version>2.5.4</version>
    		<relativePath/> 
    	</parent>
    	
    	<groupId>com.demo</groupId>
    	<artifactId>NumberDemoWeb</artifactId>
    	<version>0.0.1-SNAPSHOT</version>
    	
    	<packaging>war</packaging>
    	<name>NumberDemoWeb</name>
    	<description>Demo project for Spring Boot</description>
    	
    	<properties>
    		<java.version>1.8</java.version>
    	</properties>
    	
    	<dependencies>
    		<dependency>
    			<groupId>org.springframework.boot</groupId>
    			<artifactId>spring-boot-starter-web</artifactId>
    		</dependency>
    
    		<dependency>
    			<groupId>org.springframework.boot</groupId>
    			<artifactId>spring-boot-starter-tomcat</artifactId>
    			<scope>provided</scope>
    		</dependency>
    		
    		
    		<dependency>
    			<groupId>com.demo</groupId>
    			<artifactId>Number</artifactId>
    			<version>0.0.1</version>
    			<scope>system</scope>
    			<systemPath>F:\1\Number.jar</systemPath>
    		</dependency>
    	</dependencies>
    
    	<build>
    		<finalName>number</finalName>
    		<plugins>
    			<plugin>
    				<groupId>org.springframework.boot</groupId>
    				<artifactId>spring-boot-maven-plugin</artifactId>
    			</plugin>
    			<plugin>
    				<groupId>org.springframework.boot</groupId>
    				<artifactId>spring-boot-maven-plugin</artifactId>
    				<configuration>
    					
    					<includeSystemScope>false</includeSystemScope>
    				</configuration>
    				<executions>
    					<execution>
    						<goals>
    							<goal>repackage</goal>
    						</goals>
    					</execution>
    				</executions>
    			</plugin>
    		</plugins>
    	</build>
    
    </project>

### 3）目录结构 ###

![目录结构2][2]

### 4）打成War包 ###

![打包完成2][2 1]

## 3、可执行的 Jar 包 ##

> 我们实现一个 Main 方法，调用外部 Jar 包中写好的方法，然后打成 Jar 包，记住这个要包含外部 Jar 包。

### 1）Main方法 ###

@SpringBootApplication
    public class NumberDemoApplication {
        
    
    	public static void main(String[] args) {
        
    		SpringApplication.run(NumberDemoApplication.class, args);
    		NumUtil.num();
    	}
    
    }

### 2）Pom.xml ###

<?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    	<modelVersion>4.0.0</modelVersion>
    	<parent>
    		<groupId>org.springframework.boot</groupId>
    		<artifactId>spring-boot-starter-parent</artifactId>
    		<version>2.5.4</version>
    		<relativePath/> 
    	</parent>
    	
    	<groupId>com.demo</groupId>
    	<artifactId>NumberDemo</artifactId>
    	<version>0.0.1-SNAPSHOT</version>
    	
    	<name>NumberDemo</name>
    	<description>Demo project for Spring Boot</description>
    	
    	<properties>
    		<java.version>1.8</java.version>
    	</properties>
    	
    	<dependencies>
    		<dependency>
    			<groupId>org.springframework.boot</groupId>
    			<artifactId>spring-boot-starter-web</artifactId>
    		</dependency>
    		
    		<dependency>
    		    <groupId>org.springframework.boot</groupId>
    		    <artifactId>spring-boot-starter-tomcat</artifactId>
    		    <scope>provided</scope>
    		</dependency>
    		
    		
    		<dependency>
    			<groupId>com.demo</groupId>
    			<artifactId>Number</artifactId>
    			<version>0.0.1</version>
    			<scope>system</scope>
    			<systemPath>F:\1\Number.jar</systemPath>
    		</dependency>
    	</dependencies>
    
    	<build>
    		<plugins>
    			<plugin>
    				<groupId>org.springframework.boot</groupId>
    				<artifactId>spring-boot-maven-plugin</artifactId>
    			</plugin>
    			<plugin>
    				<groupId>org.springframework.boot</groupId>
    				<artifactId>spring-boot-maven-plugin</artifactId>
    				<configuration>
    					
    					<includeSystemScope>true</includeSystemScope>
    				</configuration>
    				<executions>
    					<execution>
    						<goals>
    							<goal>repackage</goal>
    						</goals>
    					</execution>
    				</executions>
    			</plugin>
    		</plugins>
    	</build>
    
    </project>

### 3）目录结构 ###

![目录结构3][3]

### 4）打成Jar包 ###

![打包完成3][3 1]

--------------------

# 二、两种启动方式 #

## 1、War 包启动方式（Tomcat 启动） ##

> 这种方式依赖于 Tomcat 启动，这种方式其实很简单，只需要将外部 Jar 包放到 Tomcat 或项目的 `WEB-INF/lib` 目录中即可，最后重新启动 Tomcat。

## 2、Jar 包启动方式（`java -jar` 启动） ##

> 这种方式不如 War 包方式简单，我们需要将可执行 Jar 包中的 `BOOT-INF` 目录解压出来，然后替换该目录下 `lib` 目录中的外部 Jar 包，然后使用命令：`jar -uf0 XXX.jar BOOT-INF/lib/`，最后重新启动这个可执行 Jar 包。

![替换Jar][Jar]

![执行命令][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5bCP5byC5bi4_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center]

> 细心的小伙伴可能发现了，我画绿框的地方报错了，这是因为我在执行这条命令的时候正在打开 Jar 压缩包，所以没有写入成功。

--------------------

# 三、jar 命令参数说明 #

![jar命令][jar]

> 看到上面的参数选项; 我们决定使用 `-uf0` 来操作。
> 
>  *  `u`：更新现有的档案；
>  *  `f`：指定档案文件名；
>  *  `0`：仅存储；不适用任何 ZIP 压缩。

--------------------

# 四、测试代码 #

为了方便大家测试，我将本文中使用的 Demo 程序提供给大家。

下载链接：[https://download.csdn.net/download/sun8112133/23160424][https_download.csdn.net_download_sun8112133_23160424]

*博客中若有不恰当的地方，请您一定要告诉我。前路崎岖，望我们可以互相帮助，并肩前行！*

[https_sunkuan.blog.csdn.net_article_details_120317668]: https://sunkuan.blog.csdn.net/article/details/120317668
[9209c652ce684cc8b9c5b45912478c03.png_pic_center]: /images/20220828/93b529aad6e14259bb6a18e3c6d807b8.png
[Jar1]: /images/20220828/53f99475caa748fca25f863e95d0ab92.png
[Jar2]: /images/20220828/45896ee787994845bb652b6de789ab47.png
[Jar3]: /images/20220828/c92ae21ff7f940adace12c94660fd7ae.png
[2bc4520a37dc40e3888e8d2cf3377048.png_pic_center]: /images/20220828/e4471c61bef741128108882e393354b7.png
[2]: /images/20220828/b947ec73c7564aab845ac6ca8e30b730.png
[2 1]: /images/20220828/e53a719e19044014bf3ae1de284e52ac.png
[3]: /images/20220828/a4e2718a07a84b66b9ad4a3e366e6973.png
[3 1]: /images/20220828/9127685687e84c1b886276cd1fd3e9b0.png
[Jar]: /images/20220828/e5bcaa300c1a4e42aa6225c6d6bcd475.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5bCP5byC5bi4_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center]: /images/20220828/f2887531f8c04a5494da6187cc77baaf.png
[jar]: /images/20220828/77bbc44082964fbca9378fc177f4024a.png
[https_download.csdn.net_download_sun8112133_23160424]: https://download.csdn.net/download/sun8112133/23160424