Spring企业级程序设计 • 【第5章 Spring MVC快速入门】

全部章节   >>>>

---

本章目录

5.1 Spring MVC设计概述及其框架结构

5.1.1 Spring MVC介绍

5.1.1 Spring MVC优势

5.1.2  Spring MVC工作原理

5.1.3 手动搭建Spring MVC环境

5.1.4 实践练习

5.2 处理器映射器和适配器

5.2.1 配置处理器映射器和适配器

5.2.2   注解驱动

5.2.3   @RequestMapping注解

5.2.3 注解驱动

5.2.4 实践练习

5.3  Spring MVC简单类型数据绑定

5.3.1 基本数据类型绑定

5.3.2  POJO类型数据绑定

5.3.3 Json类型数据交互

5.3.4 实践练习

5.4 Spring MVC复杂类型数据绑定

5.4.1  List集合类型数据绑定

5.4.2  Set集合类型数据绑定

5.4.3  Map集合类型数据绑定

5.4.4 实践练习

总结

---

5.1 Spring MVC设计概述及其框架结构

5.1.1 Spring MVC介绍

Spring MVC是目前最好的实现MVC设计模式的框架，是Spring框架的一个分支产品，以Spring IoC容器为基础，并利用容器的特性来简化它的配置。

Spring MVC相当于Spring的一个子模块，可以很好地和Spring结合起来进行开发，是Java Web开发者应该要掌握的框架。

5.1.1 Spring MVC优势

• 清晰的角色划分
• 分工明确
• 无需继承框架特定API，可以使用命令对象直接作为业务对象。
• 和Spring其他框架无缝集成
• 可适配，通过HandlerAdapter可以支持任意的类作为处理器。
• 可定制性，HandlerMapping、ViewResolver等能够非常简单的定制。
• 功能强大的数据验证、格式化和绑定机制。
• 利用Spring提供的Mock对象能够非常简单的进行Web层单元测试。
• 本地化和主题的解析的支持，使我们更容易进行国际化和主题的切换。
• 强大的JSP标签库，使JSP编写更容易。

5.1.2  Spring MVC工作原理

Spring MVC的设计是围绕DispatcherServlet展开的，DispatcherServlet负责将请求派发到特定的处理器。

5.1.3 手动搭建Spring MVC环境

示例：搭建SpringMVC开发环境 创建WEB工程。

添加相关jar。

在src目录下创建Spring MVC的核心配置文件springmvc.xml。

在web.xml配置文件中配置Spring MVC的DispatcherServlet前端控制器。

在WebContent目录下创建index.jsp文件。

发布程序启动WEB服务器访问。

<?xml version="1.0" encoding="UTF-8"?>
<beans  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
		xmlns="http://www.springframework.org/schema/beans"
		xmlns:context="http://www.springframework.org/schema/context"
		xmlns:aop="http://www.springframework.org/schema/aop"
		xmlns:tx="http://www.springframework.org/schema/tx"
		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.2.xsd
		http://www.springframework.org/schema/context
		http://www.springframework.org/schema/context/spring-context-4.2.xsd
		http://www.springframework.org/schema/aop
		http://www.springframework.org/schema/aop/spring-aop-4.2.xsd
		http://www.springframework.org/schema/tx
		http://www.springframework.org/schema/tx/spring-tx-4.2.xsd
		http://www.springframework.org/schema/mvc
		http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd ">
	<!-- 此处输入内容 -->
</beans>

<!-- 配置前端控制器 -->
<servlet>
	<servlet-name>springmvc</servlet-name>
	<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
	<!-- 指定Spring MVC的核心配置文件 -->
	<init-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>classpath:springmvc.xml</param-value>
	</init-param>
	<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
	<servlet-name>springmvc</servlet-name>
	<!-- 拦截所有以do结尾的请求 -->
	<url-pattern>*.do</url-pattern>
</servlet-mapping>

5.1.4 实践练习

5.2 处理器映射器和适配器

