Maven

先将我用到的自定义变量贴过来，防止插件中出现一些变量，大家不理解




Java代码 复制代码 收藏代码
1.<!-- 全局属性配置 --> 
2.<properties> 
3.    <project.build.name>tools</project.build.name> 
4.    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 
5.</properties> 


project.build.name： 用来定义war包名称
project.build.sourceEncoding： 用来定义资源文件的编码格式

下面开始讲解常用的maven插件配置

一、编译插件



Java代码 复制代码 收藏代码
1.<!-- 编译插件 --> 
2.<plugin> 
3.    <groupId>org.apache.maven.plugins</groupId> 
4.    <artifactId>maven-compiler-plugin</artifactId> 
5.    <configuration> 
6.        <source>1.6</source> 
7.        <target>1.6</target> 
8.        <encoding>${project.build.sourceEncoding}</encoding> 
9.    </configuration> 
10.</plugin> 


source：源代码编译版本；
target：目标平台编译版本；
encoding：字符集编码。

二、设置资源文件的编码方式



Java代码 复制代码 收藏代码
1.<!-- 设置资源文件的编码方式 --> 
2.<plugin> 
3.    <groupId>org.apache.maven.plugins</groupId> 
4.    <artifactId>maven-resources-plugin</artifactId> 
5.    <version>2.4.3</version> 
6.    <executions> 
7.        <execution> 
8.            <phase>compile</phase> 
9.        </execution> 
10.    </executions> 
11.    <configuration> 
12.        <encoding>${project.build.sourceEncoding}</encoding> 
13.    </configuration> 
14.</plugin> 


xml、properties文件都是资源文件，编码的时候遇到中文总要进行转码！用什么编码？UTF-8，那就记得强制<encoding>${project.build.sourceEncoding}</encoding>

三、自动拷贝jar包到target目录



Java代码 复制代码 收藏代码
1.<!-- 依赖插件 --> 
2.<plugin> 
3.    <groupId>org.apache.maven.plugins</groupId> 
4.    <artifactId>maven-dependency-plugin</artifactId> 
5.    <version>2.6</version> 
6.    <executions> 
7.        <execution> 
8.            <id>copy-dependencies</id> 
9.            <phase>compile</phase> 
10.            <goals> 
11.                <goal>copy-dependencies</goal> 
12.            </goals> 
13.            <configuration> 
14.                <!-- ${project.build.directory}为Maven内置变量，缺省为target --> 
15.                <outputDirectory>${project.build.directory}/lib</outputDirectory> 
16.                <!-- 表示是否不包含间接依赖的包 --> 
17.                <excludeTransitive>false</excludeTransitive> 
18.                <!-- 表示复制的jar文件去掉版本信息 --> 
19.                <stripVersion>true</stripVersion> 
20.            </configuration> 
21.        </execution> 
22.    </executions> 
23.</plugin> 



在部署war包时，需要将项目依赖的jar包，也打到war包中，因此就会用到上述插件

四、生成源代码jar包



Java代码 复制代码 收藏代码
1.<!-- 源代码打包插件 --> 
2.<plugin> 
3.    <artifactId>maven-source-plugin</artifactId> 
4.    <version>2.1</version> 
5.    <configuration> 
6.        <!-- <finalName>${project.build.name}</finalName> --> 
7.        <attach>true</attach> 
8.        <encoding>${project.build.sourceEncoding}</encoding> 
9.    </configuration> 
10.    <executions> 
11.        <execution> 
12.            <phase>compile</phase> 
13.            <goals> 
14.                <goal>jar</goal> 
15.            </goals> 
16.        </execution> 
17.    </executions> 
18.</plugin> 


该插件主要用于在打jar包时，把源代码也打成jar包

五、将项目打成jar包



