Maven系列--在项目中的使用

开头的时候说过,能接触到maven,全赖boss的高明只见在项目中使用了。也亏得开明的boss甩给了我一周多的时间去了解和研究。程序员的行业,废话再多也抵不过真枪实弹,以下介绍一下我在项目中是如何使用maven的。

这个maven项目是一个有三个子系统,分别是admin、index和search。

144412_nTUi_1442864.jpg

图1 [项目总结构图]

我们首先分析一下图1:

  • build->存放构建生成的打包项目

  • core->存放核心代码项目

  • doc->存放项目文档的文件夹

  • modules->存放功能模块项目

  • *.bat ->构建项目包的脚本

其实,对maven来说,core或者modules中的项目均为module,只不过在我这个项目中就按照功能划分了一下而已。

先来看一下目录结构中的pom.xml,这个文件主要用来管理各个module

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

	<groupId>test.maven</groupId>
	<artifactId>test</artifactId>
	<version>2.1.60-SNAPSHOT</version>
	<packaging>pom</packaging>

	<profiles>
		<!-- 全部模块 -->
		<profile>
			<id>all</id>
			<modules>
				<module>core/parent/pom.xml</module>
				<module>core/core/pom.xml</module>
				<module>core/wordsegment/pom.xml</module>
				<module>core/queryprocessor/pom.xml</module>
				<module>modules/index/pom.xml</module>
				<module>modules/search/pom.xml</module>
				<module>modules/admin/pom.xml</module>
			</modules>
		</profile>

		<!-- index -->
		<profile>
			<id>index</id>
			<modules>
				<module>core/parent/pom.xml</module>
				<module>core/core/pom.xml</module>
				<module>core/wordsegment/pom.xml</module>
				<module>modules/index/pom.xml</module>
			</modules>
		</profile>

		<!-- search -->
		<profile>
			<id>search</id>
			<modules>
				<module>core/parent/pom.xml</module>
				<module>core/core/pom.xml</module>
				<module>core/wordsegment/pom.xml</module>
				<module>core/queryprocessor/pom.xml</module>
				<module>modules/search/pom.xml</module>
			</modules>
		</profile>

		<!-- admin -->
		<profile>
			<id>admin</id>
			<modules>
				<module>core/parent/pom.xml</module>
				<module>core/core/pom.xml</module>
				<module>modules/admin/pom.xml</module>
			</modules>
		</profile>
	</profiles>
</project>

这个pom.xml有什么用?其最主要的作用就是在构建打包时分类构建。比如我只想单独构建admin模块,那我就可以双击运行build_admin.bat或者执行

mvn package -Padmin

 如此将不会影响到此打包过程中没使用到的module。

请注意<module>标记中使用到的是相对路径。



接下来要讲得是core/parent/pom.xml这个文件

145956_ABi3_1442864.jpg

图2