在Spring MVC中，处理器映射器和适配器这两个组件在Spring MVC整个的运行流程之中扮演一个很重要的角色。

映射器和适配器两个组件的功能：

• 映射器主要是跟在浏览器上输入的URL来映射对应的Handle，具体的映射规则需要根据使用哪一个映射器来决定
• 适配器主要是决定调用哪个Handler来实现具体的业务逻辑。

5.2.1 配置处理器映射器和适配器

示例：配置官方推荐的处理器映射器和适配器，在页面中输出结果。

<!-- 开启注解扫描功能 -->
<context:component-scan base-package="com.mhys.demo"></context:component-scan>
<!-- 配置处理器映射器 -->
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"></bean>
<!-- 配置处理器适配器 -->
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"></bean>

@RequestMapping注解将url请求与业务方法进行映射。

ModelAndView对象的作用：设置转向地址和传递处理器中方法处理结果数据到结果页面。

5.2.2   <mvc:annotation-driven />注解驱动

手动配置处理器映射器和适配器比较麻烦，也不便于记忆。为了简化配置，官方提供了<mvc:annotation-driven />注解驱动标签来简化配置

此标签会自动注册RequestMappingHandlerMapping和RequestMappingHandlerAdapter两个Bean，当然还简化了其他的一些配置信息。

示例： 通过<mvc:annotation-driven />注解驱动标签来简化处理器映射器和适配器的配置。

5.2.3   @RequestMapping注解

Spring MVC通过@RequestMapping注解将url请求与业务方法进行映射。在Spring MVC框架中，@RequestMapping注解的使用频率很高，它可以添加在处理器类上以及方法上，在类定义处添加@RequestMapping注解，相当于多了一层访问路径。

@RequestMapping注解有三个常用的属性：

• value：指定url请求的实际地址，是@RequestMapping的默认值，可省略不写。
• method：指定请求的类型，get、post、put和delete等，常用get和post类型请求。
• params：指定请求中必须包含某些参数值，否则无法调用该方法。

5.2.3 <mvc:annotation-driven />注解驱动

示例：通过@RequestMapping完成GET和POST请求处理。

@Controller
@RequestMapping("/first")
public class RequestMappingController {
	@RequestMapping(value="/postTest",method=RequestMethod.GET)
	public ModelAndView testMethod(){
		ModelAndView model= new ModelAndView();
		model.addObject("method", "get请求成功！");
		model.setViewName("/WEB-INF/jsp/test.jsp");
		return model;
	}
}

@Controller
@RequestMapping("/first")
public class RequestMappingController {
	@RequestMapping(value="/postTest",method=RequestMethod.POST)
	public ModelAndView testMethod(){
		ModelAndView model= new ModelAndView();
		model.addObject("method", "get请求成功！");
		model.setViewName("/WEB-INF/jsp/test.jsp");
		return model;
	}
}

5.2.4 实践练习

5.3  Spring MVC简单类型数据绑定

在开发中，经常需要用到的是在业务方法中获取url中的参数和前端页面中的参数。这个时候需要了解Spring MVC的数据绑定。数据绑定就是在后台业务方法中，直接获取前端HTTP请求中的参数。

HTTP请求传输的参数都是String类型，但是Hanlder业务方法中的参数都是指定的数据类型，如int、Object等，所以需要处理参数的类型转换。

此项工作不需要开发人员去完成，Spring MVC的HandlerAdapter组件会在执行Handler业务方法之前完成参数的绑定。

5.3.1 基本数据类型绑定

示例：使用@RequestParam来接收基本数据类型参数。

@Controller
@RequestMapping("/method")
public class MethodController {
	@RequestMapping("/items")
	public String getParams(@RequestParam("ownerName") String ownerName,
		 @RequestParam("itemName") String itemName, @RequestParam("itemPrice")  String itemPrice){

		System.out.println("ownerName：" + ownerName);
		System.out.println("itemName：" + itemName);
		System.out.println("itemPrice：" + itemPrice);
		return "index.jsp";
	}
}

