springMVC笔记

MVC设计模式是我发一个请求到目标处理器，目标处理器去调业务方法，业务方法可能有返回值，然后转发到页面，在页面上显示业务方法的返回值。

注解：

@controller：标识为控制器

@RequestMapping：映射请求

@PathVariable：映射请求参数（REST风格的url）

@RequestParam：绑定请求参数

@RequestHeader：不常用

@CookieValue：映射CookieValue

@SessionAttributes：将模型数据放到session中，只能放在类上面

@ModelAttribute：可以模拟出struts2的preparable拦截器的效果，可以放在方法上面或者参数前面

@InitBinder：由它标识的方法，可以对WebDataBinder对象进行初始化。

@DateTimeFormat(pattern="yyyy-MM-dd")，放在如private Date birth之上

@NumberFormat(pattern="#,###,###.#")，放在如private Float salary之上

@RequestBody，修饰目标方法入参

@ResponseBody，修饰方法的返回值

@ExceptionHandler，异常处理的，方法上

@ControllerAdvice，异常类的注解，标记在类上面

@ControllerAdvice
public class SpringMVCTestExceptionHandler {

    @ExceptionHandler({ArithmeticException.class})
    public ModelAndView handleArithmeticException(Exception ex){
        System.out.println("----> 出异常了: " + ex);
        ModelAndView mv = new ModelAndView("error");
        mv.addObject("exception", ex);
        return mv;
    }
    
}

/**
 * 1. 在 @ExceptionHandler 方法的入参中可以加入 Exception 类型的参数, 该参数即对应发生的异常对象
 * 2. @ExceptionHandler 方法的入参中不能传入 Map. 若希望把异常信息传导页面上, 需要使用 ModelAndView 作为返回值
 * 3. @ExceptionHandler 方法标记的异常有优先级的问题. 
 * 4. @ControllerAdvice: 如果在当前 Handler 中找不到 @ExceptionHandler 方法来出来当前方法出现的异常, 
 * 则将去 @ControllerAdvice 标记的类中查找 @ExceptionHandler 标记的方法来处理异常. 
 */
//    @ExceptionHandler({ArithmeticException.class})
//    public ModelAndView handleArithmeticException(Exception ex){
//        System.out.println("出异常了: " + ex);
//        ModelAndView mv = new ModelAndView("error");
//        mv.addObject("exception", ex);
//        return mv;
//    }

@ResponseStatus，主要放在继承了Exception的类上面，定制出错时候的页面，也可以放在方法上，如：

@ResponseStatus(value=HttpStatus.FORBIDDEN, reason="用户名和密码不匹配!")
public class UserNameNotMatchPasswordException extends RuntimeException{}

在web.xml中配置springMVC的dispatcherServlet

<!-- 配置 DispatcherServlet -->
<servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 配置 DispatcherServlet 的一个初始化参数: 配置 SpringMVC 配置文件的位置和名称 -->
    <!-- 
        实际上也可以不通过 contextConfigLocation 来配置 SpringMVC 的配置文件, 而使用默认的.
        默认的配置文件为: /WEB-INF/<servlet-name>-servlet.xml
    -->
    <!--  
    <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>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>　

在一个控制器里，一个方法返回“success”，那这个“success”返回给谁呢？如下：

<!-- 配置视图解析器: 如何把 handler 方法返回值解析为实际的物理视图 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/views/"></property>
    <property name="suffix" value=".jsp"></property>
</bean>

/**
 * 1. 使用 @RequestMapping 注解来映射请求的 URL
 * 2. 返回值会通过视图解析器解析为实际的物理视图, 对于 InternalResourceViewResolver 视图解析器, 会做如下的解析:
 * 通过 prefix + returnVal + 后缀 这样的方式得到实际的物理视图, 然会做转发操作
 * 
 * /WEB-INF/views/success.jsp
 * 
 * @return
 */
@RequestMapping("/helloworld")
public String hello(){}

 

/**
 * @PathVariable 可以来映射 URL 中的占位符到目标方法的参数中.
 * @param id
 * @return
 */
