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.它们会包含对应的文件供页面使用.
1

​ 同其他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的依赖

  
<dependency>
    <groupId>javax.servletgroupId>
    <artifactId>javax.servlet-apiartifactId>
    <version>3.1.0version>
    <scope>providedscope>
dependency>

<dependency>
    <groupId>javax.servlet.jspgroupId>
    <artifactId>jsp-apiartifactId>
    <version>2.1version>
    <scope>providedscope>
dependency>
1
2
3
4
5
6
7
8
9
10
11
12
13
14

完整的pom.xml文件:

<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.0modelVersion>
	<groupId>com.fsgroupId>
    <artifactId>myUser-webartifactId>
     <version>1.0-SNAPSHOTversion>
    <packaging>warpackaging>

    <name>myUser-web Maven Webappname>
    
    <url>http://www.example.comurl>

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

    <dependencies>
        
        <dependency>
            <groupId>javax.servletgroupId>
            <artifactId>javax.servlet-apiartifactId>
            <version>3.1.0version>
            <scope>providedscope>
        dependency>
        
        <dependency>
            <groupId>javax.servlet.jspgroupId>
            <artifactId>jsp-apiartifactId>
            <version>2.1version>
            <scope>providedscope>
        dependency>
    dependencies>

    <build>
        <finalName>myUser-webfinalName>
        <pluginManagement>
            <plugins>
                <plugin>
                    <artifactId>maven-clean-pluginartifactId>
                    <version>3.1.0version>
                plugin>
                
                <plugin>
                    <artifactId>maven-resources-pluginartifactId>
                    <version>3.0.2version>
                plugin>
                <plugin>
                    <artifactId>maven-compiler-pluginartifactId>
                    <version>3.8.0version>
                plugin>
                <plugin>
                    <artifactId>maven-surefire-pluginartifactId>
                    <version>2.22.1version>
                plugin>
                <plugin>
                    <artifactId>maven-war-pluginartifactId>
                    <version>3.2.2version>
                plugin>
                <plugin>
                    <artifactId>maven-install-pluginartifactId>
                    <version>2.5.2version>
                plugin>
                <plugin>
                    <artifactId>maven-deploy-pluginartifactId>
                    <version>2.8.2version>
                plugin>
            plugins>
        pluginManagement>
    build>
project>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

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