SpringMVC【三】Controller/RequestMapping/结果跳转方式/数据处理

4、控制器 Controller

控制器：

控制器负责提供访问应用程序的行为，通常通过接口定义或注解定义两种方法实现
控制器负责解析用户的请求并将其转换为一个模型
在 Spring MVC 中一个控制器类可以包含多个方法
在 Spring MVC 中，对于 Controller 的配置方式有很多种

注意：

实现接口 Controller 定义控制器是较老的办法
缺点是：一个控制器中只有一个方法，如果要多个方法则需要定义多个 Controller，定义的方式比较麻烦

4.1 实现 Controller 接口

Controller 是一个接口（函数式接口），在 org.springframework.web.servlet.mvc 包下，实现该接口的类获得控制器功能，接口中只有一个方法，源码如下：

@FunctionalInterface
public interface Controller {
	//处理请求且返回一个模型与视图对象
   @Nullable
   ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception;
}

测试：

SpringMVC 的配置文件中只有视图解析器

不用配置处理器和适配器就可以使用，因为 Spring 自动帮我们配置了

编写一个 controller 类

// 只要实现了 Controller 接口的类，说明这就是一个控制器了
public class ControllerDemoTest1 implements Controller {
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
        ModelAndView mv = new ModelAndView();
        
        mv.addObject("msg","hello, ControllerDemoTest1");
        mv.setViewName("test");
        
        return mv;
    }
}

在 SpringMVC 配置文件中注册请求的 bean，name 对应请求路径，class 对应处理请求的类
```
<bean name="/t1" class="com.song.controller.ControllerDemoTest1"/>
```

WEB-INF/jsp 目录下编写前端 test.jsp，对应视图解析器

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
	${msg}
</body>
</html>

配置 Tomcat 运行测试，在浏览器地址栏输入 http://localhost:8080/t1
测试结果：页面上会显示 hello, ControllerDemoTest1

扫描二维码关注公众号，回复： 11379593 查看本文章

4.2 使用注解 @Controller【平时使用的最多的方式】

@Controller 注解类型用于声明 Spring 类的实例是一个控制器（IOC 中还有 3 个相同功能的注解）：

@Component 组件
@Service service
@Repository dao

测试：

SpringMVC 的配置文件中除了配置视图解析器，还要配置自动扫描包

因为 Spring 可以使用扫描机制来找到应用程序中所有基于注解的控制器类，为了保证 Spring 能找到我们的控制器，需要在配置文件中声明组件扫描。
```
<context:component-scan base-package="com.song.controller"/>
```

编写一个 controller 类，使用注解实现；

// 被这个注解的类中的所有方法，如果返回值是String，并且有具体的页面可以跳转，那么就会被视图解析器解析
@Controller // 代表这个类会被 Spring接管，
public class ControllerTest2 {

    @RequestMapping("/t2")   //映射访问路径
    public String test(Model model){
		//Spring MVC会自动实例化一个Model对象用于向视图中传值
        model.addAttribute("msg", "Hello, ControllerTest2");
		//返回视图位置
        return "test"; //  WEB-INF/jsp/test.jsp
    }
}

配置 Tomcat 运行测试，在浏览器地址栏输入 http://localhost:8080/t2
测试结果：页面上会显示 hello, ControllerDemoTest2

注意：这两种实现控制器的方式，两个请求都可以指向一个视图，但是页面的结果是不一样的，从这里可以看出视图是被复用的，即控制器与视图之间是弱耦合关系。

5、RequestMapping

@RequestMapping 注解用于映射 url 到控制器类或一个特定的处理程序方法。

可用于类或方法上。用于类上，表示类中的所有响应请求的方法都是以该地址作为父路径。

只注解在方法上：访问路径：http://localhost:8080 / 项目名 / t1

@Controller
public class ControllerTest3 {

    @RequestMapping("t1")
    public String test1(Model model){
        model.addAttribute("msg", "test3");
        return "test";
    }
}

同时注解类和方法上：访问路径：http://localhost:8080 / 项目名 /c3/t1

@Controller
//@RequestMapping("/c3")
public class ControllerTest3 {

    //@RequestMapping("/t1")
    public String test1(Model model){
        model.addAttribute("msg", "test3");
        return "test";
    }
}

注意：一般直接在方法上写 //@RequestMapping("/c3/t1")，和同时在类和方法上注解作用一样。

6、结果跳转方式

6.1 ModelAndView

设置 ModelAndView 对象 , 根据 view 的名称和视图解析器跳到指定的页面

页面 : 视图解析器前缀 + viewName + 视图解析器后缀

public class ControllerDemoTest1 implements Controller {
   
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
        ModelAndView mv = new ModelAndView();
        
        mv.addObject("msg","hello, ControllerDemoTest1");
        mv.setViewName("test");
        //返回一个模型视图对象
        return mv;
    }
}

6.2 ServletAPI

通过设置 ServletAPI , 不需要视图解析器

通过 HttpServletResponse 进行输出
通过 HttpServletResponse 实现重定向
通过 HttpServletRequest 实现转发

@Controller
public class ModelTest {

    @RequestMapping("/m/t1")
    public String test1(HttpServletResponse response, HttpServletRequest request){
        HttpSession session = request.getSession();
        System.out.println(session.getId());
        return "test";
    }
    
    @RequestMapping("/m/t2")
   	public void test2(HttpServletRequest req, HttpServletResponse rsp) throws IOException {
       	rsp.getWriter().println("Hello,Spring By servlet API");
  }

   	@RequestMapping("/m/t3")
   	public void test3(HttpServletRequest req, HttpServletResponse rsp) throws IOException {
       	rsp.sendRedirect("/index.jsp");
  }