<body>
	<hr />
	<h1>添加古董信息</h1><br/>
	<form action="method/items.do" method="post">
		宝贝任务：<input type="text" name="ownerName"><br/><br/>
		宝贝名：<input type="text" name="itemName"><br/><br/>
		宝贝价格：<input type="text" name="itemPrice"><br/><br/>
		<input type="submit" value="添加">
	</form>
</body>

5.3.2  POJO类型数据绑定

示例：接收页面提交的参数实现对入参数据的封装。

//地址实体类
public class Address {
		private String addressId;
		private String addressName;
		// set()方法和get()方法省略
		@Override
		public String toString() {
			return "Address [addressId=" + addressId + ", addressName="
				+ addressName + "]";
		}
}

//用户实体类
public class User {
	private String username;
	private int age;
	private Address address;
	// set()方法和get()方法省略

	@Override
	public String toString() {
		return "User [username=" + username + ", age=" + age + ", address="
				+ address + "]";
	}
}

@Controller
@RequestMapping("/user")
public class UserController {
	@RequestMapping("/user")
		// 进入用户注册页面
	public ModelAndView intouser(User user){
		ModelAndView model = new ModelAndView();
		model.setViewName("/WEB-INF/jsp/user.jsp");
		return model;
	}
	@RequestMapping("/info")
	public String userInfo(User user){
		System.out.println(user);
		return null;
	}
}

<body>
	<form action="info.do" method="post">
		姓名：<input type="text" name="username"/><br/><br/>
		年龄：<input type="text" name="age"/><br/><br/>
		地址编号：<input type="text" name="address.addressId"/><br/><br/>
		地址：<input type="text" name="address.addressName"/><br/><br/>
	<input type="submit" value="提交"/>
	</form>
</body>

5.3.3 Json类型数据交互

在前后端交互中，经常碰见Ajax请求后端业务方法并将Json格式的参数传到后端的情况。如果需要Spring MVC支持Json，必须加入Json的处理jar包。添加jar包。

示例：将客户的账号和金额传到后端，然后将金额加100返回客户信息到前端。这里将使用@RequestBody注解和@ResponseBody注解来接收Json格式数据和返回Json格式数据。

@Controller
@RequestMapping("/customer")
public class CustomerController {
	@RequestMapping(value="/jsontest",method=RequestMethod.POST )
	@ResponseBody
	public Customer jsonTest(@RequestBody Customer customer ){
		System.out.println(customer.getCustomerId()+"------"+customer.getMoney());
		int money = customer.getMoney() + 100;
		customer.setMoney(money);
		return customer;
	}
	@RequestMapping("/json")
	@ResponseBody
		// 进入页面
	public ModelAndView intoJson(){
		ModelAndView model = new ModelAndView();
		model.setViewName("/WEB-INF/jsp/customer.jsp");
		return model;
	}
}

<script type="text/javascript" language="javascript">
	$(document).ready(function(){
		var customer = {"customerId":"584135","money":105};
		$("#json").click(function () {
			$.ajax({
				url:"<%=request.getContextPath() %>/customer/jsontest.do",
		        data:JSON.stringify(customer), // 将Json对象转换成Json字符串
		        contentType: "application/json;charset=UTF-8",
		        type:"post",
		        dataType:"json",
		        success:function(data){
		            alert(data.customerId+"---"+data.money);
		        }
			})
		});
	});
</script>

5.3.4 实践练习

5.4 Spring MVC复杂类型数据绑定

5.4.1  List集合类型数据绑定

示例：在前台页面注册多个员工的信息，后台通过List集合数据绑定来获取员工集合信息。

public class Employee {
	private String id;
	private String name;

	@Override
	public String toString() {
		return "Employee [id=" + id + ", name=" + name + "]";
	}
// set()方法和get()方法省略
}

@Controller
public class EmployeeController {
	@RequestMapping("/employeeList")
	@ResponseBody
	public String getEmployeeList(EmployeeList employeeList){
		StringBuffer sbf = new StringBuffer();
		for(Employee employee : employeeList.getEmployees()){
			sbf.append(employee);
		}
		return "员工：" + sbf.toString();
	}
}