我们可以看到,parent下只有一个pom.xml文件,这个文件管理着项目中使用到的所有公用依赖包以及插件,由于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 http://maven.apache.org/maven-v4_0_0.xsd">
	<modelVersion>4.0.0</modelVersion>

	<groupId>test.maven</groupId>
	<artifactId>test-parent</artifactId>
	<packaging>pom</packaging>

	<version>2.1.60-SNAPSHOT</version>

	<properties>
		<!-- 主要依赖库的版本定义 -->
		<test.maven.version>${project.version}</test.maven.version>
		<!-- Plugin的属性定义 -->
		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
	</properties>

	<!-- 打包私服URL -->
	<distributionManagement>
		<repository>
			<id>releases</id>
			<url>http://192.168.8.181:9981/nexus/content/repositories/releases</url>
		</repository>
		<snapshotRepository>
			<id>snapshots</id>
			<url>http://192.168.8.181:9981/nexus/content/repositories/snapshots</url>
		</snapshotRepository>
	</distributionManagement>

	<!-- 预定义依赖项的version,scope与exclusions,子项目中只需定义groupId 和 artifactId 即可 -->
	<dependencyManagement>
		<dependencies>
			<!-- modules begin 项目中依赖到的其他项目模块 -->
			<dependency>
				<groupId>test.maven</groupId>
				<artifactId>core</artifactId>
				<version>${test.maven.version}</version>
			</dependency>
			
			<dependency>
				<groupId>test.maven</groupId>
				<artifactId>queryprocessor</artifactId>
				<version>${test.maven.version}</version>
			</dependency>

			....................................................................
			....................................................................
			....................................................................
			
			<!-- google -->
			<dependency>
				<groupId>com.google.guava</groupId>
				<artifactId>guava</artifactId>
				<version>15.0</version>
				<scope>compile</scope>
			</dependency>
		</dependencies>
	</dependencyManagement>

	<!-- 插件配置 -->
	<build>
		<pluginManagement>
			<plugins>
				<!-- compiler插件, 设定JDK版本 -->
				<plugin>
					<groupId>org.apache.maven.plugins</groupId>
					<artifactId>maven-compiler-plugin</artifactId>
					<version>3.1</version>
					<configuration>
						<source>1.7</source>
						<target>1.7</target>
						<encoding>${project.build.sourceEncoding}</encoding>
						<showWarnings>true</showWarnings>
					</configuration>
				</plugin>
                                
                                .........................................................
                                .........................................................
                                .........................................................

				<!-- eclipse插件,设定下载Source并屏蔽.svn文件 -->
				<plugin>
					<groupId>org.apache.maven.plugins</groupId>
					<artifactId>maven-eclipse-plugin</artifactId>
					<version>2.9</version>
					<configuration>
						<sourceExcludes>
							<sourceExclude>**/.svn/</sourceExclude>
						</sourceExcludes>
						<downloadSources>true</downloadSources>
						<downloadJavadocs>false</downloadJavadocs>
					</configuration>
				</plugin>
			</plugins>
		</pluginManagement>
	</build>
</project>

<dependencyManagement>标记中管理了所有用到的依赖包,明确定义了用到的依赖包的版本

<pluginManagement>中标记了用到的插件,并为一些插件设定了部分统一配置,如maven-compiler-plugin插件中的JDK版本设定为1.7

我们再看module中是怎么使用这个parent的pom.xml的,例如queryprocessor的pom.xml

<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>

	<!-- 集成parent的pom.xml -->
	<parent>
		<groupId>test.maven</groupId>
		<artifactId>test-parent</artifactId>
		<version>2.1.60-SNAPSHOT</version>
		<relativePath>../parent/pom.xml</relativePath>
	</parent>

	<artifactId>queryprocessor</artifactId>
	<packaging>jar</packaging>

	<dependencies>
	        <!-- 应用项目中的其他项目,看见没,这里没有写版本号!因为parent中写了 -->
		<dependency>
			<groupId>test.maven</groupId>
			<artifactId>wordsegment</artifactId>
		</dependency>


		<!-- lucene 引用依赖包也没有写版本号,parent中的依赖包管理已经写好了-->
		<dependency>
			<groupId>org.apache.lucene</groupId>
			<artifactId>lucene-queries</artifactId>
		</dependency>

                ....................................................................
                ....................................................................
                ....................................................................
                
		<!-- test -->
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<scope>test</scope>
		</dependency>
	</dependencies>

	<build>
		<finalName>test-${project.artifactId}-${project.version}</finalName>
		<plugins>
			<!-- compiler插件 这里也没有写版本号,更没有写配置,这个项目使用的就是jdk1.7,maven3默认使用的是jdk1.6-->
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-compiler-plugin</artifactId>
			</plugin>

			....................................................................
			....................................................................
			....................................................................

			<!-- dependency插件 -->
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-dependency-plugin</artifactId>
			</plugin>
		</plugins>
	</build>
</project>

从上面的pom.xml可以看到,依赖包以及插件的配置中,已经不再写版本号了,插件中也可以默认使用parent中的配置。


最后面讲讲怎么把项目打包到build文件夹中

例如admin项目中,用到了打包插件maven-assembly-plugin

写贴上admin项目的目录结构图

160245_WH5v_1442864.jpg

图3

