[转]Java Web笔记：搭建环境和项目配置（MyEclipse 2014 + Maven + Tomcat）

来源：http://www.jianshu.com/p/56caa738506a

0. 绪言

Java Web开发中，除了基础知识外，开发环境搭建，也是一项基本功。开发环境包括了IDE、项目管理、项目架构组织、依赖管理等等，以及简单的测试。能够熟练的搭建出Java Web的开发环境，也能够提现开发者Java Web的开发功底，如Maven依赖管理的使用，项目组织结构的清晰程度，都能体现开发者素质。

环境搭建过程比较简单，但是基于Maven的Java Web项目，在MyEclipse这个IDE下创建时，需要做一些自主的调整。

1. 环境参数

MyEclipse

MyEclipse Spring 2014 GA （很多人不懂GA，General Availability，正式发布的版本），Spring版本增加了Spring插件，装标准版、Pro版也可以。如果没有必要，就不用装blue版本和bling了。

其他

JDK 1.7
Maven 3.3.3
Tomcat 8

2. 安装

配置Java开发环境

下载安装JDK 1.7,JRE 7
配置环境变量：
（1）新建 JAVA_HOME
D:\Java\jdk1.7.0_17
（2）新建JAVA_CLASSPATH
.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar
（3）添加Path
.;%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;
注意了，JRE环境变量慎重添加，小心Tomcat启动错误。

Maven

下载，解压到常用目录，尽量简洁的路径。
我的路径：D:\apache-maven-3.3.3

安装MyEclipse

下载标准版，或者Spring版本，选择稳定的，我用的是2014版本，之前一直用2010版本，都挺好用的。
安装完成即可。

Tomcat

下载，解压到常用目录，尽量简洁的路径。
我的路径：D:\apache-tomcat-8.0.23

3. MyEclipse的Maven配置

启动MyEclipse，配置Maven：Window -> Preferences -> MyEclipse -> Maven4MyEclipse
所有的配置都在此处完成。

添加Maven

配置JDK：

Maven配置JDK.png

Installations中：

添加Maven.png

通过Add，添加自己的Maven，配置文件会自动识别获取到。
User Settings中：

配置参数文件.png

完成配置后即可使用。

Tomcat配置

Window -> Preferences -> MyEclipse -> Servers -> Tomcat

Tomcat配置.png

选择Tomcat主目录：

Tomcat配置参数.png

完成配置。

4. Java Web on Maven项目建立

Java Web on Maven项目，有两种方式建立，与IntelliJ IDEA不同，MyEclipse默认并不是基于Maven进行项目管理的，而是使用自己的项目管理方式。因此，此处有两种方式建立项目：
·建立一个Java Web Project，引入Maven（推荐，快捷）
·建立一个Maven Project，引入J2EE

建立一个Java Web Project 并 引入 Maven

Java Web提供了Java Web所需要的各类文件和文件目录，但是并没有提供Maven，所以需要进行适当的引入。

这种方式建立的项目，有着Maven的结构，采用Maven管理包，但实质上是一个Java Web项目。不过从本实际效果看，和第二种方法是一致的。

新建Java Web项目

新建Java Web项目.png

进入向导：

建立项目.png

Next... Next....

选择添加web.xml.png

Next...

目录结构选择.png

推荐选择标准Maven项目结构，图中虽然是选在第一个，但是实际上选了第二个，不再重复截图了。

创建完成.png

最终创建成功，项目结构如图：

Java Web 项目引入Maven管理.png

建立一个 Maven Project 并 引入J2EE

这种方式建立的项目，是一个Maven项目，增加了对Java Web的相关支持，补充了各类配置参数文件和目录。与前一种方法所达到的效果是相同的。

通过建立Maven项目，然后将J2EE引入到项目中，添加必要的目录结构等。
新建项目：

新建Maven项目.png

使用filter筛选：

选择Maven.png

需要选择一个archetype：输入webapp筛选，可能一开始没有加载出来，稍微等等：

没加载出来的.png

MyEclipse玩命的在处理.png

archetype加载成功.png

如图，选择webapp-javaee的6或者7，此处选择7，Next...

Maven参数.png

Finish完成项目建立。
完成建立项目如图：

项目结构.png

里面有个错误，新建项目就有错误，有意思：
Plugin execution not covered by
lifecycle configuration:
org.apache.maven.plugins:maven-dependency-plugin:2.6:copy (execution:
default, phase: validate)
说是有个plugin有问题：

maven-dependency-plugin问题.png

解决办法是给这个plugin单独包一下：

<build>
    <pluginManagement>
        <plugins>
            <plugin> ... </plugin>
            <plugin> ... </plugin>
                  ....
        </plugins>
    </pluginManagement>
</build>

使用子项目添加方式，解决问题.png

错误解决了，Maven项目建立成功。

从前面项目结构图中，可以看到，Maven项目具有的特征目录结构与在Java Web项目基础上引入Maven包管理基本一致，但还是有比较多的细节差别，下面将一一补充。

补充目录

