SpringMVC03：配置解析

是志明呀

已于 2022-04-23 10:25:21 修改

阅读量493

点赞数 1

分类专栏： Java EE 文章标签：后端 springmvc java

于 2021-11-08 16:30:48 首次发布

本文链接：https://blog.csdn.net/weixin_44262126/article/details/121210586

版权

Java EE 专栏收录该内容

29 篇文章 5 订阅

订阅专栏

本文为 SSM 框架系列之 SpringMVC 第三部分：配置解析
其它内容的链接如下：
1. 传统 MVC
2. Hello SpringMVC
3. 配置解析
4. JSON的使用
5. AJAX 的使用
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 前需要有斜线
<bean name="/controllerTest1" class="sharm.controller.ControllerTest1"/>

1.2 使用 Controller 注解

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

<context:component-scan base-package="sharm.controller"/>
```

增加一个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 的配置文件中的视图解析器中书写，如下：

<!-- 视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"
      id="internalResourceViewResolver">
    <!-- 前缀 -->
    <property name="prefix" value="/WEB-INF/jsp/" />
    <!-- 后缀 -->
    <property name="suffix" value=".jsp" />
</bean>

此时控制器 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 中增加过滤器标签

<filter>
    <filter-name>encodeing</filter-name>
    <filter-class>sharm.filter.EncodingFilter</filter-class>
</filter>

<filter-mapping>
    <filter-name>encodeing</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

/ 和 /* 的区别：/ 不会匹配到 .jsp，只针对我们编写的请求，即 .jsp 不会进入 spring 的 DispatcherServlet 类而 /* 会匹配全部文件。

2 使用 SpringMVC 的官方过滤器（推荐）

在 web.xml 配置如下：

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

3 使用网络大神的自定义过滤器方法

import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletRequestWrapper;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.util.Map;

/**
* 解决get和post请求 全部乱码的过滤器
*/
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<String, String[]> 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<String, String[]> parameterMap = getParameterMap();
       String[] values = parameterMap.get(name);
       if (values == null) {
           return null;
      }
       return values[0]; // 取回参数的第一个值
  }

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