<body>
	<form action="employeeList.do" method="post">
		员工1编号：<input type="text" name="employees[0].id"/>
		员工1姓名：<input type="text" name="employees[0].name"/><br/><br/>
		员工2编号：<input type="text" name="employees[1].id"/>
		员工2姓名：<input type="text" name="employees[1].name"/><br/><br/>
		员工3编号：<input type="text" name="employees[2].id"/>
		员工3姓名：<input type="text" name="employees[2].name"/><br/><br/>
		<input type="submit" value="List提交"/>
	</form>
</body>

5.4.2  Set集合类型数据绑定

示例：通过Set集合来完成员工信息集合的数据绑定。

public class EmployeeSet {
		private Set<Employee> employees = new HashSet<Employee>();

		public EmployeeSet() {
			employees.add(new Employee());
			employees.add(new Employee());
			employees.add(new Employee());
		}
		// set()方法和get()方法省略
}

@Controller
public class EmployeeController {
	// 原有代码省略
	@RequestMapping("/employeeSet")
	@ResponseBody
	public String getEmployeeSet(EmployeeSet employeeSet){
		StringBuffer sbf = new StringBuffer();
		for(Employee employee : employeeSet.getEmployees()){
			sbf.append(employee);
		}
		return "员工：" + sbf.toString();
	}
}

<body>
	<form action="employeeList.do" method="post">
		员工1编号：<input type="text" name="employees[0].id"/>
		员工1姓名：<input type="text" name="employees[0].name"/><br/><br/>
		员工2编号：<input type="text" name="employees[1].id"/>
		员工2姓名：<input type="text" name="employees[1].name"/><br/><br/>
		员工3编号：<input type="text" name="employees[2].id"/>
		员工3姓名：<input type="text" name="employees[2].name"/><br/><br/>
		<input type="submit" value="List提交"/>
	</form>
</body>

5.4.3  Map集合类型数据绑定

示例：通过Map集合来完成员工信息集合的数据绑定。

@Controller
public class EmployeeController {
	// 原有代码省略

	@RequestMapping("/employeeMap")
	@ResponseBody
	public String getEmployeeMap(EmployeeMap employeeMap){
		StringBuffer sbf = new StringBuffer();
		for(String key:employeeMap.getEmployees().keySet()){
	        		Employee employee = employeeMap.getEmployees().get(key);
	     		 sbf.append(employee);
	    	}
		return "员工：" + sbf.toString();
	}
}

<body>
	<form action="employeeMap.do" method="post">
		员工1编号：<input type="text" name="employees['a'].id"/>
		员工1姓名：<input type="text" name="employees['a'].name"/><br/><br/>
		员工2编号：<input type="text" name="employees['b'].id"/>
		员工2姓名：<input type="text" name="employees['b'].name"/><br/><br/>
		员工3编号：<input type="text" name="employees['c'].id"/>
		员工3姓名：<input type="text" name="employees['c'].name"/><br/><br/>
		// 原有代码省略
		&nbsp;&nbsp;&nbsp;&nbsp;<input type="submit" value="Map提交"/>
	</form>
</body>

5.4.4 实践练习

总结

Spring MVC的主要组件：

• DispatcherServlet前端控制器：作为前端控制器，整个流程控制的中心。
• HandlerMapping处理器映射器：通过扩展处理器映射器实现不同的映射方式。
• HandlAdapter处理器适配器：通过扩展处理器适配器，支持更多类型的处理器。
• ViewResolver视图解析器：通过扩展视图解析器，支持更多类型的视图解析。

@RequestMapping：用于处理请求URL映射的注解，可用于类或方法上。

@RequestBody：注解实现接收HTTP请求的Json数据，将Json转换为java对象。

@ResponseBody：注解实现将Conreoller处理器类中方法返回对象转化为Json对象响应给客户。