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>