maven plugin在tomcat 热部署

前言:

        此处的方法适用于tomcat6 和 tomcat7,对于最新的tomcat8还没有进行过測试,有兴趣的同学能够自己測一下.

总共分为五步:
        1.在tomcat中配置用户权限,即加入管理员帐号
        2.在maven中加入server,配置tomcat的管理员帐号password
        3.在project中加入插件,以及maven中配置的server,
        4.设置部署命令
        5.进行部署

以下进行分步骤解说:
        一、 在tomcat中配置用户权限,即加入管理员帐号.
        我们须要实现热部署,自然就须要通过maven操作tomcat,所以就须要maven取得操作tomcat的权限,如今这一步就是配置tomcat的可操作权限。在tomcat的安装文件夹下,改动conf / tomcat-user.xml文件,在<tomcat-users> 节点以下添加例如以下配置:

<role rolename="manager-gui" />
<role rolename="manager-script" />
<user username="tomcat" password="tomcat" roles="manager-gui, manager-script" />

        二、 在maven中加入server,配置tomcat的管理员帐号password

        如今tomcat开启了权限,maven既然要操作tomcat,那么maven就要拿到tomcat的管理员帐号和password才可以使用.在maven的安装文件夹下,改动conf / setting.xml文件.在<server> 节点以下添加例如以下配置:

<server> 
	<id>admin</id> 
	<username>tomcat</username> 
	<password>tomcat</password>
</server>

        三、 在project中加入插件,以及maven中配置的server,

       如今maven已经拥有操作tomcat的权限了,可是这两者之间想要通信的话还须要一个桥梁,那就是在maven中配置tomcat插件.改动项目的pom.xml文件,在<build> 节点以下添加例如以下配置:

<plugins> <!-- 第一种方式: apache官方tomcat插件,支持deploy -->
	<plugin>
		<groupId>org.apache.tomcat.maven</groupId>
		<artifactId>tomcat7-maven-plugin</artifactId>
		<version>2.0-SNAPSHOT</version>
		<configuration>
			<url>http://localhost:8080/manager/text</url>
			<server>admin</server>
		</configuration>
	</plugin> <!-- 另外一种方式: 第三方tomcat插件,支持redeploy -->
	<plugin>
		<groupId>org.codehaus.mojo</groupId>
		<artifactId>tomcat-maven-plugin</artifactId>
		<version>1.1</version>
		<configuration>
			<url>http://localhost:8080/manager/text</url>
			<server>admin</server>
			<ignorePackaging>true</ignorePackaging>
		</configuration>
	</plugin>
</plugins>

        对于以上插件,网上有两种,经过測试都是能够用的,可是注意,以上的配置仅仅能用于tomcat7,假设要用tomcat6的话,须要配置成例如以下方式:

<plugins> <!-- apache官方tomcat插件,支持deploy -->
	<plugin>
		<groupId>org.apache.tomcat.maven</groupId>
		<artifactId>tomcat6-maven-plugin</artifactId>
		<version>2.0-SNAPSHOT</version>
		<configuration>
			<url>http://localhost:8080/manager/html</url>
			<server>admin</server>
		</configuration>
	</plugin> <!-- 第三方tomcat插件,支持redeploy -->
	<plugin>
		<groupId>org.codehaus.mojo</groupId>
		<artifactId>tomcat-maven-plugin</artifactId>
		<version>1.1</version>
		<configuration>
			<url>http://localhost:8080/manager</url>
			<server>admin</server>
			<ignorePackaging>true</ignorePackaging>
		</configuration>
	</plugin>
</plugins>

        不论是tomcat7还是tomcat6,仅仅要用到当中一种插件即可了.可是这两种插件还是有差别的:
        第一种是apache官方的插件,支持deploy命令,假设已经部署到tomcat容器,第二次部署的时候就会报错,提示该项目已经部署.
        另外一种是第三方的插件,能够使用redeploy命令,能够反复部署
        同一时候,请在<project>节点下添加仓库配置,不然可能插件找不到,导致报错:

