SpringMVC学习笔记

一、SpringMVC简介
1.什么是MVC
Model：数据模型
View：视图
Controller：控制器

MVC是一种Web应用架构，是一种代码设计思想
思想：将所有客户端请求交由控制器，由控制器将其进行分发，并将结果响应给客户端。

2.常见MVC框架
使用原生Servlet实现MVC：

• 配置比较复杂
• 数据处理太麻烦

实际开发中一般都会使用MVC框架，如Struts1、Struts2、SpringMVC等

对比：

• 效率方面，Struts1>SpringMVC>Struts2
  Struts2是多例的，效率低
  Struts1和SpringMVC是单例的，两者效率差不多。
• 配置方面：SpringMVC>Struts2>Struts1

3.为什么使用SpringMVC

• 使用注解来替代xml配置，更简单
• 是单例的，效率高
• 用户可以自定义，扩展性好
• SpringMVC和Spring无缝衔接

二、SpringMVC实现原理
1.流程图

springMVC运行原理

2.执行过程

• DispatcherServlet
  SpringMVC核心控制器(前端控制器)：主要是用来分发请求的
• HandlerMapping
  映射处理器：根据请求的url来映射查找到对应的Handler
  Handler就是Controller层的实现类
• HandlerAdapter
  适配器：用来适配不同的处理器Handler
  处理器有两种实现方式：实现接口、基于注解，所以执行前需要先适配
• Handler
  处理器：真正用来处理和执行业务，并产生数据模型Model和视图View，
  Handler会将Model和View封装成ModelAndView对象并返回。
• ViewResolver
  视图解析器：根据视图名称解析成具体的视图，一般多为jsp页面，然后把它封装成View对象并返回。
• View
  视图：使用具体的视图技术进行渲染，结合Model进行数据展示。
  视图有很多种形式：jsp、freemarker、velocity、excel、pdf等。

三、第一个SpringMVC程序
1.添加jar包

        
        
            org.springframework
            spring-webmvc
            ${spring.version}
        

2.配置核心控制器

  
    springMVC
    org.springframework.web.servlet.DispatcherServlet
    
    1
  
  
    springMVC
    /
  

3.创建配置文件
两种定义方式：

• 使用默认的位置，默认在WEB-INF/目录下，
  名称为：核心Servlet名称-servlet.xml
  例如：springMVC-servlet.xml
• 自定义位置，名称自定义

根据Controller实现方式的不同，配置方式也有所不同，有两种方式定义Controller

• 实现接口
• 基于注解

3.1实现接口的Controller

public class HelloController implements Controller {
    @Override
    public ModelAndView handleRequest(HttpServletRequest req, HttpServletResponse resp) throws Exception {
        //获取请求信息
        String name = req.getParameter("name");
        ModelAndView mav = new ModelAndView();
        //在ModelAndView中添加属性
        mav.addObject("msg","Hello "+name);
        //指定视图路径
        mav.setViewName("hello");
        //返回
        return mav;
    }
}

springMVC-servlet.xml

3.2 基于注解的Controller

@Controller
public class HelloAnnotationController {

    @RequestMapping("/hello")
    public ModelAndView sayHello(String name){
        ModelAndView mav = new ModelAndView();
        mav.addObject("msg","你好 "+name);
        mav.setViewName("hello");
        return mav;
    }
}

springmvc.xml

注意：也可以使用来省略映射处理器和映射适配器。

四、静态资源的放行
当DispatcherServlet的/配置为/时，会拦截所有请求，其中包括静态资源。

问题：因为DispatcherServlet会将静态资源当作Controller，所以会拿到HandlerMapping中去查找。
解决1：

• 使用Tomcat提供的默认Servlet
  tomcat提供了默认的Servlet来处理静态资源

缺点：

• 如果使用的不是Tomcat，有可能不生效
• 只能读取webapp下的资源，无法读取WEB-INF下的资源

解决2：

• 在SpringMVC配置文件中添加
  

2.直接访问jsp页面
问题：默认不能直接访问WEB-INF下的jsp页面，一般都是在Controller中做转发的映射
解决：在SpringMVC配置文件中添加如下语句

五、Controller详解
1.方法的返回值，共有四种类型：

• ModelAndView：表示返回的是数据模型和视图名
• String：表示返回的是视图的名字
  三种写法（形式）：
  普通字符串-->表示视图名称
  "forward:"+url-->转发
  "redirect:"+url-->重定向
• void：将请求的url作为视图名称，很少使用
• Object：表示返回的是数据模型（一般返回的是json数据）

2.SpringMVC注解

SpringMVC常用注解

3.@RequestMapping
3.1 基本用法
该注解可以定义在方法上，也可以定义在类上，用来表示层级关系。

配置URL时以/开头和不以/开头的区别：
添加/代表从项目的根目录开始访问，不添加/代表从当前位置开始查找。

3.2 URL的多种写法
请求映射路径有三种写法：

