在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文件.
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的依赖
javax.servlet javax.servlet-api 3.1.0 provided
javax.servlet.jsp jsp-api 2.1 provided
完整的pom.xml文件:
4.0.0 com.fs myUser-web 1.0-SNAPSHOT war myUser-web Maven Webapp http://www.example.com UTF-8 1.8 1.8 javax.servlet javax.servlet-api 3.1.0 provided javax.servlet.jsp jsp-api 2.1 provided myUser-web maven-clean-plugin 3.1.0 maven-resources-plugin 3.0.2 maven-compiler-plugin 3.8.0 maven-surefire-plugin 2.22.1 maven-war-plugin 3.2.2 maven-install-plugin 2.5.2 maven-deploy-plugin 2.8.2
如上述代码所示, user-web的packaging元素的值为war,表示这是一个web项目,需要以war方式进行打包,user-web依赖于servlet-api和jsp-api这两个几乎所有的Web项目都要依赖的包,它们为servlet和jsp的编写提供支持,需要注意的是,这两个依赖范围是provided,表示它们最终不会被打包到War文件中,这是因为几乎所有的Web服务器都会提供这两个类库,如果war包中重复出现,就会导致潜在的依赖冲突问题.