@RequestMapping("/testPathVariable/{id}")
public String testPathVariable(@PathVariable("id") Integer id) {
    System.out.println("testPathVariable: " + id);
    return SUCCESS;
}

REST风格，没用jquery，需要使用一个HiddenHttpMethodFilter，其获取"_method"参数的值，如果此时是post的请求，就将转发为对应的请求方式，发送给springMVC：

在web.xml中配置：

<!-- 
配置 org.springframework.web.filter.HiddenHttpMethodFilter: 可以把 POST 请求转为 DELETE 或 POST 请求 
-->
<filter>
    <filter-name>HiddenHttpMethodFilter</filter-name>
    <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
</filter>

<filter-mapping>
    <filter-name>HiddenHttpMethodFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

<form action="springmvc/testRest/1" method="post">
    <input type="hidden" name="_method" value="PUT"/>
    <input type="submit" value="TestRest PUT"/>
</form>
<br><br>

<form action="springmvc/testRest/1" method="post">
    <input type="hidden" name="_method" value="DELETE"/>
    <input type="submit" value="TestRest DELETE"/>
</form>
<br><br>

<form action="springmvc/testRest" method="post">
    <input type="submit" value="TestRest POST"/>
</form>
<br><br>

<a href="springmvc/testRest/1">Test Rest Get</a>
<br><br>

/**
 * Rest 风格的 URL. 以 CRUD 为例: 新增: /order POST 修改: /order/1 PUT update?id=1 获取:
 * /order/1 GET get?id=1 删除: /order/1 DELETE delete?id=1
 * 
 * 如何发送 PUT 请求和 DELETE 请求呢 ? 1. 需要配置 HiddenHttpMethodFilter 2. 需要发送 POST 请求
 * 3. 需要在发送 POST 请求时携带一个 name="_method" 的隐藏域, 值为 DELETE 或 PUT
 * 
 * 在 SpringMVC 的目标方法中如何得到 id 呢? 使用 @PathVariable 注解
 * 
 */
@RequestMapping(value = "/testRest/{id}", method = RequestMethod.PUT)
public String testRestPut(@PathVariable Integer id) {
    System.out.println("testRest Put: " + id);
    return SUCCESS;
}

@RequestMapping(value = "/testRest/{id}", method = RequestMethod.DELETE)
public String testRestDelete(@PathVariable Integer id) {
    System.out.println("testRest Delete: " + id);
    return SUCCESS;
}

@RequestMapping(value = "/testRest", method = RequestMethod.POST)
public String testRest() {
    System.out.println("testRest POST");
    return SUCCESS;
}

@RequestMapping(value = "/testRest/{id}", method = RequestMethod.GET)
public String testRest(@PathVariable Integer id) {
    System.out.println("testRest GET: " + id);
    return SUCCESS;
}

/**
 * @RequestParam 来映射请求参数. value 值即请求参数的参数名 required 该参数是否必须. 默认为 true
 *               defaultValue 请求参数的默认值
 */
@RequestMapping(value = "/testRequestParam")
public String testRequestParam(
        @RequestParam(value = "username") String un,
        @RequestParam(value = "age", required = false, defaultValue = "0") int age) {
    System.out.println("testRequestParam, username: " + un + ", age: "
            + age);
    return SUCCESS;
}

/**
 * 了解: 映射请求头信息 用法同 @RequestParam
 */
@RequestMapping("/testRequestHeader")
public String testRequestHeader(
        @RequestHeader(value = "Accept-Language") String al) {
    System.out.println("testRequestHeader, Accept-Language: " + al);
    return SUCCESS;
}

/**
 * 了解:
 * 
 * @CookieValue: 映射一个 Cookie 值. 属性同 @RequestParam
 */
@RequestMapping("/testCookieValue")
public String testCookieValue(@CookieValue("JSESSIONID") String sessionId) {
    System.out.println("testCookieValue: sessionId: " + sessionId);
    return SUCCESS;
}