补充
src/main/resources
src/main/webapp/WEB-INF
src/main/webapp/WEB-INF/classes
src/main/webapp/META-INF
src/test/resources
src/test/webapp

补充后的目录结构.png

目录增加后，跟build path设置：

选择配置.png

增加对应的目录，如果你之前不是增加的sources folder：

增加源目录.png

配置输出目录：

配置输出目录.png

最终结果：

配置结果.png

此时基本上就配置完成了。

5. 项目其他配置

参考网上大牛们的经验，有如下一些经验配置，感谢各位大牛提供的宝贵经验，在此不一一列举。

常用包pom配置

spring包

    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-web</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>4.1.1.RELEASE</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-beans</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-jdbc</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-tx</artifactId>
        <version>${spring.version}</version>
    </dependency>

servlet

    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.1.0</version>
    </dependency>

数据相关操作

数据库操作，MySQL、iBatis

    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.37</version>
    </dependency>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis-spring</artifactId>
        <version>${mybatis-spring-version}</version>
    </dependency>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>${mybatis-version}</version>
    </dependency>
    <dependency>
        <groupId>org.mybatis.generator</groupId>
        <artifactId>mybatis-generator-core</artifactId>
        <version>1.3.2</version>
    </dependency>

数据源配置

    <dependency>
        <groupId>com.mchange</groupId>
        <artifactId>c3p0</artifactId>
        <version>0.9.5.1</version>
    </dependency>

json操作

    <dependency>
       <groupId>com.alibaba</groupId>
       <artifactId>fastjson</artifactId>
       <version>1.2.1</version>
    </dependency>

测试包

    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.11</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-test</artifactId>
        <version>4.1.1.RELEASE</version>
        <scope>test</scope>
    </dependency>

日志包

    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>${log4j-version}</version>
    </dependency>
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-log4j12</artifactId>
        <version>${slf4j-version}</version>
    </dependency>
      <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-api</artifactId>
        <version>${slf4j-version}</version>
    </dependency>

其他

    <dependency>
       <groupId>org.apache.commons</groupId>
       <artifactId>commons-lang3</artifactId>
       <version>3.3</version>
    </dependency>

web.xml

web.xml配置中，一些比较常见的配置。

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" id="WebApp_ID" version="3.1">
  <display-name>Maven4JavaWebProjectDemo</display-name>
  <welcome-file-list>
    <welcome-file>index.html</welcome-file>
    <welcome-file>index.htm</welcome-file>
    <welcome-file>index.jsp</welcome-file>
    <welcome-file>default.html</welcome-file>
    <welcome-file>default.htm</welcome-file>
    <welcome-file>default.jsp</welcome-file>
  </welcome-file-list>
  <servlet>
        <servlet-name>Maven4JavaWebProjectDemo</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring/applicationContext.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>Maven4JavaWebProjectDemo</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
    <filter>
        <filter-name>encodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
        <init-param>
            <param-name>forceEncoding</param-name>
            <param-value>true</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>encodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
    <session-config>
        <session-timeout>60</session-timeout>
    </session-config>
</web-app>

注册了一个servlet，是org.springframework.web.servlet.DispatcherServlet前端控制器，同时给这个servlet前端控制器分配了servlet-mapping。此处，给DispatcherServlet分配的映射是/，即所有的请求。同时，此处指定了Spring的DispatcherServlet的配置文件所在位置：classpath:spring/applicationContext.xml。
跟着网上大牛学习，spring配置：

  <servlet>
        <servlet-name>Maven4JavaWebProjectDemo</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring/applicationContext.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

applicationContext.xml

位于src/main/resources/spring/目录下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans-3.0.xsd">
     <import resource="classpath:spring/applicationContext-mvc.xml" />
</beans>

该配置中，import了外部文件，用于配置mvc内容，位置与其在相同目录：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
       http://www.springframework.org/schema/context
       http://www.springframework.org/schema/context/spring-context-3.0.xsd
       http://www.springframework.org/schema/mvc
       http://www.springframework.org/schema/mvc/spring-mvc.xsd"
       default-lazy-init="true">
    <context:component-scan base-package="com.hgr.Maven4JavaWebProjectDemo"/>
    <mvc:resources location="/WEB-INF/pages/" mapping="/pages/**"/>
    <!-- 视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/pages/"/>
        <property name="suffix" value=".jsp"/>
    </bean>
    <!-- 默认的注解映射的支持 -->
    <mvc:annotation-driven>
        <mvc:message-converters register-defaults="true">
            <bean class="com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter">
                <property name="supportedMediaTypes">
                    <list>
                        <value>text/plain;charset=utf-8</value>
                        <value>application/json;charset=utf-8</value>
                        <value>application/x-www-form-urlencoded</value>
                    </list>
                </property>
            </bean>
        </mvc:message-converters>
    </mvc:annotation-driven>
</beans>

项目输出配置：

WEB输出配置.png

6. 部署

可以Debug As，也可以Run As：

部署运行.png

选择之前配置的Server：

选择Server.png

Tomcat的webapp下部署成功：

文件目录.png

测试运行：

运行结果.png

跟着大牛学习，参考来自：嘟嘟MD