// 实现 org.springframework.web.servlet.mvc.Controller 接口
public class HelloController implements Controller {
    @Override // springmvc方法中允许我们传入原生的API
    public ModelAndView handleRequest(HttpServletRequest request,
                                      HttpServletResponse response) throws Exception {
        // ModelAndView 模型和视图类
        ModelAndView mv = new ModelAndView();
        // 封装对象，放在ModelAndView中。
        mv.addObject("msg","HelloSpringMVC!");
        // 封装要跳转的视图，放在ModelAndView中
        mv.setViewName("hello"); //: /WEB-INF/jsp/hello.jsp
        return mv;
    }
}

// 使用Controller注解不用再继承Controller接口
@Controller // 实现Controller接口是一种较老的方法，推荐使用注解实现
// 可在类上再加一层请求路径的映射,也可省略
@RequestMapping("/controller")
public class HelloController {
    // 映射请求路径
    @RequestMapping("/hello") // 请求：项目路径/controller/hello
    public String hello(Model model){ // 参数可自定义，此处的Model存储传递数据
        // 向模型存入数据
        model.addAttribute("msg","hello springmvc");
        // 返回的字符串表示视图：/WEB-INF/jsp/hello.jsp
        return "hello";
        // 如果没有配置视图解析器，返回 "/WEB-INF/jsp/hello.jsp" 也能达到效果
    }
}

@RequestMapping("/add") // "/" 可省略（使用时自动添加）
public String add(int a,int b,Model model){ // 需要接受ab两个参数
    model.addAttribute("msg","两数和为："+(a+b));
    return "hello";
}

// ? 匹配单个任意字符（0个或多个字符都会导致404）
@RequestMapping(value = "/hello?")
// * 匹配多个字符(可0个)或一层路径，hello? 与 hello* 同时存在优先访问精确度高的
@RequestMapping(value = "/*/hello*")
// ** 可匹配多层路径
@RequestMapping(value = "/**/hello")

/**
 * 大括号声明路径变量值在 url 中映射的位置，
 * 路径变量在url中的位置和个数可以随意更改（/add/{a}/{b}/{a}：a值为最后一个a值），
 * 但必须给所有路径变量声明并赋值
 */
@RequestMapping("/add/{a}/{b}")
// @PathVariable 默认将路径变量名与参数名匹配，也可value属性值来指定
public String add(@PathVariable int a, // 基本数据类型建议使用封装类型接收
                  @PathVariable("b") int b,
                  // 支持将所有的路径变量 k,v 都封装在一个 Map<String,String> 中
                  @PathVariable Map<String,String> pv, 
                  Model model){
    model.addAttribute("msg","两数和为："+(a-b));
    return "hello";
}

// 以书籍管理的 URL 请求为例
/getBook?id=1    // 获取书籍
/deleteBook?id=1 // 删除书籍
/addBook         // 添加书籍
/updateBook?id=1 // 更新书籍

// restRul：资源名/资源标识
/book/1  // GET    请求：获取书籍
/book/1  // DELETE 请求：删除书籍
/book    // POST   请求：保存或新增书籍
/book/1  // PUT    请求：更新书籍

// RequestMapping 中可以通过给method赋值指定请求方式（非指定方式请求将会报错）
@RequestMapping(value = "/add/{a}/{b}",method = RequestMethod.POST)

// springmvc 也提供了具体请求方式的注解，它们是RequestMapping的快捷方式使用方法类似
@GetMapping
@PostMapping
@PutMapping
@DeleteMapping
@PatchMapping

@RequestMapping(value="hello02",params={"name"}) // 必须包含name参数
@RequestMapping(value="hello03",params={"!name"}) // 不能包含name参数
@RequestMapping(value="hello04",params={"name=4"}) // 指定参数且指定值
// 指定参数不能为某指定值(可以为空或参数不存在)
@RequestMapping(value="hello04",params={"name!=4"})
@RequestMapping(value="hello05",params={"name!=5","age"}) // 添加多个参数条件

// Windows 浏览器中访问时请求头中有个参数： sec-ch-ua-platform: "Windows"
headers = {"sec-ch-ua-platform=Windows"} // 表示只能 win 访问

@RequestMapping("/hello")
public void hello(HttpServletRequest req,HttpServletResponse rsp) 
    throws ServletException, IOException {
    // 重定向
    // rsp.sendRedirect("index.jsp");
    // 转发
    req.setAttribute("msg","hello springmvc");
    req.getRequestDispatcher("/WEB-INF/jsp/hello.jsp").forward(req,rsp);
}