• Ant风格
  *：表示单层目录，可以匹配任意字符 ，但是只能在一个层级中
  **：表示多层或单层目录，可以没有字符，“/”也可以没有
  ?：表示单个字符，必须有一个字符
• Rest风格
  {变量}：表示url中的占位符，可以结合@PathVariable获取值
  {变量:正则}：表示使用正则表达式来限定值的格式
• 固定写法
  value和path互为别名，值为数组，可以指定多个值

3.3 根据请求方式来访问
限定请求方式：GET、POST、PUT、DELETE等

    /**
     * 根据请求方式访问
     */
    @RequestMapping(value = "/test6",method = RequestMethod.GET)
    public String test6(){
        return "hello";
    }

//    @RequestMapping(path = "/user/{id}",method = RequestMethod.GET)
    @GetMapping("/user/{id}")
    public String deleteUser(@PathVariable Integer id){
        System.out.println("delete user id:"+id);
        return "hello";
    }

//    @RequestMapping(path = "/user/{id}",method = RequestMethod.POST)
    @PostMapping("/user/{id}")
    public String selectUser(@PathVariable Integer id){
        System.out.println("select user id:"+id);
        return "hello";
    }

3.4 其他属性

• params
  限定请求参数，必须符合指定条件

    //请求参数中必须包含id，uname必须为admin,pwd不能是123
    @RequestMapping(path = "/test7",params = {"id","uname=admin","pwd!=123"})
    public String test7(){
        return "hello";
    }

• headers
  限定请求头，必须符合指定条件才能访问url

    //请求头中必须包含Cookie
    @RequestMapping(path = "/test8",headers = {"Cookie"})
    public String test8(){
        return "hello";
    }

六、方法的参数
1.JavaEE组件

• HttpServletRequest
• HttpServletResponse
• HttpSession

2. IO流

• InputStream/OutputStream
• Reader/Writer

3. 向界面传递数据
   Model、Map、ModelMap
   将数据存储到request作用域中

4.String和基本数据类型

• @RequestParam：
  表示参数值来源于同名请求参数，默认所有参数都添加该注解。
  但是如果手动添加了注解，就必须为参数传值。
  如果不传参数值可以在注解中使用required属性，将值改为false。
  也可以添加defaultValue属性，为参数添加默认值。
• @PathVariable
  表示参数来源于url
• @RequestHeader
  表示参数来源于请求头
• @CookieValue
  表示参数来源于Cookie
• @RequestBody
  表示参数来源于请求体（只有POST请求才有请求体）

5.自定义类型
@ModelAttribute：
将请求数据转化为对象
条件：对象的属性名必须与表单元素一致
@ModelAttribute注解的两种用法

• 在方法参数前面添加该注解
  作用：将请求参数转换为对象
• 在方法上面添加该注解
  作用：在调用所有目标方法前都会调用添加@ModelAttribute注解的方法，并向模型中添加数据

6.错误参数

• Errors、BindingResult
  用来获取错误信息，实现服务端的数据校验

实际开发中，既要做客户端表单校验，又要做服务端表单校验

7、服务器校验框架
1.简介
1.1 JSR303校验
JSR303是一个数据验证的标准规范，用于对JavaBean中的属性进行校验，称为Bean Validation。

提供了常用的校验的注解
1.2 Hibernate Validator
是JSR303的一个参考实现，并提供了扩展注解

2.用法
2.1 添加jar包

    
        org.hibernate
        hibernate-validator
        ${hibernate-validator.version}
      

      
        org.hibernate
        hibernate-validator-annotation-processor
        ${hibernate-validator-annotation-processor.version}
      

2.2 为参数对象添加注解
在需要校验的对象前面添加@Valid注解

2.3 为对象中的属性添加注解
示例：

  @NotEmpty(message = "用户名不能为空")
  @Pattern(regexp = "\\w(6,10)",message = "用户名只能包含数字，字母，下划线，且长度为6~10位")
  private String uname;
  
  @Length(min = 6,max = 16,message = "密码长度必须为6~16位")
  private String pwd;
  
  @Pattern(regexp = "(139|133|131)\\d{8}",message = "手机号格式不正确")
  private String phone;
  
  @Email(message = "邮箱格式不正确")
  private String email;
  
  @Range(min = 1,max = 120,message = "年龄必须在1~120之间")
  private int age;

8、类型转换
1.简介
数据绑定流程：获取值--->查找转换器--->转换--->后台数据校验--->数据绑定

两种解决方式：

• 方式1：使用PropertyEditor
• 方式2：使用Converter(推荐)

2.使用PropertyEditor
步骤：
- 定义属性编辑器
- 注册属性编辑器
@InitBinder

缺点：

• 代码是嵌套在Controller层中
• 只能从字符串转换成相应的对象

3.使用Converter
步骤：

• 定义转换器，实现Converter接口。
• 配置自定义转换器

• 加载自定义转换器

9.@SessionAttributes
作用：将模型中指定名称的数据存储到session中

10.统一异常处理
1.简介
对异常进行统一处理
两种方式：

