現(xiàn)在基本上都是采用maven來進(jìn)行開發(fā)管理，我有一個(gè)需求是需要把通過maven管理的java工程打成可執(zhí)行的jar包，這樣也就是說必需把工程依賴的jar包也一起打包。而使用maven默認(rèn)的package命令構(gòu)建的jar包中只包括了工程自身的class文件，并沒有包括依賴的jar包。我們可以通過配置插件來對(duì)工程進(jìn)行打包，pom具體配置如下：

maven-assembly-plugin

<plugin> 
  <artifactId>maven-assembly-plugin</artifactId> 
  <configuration> 
    <appendAssemblyId>false</appendAssemblyId> 
    <descriptorRefs> 
      <descriptorRef>jar-with-dependencies</descriptorRef> 
    </descriptorRefs> 
    <archive> 
      <manifest>         <mainClass>com.chenzhou.examples.Main</mainClass> 
      </manifest> 
    </archive> 
  </configuration> 
  <executions> 
    <execution> 
      <id>make-assembly</id> 
      <phase>package</phase> 
      <goals> 
        <goal>assembly</goal> 
      </goals> 
    </execution> 
  </executions> 
</plugin> 

其中<mainClass></mainClass>的值表示此工程的入口類，也就是包含main方法的類，在我的例子中就是com.chenzhou.examples.Main。配置完pom后可以通過執(zhí)行mvn assembly:assembly命令來啟動(dòng)插件進(jìn)行構(gòu)建。構(gòu)建成功后會(huì)生成jar包，這樣我們就可以在命令行中通過java -jar XXX.jar來運(yùn)行jar件了。

不過使用此插件會(huì)有一些問題：我在工程中依賴了spring框架的jar包，我打包成功后使用命令來調(diào)用jar包時(shí)報(bào)錯(cuò)如下（內(nèi)網(wǎng)環(huán)境）：

org.xml.sax.SAXParseException: schema_reference.4: Failed to read schema document 'http://www.springframework.org/schema/beans/spring-beans-3.0.xsd', because 1) could not find the document; 2) the document could not be read; 3) the root element of the document is not <xsd:schema>. 

關(guān)于此問題報(bào)錯(cuò)的原因，我在網(wǎng)上找到一篇文章對(duì)此有比較詳細(xì)的解釋：http://www.dbjr.com.cn/article/168072.htm 簡(jiǎn)單來說就是spring在啟動(dòng)時(shí)會(huì)加載xsd文件，它首先會(huì)到本地查找xsd文件（一般都會(huì)包含在spring的jar包中），如果找不到則會(huì)到xml頭部定義的url指定路徑下中去尋找xsd，如果找不到則會(huì)報(bào)錯(cuò)。

附：在spring jar包下的META-INF文件夾中都會(huì)包含一個(gè)spring.schemas文件，其中就包含了對(duì)xsd文件的路徑定義，具體如下圖所示：

圖：spring-aop.jar包下META-INF文件夾下的內(nèi)容

圖：spring.schemas文件內(nèi)容

由于我的工程是在內(nèi)網(wǎng)，所以通過url路徑去尋找肯定是找不到的，但是比較奇怪的是既然spring的jar包中都會(huì)包含，那為什么還是找不到呢？

原來這是assembly插件的一個(gè)bug，具體情況參見：http://jira.codehaus.org/browse/MASSEMBLY-360

該bug產(chǎn)生的原因如下：工程一般依賴了很多的jar包，而被依賴的jar又會(huì)依賴其他的jar包，這樣，當(dāng)工程中依賴到不同的版本的spring時(shí)，在使用assembly進(jìn)行打包時(shí)，只能將某一個(gè)版本jar包下的spring.schemas文件放入最終打出的jar包里，這就有可能遺漏了一些版本的xsd的本地映射，所以會(huì)報(bào)錯(cuò)。

所以一般推薦使用另外的一個(gè)插件來進(jìn)行打包，插件名稱為：maven-shade-plugin，shade插件打包時(shí)在對(duì)spring.schemas文件處理上，它能夠?qū)⑺衘ar里的spring.schemas文件進(jìn)行合并，在最終生成的單一jar包里，spring.schemas包含了所有出現(xiàn)過的版本的集合，要使用shade插件，必須在pom進(jìn)行如下配置：

<plugin>
	<groupId>org.apache.maven.plugins</groupId>
	<artifactId>maven-shade-plugin</artifactId>
	<version>1.4</version>
	<executions>
		<execution>
			<phase>package</phase>
			<goals>
				<goal>shade</goal>
			</goals>
			<configuration>
				<transformers>
					<transformer
						implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
						<resource>META-INF/spring.handlers</resource>
					</transformer>
					<transformer
						implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
						<mainClass>com.chenzhou.examples.Main</mainClass>
					</transformer>
					<transformer>						implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
						<resource>META-INF/spring.schemas</resource>
					</transformer>
				</transformers>
			</configuration>
		</execution>
	</executions>
</plugin>

上面配置文件中有一段定義：

<transformer 
implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer"> 
  <resource>META-INF/spring.schemas</resource> 
</transformer> 

上面這段配置意思是把spring.handlers和spring.schemas文件以append方式加入到構(gòu)建的jar包中，這樣就不會(huì)存在出現(xiàn)xsd找不到的情況。

配置完pom后，調(diào)用mvn clean install命令進(jìn)行構(gòu)建，構(gòu)建成功后打開工程target目錄，發(fā)現(xiàn)生成了2個(gè)jar包，一個(gè)為：original-XXX-0.0.1-SNAPSHOT.jar，另一個(gè)為：XXX-0.0.1-SNAPSHOT.jar，其中original...jar里只包含了工程自己的class文件，而另外的一個(gè)jar包則包含了工程本身以及所有依賴的jar包的class文件。我們只需要使用第二個(gè)jar包就可以了。

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論