笔记：Maven Web项目

• 生成Web项目模块

  生成Web项目模板和生成其他项目的模板一致，差别是指定模板的类型，执行命令如下：

  mvn archetype:generate -DarchetypeArtifactId=maven-archetype-webapp

  命令结果：

  输入 groupId、artifactId、version后 Maven 会生成 Web项目结构

  

• 项目POM配置

  Web和其他项目的差别就是在打包格式，普通项目的打包格式为 JAR，而Web项目的打包格式为WAR，配置差异如下：

  <packaging>war</packaging>

• 项目目录

目录路径	说明
src/main/java	Java 源代码目录
src/main/resources	资源目录
src/main/filters	资源过滤文件目录
src/main/config	配置文件目录跟
src/main/webapp	Web 站点目录，必须WEB-INF子目录及WEB-INF子目录需要包含 web.xml配置文件
src/test/java	测试代码目录
src/test/resources	测试资源目录
src/test/filters	测试资源过滤文件目录
pom.xml	Maven2 配置文件

• 打包WAR名称配置

  默认打包WAR文件名称的设定规则值为 ${project.artifactId}-${project.version}，生成的文件名过长，在部署后需要输入冗长的地址，因此我们需要名字更为简洁的war包，可以配置 finalName 元素来修改，配置如下：

  <build>

  <finalName>drsoft</finalName>

  </build>

  执行打包命令：

  mvn clean package

  命令结果：

  

• 自动部署至本地Web容器

  可以使用Maven的插件来完成自动部署，Cargo 插件支持二种本地部署的方式，分别为 standalone 模式和existing 模式，在 standalone模式中，Cargo会从Web容器的安装目录复制一份配置到用户指定的目录，然后在此基础上部署应用，每次重新构建将清除目录；existing模式则用户需要指定现有的Web容器配置目录，然后Cargo会直接使用这些配置并将应用部署其对应位置。

  • existing模式

    <plugin>

        <groupId>org.codehaus.cargo</groupId>

        <artifactId>cargo-maven2-plugin</artifactId>

        <version>1.6.2</version>

        <configuration>

            <container>

                <!-- 容器唯一标识 -->

                <containerId>tomcat8x</containerId>

                <!-- Tomcat 安装路径 -->

                <home>D:\Developers\apache-tomcat-8.0.39</home>

            </container>

            <configuration>

                <!-- 部署类型 -->

                <type>existing</type>

                <!-- Tomcat 安装路径 -->

                <home>D:\Developers\apache-tomcat-8.0.39</home>

            </configuration>

        </configuration>

    </plugin>

  • standalone模式

    <plugin>

        <groupId>org.codehaus.cargo</groupId>

        <artifactId>cargo-maven2-plugin</artifactId>

        <version>1.6.2</version>

        <configuration>

            <container>

                <!-- 容器唯一标识 -->

                <containerId>tomcat8x</containerId>

                <!-- Tomcat 安装路径 -->

                <home>D:\Developers\apache-tomcat-8.0.39</home>

            </container>

            <configuration>

                <!-- 部署类型 -->

                <type>standalone</type>

                <!-- Tomcat 安装路径 -->

                <home>${project.build.directory}/tomcat8x</home>

            </configuration>

        </configuration>

    </plugin>

  • 常用命令

命令	说明
mvn cargo:start	启动容器，生命周期依赖于maven实例的生命周期，maven构建成功或者失败之后，cargo插件的生命周期也自动停止了
mvn cargo:run	启动容器，如果项目的类型为JavaEE，则会部署到容器
mvn cargo:stop	停止容器
mvn cargo:restart	停止并重新启动容器
mvn cargo:redeploy	部署到远程服务器，必须保证 Tomcat 是运行状态

• 自动部署到远程Web容器

  部署到Tomcat服务器，需要使用
  tomcat7-maven-plugin
  插件来实现，在执行部署时，必须启动
  Tomcat，配置信息如下：

  • Tomcat
    的用户配置：

    在
    Tomcat
    的安装目录下的
    conf/tomcat-users.xml
    配置文件，增加用户和权限配置：

    <?xml version='1.0' encoding='utf-8'?>

    <tomcat-users
    xmlns="http://tomcat.apache.org/xml"

                                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

                                xsi:schemaLocation="http://tomcat.apache.org/xml tomcat-users.xsd"

                                version="1.0">

     
     

        <role
    rolename="manager-gui"/>

        <role
    rolename="manager-script"/>

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

    </tomcat-users>

  • 项目POM配置：

    <plugin>

        <groupId>org.apache.tomcat.maven</groupId>

    <!-- 支持 Tomcat7 和 Tomcat 8 -->

        <artifactId>tomcat7-maven-plugin</artifactId>

        <version>2.2</version>

        <configuration>

    <!--
    Tomcat 的管理地址 -->

            <url>http://localhost:8080/manager/text</url>

            <server>tomcat8x</server>

        </configuration>

    </plugin>

  • 增加Tomcat服务器登录信息：

    <server>

          <id>tomcat8x</id>

          <username>tomcat</username>

          <password>liyong</password>

    </server>

  • 执行命令：

命令	说明
mvn tomcat7:deploy	执行第一次部署
mvn tomcat7:redeploy	执行覆盖部署

注意：查看插件所有的命令可以执行 mvn help:decribe -Dplugin=org.apache.tomcat.maven:tomcat7-maven-plugin