   	@RequestMapping("/m/t4")
   	public void test4(HttpServletRequest req, HttpServletResponse rsp) throws Exception {
      	 //转发
       	req.setAttribute("msg","/m/t4");
       	req.getRequestDispatcher("/WEB-INF/jsp/test.jsp").forward(req,rsp);
  }
}

6.3 SpringMVC

通过 SpringMVC 来实现转发和重定向有两种方式：需要视图解析器和没有视图解析器

无需视图解析器（测试前，需要将视图解析器注释掉）
有视图解析器

重定向不需要视图解析器，本质就是重新请求一个新地方，所以注意路径问题。可以重定向到另外一个请求实现。

public class ModelTest1 {
	// 没有视图解析器
    @RequestMapping("m1/t2")
    public String test2(Model model){
        model.addAttribute("msg","model test2");
        // 转发
//        return "/WEB-INF/jsp/test.jsp";
//        return "forward:/WEB-INF/jsp/test.jsp";
        // 重定向
        return "redirect:/index.jsp";
	}
    
    // 有视图解析器，默认转发，重定向的话要加上 redirect:/
    @RequestMapping("m1/t3")
    public String test3(Model model){
        model.addAttribute("msg","model test3");
        // 转发
//        return "test";
        // 重定向
        return "redirect:/index.jsp";
    }

7、数据处理

7.1 处理提交数据

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

Controller 类：

提交的域名称为 name，方法参数名为 name，可以直接识别

@Controller
@RequestMapping("/user")
public class UserController {

    // localhost:8080/user/t1?name=xxx
    @GetMapping("/t1")
    public String test1(String name, Model model){
        //1.接收前端参数
        System.out.println("接收到前端的参数为" + name);
        //2.将返回的结果传递给前端 Model
        model.addAttribute("msg", name);

        return "test";
    }
}

结果：

提交数据： localhost:8080/user/t1?name=xxx
控制台输出：xxx
前端 test.jsp 页面显示：xxx

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

Controller 类：

提交的域名称为 username，方法参数名为 name，要用 @RequestParam(" ") 注解将来自前端的参数命名为和前端提交的域名称一致。【建议来自前端的参数都加上这个注解 @RequestParam】

// localhost:8080/user/t1?username=xxx
// @RequestParam 建议来自前端的参数都加上这个
@GetMapping("/t1")
public String test1(@RequestParam("username") String name, Model model){
    //1.接收前端参数
    System.out.println("接收到前端的参数为" + name);
    //2.将返回的结果传递给前端 Model
    model.addAttribute("msg", name);

    return "test";
}

结果：

提交数据： localhost:8080/user/t1?username=xxx
控制台输出：xxx
前端 test.jsp 页面显示：xxx

提交的是一个对象

要求提交的表单域和对象的属性名一致 , 方法中的参数使用对象即可。

注意：如果使用对象，前端传递的参数名和对象中的属性名必须一致，否则就是null。

实体类 User

@Data
@NoArgsConstructor
@AllArgsConstructor
public class User {
    private int id;
    private String name;
    private int age;
}

Controller 类：

// 前端接收的是一个对象 id name age
/*
    1.接收前端用户传递的参数，判断参数的名字，假设名字直接在方法上，可以直接使用
    2.假设传递的是一个对象，匹配对象的字段名，如果名字一致则 OK，否则，匹配不到
 */
@GetMapping("/t2")
public String test2(User user){
    System.out.println(user);
    return "test";
}

结果

提交数据： localhost:8080/user/t1?name=zhangsan&id=1&age=3
控制台输出：User(id=1, name=zhangsan, age=3)

7.2 数据显示到前端

通过 ModelAndView（实现 Controller 接口）

public class ControllerDemoTest1 implements Controller {
    
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
        ModelAndView mv = new ModelAndView();
        mv.addObject("msg","hello, ControllerDemoTest1");
        mv.setViewName("test");

        return mv;
    }
}

通过 ModelMap

@Controller
@RequestMapping("/user")
public class UserController {
    
    @GetMapping("/t3")
    public String test3(ModelMap map){
        map.addAttribute("msg","ModelMap");

        return "test";
    }
}

通过 Model

@Controller
@RequestMapping("/user")
public class UserController {
    
    @GetMapping("/t1")
    public String test1(@RequestParam("username") String name, Model model){
        model.addAttribute("msg", name);

        return "test";
    }
}

三种方式的对比：

ModelAndView 可以在储存数据的同时，可以进行设置返回的逻辑视图，进行控制展示层的跳转。
ModelMap：继承了 LinkedHashMap，除了实现了自身的一些方法，还拥有 LinkedHashMap 的全部功能。
Model：精简版，只有寥寥几个方法只适合用于储存数据，简化了新手对于Model对象的操作和理解，（大部分情况，我们都直接使用 Model）。

7.3 乱码问题

将后台的中文数据显示页面时会出现乱码问题，乱码问题都是通过过滤器解决。

注意：get 方式不会乱码，post 方式会乱码。

SpringMVC 给我们提供了一个过滤器 , 可以在 web.xml 中配置。

<!--配置 springMVC 的乱码过滤，注意：<url-pattern> 要使用 /*-->
<filter>
    <filter-name>encoding</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>utf-8</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>encoding</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

之前的做法

编写一个过滤器的类 EncodingFilter，实现 Filter 接口，并将其配置在 web.xml 文件中。

乱码问题得以解决。

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

    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        request.setCharacterEncoding("utf-8");
        response.setCharacterEncoding("utf-8");
        chain.doFilter(request,response);
    }
    
    public void destroy() { 
    }
}

<!--注意：使用 /* 可以解决乱码问题，/ 不可以-->
<filter>
    <filter-name>encoding</filter-name>
    <filter-class>com.song.filter.EncodingFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>encoding</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>