• 使用web技术提供的统一异常处理
• 使用SpringMVC提供的异常处理

2.使用web技术的异常处理

  
  
    404
    /404.jsp
  

  
  
    500
    /500.jsp
  

3.使用SpringMVC的异常处理
步骤：
1.定义一个异常处理类(通知)，添加@ControllerAdvice注解
2.定义异常方法并添加@ExceptionHandler注解

@ControllerAdvice
public class ExceptionAdvice {

    @ExceptionHandler(ArithmeticException.class)
    public String arithmetic(Exception e){
        System.out.println(e);
        System.out.println("警报！程序出现算数异常"+e.getMessage());
        return "error/arithmetic";
    }

    @ExceptionHandler(NullPointerException.class)
    public String nullPointer(Exception e){
        System.out.println(e);
        System.out.println("警报！程序出现空指针异常"+e.getMessage());
        return "error/nullPointer";
    }

    @ExceptionHandler(Exception.class)
    public String exception(Exception e){
        System.out.println(e);
        System.out.println("警报！程序出现异常"+e.getMessage());
        return "error/exception";
    }
}

11.拦截器
1.简介
使用Interceptor对请求进行拦截，类似于过滤器Filter

2.用法
步骤：
1.定于一个类，InterceptorHandler
2.实现接口中的方法
3.配置拦截器

12.处理AJAX
1.@ResponseBody
为方法添加该注解中，会将返回值写到响应体中

2.返回JSON
三种方式：

• jackson：SpringMVC默认支持
• gson：SpringMVC默认支持，google开发
• fastjson：SpringMVC默认不支持，alibaba开发

2.1 使用jackson
步骤：
1.添加jar包

      
      
        com.fasterxml.jackson.core
        jackson-databind
        ${jackson-databind.version}
      

2.配置消息转换器(可省略)

2.2 使用gson
步骤：
1.添加jar包

      
        com.google.code.gson
        gson
        ${gson.version}
      

2.配置消息转换器(可省略)

2.3 使用fastjson
步骤：
1.引入jar包

      
        com.alibaba
        fastjson
        ${fastjson.version}
      

2.配置消息转换器

13.文件的上传单个与多个以及文件下载
1.单个文件上传
1.1 简介
SpringMVC对文件上传提供了支持，基于commons-fileupload

1.2 用法
步骤：
1.添加jar包

      
        commons-fileupload
        commons-fileupload
        ${commons-fileupload.version}
      

2.编写上传页面
注意：因为是上传文件，所以需要使用enctype属性指定上传类型

3.配置文件解析器
注意：因为文件使用的是二进制格式，所以需要配置文件解析器

4.创建Controller
注意：因为上传的文件数据是从请求参数中来，所以需要添加@RequestParam注解

  @Controller
@RequestMapping("/file")
public class FileController {

    @RequestMapping("/upload")
    public String upload(@RequestParam CommonsMultipartFile multipartFile) throws IOException {
        System.out.println(multipartFile);
        System.out.println("文件名："+multipartFile.getOriginalFilename());
        System.out.println("表单名称："+multipartFile.getName());

        //指定上传的位置
        String path = "D:/";
        //获取上传的文件的文件名
        String filename = multipartFile.getOriginalFilename();
        //上传
        multipartFile.transferTo(new File(path,filename));
        return "success";
    }
}

2.多个文件上传
步骤：
1.编写上传页面

2.编写Controller

@Controller
@RequestMapping("/file")
public class FileController {

    @RequestMapping("/upload")
    public String upload(@RequestParam CommonsMultipartFile[] multipartFiles, HttpSession session) throws IOException {
        //指定上传的位置
        String path = "D:/";
        for (CommonsMultipartFile img : multipartFiles) {
            //获取上传的文件的文件名
            String filename = img.getOriginalFilename();
            //上传
            img.transferTo(new File(path,filename));
        }
        return "success";
    }
}

3.文件下载
步骤：
1.编写下载页面

点击下载

2.创建Controller

    @RequestMapping("/download")
    public ResponseEntity download() throws IOException {
        //指定下载文件
        File file = new File("D:/美女.png");
        //通过输入流将文件传入
        FileInputStream is = new FileInputStream(file);
        //创建字节数组,并将数组大小设置为预估的文件字节数
        byte[] bytes = new byte[is.available()];
        //将输入流中的字符存储到缓存数组中
        is.read(bytes);
        //获取下载显示的文件名，并解决中文乱码
        String name = file.getName();
        String downloadFileName = new String(name.getBytes("UTF-8"), "ISO-8859-1");
        //设置Http响应头信息，并且通知浏览器以附件形式进行下载
        HttpHeaders httpHeaders = new HttpHeaders();
        httpHeaders.add("Content-Disposition","attachment;filename="+downloadFileName);
        //设置Http响应状态信息  OK代表正常
        HttpStatus status = HttpStatus.OK;
        ResponseEntity responseEntity = new ResponseEntity<>(bytes, httpHeaders, status);
        return responseEntity;
    }