<form action="springmvc/testPojo" method="post">
    username: <input type="text" name="username"/>
    <br>
    password: <input type="password" name="password"/>
    <br>
    email: <input type="text" name="email"/>
    <br>
    age: <input type="text" name="age"/>
    <br>
    city: <input type="text" name="address.city"/>
    <br>
    province: <input type="text" name="address.province"/>
    <br>
    <input type="submit" value="Submit"/>
</form>
/**
 * Spring MVC 会按请求参数名和 POJO 属性名进行自动匹配， 自动为该对象填充属性值。支持级联属性。
 * 如：dept.deptId、dept.address.tel 等
 */
@RequestMapping("/testPojo")
public String testPojo(User user) {
    System.out.println("testPojo: " + user);
    return SUCCESS;
}

/**
 * 可以使用 Serlvet 原生的 API 作为目标方法的参数 具体支持以下类型
 * 
 * HttpServletRequest 
 * HttpServletResponse 
 * HttpSession
 * java.security.Principal 
 * Locale InputStream 
 * OutputStream 
 * Reader 
 * Writer
 * @throws IOException 
 */
@RequestMapping("/testServletAPI")
public void testServletAPI(HttpServletRequest request,
        HttpServletResponse response, Writer out) throws IOException {
    System.out.println("testServletAPI, " + request + ", " + response);
    out.write("hello springmvc");
//        return SUCCESS;
}

MVC设计模式是我发一个请求到目标处理器，目标处理器去调业务方法，业务方法可能有返回值，比方说一个 对象或者一个集合，然后转发到页面，在页面上显示业务方法的返回值。这个时候，该怎么把模型数据放到域对象里（request）

处理模型数据的方式有：

1、使用ModelAndView

/**
 * 目标方法的返回值可以是 ModelAndView 类型。 
 * 其中可以包含视图和模型信息
 * SpringMVC 会把 ModelAndView 的 model 中数据放入到 request 域对象中. 
 * @return
 */
@RequestMapping("/testModelAndView")
public ModelAndView testModelAndView(){
    String viewName = SUCCESS;
    ModelAndView modelAndView = new ModelAndView(viewName);
    
    //添加模型数据到 ModelAndView 中.
    modelAndView.addObject("time", new Date());
    
    return modelAndView;
}
//页面上直接显示：
time: ${requestScope.time }

2、目标参数的入参，可以加一个map或者model类型的参数

/**
 * 目标方法可以添加 Map 类型(实际上也可以是 Model 类型或 ModelMap 类型,看父类或者接口,了解即可)的参数. 
 * @param map
 * @return
 */
@RequestMapping("/testMap")
public String testMap(Map<String, Object> map){
    System.out.println(map.getClass().getName()); 
    map.put("names", Arrays.asList("Tom", "Jerry", "Mike"));
    return SUCCESS;
}
//页面上直接获取
names: ${requestScope.names }

3、在控制器类上面加一个@SessionAttributes，在多个请求之间共用某个模型数据，SpringMVC会把模型中对应的属性，存放到HttpSession中，也会放在request中

/**
* @SessionAttributes 除了可以通过属性名指定需要放到会话中的属性外(实际上使用的是 value 属性值),
* 还可以通过模型属性的对象类型指定哪些模型属性需要放到会话中(实际上使用的是 types 属性值)
* 
* 注意: 该注解只能放在类的上面. 而不能修饰放方法. 
*/
@RequestMapping("/testSessionAttributes")
public String testSessionAttributes(Map<String, Object> map){
User user = new User("Tom", "123456", "tom@atguigu.com", 15);
map.put("user", user);
map.put("school", "atguigu");
return SUCCESS;
}
//在类上加上，value是一个String[],types是class<?> []，value和types只要有一个满足，就会将模型数据放入session
@SessionAttributes(value={"user"}, types={String.class})
@RequestMapping("/springmvc")
@Controller
public class SpringMVCTest {}
//在页面上直接取
request user: ${requestScope.user }
<br><br>

session user: ${sessionScope.user }
<br><br>

request school: ${requestScope.school }
<br><br>

session school: ${sessionScope.school }

 4、使用@ModelAttribute标记一个方法，为目标方法准备模型数据

