使用IDE版本：eclipse kepler（4.3），eclipse mars（4.5.2），maven（写文档时主要使用3.2.1，目前在切换3.3.9暂未发现问题）

tip：eclipse kepler对应jdk版本1.7，eclipse luna对应jdk版本1.8。

(csdn这个编辑器上传图片太麻烦了……从自己的知识库复制了好一会过来，发表之后图片都不见了……！抽空再完善图片吧……)

一 安装maven插件

1 eclipse安装maven插件

http://maven.apache.org/download.cgi  （http://apache.fayea.com/maven/maven-3/3.3.9/binaries/apache-maven-3.3.9-bin.tar.gz 
）下载maven，解压到相应的位置。

2 window-preferences-maven，Installations

"Add"->选择解压存放的目录。

3 修改配置文件：

3.1 修改新的库文件存放位置

3.2 maven自带的jdk版本较低，修改默认的jdk版本。

3.3 修改eclipse中maven配置文件的引用位置

二 创建Java web项目

1 New Project-> Maven -> Maven Project，点击“下一步”

2  选择项目路径。使用默认的WorkSpace location。“Next”下一步。

3  Select an Archetype选择工程类型。在Fileter中，输入webapp，选中Artifact Id为maven-archetype-webapp的项。然后“Next”下一步。

4  输入Group ID、Artifact ID、Package。

Group Id中一般填写com.公司名；Artifact Id 为工程名。

Group ID：组ID，当有多个项目相互依赖时，创建在一个Group下。总项目名称。

Artifact ID：子项目名称。即当前项目名称，相当于不使用Maven时的ProjectName。

Package：默认创建一个包，也可以不写。

“Finish”完成。

三 初始配置

1 JSP解析错误。

如图：这是因为没有servlet环境。

解决方法：右键工程-->Properties-->Project Facets，最面边的面板，选择Runtimes，选中tomcat服务。“Apply”应用配置。

2 Dynamic Web Module版本不能修改的问题

不难发现，默认的jdk版本和Dynamic Web Module版本不对。

2.1 修改JDK版本：java后面的版本，改为匹配的1.7，可以正常修改，没有问题。

2.2 直接修改Dynamic Web Module版本，则报错，并且不能修改，如下：

这是因为Maven的默认配置。该版本的Maven默认使用jdk1.5，对应的web版本是2.3。查到的解决办法有两种，这里采用了修改项目配置的方式解决：

打开pom.xml，在build的finalName下面，添加依赖

<plugins>
         <plugin>
                   <groupId>org.apache.maven.plugins</groupId>
                   <artifactId>maven-compiler-plugin</artifactId>
                   <version>3.1</version>
                   <configuration>
                            <source>1.7</source>
                            <target>1.7</target>
                   </configuration>
         </plugin>
</plugins>

保存后，项目会报错，提示更新maven project。

修改pom.xml后，一般都需要更新maven project。即右键项目，选择Maven-->Update Project...

遇到问题：如果网络比较慢，更新会很长时间，也不会停止。

解决办法：在网络比较通畅的地方执行该操作。或者，本地有正常运行的maven工程（即已经有maven的依赖库）这时，强制将进程结束。在

Window-->Properties-->Maven中，将offline选中。就可以通过本地库完成update操作了。

tip：两种修改Maven依赖的jdk版本的方式

tip1: 在1.2中引用的配置文件settings.xml中，修改maven全局jdk。（对当前项目无效，修改以后创建的工程，则自动使用该版本的jdk。）

<profiles>
      <profile>
           <id>jdk1.7</id>
           <activation>
               <activeByDefault>true</activeByDefault>
               <jdk>1.7</jdk>
           </activation>
           <properties>
               <maven.compiler.source>1.7</maven.compiler.source>
               <maven.compiler.target>1.7</maven.compiler.target>
               <maven.compiler.compilerVersion>1.7</maven.compiler.compilerVersion>
           </properties>
   </profile>

tip2: 修改项目pom.xml

在build-finalName下面，添加如下的plugin。

    <build>
        <finalName>base</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.1</version>
                <configuration>
                    <source>1.7</source>
                    <target>1.7</target>
                </configuration>
            </plugin>
        </plugins>
    </build>

2.3 这时回到properties-project facets，修改Dynamic Web Module版本，依然会报错。

解决方法：

A 先将Dynamic Web Module的版本选为3.0，然后将其前面checkbox的勾选去掉，点击”Apply“应用配置。如下：

B 再次选中Dynamic Web Module。”Apply“应用，配置完成。这时就不会报错了。

3 修改web.xml的版本

默认生成的web.xml版本是2.3dtd的。如下图：

修改为：

<?xml version="1.0"encoding="GBK"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
    id="WebApp_ID" version="3.0">

    <display-name>Archetype Created Web Application</display-name>
</web-app>

tip：关于web.xml

XML 元素是大小写敏感的。

XML元素出现的次序是敏感的。例如，XML头必须是文件中的第一项，DOCTYPE声明必须是第二项，而web- app元素必须是第三项。

在web-app元素内，元素的次序也很重要。下面的列表给出了所有可直接出现在web-app元素内的合法元素所必需的次序：

?  icon icon元素指出IDE和GUI工具用来表示Web应用的一个和两个图像文件的位置。

