spring mvc 基于maven的完整demo

来源：互联网发布：成都管家婆软件编辑：程序博客网时间：2024/05/01 09:10

记录一下使用maven构建第一个spring mvc工程的经过。

环境：

eclipse Kepler Service Release 2

jdk 1.7

tomcat7.0.52

这里假定eclipse中maven已经正确配置。

流程：

第一步：使用eclipse构建普通maven工程

第二步：将此工程构造成基于maven的java web工程

第三步：改造为简单的spring mvc工程

第四步：引入jquery、传送json数据

下面是详细过程：

第一步：使用eclipse构建普通maven工程

File-->New-->Project...-->Maven Project :

Next-->,

勾选Crate a simple project.... Next-->

输入groupId 和ArtifactId, Version使用默认就可以，Packaging选war，其他可以不填 -->Finish

下图是刚建出来的maven工程的结构：

第二步：将此工程构造成基于maven的java web工程

此时其实默认已经是java web工程，不过编译级别和web版本教低，我们修改一下。

首先确保你电脑安装了jdk1.7，并且正确设置，选择菜单：Window-->Preferences-->Java

Compiler里面修改为1.7

Installed JRE里面，选择一个jdk1.7的目录添加进去，记住要选择jdk，而不是jre，因为如果选成jre，在使用maven编译打包的时候会提示无法编译。

接下来，右击工程名，选择Properties

Java Build Path里面，Add Library，换成jdk1.7，删除原有的低版本jdk

Java Compiler里面，改为1.7

Apply-->OK

Project Facets里面，去掉Dynamic Web Module勾选，Java选项上版本改为1.7

Apply-->Ok

刚才去掉了Dynamic Web Module的勾选，是因为默认的web配置不能满足，我们要重新设置。所以，接下来，再次右击工程名,选择Properties-->Project Facets

勾上Dynamic Web Module，并把版本改为3.0，点击下面的Further configuration available...,看到如下对话框：

将Content directory改为webapp，并勾选生成web.xml选项，OK。

这时会看到，webapp目录下的结构发生了变化，工程以webapp作为web根目录

接下来，右击工程名，选择Maven-->Update Project..,执行完后，会发现工程名上面可能出现一个红叉，这是由于maven编译级别和eclipse中设置的级别不同导致，需要在pom.ml文件中添加编译的插件。

将以下代码加入pom.xml的<project>主节点下

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

再次执行Maven-->Update Project..，红叉消失。

接下来，验证web工程。

在webapp目录下，创建welcome.jsp文件:

<%@ page contentType="text/html;charset=UTF-8" language="java" %>你好，欢迎访问天街小雨！

但是文件报红，这时因为没有引入servlet和jsp的jar引起的，所以，往pom.xml里面加入这两个的依赖：

<dependencies>  <dependency><groupId>javax.servlet</groupId><artifactId>servlet-api</artifactId><version>2.4</version>  </dependency>  <dependency><groupId>javax.servlet.jsp</groupId><artifactId>jsp-api</artifactId><version>2.1</version>  </dependency></dependencies>

保存，并再次执行Maven-->Update Project.. 报红消失。

配置tomcat7.0.52，项目添加到tomcat中：

启动tomcat，浏览器中输入地址：http://localhost:8080/spring2/welcome.jsp，看到欢迎语！

第三步：改造为简单的spring mvc工程

1.pom.xml中加入spring mvc的相关依赖：

<dependency><groupId>org.springframework</groupId><artifactId>spring-context</artifactId><version>4.1.6.RELEASE</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>4.1.6.RELEASE</version></dependency>

再次执行Maven-->Update Project..

2. 配置web.xml ，配置spring servlet和url映射：

web.xml:

<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"><servlet>        <servlet-name>spring2</servlet-name>        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>        <load-on-startup>1</load-on-startup>    </servlet>    <servlet-mapping>        <servlet-name>spring2</servlet-name>        <url-pattern>/</url-pattern>    </servlet-mapping>    </web-app>

<url-pattern>/</url-pattern> 代表根目录下的所有url都可以被spring转发。

3. 配置spring mvc的配置文件，配置文件的命名，是sevlet的名字加上-servlet.xml, 在这个工程里，web.xml里面配的servlet的名字是spring2，所以spring mvc的配置文件名是spring2-servlet.xml , 路径在WEB-INF下面，spring默认会找这个文件：

spring2-servlet.xml:

<?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-4.0.xsdhttp://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsdhttp://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">    <context:annotation-config/>    <mvc:annotation-driven>        <mvc:message-converters register-defaults="true">            <bean class="org.springframework.http.converter.StringHttpMessageConverter">                <property name="supportedMediaTypes" value = "text/plain;charset=UTF-8" />            </bean>        </mvc:message-converters>    </mvc:annotation-driven>        <context:component-scan base-package="spring2.controller"/>    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>        <property name="prefix" value="/WEB-INF/templates/"/>        <property name="suffix" value=".jsp"/>    </bean></beans>

