SpringMVC03：配置

本文为 SSM 框架系列之 SpringMVC 第三部分：配置
其它内容的链接如下：
【1】MyBatis01：初识 MyBatis 与第一个 MyBaits 程序
【2】MyBatis02：CRUD 操作
【3】MyBatis03：配置解析
【4】MyBatis04：作用域和生命周期
【5】MyBatis05：分页
【6】MyBatis06：日志
【7】MyBatis07：使用注解开发
【8】MyBatis08：ResultMap 的结果集映射
【9】MyBatis09：动态 SQL 与缓存

1 Controller 控制器
- 1.1 实现 Controller 接口
- 1.2 使用 Controller 注解
2 RestFul 风格
3 后端 URL 跳转
- 3.1 传统 Servlet API
- 3.2 ModelAndView
- 3.3 SpringMVC（无视图解析器版）
4 处理提交数据
5 数据显示到前端
- 5.1 使用 ModelAndView 对象
- 5.2 使用 ModelMap 对象
- 5.3 使用 Model 对象
- 5.4 三者差异
6 乱码问题的解决

1 Controller 控制器

控制器的实现部分有两种方法，也就是我在第二章和第三章分别使用的两种方法，第一种方式是实现 Controller 接口，另一种方式是使用 Controller 注解，两种方式。

1.1 实现 Controller 接口

public class ControllerTest1 implements Controller {
   public ModelAndView handleRequest(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse) throws Exception {
       // 一
       ModelAndView mv = new ModelAndView();
       // 二
       mv.addObject("msg","Test1Controller");
       // 三
       mv.setViewName("result");
       // 四
       return mv;
  }
}

但是这种方法需要在 springmvc 配置文件写入对应的 bean：

name 前需要有斜线

1.2 使用 Controller 注解

@Controller 注解用于声明 Spring 类的实例是一个控制器；
Spring 可以使用扫描机制来找到应用程序中所有基于注解的控制器类，为了保证 Spring 可以找到你的控制器，需要在配置文件中声明组件扫描。

增加一个ControllerTest2类，使用注解实现；

//@Controller 注解的类会自动添加到 Spring 上下文中
@Controller
public class ControllerTest2{
   //映射访问路径，可以把 requestMapping 看成是前一种方式配置的 bean
   @RequestMapping("/controllerTest2")
    // 如果方法的返回值是 String，且有具体页面可以跳转，那么该返回的值便可以被视图解析器解析
   public String index(Model model){
       //Spring MVC会自动实例化一个Model对象用于向视图中传值
       model.addAttribute("msg", "ControllerTest2");
       //返回视图位置
       return "result";
  }
}

2 RestFul 风格

Restful 就是一个资源定位及资源操作（即 url ）的风格，它不是标准也不是协议，只是一种风格。基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存。

代码说明一切~~

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.*;

@Controller
public class RestfulController {
    // 原来的 url：http://localhost:8080/add?a=1?b=2
    // Restful 风格的 url：http://localhost:8080/1/2

    @RequestMapping("/add/{a}/{b}")
    // 直接请求是一种 get 方式！！！
    // 当然还可以用下述具体的注解
//    @PutMapping
//    @GetMapping
//    @DeleteMapping
//    @PostMapping
    public String test1(@PathVariable int  a, @PathVariable int b, Model model){
        int res = a + b;
        model.addAttribute("number","值为"+res);
        return "result";
    }

    // 虽然我们的地址栏内容一样，但我们走的是不同的方法
    @PostMapping("/add/{a}/{b}")
    public String test2(@PathVariable int  a, @PathVariable int b, Model model){
        int res = a * b;
        model.addAttribute("number","值为"+res);
        // 可以发现，我们的两个请求都可以指向一个视图，但是页面结果的结果是不一样的，
        // 从这里可以看出视图是被复用的，而控制器与视图之间是弱偶合关系。
        return "result";
    }
}

3 后端 URL 跳转 3.1 传统 Servlet API