?  display-name display-name元素提供GUI工具可能会用来标记这个特定的Web应用的一个名称。

?  description description元素给出与此有关的说明性文本。

?  context-param context-param元素声明应用范围内的初始化参数。

?  filter 过滤器元素将一个名字与一个实现javax.servlet.Filter接口的类相关联。

?  filter-mapping 一旦命名了一个过滤器，就要利用filter-mapping元素把它与一个或多个servlet或JSP页面相关联。

?  listener servlet API的版本2.3增加了对事件监听程序的支持，事件监听程序在建立、修改和删除会话或servlet环境时得到通知。Listener元素指出事件监听程序类。

?  servlet 在向servlet或JSP页面制定初始化参数或定制URL时，必须首先命名servlet或JSP页面。Servlet元素就是用来完成此项任务的。

?  servlet-mapping 服务器一般为servlet提供一个缺省的URL：http://host/webAppPrefix/servlet/ServletName。但是，常常会更改这个URL，以便servlet可以访问初始化参数或更容易地处理相对URL。在更改缺省URL时，使用servlet-mapping元素。

?  session-config 如果某个会话在一定时间内未被访问，服务器可以抛弃它以节省内存。可通过使用HttpSession的setMaxInactiveInterval方法明确设置单个会话对象的超时值，或者可利用session-config元素制定缺省超时值。

?  mime-mapping 如果Web应用具有想到特殊的文件，希望能保证给他们分配特定的MIME类型，则mime-mapping元素提供这种保证。

?  welcom-file-list welcome-file-list元素指示服务器在收到引用一个目录名而不是文件名的URL时，使用哪个文件。

?  error-page error-page元素使得在返回特定HTTP状态代码时，或者特定类型的异常被抛出时，能够制定将要显示的页面。

?  taglib taglib元素对标记库描述符文件（Tag Libraryu Descriptor file）指定别名。此功能使你能够更改TLD文件的位置，而不用编辑使用这些文件的JSP页面。

?  resource-env-ref resource-env-ref元素声明与资源相关的一个管理对象。

?  resource-ref resource-ref元素声明一个资源工厂使用的外部资源。

?  security-constraint security-constraint元素制定应该保护的URL。它与login-config元素联合使用

?  login-config 用login-config元素来指定服务器应该怎样给试图访问受保护页面的用户授权。它与sercurity-constraint元素联合使用。

?  security-role security-role元素给出安全角色的一个列表，这些角色将出现在servlet元素内的security-role-ref元素的role-name子元素中。分别地声明角色可使高级IDE处理安全信息更为容易。

?  env-entry env-entry元素声明Web应用的环境项。

?  ejb-ref ejb-ref元素声明一个EJB的主目录的引用。

?  ejb-local-ref ejb-local-ref元素声明一个EJB的本地主目录的应用。

4 完善Maven工程目录

4.1 标准目录和自动生成的目录结构

标准的Maven工程目录结构

自动生成的目录如下图：

4.2 完善目录结构

目标：需要的source folder；src/main/java,src/main/resources,src/test/java,src/test/resources。

我们需要创建几个java resources目录。自动生成的两个resources，如下图。

右键项目根节点，选择New-->Source Folder打开新建对话框，来创建java resources目录。也可以通过右键”Java Resources”，选择New，打开创建Source Folder对话框，手动填写project name或者通过“Browse”选择项目。

NOT：这里一定是source folder，而不是普通的folder。如果是普通Folder，在2.4.5中，也提到了怎么变成source folder。

或：

新建对话框：

分别创建src/main/java和src/test/resources。

遇到问题：<填写中>Cannot nest ‘authority/src/main/java‘ inside ‘authority/src/main/‘. To enable the nesting exclude ‘java/‘ from ‘authority/src/main/‘。<填写完成>The folder is already a source folder.如下两张图所示：

问题原因及解决方法：

原因：在配置文件中，认为这些已经存在，但是实际并没有创建成功。

解决方法：右键项目-->Properties -->Java Build Path，选择Source标签项。把报错的目录（missing）删掉。然后再重新上面的创建步骤。

创建完成：。

4.3 调整目录显示顺序

右键项目-->Properties-->Java Build Path，选择“Order and Export”标签。调整java resources的显示顺序。

4.4 更改项目使用的JDK版本

右键项目-->Properties-->Java Build Path，选择“Libraries”标签。选中“JRE System Library”--“Edit”操作。使用

4.5 更改编译文件生成路径

右键项目-->Properties-->Java Build Path，选择“Source”标签。

选中Allow output folders for source folders，双击每个srouce folder的“Output folder”，确认或者修改成：

src/main/java，src/main/resources，生成到target/classes;

src/test/java ，src/test/resources，生成到target/test-classes;

tip：将普通Folder变为Source Folder

右键项目-->Properties-->Java Build Path，选择“Source”标签。执行“Add Folder”操作。

在对话框中，新建Folder或者选择已有的Folder，点击“OK”，即可。

4.6 设置部署程序集

右键项目-->Properties--> Web Deployment Assembly，这里设置的是，项目部署发布时，文件发布的位置。删除test目录的两项，因为test目录里的东西，不需要部署发布。

部署程序集配置应该是：

小结

我们的项目中，一般常用的目录结构：

maven的整体目录结构：