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;
}

测试:

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

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

  2. 编写一个 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;
        }
    }
    
  3. 在 SpringMVC 配置文件中注册请求的 bean,name 对应请求路径,class 对应处理请求的类

    <bean name="/t1" class="com.song.controller.ControllerDemoTest1"/>
    
  4. WEB-INF/jsp 目录下编写前端 test.jsp,对应视图解析器

    <%@ page contentType="text/html;charset=UTF-8" language="java" %>
    <html>
    <head>
        <title>Title</title>
    </head>
    <body>
    	${msg}
    </body>
    </html>
    
  5. 配置 Tomcat 运行测试,在浏览器地址栏输入 http://localhost:8080/t1

  6. 测试结果:页面上会显示 hello, ControllerDemoTest1

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

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

  • @Component 组件

  • @Service service

  • @Repository dao

测试:

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

    因为 Spring 可以使用扫描机制来找到应用程序中所有基于注解的控制器类,为了保证 Spring 能找到我们的控制器,需要在配置文件中声明组件扫描。

    <context:component-scan base-package="com.song.controller"/>
    
  2. 编写一个 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
        }
    }
    
  3. 配置 Tomcat 运行测试,在浏览器地址栏输入 http://localhost:8080/t2

  4. 测试结果:页面上会显示 hello, ControllerDemoTest2

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

5、RequestMapping

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

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

@Controller
public class ControllerTest3 {

    @RequestMapping("t1")
    public String test1(Model model){
        model.addAttribute("msg", "test3");
        return "test";
    }
}
@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 , 不需要视图解析器

  1. 通过 HttpServletResponse 进行输出

  2. 通过 HttpServletResponse 实现重定向

  3. 通过 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 处理提交数据

  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
    
  2. 提交的域名称和处理方法的参数名不一致

    • 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
    
  3. 提交的是一个对象

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

    注意:如果使用对象,前端传递的参数名和对象中的属性名必须一致,否则就是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 数据显示到前端

  1. 通过 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;
        }
    }
    
  2. 通过 ModelMap

    @Controller
    @RequestMapping("/user")
    public class UserController {
        
        @GetMapping("/t3")
        public String test3(ModelMap map){
            map.addAttribute("msg","ModelMap");
    
            return "test";
        }
    }
    
  3. 通过 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>
    
posted @ 2020-06-27 23:17  Song-zw  阅读(1406)  评论(0编辑  收藏  举报