通过 Servlet API，不需要视图解析器。此时控制器 Controller 的代码为：

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@Controller
public class ResultGo {
    @RequestMapping("/result1")
    public void test1(HttpServletRequest req, HttpServletResponse rsp) throws IOException {
        // 一：通过 HttpServletResponse 进行控制栏输出
        rsp.getWriter().println("Hello,Spring BY servlet API");
    }

    @RequestMapping("/result2")
    public void test2(HttpServletRequest req, HttpServletResponse rsp) throws IOException {
        req.setAttribute("msg","My name is Sharm.");
        // 二：通过 HttpServletResponse 实现重定向
        rsp.sendRedirect("/WEB-INF/jsp/result.jsp");
    }

    @RequestMapping("/result3")
    public void test3(HttpServletRequest req, HttpServletResponse rsp) throws Exception {
        req.setAttribute("msg","My name is Sharm.");
        // // 三：通过 HttpServletResponse 实现转发
        req.getRequestDispatcher("/WEB-INF/jsp/result.jsp").forward(req,rsp);
    }
}

3.2 ModelAndView

通过 ModelAndView 对象，我们可以根据设置的 View 的名称，即setViewName，来跳转到指定的页面。

对应的页面 url 需要手动在 spring 的配置文件中的视图解析器中书写，如下：

此时控制器 Controller 的代码为：

import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

public class ResultGo implements Controller {
    @Override
    public ModelAndView handleRequest(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse) throws Exception {
        ModelAndView mv = new ModelAndView();

        // 这里的话就是一些一些业务代码，如业务层的操作、数据库的读取等，这里先略过
        String name = "输入的姓名是：Sharm";
        mv.addObject("msg", name);

        // 视图跳转，对应的 url 为：/WEB-INF/jsp/result.jsp
        mv.setViewName("result");
        return mv;
    }
}

3.3 SpringMVC（无视图解析器版）

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class ResultGo {
    @RequestMapping("/result1")
    public String test1(){
        // 默认为 转发
        return "/index.jsp";
    }

    @RequestMapping("/result2")
    public String test2(){
        // 可以手动书写 转发
        return "forward:/index.jsp";
    }

    @RequestMapping("/result3")
    public String test3(){
        // 重定向
        return "redirect:/index.jsp";
    }
}

4 处理提交数据

1 提交的域名称和处理方法的参数名一致

如：提交数据为：http://localhost:8080/hello?name=sharm

处理方法：

@RequestMapping("/hello")
public String hello(String name){
   System.out.println(name);
   return "result";
}

2 提交的域名称和处理方法的参数名不一致

如：提交数据为：http://localhost:8080/hello?username=sharm

处理方法：

@RequestMapping("/hello")
//@RequestParam("username") : username 提交的域的名称
public String hello(@RequestParam("username") String name){
   System.out.println(name);
   return "result";
}

3 当提交的是一个对象时

则后端需要设置实体类的属性和提交的表单参数一致，同时两者的名称需要相同，否则会注入失败。

如：提交数据：http://localhost:8080/user?name=sharm&id=1&age=24

需要设置实体类为：

public class User {
   private int id;
   private String name;
   private int age;
   // 无参和有参构造方法
   // getter 和 setter 方法
   // 重写 tostring() 方法
}

处理方法：

@RequestMapping("/user")
public String user(User user){
   System.out.println(user);
   return "result";
}

5 数据显示到前端 5.1 使用 ModelAndView 对象

public class ResultGo implements Controller {
    @Override
    public ModelAndView handleRequest(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse) throws Exception {
        ModelAndView mv = new ModelAndView();

        // 这里的话就是一些一些业务代码，如业务层的操作、数据库的读取等，这里先略过
        String name = "输入的姓名是：Sharm";
        mv.addObject("msg", name);

        // 视图跳转，对应的 url 为：/WEB-INF/jsp/result.jsp
        mv.setViewName("result");
        return mv;
    }
}

5.2 使用 ModelMap 对象

@RequestMapping("/hello")
public String hello(ModelMap model){
   //封装要显示到视图中的数据
   String name = "输入的姓名是：Sharm";
   model.addAttribute("msg",name);
   return "result";
}

5.3 使用 Model 对象

