package com.wh.handler;
/**
* @ModelAttribute绑定请求参数到命令对象
* @ModelAttribute一个具有如下三个作用：
*
* ①绑定请求参数到命令对象：放在功能处理方法的入参上时，用于将多个请求参数绑定到一个命令对象，
* 从而简化绑定流程，而且自动暴露为模型数据用于视图页面展示时使用；
*
* ②暴露表单引用对象为模型数据：放在处理器的一般方法（非功能处理方法）上时，是为表单准备要展示的表单引用对象，
* 如注册时需要选择的所在城市等，而且在执行功能处理方法（@RequestMapping注解的方法）之前，
* 自动添加到模型对象中，用于视图页面展示时使用；
*
* ③暴露@RequestMapping方法返回值为模型数据：放在功能处理方法的返回值上时，
* 是暴露功能处理方法的返回值为模型数据，用于视图页面展示时使用。
*/
import java.util.Arrays;
import java.util.List;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
@Controller
public class TestModelAttribute {
//一、绑定请求参数到命令对象
/**
* @ModelAttribute("u") User user
* 相当与Model model; model.addAttribute("u",user);
* 即：将user这个对象添加到Model里去，在前台是通过${u.uname}等方式来获取这个值
* 类似与：将一个页面的值，又传到另一个页面中去
*
* @ModelAttribute User user
* 表示前台应通过${user.uname}等方式来获取
*/
@RequestMapping("/m1.action")
public String m1(@ModelAttribute User user){
System.out.println("u:"+user);
return "sus.jsp";
}
/**
* 对象图导航式的绑定 workInfo.city=bj
*
* 绑定请求参数到命令对象支持对象图导航式的绑定，如请求参数包含
* “?username=zhang&password=123&workInfo.city=bj”
* 自动绑定到user中的workInfo属性的city属性中。
*/
@RequestMapping(value="/m2.action")
public String test2(@ModelAttribute("user") User user) {
System.out.println("u:"+user);
return "sus.jsp";
}
//二、暴露表单引用对象为模型数据
/**
* @ModelAttribute("clist")
* public List cityList(){}
* 表示将cityList方法的返回值添加到model里去，且Model的变量名为clist
*
* 注意：
* 1、代码会在执行功能处理方法之前执行，并将其自动添加到模型对象中，
* 即必须执行其他的功能方法，此处的方法才会在功能方法之前执行，不然，此处的方法不会执行
* 2、在功能处理方法中调用Model 入参的containsAttribute("cityList")将会返回true。
*/
@ModelAttribute("clist")
public List cityList(){
return (List) Arrays.asList("北京","上海","安徽");
}
@RequestMapping("/m3.action")
public String demo(Model model){
//System.out.println(model.containsAttribute("clist"));
return "sus.jsp";
}
//-----------------------------
/**
* 如你要修改用户资料时一般需要根据用户的编号/用户名查找用户来进行编辑，此时可以通过如下代码查找要编辑的用户。
* 也可以进行一些默认值的处理。
*
* 注意：因为@ModelAttribute注解方法会在功能方法之前执行，所以，可以在注解方法里进行一些查询操作。
* 即功能方法都不用去数据库查询，可以让@ModelAttribute注解方法进行代劳，通过
* @RequestParam(value="username", defaultValue="")先将要查询的相关信息获取；
* 然后，功能方法只需要指定跳转到哪个页面即可
*/
@ModelAttribute("user") //①
public User getUser(@RequestParam(value="username", defaultValue="") String username) {
//TODO 去数据库根据用户名查找用户对象
User user = new User();
user.setUname("zhang");
return user;
}
@RequestMapping(value="/m4") //②
public String test1(@ModelAttribute("user") User user, Model model){
return "";}
/**
*此处我们看到①和②有同名的命令对象，那Spring Web MVC内部如何处理的呢：
*(1、首先执行@ModelAttribute注解的方法，准备视图展示时所需要的模型数据；
*@ModelAttribute注解方法形式参数规则和@RequestMapping规则一样，如可以有@RequestParam等；
*（2、执行@RequestMapping注解方法，进行模型绑定时首先查找模型数据中是否含有同名对象，如果有直接使用，
*如果没有通过反射创建一个，因此②处的user将使用①处返回的命令对象。即②处的user等于①处的user。
*/
//三、暴露@RequestMapping方法返回值为模型数据
/*
*<h1>m5.jsp</h1>
*<div>
* 姓名：${user2.uname}<br/>
* 年龄：${user2.uage}<br/>
* 性别：${user2.usex}<br/>
*</div>
*/
@RequestMapping("m5.jsp.action")
public @ModelAttribute("user2") User test3(@ModelAttribute("user2") User user) {
return new User("张三",20,"男");
}
/**
*大家可以看到返回值类型是命令对象类型，而且通过@ModelAttribute("user2")注解，
*此时会暴露返回值到模型数据（名字为user2）中供视图展示使用。那哪个视图应该展示呢？
*此时Spring Web MVC会根据RequestToViewNameTranslator进行逻辑视图名的翻译，详见【4.15.5、RequestToViewNameTranslator】一节。
*此时又有问题了，@RequestMapping注解方法的入参user暴露到模型数据中的名字也是user2，其实我们能猜到：
*（3、@ModelAttribute注解的返回值会覆盖@RequestMapping注解方法中的@ModelAttribute注解的同名命令对象。
*/
//四、匿名绑定命令参数
/*
public String test4(@ModelAttribute UserModel user, Model model)
或
public String test5(UserModel user, Model model)
此时我们没有为命令对象提供暴露到模型数据中的名字，此时的名字是什么呢？
Spring Web MVC自动将简单类名（首字母小写）作为名字暴露，
如“cn.javass.chapter6.model.UserModel”暴露的名字为“userModel”。
public @ModelAttribute List<String> test6()
或
public @ModelAttribute List<UserModel> test7()
对于集合类型（Collection接口的实现者们，包括数组），生成的模型对象属性名为
“简单类名（首字母小写）”+“List”，如List<String>生成的模型对象属性名为“stringList”，
List<UserModel>生成的模型对象属性名为“userModelList”。
其他情况一律都是使用简单类名（首字母小写）作为模型对象属性名，如Map<String, UserModel>类型的模型对象属性名为“map”。
*/
}
