注意!!!
此文章需要配置了SpringDispatcherServlet
和InternalResourceViewResolver
才能够使用,如果不会配置,请翻看我【SpringMVC】系列的第一篇文章《【SpringMVC】1. SpringMVC的第一个程序——HelloWorld》
##一、在SpringMVC中如何输出数据模型?
Spring MVC 提供了以下几种途径输出模型数据:
ModelAndView
: 处理方法返回值类型为 ModelAndView时, 方法体即可通过该对象添加模型数据。Map
及Model
: 入参为org.springframework.ui.Model
、org.springframework.ui.ModelMap
或java.uti.Map
时,处理方法返回时,Map
中的数据会自动添加到模型中。@SessionAttributes
: 将模型中的某个属性暂存到 HttpSession 中,以便多个请求之间可以共享这个属性。@ModelAttribute
: 方法入参标注该注解后, 入参的对象 就会放到数据模型中。
##二、输出方法详解
###注意!!!
在敲代码之前请创建好涉及到的类,在下文以免重复创建:
- 在
com.springmvc.handlers
创建Handler类SpringMVCTest
package com.springmvc.handlers;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@RequestMapping("/springmvc")
@Controller
public class SpringMVCTest {
}
- 在WebRoot根目录下创建
index.jsp
- 在WEB-INF文件夹下创建views,并在views下创建
success.jsp
文件
###(1)ModelAndView
控制器处理方法的返回值如果为ModelAndView
, 则其既包含视图信息,也包含模型数据信息。
格式:
- 添加模型数据:
MoelAndView addObject(String attributeName, Object attributeValue)
ModelAndView addAllObject(Map<String, ?> modelMap)
2. 设置视图:
void setView(View view )
void setViewName(String viewName)
####相关代码及效果
#####1.SpringMVCTest
相关代码
/*
* 目标方法的返回值可以是ModelAndView类型 其中包含视图和模型信息
* SpringMVC会把ModelAndView的model中数据放入request域对象中
*
*/
@RequestMapping("/testModelAndView")
public ModelAndView testModelAndView() {
String viewName = SUCCESS;
ModelAndView modelAndView = new ModelAndView(viewName);
// 添加模型数据到ModelAndView中
modelAndView.addObject("time", new Date());
return modelAndView;
}
#####2.index.jsp
相关代码
<a href="springmvc/testModelAndView">testModelAndView</a>
#####3.Success.jsp
相关代码
<h1>Success page</h1>
time:${requestScope.time }
#####4.运行TomCat,访问index.jsp
点击超链接testModelAndView
能够获得当前时间,测试ModelAndView
成功
###(2)Map
及Model
####具体步骤:
- Spring MVC 在调用方法前会创建一个隐含的模型对象作为模型数据的存储容器。
- 如果方法的入参为
Map
或Model
类型,SpringMVC会将隐含模型的引用传递给这些入参。在方法体内,开发者可以通过这个入参对象访问到模型中的所有数据,也可以向模型中添加新的属性数据。
####相关代码及效果 #####1.`SpringMVCTest`相关代码
/*
* 目标方法可以添加Map类型,实际上也可以时 Model 类型或者 ModelMap 类型的参数
*/
@RequestMapping("/testMap")
public String testMap(Map<String, Object> map) {
map.put("names", Arrays.asList("Tom", "Jerry", "Mike"));
return SUCCESS;
}
#####2.index.jsp
相关代码
<a href="springmvc/testMap">testMap</a>
#####3.Success.jsp
相关代码
<h1>Success page</h1>
<br> names:${requestScope.names }
#####4.运行TomCat,访问index.jsp
点击超链接testMap
能够获得指定的姓名,即为成功
###(3)
@SessionAttributes
- 若希望在多个请求之间共用某个模型属性数据,则可以在控制器类上标注一个
@SessionAttributes
, Spring
MVC将在模型中对应的属性暂存到HttpSession 中。 - @SessionAttributes除了可以通过属性名指定需要放到会话中的属性外,还可以通过模型属性的对象类型指定哪些模型属性需要放到会话中
@SessionAttributes(types=User.class)
会将隐含模型中所有类型为 User.class 的属性添加到会话中。@SessionAttributes(value={“user1”, “user2”})
@SessionAttributes(types={User.class, Dept.class})
@SessionAttributes(value={“user1”, “user2”}, types={Dept.class})
####相关代码及效果
#####1.SpringMVCTest
相关代码
注意在类名头上
/**
* 注意控制类前面加@SessionAttributes
*/
@SessionAttributes(value = { "user" }, types = { String.class })
@RequestMapping("/springmvc")
@Controller
public class SpringMVCTest {
/*
* @SessionAttributes 使用时只能在类上面使用@SessionAttributes注解
* 除了可以通过属性名指定需要放到会话中的属性外(实际上是使用value 属性值)
* 还可以通过模型属性的对象类型指定哪些模型属性需要放到会话中(实际上是使用types 属性值)
*/
@RequestMapping("/testSessionAttributes")
public String testSessionAttributes(Map<String, Object> map) {
User user = new User("tom", "123456", "[email protected]", 15);
map.put("user", user);// 使用value属性值
map.put("school", "FSPT");// 使用types属性值
return SUCCESS;
}
}
#####2.index.jsp
相关代码
<a href="springmvc/testSessionAttributes">testSessionAttributes</a>
#####3.Success.jsp
相关代码
<h1>Success page</h1>
<br> request user:${requestScope.user }
<br>-----------------------------------------
<br> session user:${sessionScope.user }
#####4.运行TomCat,访问index.jsp
点击超链接testSessionAttributes
能够在Session域中获得user属性即为成功。
###(4)@ModelAttribute
-
在方法定义上使用
@ModelAttribute
注解:
Spring MVC在调用目标处理方法前,会先逐个调用在方法级上标注了@ModelAttribute
的方法。 -
在方法的形参前使用
@ModelAttribute
注解:
- 可以从隐含对象中获取隐含的模型数据中获取对象,再将请求参数绑定到对象中,再传入形参
- 将方法形参对象添加到模型中
- 使用场景:
举个例子,用户在填写了一个表单,表单中包含数据项id
,name
,sex
,把它们抽象出来封装到到User
中。隔了一段时间,用户发现写错名字了,需要修改name,如果直接new一个User
对象出来,由于只改动了name而已,其他的属性由于没有获得到数据从而导致id
和sex
属性都为null
,这样显然不太合适。而@ModelAttribute
这是为了解决这种状况而出现的。
####相关代码及效果 #####1.在`com.springmvc.entities`创建实体类`User`
package com.springmvc.entities;
public class User {
private Integer id;
private String username;
private String password;
private String email;
private int age;
private Address address;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public String getEmail() {
return email;
}
public void setEmail(String email) {
this.email = email;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public Address getAddress() {
return address;
}
public void setAddress(Address address) {
this.address = address;
}
@Override
public String toString() {
return "User [id=" + id + ", username=" + username + ", password=" + password + ", email=" + email + ", age="
+ age + "]";
}
public User(Integer id, String username, String password, String email, int age) {
super();
this.id = id;
this.username = username;
this.password = password;
this.email = email;
this.age = age;
}
public User(String username, String password, String email, int age) {
super();
this.username = username;
this.password = password;
this.email = email;
this.age = age;
}
public User() {
}
}
#####2.SpringMVC
相关代码`
/*
* 1.有ModelAttribute标记的方法,会在每个目标方法执行之前被SpringMVC调用 2.@ModelAttribute
* 注解也可以用来修饰目标方法的POJO类型的入参,其value属性值有如下作用
* 1)SpringMVC会使用value属性值在Implication中查找对应的对象,若存在则直接传入目标方法的入参中
* 2)SpringMVC会以value为key,POJO对象为value,存入到request中
*/
@ModelAttribute
public void getUser(@RequestParam(value = "id", required = false) Integer id, Map<String, Object> map) {
if (id != null) {
// 模拟从数据库中获取对象
User user = new User(1, "Tom", "123456", "[email protected]", 12);
System.out.println("从数据库获取一个对象" + user);
map.put("user", user);
}
}
/*
* 运行流程: 1.执行@ModelAttribute注解修饰的方法:从数据库中取出原始数据的对象,把对象放入到Map中,键名为user
* 2.SpringMVC 从Map中取出User对象,并把表单的请求参数赋值给User对象的相对应属性。
* 3。SpringMVC把上述对象传入目标方法参数
*
* * 注意: 在 @ModelAttribute 修饰的方法中, 放入到 Map 时的键需要和目标方法入参类型的第一个字母小写的字符串一致!
*
* SpringMVC 确定目标方法 POJO 类型形参的过程
*
* 1. 确定一个 key: 1). 若目标方法的 POJO 类型的参数木有使用 @ModelAttribute 作为修饰, 则 key 为 POJO
* 类名第一个字母的小写 2). 若使用了 @ModelAttribute 来修饰, 则 key 为 @ModelAttribute 注解的
* value 属性值.
*
* 2. 在 implicitModel 中查找 key 对应的对象, 若存在, 则作为入参传入 1). 若在 @ModelAttribute
* 标记的方法中在 Map 中保存过, 且 key 和 1 确定的 key 一致, 则会获取到.
*
* 3. 若 implicitModel 中不存在 key 对应的对象, 则检查当前的 Handler 是否使用 @SessionAttributes
* 注解修饰, 若使用了该注解, 且 @SessionAttributes 注解的 value 属性值中包含了 key, 则会从
* HttpSession 中来获取 key 所 对应的 value 值, 若存在则直接传入到目标方法的入参中. 若不存在则将抛出异常.
*
* 4. 若 Handler 没有标识 @SessionAttributes 注解或 @SessionAttributes 注解的 value
* 值中不包含 key, 则 会通过反射来创建 POJO 类型的参数, 传入为目标方法的参数
*
* 5. SpringMVC 会把 key 和 POJO 类型的对象保存到 implicitModel 中, 进而会保存到 request 中.
*
* 源代码分析的流程 1. 调用 @ModelAttribute 注解修饰的方法. 实际上把 @ModelAttribute 方法中 Map
* 中的数据放在了 implicitModel 中.
*
* 2. 解析请求处理器的目标参数, 实际上该目标参数来自于 WebDataBinder 对象的 target 属性 1). 创建
* WebDataBinder 对象: ①. 确定 objectName 属性: 若传入的 attrName 属性值为 "", 则
* objectName 为类名第一个字母小写. *注意: attrName. 若目标方法的 POJO 属性使用了 @ModelAttribute
* 来修饰, 则 attrName 值即为 @ModelAttribute 的 value 属性值
*
* ②. 确定 target 属性: > 在 implicitModel 中查找 attrName 对应的属性值. 若存在, ok
*
* > *若不存在: 则验证当前 Handler 是否使用了 @SessionAttributes 进行修饰, 若使用了, 则尝试从 Session
* 中 获取 attrName 所对应的属性值. 若 session 中没有对应的属性值, 则抛出了异常.
*
* > 若 Handler 没有使用 @SessionAttributes 进行修饰, 或 @SessionAttributes 中没有使用
* value 值指定的 key 和 attrName 相匹配, 则通过反射创建了 POJO 对象
*
* 2). SpringMVC 把表单的请求参数赋给了 WebDataBinder 的 target 对应的属性.
*
* 3). *SpringMVC 会把 WebDataBinder 的 attrName 和 target 给到 implicitModel.
* 近而传到 request 域对象中.
*
* 4). 把 WebDataBinder 的 target 作为参数传递给目标方法的入参.
*
* 注意:在@ModelAttribute 修饰的方法中,放入到Map 时的键需要和目标方法入参类型的第一个字母小写字符串一致,如:
* 在方法getUser中map.put("user", user); testModelAttribute(User user)
* 入参的第一个单词(即类型),需要和键名一致,只是入参的第一个字母需要大写,键名全为小写
*/
@RequestMapping("/testModelAttribute")
public String testModelAttribute(User user) {
System.out.println("修改:" + user);
return SUCCESS;
}
#####3.index.jsp
相关代码
<!--
模拟修改操作
1.原始数据:id:1、username:Tom、passowrd:123456、email:[email protected],age:12
2.密码不能被修改
3.表单回显,模拟操作直接写在表单对应的属性值
-->
<form action="springmvc/testModelAttribute">
<input type="hidden" name="id" value="1"/>
username:<input type="text" name="username" value="Tom">
<br>
email:<input type="email" name="email" value="[email protected]">
<br>
age:<input type="text" name="age" value="12">
<br>
<input type="submit">
</form>
#####4.Success.jsp
相关代码
<br> request user:${requestScope.user }
<br>-----------------------------------------
#####运行TomCat,访问index.jsp
原本数据是
- username:Tom
- email:[email protected]
- age:12
现在修改age为18
得到结果:
@SessionAttributes(value = { "user" }, types = { String.class })
没有删除,所以在Session域里面也有
User
,默认只会存在
request
域中