@RequestMapping("hello")
public String hello(Model model){
   //封装要显示到视图中的数据
   String name = "输入的姓名是：Sharm";
   model.addAttribute("msg",name);
   return "result";
}

5.4 三者差异

方法	特征
使用 ModelAndView 对象	ModelAndView 在存储数据的同时，可以进行设置返回的逻辑视图，进行控制展示层的跳转。
使用 ModelMap 对象	ModelMap 继承了 linkedMap ，除了实现了自身的一些方法，同样的继承 linkedMap 的方法和特性；
使用 Model 对象	Model 只有寥寥几个方法只适合用于储存数据，简化了新手对于Model对象的操作和理解；

6 乱码问题的解决

在 Web 开发过程中，除非所有的环境都配置为 UTF-8，不然肯定会出现乱码问题，所以如何找到并解决乱码问题很重要。

下面介绍找问题的流程，当出现乱码问题时，我们思考的步骤如下：

1 通过自定义过滤器解决乱码问题

① 书写 Servlet 的过滤器代码

package sharm.filter;

import javax.servlet.*;
import java.io.IOException;

public class EncodingFilter implements Filter {
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        
    }

    @Override
    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
        servletRequest.setCharacterEncoding("utf-8");
        servletResponse.setCharacterEncoding("utf-8");

        filterChain.doFilter(servletRequest, servletResponse);
    }

    @Override
    public void destroy() {

    }
}

② 在 web.xml 中增加过滤器标签


    encodeing
    sharm.filter.EncodingFilter



    encodeing
    
public class GenericEncodingFilter implements Filter {

   @Override
   public void destroy() {
  }

   @Override
   public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
       //处理response的字符编码
       HttpServletResponse myResponse=(HttpServletResponse) response;
       myResponse.setContentType("text/html;charset=UTF-8");

       // 转型为与协议相关对象
       HttpServletRequest httpServletRequest = (HttpServletRequest) request;
       // 对request包装增强
       HttpServletRequest myrequest = new MyRequest(httpServletRequest);
       chain.doFilter(myrequest, response);
  }

   @Override
   public void init(FilterConfig filterConfig) throws ServletException {
  }

}

//自定义request对象，HttpServletRequest的包装类
class MyRequest extends HttpServletRequestWrapper {

   private HttpServletRequest request;
   //是否编码的标记
   private boolean hasEncode;
   //定义一个可以传入HttpServletRequest对象的构造函数，以便对其进行装饰
   public MyRequest(HttpServletRequest request) {
       super(request);// super必须写
       this.request = request;
  }

   // 对需要增强方法 进行覆盖
   @Override
   public Map getParameterMap() {
       // 先获得请求方式
       String method = request.getMethod();
       if (method.equalsIgnoreCase("post")) {
           // post请求
           try {
               // 处理post乱码
               request.setCharacterEncoding("utf-8");
               return request.getParameterMap();
          } catch (UnsupportedEncodingException e) {
               e.printStackTrace();
          }
      } else if (method.equalsIgnoreCase("get")) {
           // get请求
           Map parameterMap = request.getParameterMap();
           if (!hasEncode) { // 确保get手动编码逻辑只运行一次
               for (String parameterName : parameterMap.keySet()) {
                   String[] values = parameterMap.get(parameterName);
                   if (values != null) {
                       for (int i = 0; i < values.length; i++) {
                           try {
                               // 处理get乱码
                               values[i] = new String(values[i]
                                      .getBytes("ISO-8859-1"), "utf-8");
                          } catch (UnsupportedEncodingException e) {
                               e.printStackTrace();
                          }
                      }
                  }
              }
               hasEncode = true;
          }
           return parameterMap;
      }
       return super.getParameterMap();
  }

   //取一个值
   @Override
   public String getParameter(String name) {
       Map parameterMap = getParameterMap();
       String[] values = parameterMap.get(name);
       if (values == null) {
           return null;
      }
       return values[0]; // 取回参数的第一个值
  }

   //取所有值
   @Override
   public String[] getParameterValues(String name) {
       Map parameterMap = getParameterMap();
       String[] values = parameterMap.get(name);
       return values;
  }
}

SpringMVC03：配置

Java相关栏目本月热门文章