springMVC

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">




  <!--
      配置 前端控制器 DispatcherServlet，也可以叫做：核心调度器 或者 分发器
      接收所有 除了.jsp 的请求，都交给springmvc去处理
  -->
  <servlet>
    <servlet-name>springmvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!--
        关联springmvc的配置文件
        初始化参数
        contextConfigLocation  配置springmvc的xml配置文件， 指定路径
        也可以不配置：
            会自动去WEB-INF去找一个名字叫做 [servlet-name]-servlet.xml
            这里即是： springmvc-servlet.xml 的文件
    -->
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:spring-mvc.xml</param-value>
    </init-param>
    <!--启动时加载servlet  ：
        当web服务器 启动时 就会创建 servlet (会自动调用servlet的构造函数及init()方法）
    -->
    <load-on-startup>1</load-on-startup>
  </servlet>










  <!--
  匹配servlet的请求，/表示匹配 除了.jsp的所有请求
      我们的web容器是 有能力处理 .jsp文件 请求的，
      我们 工程里的 web.xml  都是 继承与 tomcat里conf目录下的 web.xml;
      在我们的tomcat里的web.xml里，有配置 对应的默认的servlet处理器，如下：
  <servlet>
      <servlet-name>jsp</servlet-name>
      <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
      <init-param>
          <param-name>fork</param-name>
          <param-value>false</param-value>
      </init-param>
      <init-param>
          <param-name>xpoweredBy</param-name>
          <param-value>false</param-value>
      </init-param>
      <load-on-startup>3</load-on-startup>
  </servlet>

   The mappings for the JSP servlet
  <servlet-mapping>
      <servlet-name>jsp</servlet-name>
      <url-pattern>*.jsp</url-pattern>
      <url-pattern>*.jspx</url-pattern>
  </servlet-mapping>



  <servlet>
      <servlet-name>default</servlet-name>
      <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
      <init-param>
          <param-name>debug</param-name>
          <param-value>0</param-value>
      </init-param>
      <init-param>
          <param-name>listings</param-name>
          <param-value>false</param-value>
      </init-param>
      <load-on-startup>1</load-on-startup>
  </servlet>

  The mapping for the default servlet
  <servlet-mapping>
      <servlet-name>default</servlet-name>
      <url-pattern>/</url-pattern>
  </servlet-mapping>




  配置DispatcherServlet映射：
  通常为springmvc映射的路径url-pattern：
      0、配置：“*”  是不行的，映射路径 无法解析，启动时 会直接报错。
      1、配置：“/”  的意思是：除了.jsp的请求，都会被匹配；
      2、配置：“/*” 的意思是：所有的请求 都会匹配：/user、/user/getUser.jsp   ?
      3、配置：“*.do”  、“*.action”的意思是：url结尾以 .do 或者 .action 的请求 会匹配
      4、配置：“/request/*” 的意思是： 要进行约定，  将jsp放在/views/，所有的servlet请求都用 /request/
  -->
  <servlet-mapping>
    <servlet-name>springmvc</servlet-name>
    <!--
    /*和/都是拦截所有请求，
        /会拦截的请求，但是不包含 *.jsp,
        /* 的范围更大，还会拦截  *.jsp
    -->
    <url-pattern>/</url-pattern>
  </servlet-mapping>



  <!--
  来解决 POST乱码问题:
  配置 编码过滤器 CharacterEncodingFilter，用来解决 中文  POST请求 乱码问题.
  ！！！！！！！！一定要 写在 所有 过滤器——前面！！！！！！！！！！！！！
  -->
  <filter>
    <filter-name>characterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>

    <!--encoding 编码格式-->
    <!--解决 post请求 乱码-->
    <init-param>
      <param-name>encoding</param-name>
      <param-value>UTF-8</param-value>
    </init-param>

    <!-- 同时开启 请求 和 响应 的 编码设置-->
    <!--解决 响应 乱码-->
    <init-param>
      <param-name>forceEncoding</param-name>
      <param-value>true</param-value>
    </init-param>
  </filter>

  <!--配置 拦截 哪些请求 进行过滤-->
  <filter-mapping>
    <filter-name>characterEncodingFilter</filter-name>
    <!--拦截规则-->
    <!--
        <url-pattern>  根据  url请求  进行匹配  *
        <servlet-name>  指定 具体要过滤 哪个 servlet
    -->

    <!--配置：“/*”的意思是：所有的请求 都会匹配，包括 .jsp 和 任何静态文件
    <url-pattern>/*</url-pattern>
    -->
    <servlet-name>springmvc</servlet-name>
  </filter-mapping>


  <!--处理   “HTML中form表单提交功能 不支持 rest中 PUT 和 DELETE 请求方式”  的问题 -->
  <filter>
    <filter-name>hiddenHttpMethodFilter</filter-name>
    <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
  </filter>
  <filter-mapping>
    <filter-name>hiddenHttpMethodFilter</filter-name>
    <servlet-name>springmvc</servlet-name>
  </filter-mapping>



  <!--
      解决 HTTP Status 405 - JSPs only permit GET POST or HEAD 问题的一个方案：
      自定义 一个 过滤器，将 request.method 改回 POST

      <filter>
          <filter-name>xxxfilter</filter-name>
          <filter-class>自定义过滤器</filter-class>
      </filter>
      <filter-mapping>
          <filter-name>hiddenHttpMethod</filter-name>
          <servlet-name>springmvc</servlet-name>
          <dispatcher>FORWARD</dispatcher>
      </filter-mapping>-->


  <error-page>
    <error-code>404</error-code>
    <location>/404.html</location>
  </error-page>


</web-app>

@RequestMapping

@GetMapping

@PostMapping

@PutMapping

@DeleteMapping

@ModelAttribute

@RequestParam

@RequestHeader

@CookieValue

@RequestMapping("/user/{id}/{username}")
public String path01(@PathVariable("id") Integer id, @PathVariable("username") String name)

在web.xml里，添加  HiddenHttpMethodFilter 过滤器

在表单中 添加一个 有隐藏域 <input type="hidden" value="put" name="_method">   value就是 对应的 请求方式

将 form的 method 设置 POST

过滤器 就会 自动将 POST请求 修改成 隐藏域中 对应值的 请求

tomcat 7 以上的 版本 对 request.method 更加 严格：只支持 GET / POST / HEAD:HTTP Status 405 - JSPs only permit GET POST or HEAD

@RestController

默认是 进行转发;

重定向：必须加上redirect:

负责往 session里 写入数据 的
底层 会从 model中 去找一个 叫做 type的 属性
找到了 会将 type 设置一份 到 session 中；
这种方式 是 依赖 model的
@SessionAttributes写在类上，功能 在 当前控制器下,所有的 处理方法 都会 将 model 指定的属性, 写入session

/**
* @SessionAttribute，功能是 负责 获取 session 里的 数据的
*   required： 用来设置 session中 某个属性 必须存在 ， 不存在 则会报错：
*      HTTP Status 400 - Missing session attribute 'type' of type String
*
*   当使用注解的时：
*      model 和 session 是互通的：
*        session  会 从 model中  获取 指定的属性的值  并 自动写入 到 session中的 相同属性名称的 值中，
*        model  也会 从 session中 获取 指定的属性的值  并 自动写入 到 model 中的 相同属性名称的 值中；
*        或者这么描述：
*        session 从 session会话中 读取到 指定的属性的值后，也会往 model   中 设置一份 相同属性名称的 值
*        model   从 request会话中 读取到 指定的属性的值后，也会往 session 中 设置一份 相同属性名称的 值
* @param type
* @return
*/
@RequestMapping("/annotation/session")
public String session03(@SessionAttribute(value="type",required = false) String type,
                        Model model ){

@ModelAttribute 的作用
@ModelAttribute 是 Spring MVC 中一个重要的注解，主要有两种使用方式：

1.方法级别使用
当用在 方法上 时，@ModelAttribute 表示该方法 会在 控制器中 所有处理方法 之前 执行，用于准备模型数据：
特点：
会在 每个 请求处理方法 调用前 执行
用于添加 多个控制器 共享的 模型属性
方法返回值 会 自动添加 到 模型中

2.参数级别使用
当用在方法参数上时，@ModelAttribute 表示 从模型中  获取或创建对象：

特点：
- 可以从 表单 绑定数据 到 对象
- 如果模型中 不存在 指定名称 的 对象，会 自动 实例化
- 常用于 表单处理

主要作用
数据绑定：将 请求参数 绑定到 模型对象
数据预加载：在处理方法 执行 前 准备模型数据
数据共享：在多个 请求间 共享数据
表单处理：简化 表单对象的 创建 和 绑定

工作流程
Spring 检查是否有对应的 @ModelAttribute 方法
执行这些方法 并 将结果 添加到 模型
对于 参数级别 的 注解，从 模型 或 请求中 获取/创建 对象
执行请求处理方法
@ModelAttribute 是 Spring MVC 实现数据绑定和模型管理的重要机制。

* 被@ModelAttribute 注解过的方法，
* 会在 当前处理器 类 中，所有的 请求处理方法(被@RequestMapping注解过的方法) 执行之前 ，都会 先调用 此方法;

* 实现 数据验证的 步骤：
*      1.加入hibernate-validator依赖
*      2.一定要注意！！ 将 新加入的 jar包 加入到 WEB-INF/lib 中
*      3.在 需要验证的 javaBean的 属性上面，加入对应的 验证注解，可以设置 message属性，定制 更友好的 错误提示 信息
*      4.在 需要验证的 处理方法的 对应 javaBean 参数上，加上 @Valid
*      5.在 需要验证的 处理方法的 参数中，加入 BindingResult，代表 自己处理错误，这样就不会 显示 错误页面了。
*
*   基于 原生 html form表单 实现方式：
*      1.在 将 错误信息 循环通过 map 存入到 request域 中
*      2.在jsp 通过${errors.id} 获取 对应的 错误信息
*
*   基于 spring form标签库的 实现方式：
*      1.添加一个 显示jsp的 处理方法， 一定要 传入一个 空的 User 到 model 中
*      2.在jsp中， 导入 spring-form 标签库:<%@taglib prefix="form" uri="http://www.springframework.org/tags/form" %>
*      3.在form标签上，一定要 加上 ModelAtrribute="user"
*      4.加上对应的 form标签，  必须都要 以<form:开头

配置 自定义的 类型转换器
    当 配置了 自定义的 类型转换器，需要 将 实现类 改为：FormattingConversionServiceFactoryBean，
    才可以 同时支持 自定义 类型转换器 和 数据格式化的注解：@NumberFormat 和 @DateTimeFormat

     但是，同一个 数据类型的 类型转换器 会 先执行 自定义的  类型转换器,
          再在 自定义的 类型转换器 执行后的 结果的 基础上  再执行  相同数据类型的 注解的 类型转换器功能

*****************************  自定义 类型转换器  **************************
*  不常用，因为有 “数据格式化” 标签：@NumberFormat 和 @DateTimeFormat；
*
*  可以 直接使用 标签 直接在 类属性上 标注即可；
*  例如：在User类的birthday属性上标注 注解 @DateTimeFormat(pattern = "yyyy-MM-dd")就可以实现此类的功能
*
*  1.定义 类型转换器：   需要明确 源类型 和目标类型
*  2.在convert方法里，自定义 类型转换的 实现
*  3.在springmvc中，配置 自定义 类型转换器
*     <bean class="org.springframework.context.support.ConversionServiceFactoryBean" id="conversionService">
*         <property name="converters">
*             <set>
*                 <bean class="cn.tulingxueyuan.converters.MyStringToDateConverter"></bean>
*             </set>
*         </property>
*     </bean>
* 4.<mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven>

相当于 控制器类中 所有的 处理方法 都加上了 @ResponseBody, 适用于web api

响应json
1.pom.xml中 加入 jackson依赖
2.将 jackson的 jar包 加入 WEB-INF的lib 文件夹

·请求Json接收
使用 @RequestBody，前提是 要保证 请求过来的参数数据 一定是 json数据，并且 内容类型 也必须是 "application/json"，只有指定的数据格式，才能接收，否则拒绝请求

会将文件上传到三个地方：
1.项目路径（适用 项目小，上传 使用率 低）
2.磁盘路径 ，这种方式 需要通过 虚拟目录的 映射
3.静态资源 服务器（CDN）

基于servlet api的文件下载

基于 spring ResponseEntity的 文件下载

<mvc:view-controller>是Spring MVC框架中的一个配置元素，
主要用于 简化 视图控制器的 定义，特别适用于  那些  不需要 业务逻辑处理 的  简单页面跳转 场景。
        主要用途
        直接映射URL到视图：    无需编写控制器方法，直接将请求路径映射到视图名称
        简化配置：            减少简单页面跳转所需的控制器类和方法
        处理静态页面请求：    适用于首页、欢迎页、关于页等不需要业务逻辑的页面

基本语法 在Spring MVC的XML配置文件中使用：
<mvc:view-controller path="/welcome" view-name="welcomePage"/>

常见使用场景

<mvc:view-controller>是Spring MVC中 提高 开发效率 的 有用特性，特别适合项目中  大量  简单页面跳转  的 场景。

@WebFilter 是 Java Servlet 3.0 规范引入的注解，用于简化过滤器的配置，无需在 web.xml 中声明过滤器。

基本用法

执行顺序控制

常见应用场景

注意事项

完整示例

1、定义拦截器，必须要 实现 HandlerInterceptor
2、在springmvc配置文件中 增加 拦截器配置

1、在属性资源文件中，假如 需要 国际化的 硬编码内容
2、在spring-mvc.xml里，注册 国际化资源文件 到  messageSource对象里。
3、根据 messageSource.getMessage 获取 国际内容
string code:    资源文件中的key
Object[] args:  文本中的参数，可以用占位符的方式在资源文件文本中设置参数占位符：{0},{2}
Locale locale:  当前本地化语言对象

jsp页面上的<%@taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
jsp页面上的<spring:message，会自动获取对应的国际化信息

被 @ControllerAdvice 标记的类是 处理全局异常的类:

通过 @ExceptionHandler，可以在 方法中 记录日志
转发一个 友好的界面 进行提示：
经验：1.记录日志中
2.可以将 异常 转发到 错误页面， 将 错误信息 在一个 隐藏的div 中显示
如果 @ExceptionHandler标注的方法 写在 @Controller类中，只能处理 当前控制器类 的 处理方法

@ResponseStatus 是 Spring Framework 中的一个注解，主要用于控制 HTTP 响应的状态码和原因描述。它可以用在类级别或方法级别

通常用于以下场景

常见用途

注意事项