Springsource tool suite(简称STS)(或Eclipse）将maven工程部署到Tomcat

最新推荐文章于 2022-06-05 16:02:37 发布

转载最新推荐文章于 2022-06-05 16:02:37 发布 · 904 阅读

本文介绍如何通过Maven实现Web应用的热部署到Tomcat服务器，包括配置Tomcat用户、设置Maven插件、调整项目构建路径等步骤。

Springsource tool suite(简称STS)(或Eclipse）将maven工程部署到Tomcat

下面介绍的两种方法可以让maven生成的web工程热部署到tomcat上。所谓的热部署即：可以将修改的工程部署到TOMCAT上，而不用让TOMCAT重启。

软件环境：eclipse + tomcat + maven + m2eclipse（如果使用STS，则不用安装MAVEN和m2eclipse了，因为STS上集成了eclipse和MAVEN）

或：STS+tomcat

方法一：

　　到D:/apache-tomcat-7.0.29-windows-x86/apache-tomcat-7.0.29/conf/tomcat-users.xml(D:/apache-tomcat-7.0.29-windows-x86/apache-tomcat-7.0.29为TOMCAT的存放路径，注意：TOMCAT不需要安装，下载后解压就行了）文件中定义一个tomcat用户（maven将使用这个用户往tomcat上发布maven web项目）。

1 < tomcat-users >
2     < user username = "manager" password = "tomcat" roles = "manager-gui" />
3 </ tomcat-users>

２.

　　启动tomcat，然后访问 http://localhost:8081/manager/html (注意此处我把TOMCAT的监听端口改为了8081，TOMCAT默认的监听端口为8080，可以在D:/apache-tomcat-7.0.29-windows-x86/apache-tomcat-7.0.29/conf/server.xml文件中进行修改），输入manager/tomcat(用户名/密码)，如果出现以下界面，表示tomcat一切正常：

clip_image002

　　在maven的settings.xml的servers结点下添加如下代码：(让maven在发布项目时用这个manager/tomcat(用户名/密码)这个账号访问tomcat)

1 <server>
2         <id>tomcat</id>
3         <username>manager</username>
4         <password>tomcat</password>
5  </server>

　　在eclipse中新建一个打包类型为war的maven项目，在这里我将项目名称命名为demo。

clip_image004

修改pom.xml文件，格式如下：在<build> 标签中插入下面代码

 1 <build>
 2         <finalName>jiudian</finalName>
 3 
 4         <plugins>
 5             <plugin>
 6                 <groupId>org.codehaus.mojo</groupId>
 7                 <artifactId>tomcat-maven-plugin</artifactId>
 8                 <version>1.0-beta-1</version>
 9                 <!-- 告诉maven用admin/admin账号访问setting.xml中id为tomcat的服务器，去http://localhost:8081/manager/html这个地址发布我的项目 -->
10                 <configuration>
11                     <url>http://localhost:8081/manager/html</url>
12                     <server>tomcat</server>
13                     <username>manager</username>
14                     <password>tomcat</password>
15                 </configuration>
16             </plugin>
17         </plugins>
18     </build>

在src/main/webapp下创建WEB-INF目录，在其它创建web.xml文件,内容如下（下面内容是建立web.xml文件后IDE自动添加的，不需要手动添加）：

1 <?xml version="1.0" encoding="UTF-8"?>
2 <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
3     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
4 http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
5 </web-app>

再在src/main/webapp下创建一个测试用的jsp文件index.jsp即可。建立的index.jsp的内容如下：

 1 <%-- 
 2     Document   : index
 3     Created on : 2012-8-19, 18:49:55
 4     Author     : Dell
 5 --%>
 6 
 7 <%@page contentType="text/html" pageEncoding="UTF-8"%>
 8 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
 9    "http://www.w3.org/TR/html4/loose.dtd">
10 
11 <html>
12     <head>
13         <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
14         <title>JSP Page</title>
15     </head>
16     <body>
17         <h1>Hello World!</h1>
18         <h1>This my first Blog!</h1>
19     </body>
20 </html>

Demo项目，鼠标右键，Run As 选择 Maven build......，出现如下界面：

在Goals中添加点东西：package tomcat:redeploy

package tomcat:redeploy表示：运行Maven build时将项目打包，同时部署到tomcat上。

点击Run As按钮->再选择Maven build，然后就会对项目进行打包，同时注意观看Console中的输出信息，注意相应的waring,error的提示。如果最后没有显示Buid Success则说明打包部署成功。访问:http://localhost:8081/demo/index.jsp 。如果浏览器上出现了index.jsp中的内容，则说明部署到了TOMCAT上去了，并且可以成功运行了。

然后，如果我们修改index.jsp的内容。然后再选择Maven Build。则会重新打包（war包），并部署到TOMCAT上。再刷新网页，则会出现最新的内容。

　　如果每做一次修改，想马上看到效果，却都要重新打包一次，这在大规模开发中太影响效率了。如果添加额外的步骤，即方案2。就可以了。

方案二：

　　1.修改tomcat的server.xml配置文件，在host结点下添加如下代码

Xml代码

1     <Context docBase="F:\eclipse_workspace\demo\src\main\webapp" path="/demo" reloadable="true"></Context>

这样tomcat便可以即时感知到F:\J2EE\eclipse_workspace\demo\src\main\webapp目录下文件的变化并自动重新部署了。

　　但是，我们的class文件和配置文件是编译在target/classes下呀。

　　2.

　　　回到eclipse中，右击demo项目，选java build path ，点击source选项卡，修改最下面的Default output folder为demo/src/main/webapp/WEB-INF/classes。再选择上面的demo/src/main/java及demo/src/main/resources下的Output folder选项，点击edit按钮，选择第一项Project's default output folder,点击OK。

　　这样java会被编译到WEB-INF下的classes目录，为tomcat所感知了。可是，还有项目的maven依赖包呢。

　　３.一般情况下，一个项目的依赖包一旦稳定下来，不会有太多的变动。因此，直接把maven依赖包拷到WEB-INF/lib下即可。

具体做法如下：

进入命令行，切换当前目录到项目根目录下。运行命令

mvn dependency:copy-dependencies

这时候demo项目的依赖包会被导到target/dependency下，将它们拷到WEB-INF/lib下即可。如果依赖包有变动，再导一次就好了。

总结：

　　方案一和方案二都支持断点调试。但方案一每次修改文件都要重新maven build，方案二则不用。但是如果用方案二并且最后要用maven将项目打包成war，还需要将java类的编译路径改回来，并且删除掉WEB-INF 下的classes目录和lib目录，否则会报错。

如果经过上述的步骤后，部署时仍然出现一些问题。则请看文章：STS MAVEN对项目进行打包是的一些warning,error的解决方案。