外行搞应用-maven web工程的部署
注意:本文是按照我昨天边学边试的顺序写的,算是流水账,正常的部署顺序在文章最后,按照文章里写的顺序搞会遇到一些麻烦。
之前做的Android演示app的后台部署在本机的tomcat里的,昨天老大让部署到互联网服务器里,之前一直以为ftp进去把war包扔到webapps里就行了,老大说不让那么搞,给了个例程让用maven弄。一开始是懵逼的,毕竟我只是从嵌入式组过来支援几行入门级代码,没想到部署也得我弄,完全没接触过的东西呀。。。。其实他直接找个熟手过来给我弄了就完事了,就几下的事,可能老大可能没想到这一点吧,扔下一个例程开会去了。
自己研究了一下,好像只要在pom.xml文件里写入服务器地址,tomcat的用户和密码就可以了。照猫画虎得试试吧,先做个本地实验。
tomcat用户配置
tomcat安装后是没有用户的,所以要新建一个。在tomcat安装目录下找到/conf/tomcat-users.xml,加入以下内容:
<role rolename="manager-gui"/>
<role rolename="manager-script"/>
<user username="admin" password="123456" roles="manager-gui,manager-script"/>
role就是要添加什么角色的用户,我这里添加了一个可以通过gui和脚本来管理tomcat的用户。新建用户之后打开tomcat主页http://localhost:8080/ 点manager就会出现登录弹窗,这就说明用户添加成功了。
pom.xml文件
pom.xml文件相当于配置maven打包策略的脚本,先看一个最终弄好的:
<modelVersion>4.0.0</modelVersion>
<groupId>com.posedge_clk</groupId>
<artifactId>Demo</artifactId>
<packaging>war</packaging>
<version>0.0.1-SNAPSHOT</version>
<name>Demo Maven Webapp</name>
<url>http://maven.apache.org</url>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version>
<scope>provided</scope>
</dependency>
</dependencies>
<build>
<finalName>Demo</finalName>
<plugins>
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.2</version>
<configuration>
<url>http://localhost:8080/manager/text</url>
<server>pc_tomcat</server>
<username>admin</username>
<password>123456</password>
</configuration>
</plugin>
</plugins>
</build>
最上面6行是maven工程的一些基本信息,在新建maven工程时填好会自动生成(一开始不知道要建maven工程,我都是手动写的- -)。dependencies是工程的一些依赖,相当于导入jar包。这里这个javax.servlet包好像需要依赖,不然访问servlet时会出现找不到class的情况。这块不清楚,我没有再实验了,反正以后写上吧,又不费事。与部署有关的是build部分。先加入tomcat7-maven-plugin这个插件,我本地用的是tomcat9,这个插件也是可以用的。configuration里填入tomcat的地址,用户名,密码。至于<server>pc_tomcat</server>
这个下文再说。
安装maven
本来配置完pom.xml就完事了,那么按哪个按钮是部署呢?仔细研究了网上的教程才知道,还要安装maven呀。。
maven的安装很简单,官网下载压缩包,解压之后配置环境变量就行了。为什么不详细写呢,因为我现在忘了。。以后用的时候再上网查吧。有一个坑好像是在path里,那个%M2_HOME%\bin一定要写在%JAVA_HOME%\bin后面,一开始我写在最后好像就用不了???后来写在了%JAVA_HOME%\bin的下一行就行了。不知道是当时操作失误了还是这个就这么配置的,总觉得“必须在下一行”这个设定应该是不存在的吧。
部署服务
配置server
装好maven,在目录下找到/conf/settings.xml里面加入服务器信息:
<server>
<id>pc_tomcat</id>
<username>admin</username>
<password>123456</password>
</server>
这个就是上文pom.xml里的server。这个相当于预存了服务器信息,再pom文件里直接<server>pc_tomcat</server>
就相当于填写了账号与密码。当然,不设置这个,直接在pom里写账号和密码也是可以的。
部署
打开windos cmd,cd到web工程的根目录下。输入mvn clean install
这两个指令的功能在执行后输出中体现的很明显了,clean大概是清除上次build产生的文件,install大概是build一次的意思。
之后输入mvn tomcat7:redeploy
就将服务部署到tomcat上啦。redeploy是再次部署,deploy是第一次部署,不过好像一直用redeploy就行了。undeploy是卸载服务。
其实eclipse里右键工程-run as-maven build...,在goals里也可以直接执行mvn命令,但是eclipse里那个console框看起来不舒服,直接cmd里跑,看输出爽一些。
创建maven工程
部署好了,发现webapps里也确实有东西了,访问一下报500错误。点进工程里看看,classes里没东西。。。。经过一番查找知道了,要建maven工程,这样maven打包的时候才能按照web工程的结构打包,eclipse里有把老工程转换成maven工程的选项,但是转完好像还是不好用,所以我这里就直接新建了。
直接filie-new-maven project,这个界面选webapp。
这个界面就是pom.xml文件里的前几行配置了:
finish之后右键工程,选属性,在maven配置里可以选这三个东西的版本。
网上一些教程说要先取消dynamic web module的勾,然后把java换到1.8,再勾上dynamic web module,然后修改dynamic web module的配置。我没有这么弄,我是直接用默认的,后来工程报错说一些东西java1.5不支持,我直接改到1.8了。中间这三个东西的版本确实遇到了一些麻烦,不过那个和具体代码有关,只试试最简单的工程好像默认的这个配置就可以用。
最后用maven部署一下,终于可以用啦。
正常部署顺序
上面是一些流水账,最后总结一下在本地实验maven web工程部署的过程。
- tomcat配置用户;
- 安装maven,配置server;
- 新建maven web工程;
- pom.xml中配置tomcat的地址,用户名,密码;
- 把老工程的java文件,web.xml文件都移植进去,根据错误把缺的包都添加依赖;
- mvn clean install;mvn tomcat7:redeploy完成部署。