Vcenter数据采集之maven打包可执行jar血历史

Posted

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Vcenter数据采集之maven打包可执行jar血历史相关的知识，希望对你有一定的参考价值。

技术点：spring加载xsd过程：

http://blog.csdn.net/bluishglc/article/details/7596118


案发背景：

1、一个使用maven管理的普通项目（vcenter-collector ：关于Vcenter数据采集）

2、项目主要技术： java + mybatis（基于接口形式）+其他

3、项目中有一个非maven仓库的jar包：vijava(做vcenter数据采集的)，在项目中以system方式引用

  (该jar放在${project.basedir}/lib下)


需求： 将该项目打包为一个可执行jar


案发经过：


1、引用maven的插件（maven-assembly-plugin）打有依赖的jar包

<plugin>
	<artifactId>maven-assembly-plugin</artifactId>
	<configuration>
		<archive>
			<manifest>
				<mainClass>com.main.VcenterCollectMain</mainClass>
			</manifest>
		</archive>
		<descriptorRefs>
			<descriptorRef>jar-with-dependencies</descriptorRef>
		</descriptorRefs>
	</configuration>
</plugin>

利用命令： mvn clean assembly:assembly 进行打包，

打好包后运行：java -jar Vcenter-Collector.jar

运行报错：

org.springframework.beans.factory.parsing.BeanDefinitionParsingException: Configuration problem: Unable to locate Spring NamespaceHandler for XML schema namespace [http://www.springframework.org/schema/context]

然后开始在网上搜罗答案，结果有惊喜啊，发现spring配置文件在加载的时候需要相关的xsd配合，只管自己没了解spring配置文件加载细节，在iteye上有一篇帖子：

http://chenzhou123520.iteye.com/blog/1971322  说明了原因，并给出了解决方案


好吧，按照帖子方案选择了maven-shade-plugin 插件，修改配置如下：

<plugin>
	<groupId>org.apache.maven.plugins</groupId>
	<artifactId>maven-shade-plugin</artifactId>
	<version> 1.7.1</version>
	<executions>
		<execution>
			<phase>package</phase>
			<goals>
			<goal>shade</goal>
			</goals>
			<configuration>
			   <transformers>
				<transformer
					implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
				 <mainClass>com.chenzhou.test.Main</mainClass>
				</transformer>
				</transformers>
			</configuration>
		</execution>
	</executions>
</plugin>

主要是靠下面配置（打包时分别合并所有的spring.schemas与spring.handlers文件，这样就不会丢失）：

<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.AppendingTransformer">
   <resource>META-INF/spring.schemas</resource>
</transformer>
<transformer
       implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
	<mainClass>com.main.VcenterCollectMain</mainClass>
</transformer>
</transformers>

这段配置意思是把spring.handlers和spring.schemas文件以append方式加入到构建的jar包中。

好了，接着打包：mvn clean package ，这下前面的命名空间问题解决了，但虎去狼来啊，又有新问题：由于项目采用mybatis，而且采用接口形式开发，将mapper文件统统放到了java类目录，而不是资源目录，截图如下：

技术分享

结果，导致maven打包时，这些xml文件打不进去，没办法，接着引入<resource>配置：

           <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>

好了，这下mapper打进去了，运行时又出错了，找不到类，这些类正好是通过system方式管理的本地jar:

 <dependency>
	<groupId>vijava</groupId>
	<artifactId>vijava</artifactId>
	<version>1.0</version>
	<scope>system</scope>
	<systemPath>${project.basedir}/lib/vijava55b20130927.jar</systemPath>
  </dependency>

又开始百度，，找到答案，说是要利用<resource>配置指定jar位置，加入如下配置：

<resource>
   <targetPath>lib/</targetPath>
   <directory>lib/</directory>
   <includes>
       <include>**/vijava55b20130927.jar</include>
   </includes>
</resource>

好了，打包mvn clean package ，打包正常，这个jar在jar包中在单独的lib目录中，好了准备运行jar试试，结果，报错，说找不到类，而该类就是lib中的类，看来这样虽然可以将system管理的包打到jar中，但运行时却引用不到，看来不行啊，继续找，找。。

有人说，将jar安装到本地仓库，我也想啊，但是，别人拿到项目还不是得在自己的本地再次安装一遍，太费事，采取终极方案：

  添加 in project repository，在新机器上执行时就不用运行mvn install:install-file命令了

配置如下：

<repositories>
   <repository>
	<id>in-project</id>
	<name>In Project Repo</name>
	<url>file://${project.basedir}/lib</url>
   </repository>
</repositories>


<dependency>
    <groupId>vijava</groupId>
     <artifactId>vijava</artifactId>
      <version>1.0</version>
</dependency>

本项目配置如下：

技术分享


注意：

你的jar包及路径必须严格遵循格式：
/groupId/artifactId/version/artifactId-verion.jar
本例中： lib/org/richard/my-jar/1.0/my-jar-1.0.ja

maven-shade-plugin插件有个配置属性:createDependencyReducedPom,默认值为true.
注意这个属性,如果你用这个插件来deploy,或者发布到中央仓库
这个属性会缩减你的pom文件,会把你依赖的<dependency>干掉
正确的做法是把这个值改成false，如果为true，则会生成一个裁剪的pom文件：
     dependency-reduced-pom.xml
     
应该将该值改为false：
<configuration>  
       <createDependencyReducedPom>false</createDependencyReducedPom>  
 </configuration>


最后给出本项目完整配置的pom：

<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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>

	<groupId>com.huhu</groupId>
	<artifactId>VcenterCollector</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<packaging>jar</packaging>

	<name>VcenterCollector</name>
	<url>http://maven.apache.org</url>

	<repositories>
		<repository>
		    <id>in-project</id>
		    <name>In Project Repo</name>
		    <url>file://${project.basedir}/lib</url>
		</repository>
	</repositories>

	<properties>
		<spring.version>4.1.4.RELEASE</spring.version>
		<mybatis.version>3.2.6</mybatis.version>
		<slf4j.version>1.7.7</slf4j.version>
		<log4j.version>1.2.17</log4j.version>
		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
	</properties>

	<dependencies>
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>4.8</version>
			<scope>test</scope>
		</dependency>
		<!-- spring -->

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-core</artifactId>
			<version>${spring.version}</version>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-context</artifactId>
			<version>${spring.version}</version>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-webmvc</artifactId>
			<version>${spring.version}</version>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-web</artifactId>
			<version>${spring.version}</version>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-aop</artifactId>
			<version>${spring.version}</version>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-tx</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-jdbc</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<dependency>
			<groupId>org.aspectj</groupId>
			<artifactId>aspectjweaver</artifactId>
			<version>1.8.5</version>
		</dependency>
		<!-- end spring -->
		<!-- mybatis -->
		<dependency>
			<groupId>org.mybatis</groupId>
			<artifactId>mybatis</artifactId>
			<version>${mybatis.version}</version>
		</dependency>
		<dependency>
			<groupId>org.mybatis</groupId>
			<artifactId>mybatis-spring</artifactId>
			<version>1.2.2</version>
		</dependency>

		<dependency>
			<groupId>mysql</groupId>
			<artifactId>mysql-connector-java</artifactId>
			<version>5.1.30</version>
		</dependency>
		<!-- 添加druid连接池包 -->
		<dependency>
			<groupId>com.alibaba</groupId>
			<artifactId>druid</artifactId>
			<version>1.0.12</version>
		</dependency>
		<dependency>
			<groupId>dom4j</groupId>
			<artifactId>dom4j</artifactId>
			<version>1.6.1</version>
		</dependency>
		<dependency>
			<groupId>net.sf.json-lib</groupId>
			<artifactId>json-lib</artifactId>
			<version>2.4</version>
			<classifier>jdk15</classifier>
		</dependency>
		<dependency>
			<groupId>commons-io</groupId>
			<artifactId>commons-io</artifactId>
			<version>2.4</version>
		</dependency>

		<dependency>
			<groupId>org.slf4j</groupId>
			<artifactId>slf4j-log4j12</artifactId>
			<version>${slf4j.version}</version>
		</dependency>
		
		<dependency>
		    <groupId>vijava</groupId>
		    <artifactId>vijava</artifactId>
		    <version>1.0</version>
		</dependency>
	</dependencies>
	<build>
		<finalName>VcenterCollector</finalName>
		<plugins>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-compiler-plugin</artifactId>
				<configuration>
					<source>1.6</source>
					<target>1.6</target>
				</configuration>
			</plugin>

			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-shade-plugin</artifactId>
				<version> 1.7.1</version>
				<executions>
					<execution>
						<phase>package</phase>
						<goals>
							<goal>shade</goal>
						</goals>
						<configuration>
							<createDependencyReducedPom>false</createDependencyReducedPom>
							<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.AppendingTransformer">
									<resource>META-INF/spring.schemas</resource>
								</transformer>
								<transformer
									implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
									<mainClass>com.main.VcenterCollectMain</mainClass>
								</transformer>
							</transformers>
						</configuration>
					</execution>
				</executions>
			</plugin>
		</plugins>
		<resources>
			<resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
		</resources>
	</build>
</project>


以上是关于Vcenter数据采集之maven打包可执行jar血历史的主要内容，如果未能解决你的问题，请参考以下文章

maven工程编译并生成可执行JAR包命令

Apache Maven 打包可执行jar

Maven打包可执行jar

maven项目打包插件：将maven项目打包成一个可执行的jar（瘦jar）

Maven 生成打包可执行jar包

聚合maven+spring-boot打包可执行jar