使用Eclipse新建SpringMVC项目的文章不少,按照文章一步一步操作,总会发现有不一样的地方,因此决定详细记录一次自己在eclipse中通过maven构建SpringMVC项目的过程。
一、前提条件
- jdk的安装与配置
- eclipse
- tomcat下载与在eclipse中的配置
- maven的下载与在eclipse中的配置
上面4个条件很简单,而且网上的配置教程很多且大同小异不容易引起歧义,这里就不再介绍。
二、构建项目
在Eclispe中,菜单操作:File -> New -> Maven Project,弹出如下的窗口
选择第二项,然后点击next上一步之后,来到新的窗口
在Filter中输入“webapp”,然后选择Artifact Id为“maven-archetype-webapp”一项,然后点击next上一步之后,来到如下窗口
根据自己的需求,输入我框起来的两项,点击Finish。
经过前3步,已经通过maven建立了一个web项目,但是存在错误且需要进行额外配置,项目结构如下图所示:
可以看出index.jsp中有错误,且没有src/main/java、src/test/java目录。在eclipse中选中项目名称,右键选择弹出菜单中的最后一项Properties,弹出如下窗口:
我们要在这个窗口做一个修改和一个添加:
(1) 修改:选中 JRE System Library,然后点击右侧的 Edit按钮,到如下界面
选中本机安装的jdk,然后Finish;
(2) 添加:此时我们又回到了上一步中的界面,
点击右侧的 Add Library,来到如下界面
选中 Server Runtime,然后next,来到新的界面
这里是我们在eclipse中配置的Tomcat,选中自己的配置,就可以Finish了。
此时,我们得到项目目录变了,如下
src/main/java、src/test/java目录都有了。
但是,此时并没有结束,打开web.xml文件
版本为2.3,一般情况下为2.5、3.0的,因此需要修改,下面还得接着操作。删除web.xml文件,勇敢大胆地删除。选中项目名,右键再次选择最后一项Properties,不过这次我们操作的下图中框中的部分
点击Project Facts后,看到Dynamic Web Module,确实跟已经被删除的web.xml中的版本一致。将Dynamic Web Module前面的勾选取消,然后点击右下角的Apply
然后,我们将Dynamic Web Module的version通过下拉菜单修改为3.0,然后再次勾选Dynamic Web Module,此时在下面会有一个提示,如下图
点击提示,来到下图
将Content directory修改为src/main/webapp
重要的来了,要勾选我框中的第二个选项,上一步之所以敢放心大胆地删掉web.xml文件,就是因为此处可以根据我们的要求生成新的web.xml。点击OK,一切就OK啦,再次查看项目的目录,果然又有web.xml文件了,打开,就是我们想要的版本。
到此为止,我们已经构建了一个web项目,要变成SpringMVC项目,就需要在pom.xml中引入spring相关的包,同时配置web.xml、添加applicationContext.xm文件、xxx-servlet.xml文件,下面给出本人的一个配置:
pom.xml
<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/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.code.spring</groupId>
<artifactId>web</artifactId>
<packaging>war</packaging>
<version>0.0.1-SNAPSHOT</version>
<name>web Maven Webapp</name>
<url>http://maven.apache.org</url>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>4.3.5.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>4.3.5.RELEASE</version>
</dependency>
</dependencies>
<build>
<finalName>web</finalName>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.6</source>
<target>1.6</target>
</configuration>
</plugin>
</plugins>
</build>
</project>
web.xml
<?xml version="1.0" encoding="UTF-8"?>
<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>web</display-name>
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<servlet>
<servlet-name>dispatcher</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>dispatcher</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>inedx.jsp</welcome-file>
</welcome-file-list>
</web-app>
配置ContextLoaderListener表示,该工程要以spring的方式启动。启动时会默认在/WEB-INF目录下查找applicationContext.xml作为spring容器的配置文件,这里可以初始化一些bean,如DataSource。我们这里什么也不做。代码如下:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
</beans>
在web.xml中配置DispatcherServlet表示,该工程将采用SpringMVC的方式。启动时也会默认在/WEB-INF目录下查找xxx-servlet.xml作为配置文件,xxx就是DispatcherServlet的名字:
<?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.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-4.0.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">
<!-- 配置自动扫描的包 -->
<context:component-scan base-package="com.code.web.controller"></context:component-scan>
<mvc:annotation-driven />
<!-- 配置视图解析器 -->
<bean
class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/views/"></property>
<property name="suffix" value=".jsp"></property>
</bean>
</beans>
通过上面的配置,整个SprignMVC项目已经搭建好,下面写一个简单的测试例子:
package com.code.web.controller;
import javax.servlet.http.HttpServletRequest;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class HelloSpring {
@RequestMapping(value = "/hello")
public String helloSpring(HttpServletRequest request) {
return "HelloSpring";
}
}
HelloSpring.jsp的代码为:
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>欢迎</title>
</head>
<body>
欢迎来到Spring的世界
</body>
</html>
在Tomcat中运行项目,输入http://localhost:8080/web/hello,访问页面:
上面就是一个简单的SpringMVC项目在eclipse中的构建过程。
参考文献: