Spring MVC入门(4.1版本)

时间:2022-08-29 21:58:20

(第一版,2014年12月27日)

Web MVC框架中除了最流行的Struts,还有Spring MVC,相对来说Spring MVC更加灵活、简便,如果你只是开发一个小型的web应用,我认为Spring MVC是更好的选择。

下面我就以一个简单的例子来说明Spring MVC的基本用法。(示例程序我已上传至gitcafe,https://gitcafe.com/xt/SpringMVC_Study

首先下载相关的jar包:

spring:http://maven.springframework.org/release/org/springframework/spring/

jackson:http://repo1.maven.org/maven2/com/fasterxml/jackson/core/  (为实现前后台传递json数据)

commons logging:http://commons.apache.org/proper/commons-logging/download_logging.cgi

JSTL:http://archive.apache.org/dist/jakarta/taglibs/standard/binaries/

导入的包如下图所示:

Spring MVC入门(4.1版本)

 (当然,如果你懒得下载,可以直接下载我的工程,将里面lib文件夹下的包导入你自己的工程里去即可。)

新建一个web工程,名称为SpringMVC_Study,之后配置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"
xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
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">

<!-- spring MVC配置 -->
<servlet>
<servlet-name>SpringMVC</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springservlet-config.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>SpringMVC</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>

<!-- 配置post表单编码格式(避免中文乱码) -->
<filter>
<filter-name>CharacterEncodingFilter</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>
</filter>
<filter-mapping>
<filter-name>CharacterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

</web-app>

在配置中,设置了一个名为“springMVC”的servlet,其实现类为spring的DispatcherServlet。contextConfigLocation指定了这个servlet的配置文件位置和名称,load-on-startup的属性值为1,意为随着servlet容器一同启动,servlet-mapping设置为“/”,即拦截所有请求。

下面在src目录下新建Spring MVC的配置文件:springservlet-config.xml(其路径名称与web.xml中contextConfigLocation的值相对应:即classpath:springservlet-config.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:p
="http://www.springframework.org/schema/p"
xmlns:context
="http://www.springframework.org/schema/context"
xmlns:util
="http://www.springframework.org/schema/util"
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/util
http://www.springframework.org/schema/util/spring-util.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd"
>


<!-- 使用默认的注解映射 -->
<mvc:annotation-driven/>

<!-- 自动扫描controller包中的控制器 -->
<context:component-scan base-package="controller"/>

<!-- 视图解析路径配置 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
<property name="contentType" value="text/html"/>
<property name="prefix" value="/WEB-INF/page/"/>
<property name="suffix" value=".jsp"/>
</bean>

<!-- Json转换器配置 -->
<bean id="mappingJackson2HttpMessageConverter"
class
="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
<property name="supportedMediaTypes">
<list>
<value>text/html;charset=UTF-8</value>
</list>
</property>
</bean>
<bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">
<property name="messageConverters">
<list>
<ref bean="mappingJackson2HttpMessageConverter" />
</list>
</property>
</bean>

<!-- 配置静态资源(JS、CSS、图片等)的访问路径 -->
<mvc:resources location="/WEB-INF/plugin/" mapping="/plugin/**"/>

</beans>

其中需要说明的是文件最后位置的mvc:resources属性,因之前在web.xml中设置的是拦截所有请求,因此页面文件访问服务器的JS、CSS、图片等文件时也会被拦截掉。这里配置了静态资源的访问路径,所以对“plugin”这个文件夹下内容的访问将不再被拦截(因此应将将这些文件放在plugin文件夹里),

以上就是Spring MVC的基本配置了,下面新建一个包:controller,在其下再新建一个类:LoginController,作为登录控制器,用来处理用户登录的请求,代码如下:

package controller;

import java.util.HashMap;
import java.util.List;
import java.util.Map;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.servlet.ModelAndView;

import service.PersonService;
import entity.Person;

@Controller
public class LoginController {


//域名访问跳转到登录页
@RequestMapping("/")
public String index(){

return "login";
}

//登录跳转到首页
@RequestMapping(value="/login",method = RequestMethod.POST)
public ModelAndView login(String nickname){
ModelAndView mv
= new ModelAndView();
mv.setViewName(
"home/index");
mv.addObject(
"nickname",nickname);
return mv;
}

//获取人员信息
@RequestMapping(value="/getPersonData.do")
@ResponseBody
//添加该注释后,返回值将由转换器进行转换,转换器为Jackson,所以会转换成json格式
public Map<String,Object> getPersonData(){
Map
<String,Object> personMap = new HashMap<String,Object>();
PersonService service
= new PersonService();

List
<Person> personData = service.getPersonInfo();
personMap.put(
"rows",personData);

return personMap;

}

}

 类前面前加了“@Controller”注释,因上面Spring MVC配置文件中配置了对controller包的扫描,所以加了注释的类会被spring容器自动识别。“@RequestMapping”注释用来配置跳转,可以直接返回一个字符串来匹配要跳转的JSP文件名称,也可以返回一个ModelAndView,里面除了包含跳转文件名称,还可以包含参数。添加了“@ResponseBody”注释的函数,其返回值会被转换器进行转换,因在配置文件中设置了转换器为Jackson,所以会转换成json格式。

为了模拟一个web应用的开发,再新建两个类:personService和PersonBean,作为业务逻辑和数据模型。

其代码如下:

Person:

package entity;

public class Person {
private Integer id;
private String name;
private String age;
private String description;

public Person(Integer id, String name, String age, String description) {
this.id = id;
this.name = name;
this.age = age;
this.description = description;
}

public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getAge() {
return age;
}
public void setAge(String age) {
this.age = age;
}
public String getDescription() {
return description;
}
public void setDescription(String description) {
this.description = description;
}
}

Person类为一个POJO,用来存储人员信息。

PersonService:

package service;

import java.util.ArrayList;
import java.util.List;

import entity.Person;

public class PersonService {

public List<Person> getPersonInfo(){
List
<Person> personData = new ArrayList<Person>();
//填充数据
Person p = null;
p
= new Person(1,"小明","25","中*员");
personData.add(p);
p
= new Person(1,"小华","21","共青团员");
personData.add(p);
p
= new Person(1,"小丽","13","少先队员");
personData.add(p);
return personData;
}

}

PersonService只包含一个方法getPersonInfo,返回3条含有数据的Person实例。

以上就是用到的JAVA代码了,下面新建两个JSP文件login.jsp和index.jsp作为前台页面,其代码分别如下:

login.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>登录</title>
</head>
<body>
<form id="loginFrom" name="loginFrom" method="post" action="login.do">
<label>请输入昵称:</label>
<input id="nickname" name="nickname" type="text"/>
<button id="login" type="submit">登录</button>
</form>
<h2 id="errorMsg">${errorMsg}</h2>
</body>
</html>

index.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>欢迎</title>

<script src="plugin/jquery-1.11.2.js"></script>
<script type="text/javascript">
function getPersonData() {
$.ajax({
url:
"getPersonData.do",
success:
function (result) {
var content = "";
for (var i = 0; i < result.rows.length; i++) {
var item = result.rows[i];
content
+= item.name+","+item.age+","+item.description+"<br>";
}
$(
"#personData").after(content);
}
});
}
</script>
</head>
<body>
你好!${nickname}
<br>
<button onclick="getPersonData()" id="submitButton">获取人员信息</button>
<div id="personData"></div>
</body>
</html>

这里使用了jQuery,将jQuery文件其放到plugin文件夹下即可。

 

以上就是整个示例工程的代码了,部署到Tomcat后,访问 http://localhost:8080/SpringMVC_Study/ ,弹出页面如下:

Spring MVC入门(4.1版本)

输入昵称后,点击“登录”,跳转至首页:

Spring MVC入门(4.1版本)

点击“获取人员信息”,会调用getPersonData方法,返回json格式数据,在index.jsp中对返回的json数据进行了解析,并输出到页面上:

Spring MVC入门(4.1版本)

 

OK,讲解完毕,希望能对你有所帮助 :)

另外,如果你是在一个项目组中,或者研发一个较大的系统,建议使用3.x版本,目前对4.x版本的资料还比较有限,而且一些接口也发生了变化,很容易造成麻烦(比如配置Jackson,3和4就不太一样,坑了我好久。。。)