<repositories>
	<repository>
		<id>people.apache.snapshots</id>
		<url>http://repository.apache.org/content/groups/snapshots-group/</url>
		<releases>
			<enabled>false</enabled>
		</releases>
		<snapshots>
			<enabled>true</enabled>
		</snapshots>
	</repository>
</repositories>
<pluginRepositories>
	<pluginRepository>
		<id>apache.snapshots</id>
		<name>Apache Snapshots</name>
		<url>http://repository.apache.org/content/groups/snapshots-group/</url>
		<releases>
			<enabled>false</enabled>
		</releases>
		<snapshots>
			<enabled>true</enabled>
		</snapshots>
	</pluginRepository>
</pluginRepositories>

        四、 设置部署命令
        一般使用搜是在eclipse中,能够右键点击须要部署的项目,Run as -> Run configurations -> maven build -> 右键 new,这样配置一个新的maven命令
        详细配置命令方法:
        1.在base directory中选择自己的项目
        2.Goals的配置
        假设使用apache的官方插件,那么就用 "tomcat7:deploy" 命令，假设使用第三方插件,那么就用 "tomcat:redeploy"命令

        五、 进行部署
        右键自己的项目,Run as -> Maven build就可以.

注:
        有些同学不习惯使用IDE,那么在命令行中使用maven实现部署也是一样的.通过命令行进入到自己的项目目录下,使用mvn命令,比如: mvn tomcat7:deploy

附相关错误及解决的方法:
        1. Connection refused错误
        报错信息例如以下：
[ERROR]Failed to execute goal org.apache.tomcat.maven: tomcat7-maven-plugin: 2.0- SNAPSHOT: deploy (default-cli) on project helloworld: Cannot invoke Tomcat manager: Connection refused: connect -> [Help 1]
        原因：未启动Tomcatserver
        解决的方法：先启动Tomcatserver再选择Run

        2.  401错误
        报错信息例如以下:
[ERROR] Failed to execute goal org.apache.tomcat.maven:tomcat7-maven-plugin: 2.0-SNAPSHOT:deploy (default-cli) on project helloworld: Cannot invoke Tomcat manager: Server returned HTTP response code: 401 for URL: http://localhost:8080/manager/text/deploy?path=%2Fhelloworld -> [Help 1]
        原因：权限问题
        解决的方法：在$CATALINA_BASE/conf/tomcat-users.xml。
        如D:/apache-tomcat-7.0.34/conf/tomcat-users.xml文件里加入权限

<role rolename=”manager”/>
<user username=”admin” password=”admin” roles=”manager”/>

        改动pom.xml文件，在<configuration>  </configuration>中加入

<username>admin</username>
<password>admin</password>

        3. 403错误
        报错信息例如以下：
[ERROR] Failed to execute goal org.apache.tomcat.maven:tomcat7-maven-plugin: 2.0-SNAPSHOT:deploy (default-cli) on project helloworld: Cannot invoke Tomcat manager: Server returned HTTP response code: 403 for URL: http://localhost:8080/manager/html/deploy?

path=%2Fhelloworld -> [Help 1]
        原因：产生该问题有可能由于两个原因，详细參见解决的方法
        解决的方法：
        1）假设使用的是Tomcat 7，须要改动pom.xml中部署的url地址，将<url>http://localhost:8080/manager</url>改<url>http://localhost:8080/manager/text</url>
        2）给tomcat用户权限分配上，须要同一时候具备manager-gui和manager-script权限，我在遇到该问题时，就是忘了分配manager-script权限。
       正确的conf/tomcat-users.xml配置应为：

<tomcat-users>
	<role rolename="manager-gui" />
	<role rolename="manager-script" />
	<user username="admin” password="admin" roles="manager-gui, manager-script" />
</tomcat-users>