Java代码 复制代码 收藏代码
1.<!-- jar包插件 --> 
2.<plugin> 
3.    <groupId>org.apache.maven.plugins</groupId> 
4.    <artifactId>maven-jar-plugin</artifactId> 
5.    <version>2.4</version> 
6.    <configuration> 
7.        <archive> 
8.            <manifest> 
9.                <!-- 告知 maven-jar-plugin添加一个 Class-Path元素到 MANIFEST.MF文件，以及在Class-Path元素中包括所有依赖项 --> 
10.                <addClasspath>true</addClasspath> 
11.                <!-- 所有的依赖项应该位于 lib文件夹 --> 
12.                <classpathPrefix>lib/</classpathPrefix> 
13.                <!-- 当用户使用 lib命令执行JAR文件时，使用该元素定义将要执行的类名 --> 
14.                <mainClass>com.zhengtian.tools.service.phone.MobilePhoneTool</mainClass> 
15.            </manifest> 
16.        </archive> 
17.    </configuration> 
18.</plugin> 



在将项目打成jar包时，有时会需要将项目打成可以直接运行的jar包，因此就需要将项目依赖的jar包也打入jar包中，此时需要在Eclipse上安装例外一个插件，用来打可执行jar包，详情见链接http://zheng12tian.iteye.com/blog/1765626

六、将项目打成war包



Java代码 复制代码 收藏代码
1.<!-- war插件 --> 
2.<plugin> 
3.    <groupId>org.apache.maven.plugins</groupId> 
4.    <artifactId>maven-war-plugin</artifactId> 
5.    <version>2.1.1</version> 
6.    <configuration> 
7.        <!-- <warName>${project.build.name}</warName> --> 
8.    </configuration> 
9.</plugin> 


encoding：强制字符集编码
warName：war包名字——platform.war
webappDirectory：产生war前，用于存放构建war包的目录——target/platform。
warSourceDirectory：我把web工程搞成了eclipse下的WTP类型。我不喜欢maven产生的webapp目录，更喜欢WebContent！

需要注意的是：
采用上述插件部署项目的话，使用clean package tomcat:redeploy命令。使用该命令前，需要先启动tomcat，实际上是为了让tomcat启动manager项目，实现动态部署

此部署方式虽然也是动态部署的范畴，但是每次修改文件后，需要手动再次重新部署，才会加载更改。

如果想让tomcat自动扫描项目的改动，自动加载，那么需要将maven工程的java全部编译的webapp目录下，然后将jar包和资源文件也打到webapp目录。最后在$CATALINA_HOME/conf /Catalina/localhost中添加一个xml文件，修改docbase为webapp目录。

Tomcat常用的部署方式介绍：http://blog.csdn.net/yangxueyong/article/details/6130065

七、在打包时，需要清空一些指定的目录



Java代码 复制代码 收藏代码
1.<!-- clean插件 --> 
2.<plugin> 
3.    <artifactId>maven-clean-plugin</artifactId> 
4.    <version>2.4.1</version> 
5.    <configuration> 
6.        <filesets> 
7.            <fileset> 
8.                <directory>src/main/webapp/WEB-INF/classes</directory> 
9.            </fileset> 
10.            <fileset> 
11.                <directory>src/main/webapp/WEB-INF/lib</directory> 
12.            </fileset> 
13.            <fileset> 
14.                <directory>${project.build.directory}</directory> 
15.            </fileset> 
16.        </filesets> 
17.    </configuration> 
18.</plugin> 



八、利用tomcat-maven-plugin插件将项目自动打包并部署到tomcat中



Java代码 复制代码 收藏代码
1. <!-- tomcat插件 --> 
2.    <plugin> 
3.        <groupId>org.codehaus.mojo</groupId> 
4.        <artifactId>tomcat-maven-plugin</artifactId> 
5.        <configuration> 
6.            <server>tomcat6-manager</server> 
7.            <path>/${project.build.name}</path> 
8.            <url>http://localhost:8080/manager</url> 
9.            <username>admin</username> 
10.            <password>admin</password> 
11.        </configuration> 
12.        <executions> 
13.            <execution> 
14.                <phase>deploy</phase> 
15.                <goals> 
16.                    <goal>deploy</goal> 
17.                </goals> 
18.            </execution> 
19.        </executions> 
20.    </plugin> 
21.</plugins> 


