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

我就是我 2023-10-04 20:02 156阅读 0赞

#### 5.1 Maven中Web项目的结构 ####

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

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-aK6tn1AE-1669277225840)(assets/wps44.jpg)\]][img-aK6tn1AE-1669277225840_assets_wps44.jpg]

一个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文件如下图:

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-vKkIDUN3-1669277225841)(assets/wps45.jpg)\]][img-vKkIDUN3-1669277225841_assets_wps45.jpg]

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

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-tu4mDVOK-1669277225842)(assets/wps46.jpg)\]][img-tu4mDVOK-1669277225842_assets_wps46.jpg]

在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项目：  
![在这里插入图片描述][7b525d6de5e84d2ea2663b598699c712.png]  
![在这里插入图片描述][f5c46723e1cc43099a823df66bc2dac6.png]

创建web的项目结构:  
![在这里插入图片描述][808c6c0f8eff4b78ba108210b10ad58f.png]

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

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

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ZLCd2SBe-1669277225848)(assets/image-20211113111001103.png)\]][img-ZLCd2SBe-1669277225848_assets_image-20211113111001103.png]

**解决方案:**

![在这里插入图片描述][d0b1b40a41c643b5beec4cfc451ad052.png]

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-TngwQRza-1669277225850)(assets/image-20211113111451235.png)\]][img-TngwQRza-1669277225850_assets_image-20211113111451235.png]  
![在这里插入图片描述][784d40ac95d54484bf6bb9b8ccfc3849.png]  
![\]][252cfa47e3a44900964886ab415b31df.png]

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

![在这里插入图片描述][0f4a432f224f41d7bacf2d101fad9197.png]  
![在这里插入图片描述][56dff486549d42cb972de6cabfde010b.png]

**第三个问题: 配置tomcat环境**

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

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

![在这里插入图片描述][84bdffeefc204ea6bb4f5823b6acd818.png]  
![在这里插入图片描述][80d17fa6cb6c4981983949bd2364fab1.png]

**完整的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>
        
        <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>
            
            <dependency>
                <groupId>javax.servlet</groupId>
                <artifactId>javax.servlet-api</artifactId>
                <version>3.1.0</version>
                <scope>provided</scope>
            </dependency>
            
            <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>
                <plugins>
                    <plugin>
                        <artifactId>maven-clean-plugin</artifactId>
                        <version>3.1.0</version>
                    </plugin>
                    
                    <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包中重复出现,就会导致潜在的依赖冲突问题.**

[img-aK6tn1AE-1669277225840_assets_wps44.jpg]: https://img-blog.csdnimg.cn/8e8ffe8b660644989f759a6b203b2436.png
[img-vKkIDUN3-1669277225841_assets_wps45.jpg]: https://img-blog.csdnimg.cn/9de16288c07340c2a90850f936fc240b.png
[img-tu4mDVOK-1669277225842_assets_wps46.jpg]: https://img-blog.csdnimg.cn/2d22ba59ce78454691500980652a583d.png
[7b525d6de5e84d2ea2663b598699c712.png]: https://img-blog.csdnimg.cn/7b525d6de5e84d2ea2663b598699c712.png
[f5c46723e1cc43099a823df66bc2dac6.png]: https://img-blog.csdnimg.cn/f5c46723e1cc43099a823df66bc2dac6.png
[808c6c0f8eff4b78ba108210b10ad58f.png]: https://img-blog.csdnimg.cn/808c6c0f8eff4b78ba108210b10ad58f.png
[img-ZLCd2SBe-1669277225848_assets_image-20211113111001103.png]: https://img-blog.csdnimg.cn/f5c416e762c64c098c9ea201c1340a66.png
[d0b1b40a41c643b5beec4cfc451ad052.png]: https://img-blog.csdnimg.cn/d0b1b40a41c643b5beec4cfc451ad052.png
[img-TngwQRza-1669277225850_assets_image-20211113111451235.png]: https://img-blog.csdnimg.cn/b5347bb20fbb4c56850a242740e473d8.png
[784d40ac95d54484bf6bb9b8ccfc3849.png]: https://img-blog.csdnimg.cn/784d40ac95d54484bf6bb9b8ccfc3849.png
[252cfa47e3a44900964886ab415b31df.png]: https://img-blog.csdnimg.cn/252cfa47e3a44900964886ab415b31df.png
[0f4a432f224f41d7bacf2d101fad9197.png]: https://img-blog.csdnimg.cn/0f4a432f224f41d7bacf2d101fad9197.png
[56dff486549d42cb972de6cabfde010b.png]: https://img-blog.csdnimg.cn/56dff486549d42cb972de6cabfde010b.png
[84bdffeefc204ea6bb4f5823b6acd818.png]: https://img-blog.csdnimg.cn/84bdffeefc204ea6bb4f5823b6acd818.png
[80d17fa6cb6c4981983949bd2364fab1.png]: https://img-blog.csdnimg.cn/80d17fa6cb6c4981983949bd2364fab1.png