maven学习： 使用Maven构建Web项目

5.1 Maven中Web项目的结构

​ 在java的世界中，Web应用占有很大的地位，而它的标准打包方式是WAR。WAR与JAR类似，但它包含了更多内容，如JSP文件、Servlet、web.xml配置文件、静态web资源（如html，css，js）等。一个典型的WAR文件会有如下的目录结构:

	一个WAR包下至少包含两个子目录:META-INF和WEB-INF.前者包含了一些打包元数据信息.我们一般不去关心;后者是WAR包的核心,WEB-INF下必须包含一个Web资源文件:web.xml,它的子目录classes包含所有该web项目的类的class文件,而另外一个子目录lib则包含所有该WEB项目的依赖的jar包,classes和lib目录都会在运行的时候被加入到Classpath中,除了META-INF和WEB-INF外,一般的WAR包都会包含很多Web资源,比如html文件,jsp文件等.还能看到一些文件夹:img,css,js.它们会包含对应的文件供页面使用.

​ 同其他Maven项目一样,Maven对Web项目的布局结构也有一个约定,不过要记住的是,打包方式为war,pom文件如下图:

​ Web项目的类以及资源文件同一般JAR项目一样,默认位置都是在src/main/java和src/main/resources,测试类及测试资源文件的默认位置是src/test/java/和src/test/resources.Web项目比较特殊的地方在于:它还有一个Web资源目录,默认位置是src/main/webapp/.一个典型的Web项目的Maven目录结构如下:

​ 在src/main/webapp/目录下,必须包含一个子目录WEB-INF,该子目录还必须要包含web.xml文件.src/main/webapp目录下的其他文件和目录可以包括:html,jsp,js,css等.

​ 在使用Maven创建web项目之前,必须首先理解这种Maven项目结构和WAR包结构的对应关系,有一点需要注意的是:WAR包中包含的一个lib目录是用来放所依赖的jar,但是在Maven项目结构中没有这样一个目录,这是因为依赖的都配置在pom文件中,Maven在用WAR方式打包的时候会根据POM的配置从本地仓库复制相应的JAR文件.

5.2 idea创建maven的web项目

idea创建web项目：

创建web的项目结构:

我们发现此时的web项目有如下问题:

第一个问题: 自动生成的web.xml的版本: 2.3 修改为3.0

解决方案:

第二个问题：没有src/main/java src/main/resources src/test/java 这个三个目录, 需要手动创建

第三个问题: 配置tomcat环境

​ web项目添加servlet-api的依赖, jsp-api的依赖

  <!-- servlet-api -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>3.1.0</version>
    <scope>provided</scope>
</dependency>
<!-- jsp-api -->
<dependency>
    <groupId>javax.servlet.jsp</groupId>
    <artifactId>jsp-api</artifactId>
    <version>2.1</version>
    <scope>provided</scope>
</dependency>

完整的pom.xml文件:

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
	<groupId>com.fs</groupId>
    <artifactId>myUser-web</artifactId>
     <version>1.0-SNAPSHOT</version>
    <packaging>war</packaging>

    <name>myUser-web Maven Webapp</name>
    <!-- FIXME change it to the project's website -->
    <url>http://www.example.com</url>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
    </properties>

    <dependencies>
        <!-- servlet-api -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
            <scope>provided</scope>
        </dependency>
        <!-- jsp-api -->
        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
            <version>2.1</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>

    <build>
        <finalName>myUser-web</finalName>
        <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
            <plugins>
                <plugin>
                    <artifactId>maven-clean-plugin</artifactId>
                    <version>3.1.0</version>
                </plugin>
                <!-- see http://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_war_packaging -->
                <plugin>
                    <artifactId>maven-resources-plugin</artifactId>
                    <version>3.0.2</version>
                </plugin>
                <plugin>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>3.8.0</version>
                </plugin>
                <plugin>
                    <artifactId>maven-surefire-plugin</artifactId>
                    <version>2.22.1</version>
                </plugin>
                <plugin>
                    <artifactId>maven-war-plugin</artifactId>
                    <version>3.2.2</version>
                </plugin>
                <plugin>
                    <artifactId>maven-install-plugin</artifactId>
                    <version>2.5.2</version>
                </plugin>
                <plugin>
                    <artifactId>maven-deploy-plugin</artifactId>
                    <version>2.8.2</version>
                </plugin>
            </plugins>
        </pluginManagement>
    </build>
</project>

​ 如上述代码所示, user-web的packaging元素的值为war,表示这是一个web项目,需要以war方式进行打包,user-web依赖于servlet-api和jsp-api这两个几乎所有的Web项目都要依赖的包,它们为servlet和jsp的编写提供支持,需要注意的是,这两个依赖范围是provided,表示它们最终不会被打包到War文件中,这是因为几乎所有的Web服务器都会提供这两个类库,如果war包中重复出现,就会导致潜在的依赖冲突问题.