@RequestMapping("/hello")
public String hello() {
    // 转发方式一：默认就是转发方式
    // return "hello";
    // return "../../index"; // return 中允许使用相对路径
    
    // 转发方式二：使用关键字forward，将不会自动拼接前后缀
    // return "forward:/index.jsp"; // 必须有 / ,不加就是相对路径
    
    /**
     * 重定向：使用关键字redirect，且有视图解析器时重定向也能正常使用
     * 重定向本质就是重新请求所以不一定要返回路径也可以是一个新请求
     * 不会自动拼接前后缀
     */
    return "redirect:/index.jsp";
}

/** 请求为：localhost:8080/springmvc_demo03/hello?user=test&password=111&pets=cat&pets=pig
 * @param user 请求中参数名与变量名一致时自动赋值，不存在时值为 null
 * @param pass 当请求中参数名与变量名冲突时，在变量前使用 @RequestParam 指定要接收的参数
 */
@RequestMapping("/hello")
// 未接受到值的变量为该java类型的默认值
public String hello(String user,
                    @RequestParam("password")int pass, // 根据 key 获取指定参数
                    @RequestParam("pets")List<String> pets, // 一个 key 有多个值时可以封装为一个集合
                    // 拿到当前所有的参数(想拿到 pets 所有值使用 SpringMvc 工具类 MultiValueMap 替换 Map)
                    @RequestParam Map<String,String> params,
                    Model model) {
    String msg="用户名："+user+"，密码："+pass;
    model.addAttribute("msg",msg);
    return "hello";
}

// 获取请求头中的信息，可设置属性同上
public String hello04(
    @RequestHeader("User-Agent")String userAgent, // 根据 key 来获取请求头的信息
    @RequestHeader Map<String,String> header ){} // 获取所有的 header 信息

// 获取 cookie 中的值，可设置属性同上
public String hello04(@CookieValue("JSESSIONID")String jId,
                      @CookieValue("JSESSIONID") Cookie cookie){
    // 可以将 cookie 封装在 Cookie 对象中
    System.out.println(cookie.getName()+"===>"+cookie.getValue());
}

@DateTimeFormat(pattern = "yyyy-MM--dd")
private Date date; // 某pojo类中的Date成员属性

// 省略get set方法
public class User {
    private String name;
    private int pass;
    private Book book; // 关联Book类
}
// 省略get set方法
class Book{ private String name; }

/** 请求为：localhost:8080/springmvc_demo03/hello?name=test&pass=111&book.name=mybook
 * @param user 请求中的参数与该类中有set方法的成员（基本类型和String）名一致时，
 *             将给该成员变量赋值，无映射的成员变量为该java类型的默认值
 * @param name 同样参数与变量名一致时还会给该变量赋值
 */
@RequestMapping("/hello")
public String hello(User user,String name, Model model) {
    model.addAttribute("msg",user+",name="+name);
    return "hello";
}

@RequestMapping("/add")
public String add(HttpServletRequest request, 
                  HttpServletResponse response,
                  HttpSession session){}

@RequestMapping("/test")
public String test(Map<String,Object> map,
                   Model model, ModelMap modelMap){
    map.put("key","val");
    model.addAttribute("key","val");
    modelMap.addAttribute("key","val");
    return "success";
}

@RequestMapping("/test")
public ModelAndView test(){
    // new ModelAndView("index"); // 构造函数允许指定视图(页面)
    ModelAndView mv = new ModelAndView();
    mv.setViewName("index"); // 设置视图
    mv.addObject("key","val"); // 添加数据
    return mv;
}

// 给model存储数据时key等于value数组中值的数据，将同时在 session 域中存储一份
// types 将model中同类型的数据在session中储存一份
@SessionAttributes(value = {"msg","key"} , types = {String.class}) // 在类上使用此注解

@GetMapping("/goToPage")
public String goToPage(HttpServletRequest request){
    // 通过原生 API 在 request 域中保存信息
    request.setAttribute("msg","request msg");
    return "forward:/success"; // 转发请求
}
@ResponseBody
@GetMapping("/success")
public String success(
    @RequestAttribute("msg")String msg){ // 获取到 request 域中的 msg 信息
    // @RequestAttribute(value="msg", required=false) // required 参数是否必须存在（默认 true）
    return msg;
}