<context:component-scan base-package="spring2.controller"/>这句表示程序会扫描spring2.controller这个包，那么这个包下面的类，如果有spring的注解，都会被相应处理，我们创建这个包，并创建controller类，如果没有这句，controller类不会被扫描到，也就不会被当做controller来运行。这里我们创建的controller叫做MainController

MainController.java:

package spring2.controller;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RequestMethod;import org.springframework.web.bind.annotation.RestController;import org.springframework.web.servlet.ModelAndView;@RestControllerpublic class MainController {    @RequestMapping(value = "home", method = RequestMethod.GET)    public ModelAndView taskReleaseCon() {        ModelAndView mv = new ModelAndView();        mv.setViewName("home");        return mv;    }}

@RestController这个注解表示他是一个controller，value=“home”，表示如果url是根目录/home，就会跳转到这个方法里面来处理。mv.setViewName("home");这句表示，这个请求会被最终转发到WEB-INF/templates/home.jsp，我们创建WEB-INF/templates/home.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>spring home page</title></head><body>    天街小雨欢迎你来到spring mvc</body></html>

这时候还需要加入jstl依赖，pom.xml:

<dependency>        <groupId>jstl</groupId><artifactId>jstl</artifactId><version>1.2</version></dependency>

重启tomcat，浏览器地址中输入：http://localhost:8080/spring2/home，页面看到欢迎语。

第四步：引入jquery、传送json数据

我们在webapp目录下创建js目录，将jquery-2.0.3.min.js拷到这个目录下，当然放在别处也可以，在home.jsp中引入这个文件：

spring2-servlet.xml：

<mvc:resources mapping="/**" location="/js/"/>

意思是将/js/目录下的资源，映射到根目录下，不知道表达的清楚不，可以自己先不加这句试试效果，对比一下。

这样，引入了jquery，写个ajax测试一下,home.jsp:

<script type="text/javascript">    $.ajax({        type: 'get',        url: 'test',        dataType: "text",        success: function (data) {        alert(data)        }    });    </script>

ajax的地址为test，我们需要配置映射test的controler，还是在MainControler里面，添加一个方法：

@RequestMapping(value = "test", method = RequestMethod.GET)public String test() {    return "hello";}

现在流程变成这样，我们访问home的时候，跳转到home.jsp, 在home.jsp，有一个ajax请求，访问test，test返回一个字符串“hello”，浏览器接收到hello并弹出来。

重启tomcat，再次访问http://localhost:8080/spring2/home，页面弹出hello

接下来，要让controller对test请求返回json数据，浏览器接收并处理json

首先需要添加json处理的maven依赖，pom.xml:

        <dependency>            <groupId>org.codehaus.jackson</groupId>            <artifactId>jackson-core-asl</artifactId>            <version>1.9.13</version>        </dependency>        <dependency>            <groupId>org.codehaus.jackson</groupId>            <artifactId>jackson-mapper-asl</artifactId>            <version>1.9.13</version>        </dependency>                    <dependency>                  <groupId>com.fasterxml.jackson.core</groupId>                  <artifactId>jackson-core</artifactId>                  <version>2.5.3</version>              </dependency>              <dependency>                  <groupId>com.fasterxml.jackson.core</groupId>                  <artifactId>jackson-databind</artifactId>                  <version>2.5.2</version>              </dependency>              <dependency>                  <groupId>com.fasterxml.jackson.core</groupId>                  <artifactId>jackson-annotations</artifactId>                  <version>2.5.3</version>              </dependency>

然后，创建一个bean，spring2.domain.User,实现序列化接口

User.java:

package spring2.domain;import java.io.Serializable;public class User implements Serializable {String name;String password;public String getName() {return name;}public void setName(String name) {this.name = name;}public String getPassword() {return password;}public void setPassword(String password) {this.password = password;}public User(String name, String password) {super();this.name = name;this.password = password;}}

在controller里面，将返回值改为User类型，返回一个User对象，MainController.java:

@RequestMapping(value = "test", method = RequestMethod.GET)public User test() {    return new User("xiaoyu","123456");}

在客户端，修改一下ajax的结果处理方式，home.jsp

$.ajax({type: 'get',url: 'test',dataType: "json",success: function (data) {       alert(data.name)}});

再次访问http://localhost:8080/spring2/home：

如果需要打包项目，单独放到tomcat运行，步奏如下：

右击工程名-->Run As-->Maven Install, 就会在工程target目录下生成spring2.war, 将war包扔到tomcat的webapps目录下，启动tomcat就可以。

如需要我的完整的工程，请到这里下载：

http://download.csdn.net/download/valenon/8784705

0 1