path：是指项目部署到tomcat后的项目名称
url：是指tomcat的manager访问地址
server：这个是tomcat服务名称设置，需要配置maven的settings.xml文件，在servers节点中手动配置server，如下所示：



Java代码 复制代码 收藏代码
1.<server> 
2.    <id>tomcat6-manager</id> 
3.    <username>admin</username> 
4.    <password>admin</password> 
5.</server> 



九、利用cargo-maven2-plugin插件将项目自动打包并部署到tomcat中



Java代码 复制代码 收藏代码
1.<plugin> 
2.                <!-- 指定插件名称及版本号 --> 
3.                <groupId>org.codehaus.cargo</groupId> 
4.                <artifactId>cargo-maven2-plugin</artifactId> 
5.                <version>1.2.3</version> 
6.                <!-- 插件的Tomcat6.x配置 --> 
7.                <configuration> 
8.                    <!-- 容器的配置 --> 
9.                    <container> 
10.                        <!-- 指定服务器版本 --> 
11.                        <containerId>tomcat6x</containerId> 
12.                        <!-- 指定服务器的安装目录 --> 
13.                        <home>E:\Program Files\tomcat-6.0.32</home> 
14.                    </container> 
15.                    <!-- 具体的配置 --> 
16.                    <configuration> 
17.                        <!-- 部署模式：existing、standalone等 --> 
18.                        <type>existing</type> 
19.                        <!-- Tomcat的位置，即catalina.home --> 
20.                        <home>E:\Program Files\tomcat-6.0.32</home> 
21.                        <!-- 配置属性 --> 
22.                        <properties> 
23.                            <!-- 管理地址 --> 
24.                            <cargo.tomcat.manager.url>http://localhost:8080/manager</cargo.tomcat.manager.url> 
25.                            <!-- Tomcat用户名 --> 
26.                            <cargo.remote.username>admin</cargo.remote.username> 
27.                            <!-- Tomcat密码 --> 
28.                            <cargo.remote.password>admin</cargo.remote.password> 
29.                            <!-- <cargo.jvmargs> -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8787 </cargo.jvmargs> --> 
30.                        </properties> 
31.                    </configuration> 
32.                </configuration> 
33.            </plugin> 



username和password：是指tomcat的tomcat-users.xml文件中配置的，文件路径为E:\Program Files\tomcat-6.0.32\conf\tomcat-users.xml，如下所示：




Java代码 复制代码 收藏代码
1.<role rolename="manager"/>  
2.<user password="admin" roles="manager" username="admin"/>  



十、有时候插件检查不通过，需要人为的忽略对有些插件的检查



Java代码 复制代码 收藏代码
1.<!-- 插件管理 --> 
2.<pluginManagement> 
3.    <plugins> 
4.        <plugin> 
5.            <groupId>org.eclipse.m2e</groupId> 
6.            <artifactId>lifecycle-mapping</artifactId> 
7.            <version>1.0.0</version> 
8.            <configuration> 
9.                <lifecycleMappingMetadata> 
10.                    <pluginExecutions> 
11.                        <!-- 忽略2.0以上版本的maven-dependency-plugin的检查 --> 
12.                        <pluginExecution> 
13.                            <pluginExecutionFilter> 
14.                                <groupId>org.apache.maven.plugins</groupId> 
15.                                <artifactId>maven-dependency-plugin</artifactId> 
16.                                <versionRange>[2.0,)</versionRange> 
17.                                <goals> 
18.                                    <goal>copy-dependencies</goal> 
19.                                </goals> 
20.                            </pluginExecutionFilter> 
21.                            <action> 
22.                                <ignore /> 
23.                            </action> 
24.                        </pluginExecution> 
25.                    </pluginExecutions> 
26.                </lifecycleMappingMetadata> 
27.            </configuration> 
28.        </plugin> 
29.    </plugins> 
30.</pluginManagement>