<!-- assembly插件 -->
<plugin>
	<groupId>org.apache.maven.plugins</groupId>
	<artifactId>maven-assembly-plugin</artifactId>
	<executions>
		<execution>
			<id>assembly:admin</id>
			<phase>package</phase> <!-- 绑定在打包阶段 -->
			<goals>
				<goal>single</goal>
			</goals>
		</execution>
	</executions>
       	<configuration>
		<finalName>${project.artifactId}</finalName>
		<outputDirectory>target/assembly</outputDirectory> <!-- 打包后,目标输出的文件夹 -->
		<filters>
			<filter>${basedir}/src/main/assemblies/filter.properties</filter> <!-- 存放需要替换的变量的值,比如执行脚本中有个${VersionID},根据filter里的值能替换成对应的 -->
		</filters>
		<descriptors>
			<descriptor>src/main/assemblies/assembly.xml</descriptor> <!-- 打包的详细配置文件 -->
		</descriptors>
	</configuration>
</plugin>


再来看看assembly.xml是怎么处理的

<?xml version="1.0"?>
<assembly
	xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2 http://maven.apache.org/xsd/assembly-1.1.2.xsd">
	<id>distribution</id>
	<formats>
		<format>dir</format><!-- 这里是有多种打包方式的,常用的有:zip、tar、tar.gz、dir、war、jar -->
	</formats>
	<includeBaseDirectory>false</includeBaseDirectory>

	<!-- 需要装配copy的文件 -->
	<fileSets>
		<!-- 说明文件 -->
		<fileSet>
			<directory>work</directory>
			<outputDirectory>/</outputDirectory>
			<filtered>false</filtered>
			<includes>
				<include>*.txt</include>
			</includes>
		</fileSet>
		<!-- 配置文件 -->
		<fileSet>
			<directory>work/conf</directory>
			<outputDirectory>/conf</outputDirectory>
			<filtered>true</filtered>
		</fileSet>
		<!-- database.sql文件 -->
		<fileSet>
			<directory>work/db</directory>
			<outputDirectory>/db</outputDirectory>
			<filtered>false</filtered>
		</fileSet>

		<!-- 日志文件 -->
		<fileSet>
			<directory>work/logs</directory>
			<outputDirectory>/logs</outputDirectory>
			<filtered>false</filtered>
		</fileSet>
	</fileSets>
</assembly>

到这里,构建出来的文件被放入到了target/assembly这个目录中,剩下的就是build_admin.bat的工作了

@echo off
echo [info] 确保默认JDK版本为JDK7.0及以上版本,已配置JAVA_HOME.

set MVN=mvn
set MAVEN_OPTS=%MAVEN_OPTS% -XX:MaxPermSize=128m

echo MAVEN命令:%MVN%
echo ---------------------------------------------------------------------------------
echo *                [Step 1] 开始编译并打包admin工程            *
echo ---------------------------------------------------------------------------------

call %MVN%  clean install -Padmin -Dmaven.test.skip=true
if errorlevel 1 goto error

echo ---------------------------------------------------------------------------------
echo *      [Step 2]admin工程打包成功  ,放入对应的build目录     *
echo ---------------------------------------------------------------------------------

set time_hh=%time:~0,2%
if /i %time_hh% LSS 10 (set time_hh=0%time:~1,1%)
set currentTime=%date:~,4%%date:~5,2%%date:~8,2%_%time_hh%%time:~3,2%%time:~6,2%
set filename=admin_%currentTime%

rem echo %filename%
echo 开始创建build目录
md build\%filename%

xcopy modules\admin\target\admin.war build\%filename%\.
xcopy /e /s modules\admin\target\assembly\admin-distribution build\%filename%\. 

echo ---------------------------------------------------------------------------------
echo *              [Step 3] 开始清除操作                                           *
echo ---------------------------------------------------------------------------------

call %MVN% clean -Padmin -Dmaven.test.skip=true
if errorlevel 1 goto error1

echo ---------------------------------------------------------------------------------
echo *              		 清除操作成功                                             *
echo ---------------------------------------------------------------------------------

goto end

:error
echo "编译打包失败,有错误发生"
goto end
:error1
echo "清除失败,有错误出现"
goto end
:end
pause

通过执行这脚本将target/assembly里的文件搬运到build中,完整的构建包就出来了,然后就可以交付给其他部门使用了!



转载于:https://my.oschina.net/poorzerg/blog/201894

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值