/**
 * 1. 有 @ModelAttribute 标记的方法, 会在每个目标方法执行之前被 SpringMVC 调用! 
 * 2. @ModelAttribute 注解也可以来修饰目标方法 POJO 类型的入参, 其 value 属性值有如下的作用:
 * 1). SpringMVC 会使用 value 属性值在 implicitModel 中查找对应的对象, 若存在则会直接传入到目标方法的入参中.
 * 2). SpringMVC 会一 value 为 key, POJO 类型的对象为 value, 存入到 request 中. 
 */
@ModelAttribute
public void getUser(@RequestParam(value="id",required=false) Integer id, 
        Map<String, Object> map){
    System.out.println("modelAttribute method");
    if(id != null){
        //模拟从数据库中获取对象
        User user = new User(1, "Tom", "123456", "tom@atguigu.com", 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 作为参数传递给目标方法的入参. 
 */
@RequestMapping("/testModelAttribute")
public String testModelAttribute(User user){
    System.out.println("修改: " + user);
    return SUCCESS;
}

 springMVC如何解析视图呢？

无论目标方法返回的是一个string、ModelAndView、还是View，springMVC都会将他转化为一个ModelAndView对象，springMVC借助视图解析器（ViewResolver）把ModelAndView转化成为一个真正的物理视图

ModelAndView包含的属性有：

cleared=false;

model=ModelMap(里面可能有相关属性，就是放到那个map的属性)

view=“success”

--------------------------------------

(默认的view：)InternalResourceView和InternalResourceViewResolver是处理jsp的，如果把standard.jar和jstl.jar加入，view就会自动变成jstlView

--------------------------

25. 尚硅谷_佟刚_SpringMVC_JstlView.avi 涉及到了国际化

------------------------------

如果我想直接转发到一个页面，而不经过handler的方法，可以在配置文件里面加上配置：

<!-- 配置直接转发的页面 -->
<!-- 可以直接相应转发的页面, 而无需再经过 Handler 的方法.  -->
<mvc:view-controller path="/success" view-name="success"/>

<!-- 在实际开发中通常都需配置 mvc:annotation-driven 标签 -->
<mvc:annotation-driven></mvc:annotation-driven>

<mvc:annotation-driven>如果不加这个标签，会导致其他链接失效。

-----------------------------------------

如果想要自定义视图，比如整合excel这种，则需要自定义视图解析器（实际上springMVC已经为excel实现了一个view的抽象类），此处仅为距离：

步骤：1，写一个方法，实现View接口

@Component
public class HelloView implements View{

@Override
public String getContentType() {
    return "text/html";
}

@Override
public void render(Map<String, ?> model, HttpServletRequest request,
        HttpServletResponse response) throws Exception {
    response.getWriter().print("hello view, time: " + new Date());
}

}

这个自定义的view如何搞到页面上呢？需要一个视图解析器 BeanNameViewResolver ，如下源码：handler的方法中把view的名字传过来，然后它去IOC容器中去获得对应的View

2、配置视图解析器 BeanNameViewResolver

<!-- 配置视图解析器: 如何把 handler 方法返回值解析为实际的物理视图 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/views/"></property>
    <property name="suffix" value=".jsp"></property>
</bean>

<!-- 配置视图  BeanNameViewResolver 解析器: 使用视图的名字来解析视图 -->
<!-- 通过 order 属性来定义视图解析器的优先级, order 值越小优先级越高 -->
<bean class="org.springframework.web.servlet.view.BeanNameViewResolver">
    <property name="order" value="100"></property>
</bean>

InternalResourceViewResolver的有显示是max，所以随便配一个视图解析器，就比它优先，视图解析器，执行顺序，常用的放后面。

3、写方法，返回自定义的view

@RequestMapping("/testView")
public String testView(){
    System.out.println("testView");
    return "helloView";
}

--------------------------------------------

如果返回的字符串中带 forward: 或 redirect:前缀时，SpringMVC 会对他们进行特殊处理：将 forward: 和redirect: 当成指示符，其后的字符串作为 URL 来处理
redirect:/success.jsp：会完成一个到根目录下 success.jsp 的重定向的操作
forward:success.jsp：会完成一个到 success.jsp 的转发操作

-----------------------------

希望点击超链接，执行delete或者put请求，但是超链接是get，而只有是post请求的时候才能转化，这个时候就需要借助js

<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
<!--  
    SpringMVC 处理静态资源:
    1. 为什么会有这样的问题:
    优雅的 REST 风格的资源URL 不希望带 .html 或 .do 等后缀
    若将 DispatcherServlet 请求映射配置为 /, 
    则 Spring MVC 将捕获 WEB 容器的所有请求, 包括静态资源的请求, SpringMVC 会将他们当成一个普通请求处理, 
    因找不到对应处理器将导致错误。
    2. 解决: 在 SpringMVC 的配置文件中配置 <mvc:default-servlet-handler/>
-->
<script type="text/javascript" src="scripts/jquery-1.9.1.min.js"></script>
<script type="text/javascript">
    $(function(){
        $(".delete").click(function(){
            var href = $(this).attr("href");
            $("form").attr("action", href).submit();            
            return false;
        });
    })
</script>
</head>

但是加入js还不行，这个时候用到了springMVC处理静态资源的问题。

需要在springMVC配置文件中加入<mvc:default-servlet-handler/>

<!--  
    default-servlet-handler 将在 SpringMVC 上下文中定义一个 DefaultServletHttpRequestHandler,
    它会对进入 DispatcherServlet 的请求进行筛查, 如果发现是没有经过映射的请求, 就将该请求交由 WEB 应用服务器默认的 
    Servlet 处理. 如果不是静态资源的请求，才由 DispatcherServlet 继续处理

    一般 WEB 应用服务器默认的 Servlet 的名称都是 default.（在tomcat下的xml文件中有配）
    若所使用的 WEB 服务器的默认 Servlet 名称不是 default，则需要通过 default-servlet-name 属性显式指定
    
-->
<mvc:default-servlet-handler/>

单单加入 <mvc:default-servlet-handler/> 还不行，还需要加入<mvc:annotation-driven></mvc:annotation-driven>。

这个时候，能处理静态资源了，springMVC会先判断请求有没有被映射过

---------------

springMVC的form标签是用于表单回显的，form节点里面要有modelAttribute以及其对应map里面对应的值

form标签的path里面的值，在 modelAttribute 对应的bean里面要有对应的属性！

可以替换为<input>

-------------------------

在jsp中使用绝对路径：%{pageContext.request.contextPath}/.....

----------------------------

springMVC的自定义类型转换器我觉得有大用啊！将一个用户数据bean用字符串的形式组合起来，写入log，然后当天夜里，跑数据，写个转换器，将bean字符串转化为bean的各个属性，然后写入数据库，不知道会不会比日志解析快一点。

自定义转换器可以和quartz联系起来，以及cache

-------------------------------

<mvc:annotation-driven></mvc:annotation-driven>什么时候用它了呢？

1、自定义转发， 不经过handler的方法

<!-- 配置直接转发的页面 -->
<!-- 可以直接相应转发的页面, 而无需再经过 Handler 的方法.  -->
<mvc:view-controller path="/success" view-name="success"/>

2、处理静态资源的时候

<!--  
    default-servlet-handler 将在 SpringMVC 上下文中定义一个 DefaultServletHttpRequestHandler,
    它会对进入 DispatcherServlet 的请求进行筛查, 如果发现是没有经过映射的请求, 就将该请求交由 WEB 应用服务器默认的 
    Servlet 处理. 如果不是静态资源的请求，才由 DispatcherServlet 继续处理

    一般 WEB 应用服务器默认的 Servlet 的名称都是 default.（在tomcat下的xml文件中有配）
    若所使用的 WEB 服务器的默认 Servlet 名称不是 default，则需要通过 default-servlet-name 属性显式指定
    
-->
<mvc:default-servlet-handler/>

3、用类型转换器的时候

<mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven>    
    
<!-- 配置 ConversionService -->
<bean id="conversionService"
    class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
    <property name="converters">
        <set>
            <ref bean="employeeConverter"/>
        </set>
    </property>    
</bean>

--------------------------------------------