[转]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:
![](http://upload-images.jianshu.io/upload_images/1708416-dc77b86f4a2bff49.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
Installations中:
![](http://upload-images.jianshu.io/upload_images/1708416-83006b2c99558841.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/640)
通过Add,添加自己的Maven,配置文件会自动识别获取到。
User Settings中:
![](http://upload-images.jianshu.io/upload_images/1708416-be84ded5e3e9232e.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/640)
完成配置后即可使用。
Tomcat配置
Window -> Preferences -> MyEclipse -> Servers -> Tomcat
![](http://upload-images.jianshu.io/upload_images/1708416-d5309337249ed408.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/640)
选择Tomcat主目录:
![](http://upload-images.jianshu.io/upload_images/1708416-3d297a98538933d3.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/640)
完成配置。
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项目
![](http://upload-images.jianshu.io/upload_images/1708416-db5fb06cc9585639.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/640)
进入向导:
![](http://upload-images.jianshu.io/upload_images/1708416-f9f9774e012a4ab2.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/480)
Next... Next....
![](http://upload-images.jianshu.io/upload_images/1708416-38eddda4ae1ebfcc.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/480)
Next...
![](http://upload-images.jianshu.io/upload_images/1708416-e1a7c089e7c7e83f.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/480)
推荐选择标准Maven项目结构,图中虽然是选在第一个,但是实际上选了第二个,不再重复截图了。
![](http://upload-images.jianshu.io/upload_images/1708416-4a8f90f91fc2a7dc.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/480)
最终创建成功,项目结构如图:
![](http://upload-images.jianshu.io/upload_images/1708416-7a7e90235356dc76.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/480)
建立一个 Maven Project 并 引入J2EE
这种方式建立的项目,是一个Maven项目,增加了对Java Web的相关支持,补充了各类配置参数文件和目录。与前一种方法所达到的效果是相同的。
通过建立Maven项目,然后将J2EE引入到项目中,添加必要的目录结构等。
新建项目:
![](http://upload-images.jianshu.io/upload_images/1708416-e7ff17de51c170d7.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/640)
使用filter筛选:
![](http://upload-images.jianshu.io/upload_images/1708416-d3d087836e47ae3a.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/480)
需要选择一个archetype:输入webapp筛选,可能一开始没有加载出来,稍微等等:
![](http://upload-images.jianshu.io/upload_images/1708416-a81cd9d0bde31a12.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/480)
![](http://upload-images.jianshu.io/upload_images/1708416-eafaa27173836773.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/360)
![](http://upload-images.jianshu.io/upload_images/1708416-fb208d97abc053fb.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/640)
如图,选择webapp-javaee的6或者7,此处选择7,Next...
![](http://upload-images.jianshu.io/upload_images/1708416-4083c904efc2eae3.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/640)
Finish完成项目建立。
完成建立项目如图:
![](http://upload-images.jianshu.io/upload_images/1708416-351930936ec2f392.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/640)
里面有个错误,新建项目就有错误,有意思:
Plugin execution not covered by
lifecycle configuration:
org.apache.maven.plugins:maven-dependency-plugin:2.6:copy (execution:
default, phase: validate)
说是有个plugin有问题:
![](http://upload-images.jianshu.io/upload_images/1708416-c3b12ea3fa63979b.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/640)
解决办法是给这个plugin单独包一下:
<build>
<pluginManagement>
<plugins>
<plugin> ... </plugin>
<plugin> ... </plugin>
....
</plugins>
</pluginManagement>
</build>
![](http://upload-images.jianshu.io/upload_images/1708416-8790d2b51692c475.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/640)
错误解决了,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
![](http://upload-images.jianshu.io/upload_images/1708416-c8b7cdac067d4699.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/640)
目录增加后,跟build path设置:
![](http://upload-images.jianshu.io/upload_images/1708416-19d27a7d8e6e2737.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/640)
增加对应的目录,如果你之前不是增加的sources folder:
![](http://upload-images.jianshu.io/upload_images/1708416-374990976c57543c.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/720)
配置输出目录:
![](http://upload-images.jianshu.io/upload_images/1708416-ac10ecdb1741dd4b.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/720)
最终结果:
![](http://upload-images.jianshu.io/upload_images/1708416-b8fbdee0378ba0bc.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/640)
此时基本上就配置完成了。
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>
项目输出配置:
![](http://upload-images.jianshu.io/upload_images/1708416-3f7da446125e78fc.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/640)
6. 部署
可以Debug As,也可以Run As:
![](http://upload-images.jianshu.io/upload_images/1708416-37386d222a28acdb.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/480)
选择之前配置的Server:
![](http://upload-images.jianshu.io/upload_images/1708416-738ad381959227c1.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/360)
Tomcat的webapp下部署成功:
![](http://upload-images.jianshu.io/upload_images/1708416-6d92a5cfae011924.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/360)
测试运行:
![](http://upload-images.jianshu.io/upload_images/1708416-6ae6c31ba8bae91a.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/640)
跟着大牛学习,参考来自:嘟嘟MD