腾讯云

文章/答案/技术大牛

发布

社区首页 >专栏 >SpringMVC基础（上篇）

SpringMVC基础（上篇）

发布于 2022-03-12 06:51:24

34700

代码可运行

文章被收录于专栏：OY_学习记录OY_学习记录

运行总次数：0

代码可运行

资料已经打包放在博客下面（文章末尾）
源码分析
源代码

一、SpringMVC 入门案例

个人 CSDN 博客：CSDN

点击链接查看：SpringMVC 之永远的 Hello world

二、 @RequestMapping 注解

1、@RequestMapping 概念

在控制器的类定义及方法定义处都可标注 @RequestMapping ① 标记在类上：提供初步的映射信息。相对于 WEB 应用的根目录 ② 标记在方法上：提供一步的细分映射信息。相对于标记在类的 URL
若类上未标注 @RequestMapping，则方法处标记的 URL 相对于 WEB 应用的根目录
作用：DispatcherServlet 截获请求后，就通过控制器上 @RequestMapping 提供的映射信息确定请求所对应的处理方法。

2、RequestMapping 可标注的位置

@RequestMapping：设置请求映射，把请求和控制层中的方法设置映射关系

当请求路径和@RequestMapping 的 value 属性值一致时，则该注解的方法即为处理请求的方法

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

@RequestMapping 可以加在类上，也可加在方法上。

@Controller
@RequestMapping("/test")
public class ControllerTest {

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

若类和方法上加得有，应该一层一层的访问，先访问类，在访问类中的方法

3、RequestMapping 映射请求方式

method：用来设置请求方式只有客户端发送请求方式和 method 的值一致，才能处理请求。请求方式： GET（查询） POST（添加）PUT（修改）DELETE（删除）

@RequestMapping(value = "/hello", method = RequestMethod.GET)

params: 用来设置客户端传到服务器的数据，支持表达式。例如：username !username username=admin username!=admin

@RequestMapping(value = "/hello", params= {"username","age!=12"} )

headers: 用来设置请求头信息，所发送的请求的请求头信息一定要和 headers 属性中所设置的一致

@RequestMapping(value = "/hello", headers= {"Accept-Language=zh-CN,zh;q=0.8,zh-TW;q=0.7,zh-HK;q=0.5,en-US;q=0.3,en;q=0.2"} )

4、RequestMapping 支持 Ant 路径风格

Ant 风格资源地址支持 3 种匹配 ?：匹配文件名中的一个字符 *：匹配文件名中的任意字符 **：** 匹配多层路径
@RequestMapping 支持 Ant 风格的 URL 例如：/user/*/createUser 匹配 /user/aaa/createUser、/user/bbb/createUser 等 URL 例如：/user/**/createUser 匹配 /user/createUser、/user/**aaa/bbb/**createUser 等 URL

@RequestMapping(value = "/*/ant??/**/testAnt")
public String hello1(){
  System.out.println("hello");
   return "hello";
}

5、RequestMapping 映射请求占位符 PathVariable 注解

通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中：URL 中的 {xxx} 占位符可以通过 @PathVariable(“xxx“) 绑定到操作方法的入参中。

@RequestMapping("/testREST/{id}/{username}")
public String testREST(@PathVariable Integer id, @PathVariable String username){
   System.out.println("id=" + id +",username="+username);
   return "hello";
}

三、REST

1、简介 REST

REST：即 Representational State Transfer 。（资源）表现层状态转化。是目前最流行的一种互联网软件架构。

2、配置 HiddenHTTPMethodFilter 过滤器

在web.xml中配置

<filter>
	<filter-name>HiddenHttpMethodFilter</filter-name>
	<filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
</filter>
<filter-mapping>
	<filter-name>HiddenHttpMethodFilter</filter-name>
	<url-pattern>/*</url-pattern>
</filter-mapping>

3、原理图

4、代码示例

GET

在 web 目录下创建 rest.jsp 文件

<body>
    <a href="testREST/100">测试GET</a>
</body>

@RequestMapping(value = "/testREST/{id}",method = RequestMethod.GET)
public String getUserById(@PathVariable("id") Integer id){
    System.out.println("GET,id="+id);
    return "success";
}

POST

【rest.jsp】

<form action="testREST" method="post">
    <input type="submit" value="测试POST">
</form>

@RequestMapping(value = "/testREST", method = RequestMethod.POST)
public String insertUser(){
    System.out.println("POSt");
    return "success";
}

PUT

【rest.jsp】

<form action="testREST" method="POST">
    <input type="hidden" name="_method" value="PUT" />
    <input type="submit" value="测试PUT" />
</form>

@RequestMapping(value = "/testREST", method = RequestMethod.POST)
public String insertUser(){
    System.out.println("POSt");
    return "success";
}

DELETE

【rest.jsp】

<form action="testREST/1001" method="POST">
    <input type="hidden" name="_method" value="DELETE" />
    <input type="submit" value="测试DELETE" />
</form>

@RequestMapping(value = "/testREST/{id}", method = RequestMethod.DELETE)
public String deleteUser(@PathVariable("id") Integer id){
    System.out.println("DELETE, id=" + id);
    return "success";
}

注意：测试 PUT 和 DELETE 中 Tomcat 为 8.0 或者以上，则会出现以下报错

解决方式：【 JSP 只允许 GET、POST 或 HEAD】

在你要跳转到的目标页面的下面这句代码里面添加**isErrorPage=”true”**即可，如下：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>

改为

<%@ page contentType="text/html;charset=UTF-8" language="java" isErrorPage="true"%>

四、处理请求数据

请求参数：请求参数 cookie 信息请求头信息….

JavaWEB: HttpServletRequest

Request.getParameter(参数名)； Request.getParameterMap();

Request.getCookies();

Request.getHeader();

1、请求处理的方法签名

Spring MVC 通过分析处理方法的签名(方法名+ 参数列表)， HTTP 请求信息绑定到处理方法的相应形参中。
Spring MVC 对控制器处理方法签名的限制是很宽松的，几乎可以按喜欢的任何方式对方法进行签名。
必要时可以对方法及方法入参标注相应的注解（ @PathVariable 、 @RequestParam、@RequestHeader 等）、
Spring MVC 框架会将 HTTP 请求的信息绑定到相应的方法入参中，并根据方法的返回值类型做出相应的后续处理。

2、@RequestParam 注解

@RequestParam 可以把请求参数传递给请求方法
在处理请求的方法中，加入相对应的形参，保证形参数名和传递的数据的参数名保持一致，就可以自动赋值
value：当不满足赋值条件时，可以使用 value 属性，指定映射关系
required：设置形参是否赋被赋值，默认为 ture，必须赋值，若设置为 false，则不必须赋值，因此形参的值为 null
defaultValue：若形参所获取得的值为 null,则设置一个默认值，用在分页和模糊查询中

代码示例：

【param.jsp】

<body>
    <form action="param" method="post">
        username:<input type="text" name="username"><br>
        password:<input type="text" name="password"><br>
        age:<input type="text" name="age"><br>
        <input type="submit" value="提交">
    </form>
</body>

【ParamController.java】

@RequestMapping(value = "/param",method = RequestMethod.POST)
   public String param(@RequestParam(value = "username",required =false, defaultValue = "xiaoming") String name, String password, String age){
       System.out.println("name="+name+",password="+password+",age="+age);
       return "success";
   }

3、@RequsetHeader 注解

使用@RequestHeader 绑定请求头的属性值
请求头包含若干个属性，服务器可据此获知客户端的信息，通过@RequestHeader 即可将请求头的属性绑定到处理方法的入参中

@RequestMapping(value = "/param", method = RequestMethod.POST)
public String param(@RequestHeader("Accept-Language") String AcceptLanguage){
    System.out.println("AcceptLanguage="+AcceptLanguage);
    return "success";
}

4、@CookieValue 注解

使用@CookieValue 绑定请求中的 cookie 值
@CookieValue 可让处理的方法入参绑定某个 Cookie 值

@RequestMapping(value = "/param", method = RequestMethod.POST)
public String param(@CookieValue(value ="JSESSIONID" ) String  JSESSIONID){
    System.out.println("JSESSIONID"+JSESSIONID);
    return "success";
}

5、使用 POJO 作为参数

使用 POJO 对象绑定请求参数值
Spring MVC 会按请求参数名和 POJO 属性名进行自动匹配，自动为该对象填充属性值，支持级联赋值。

【param.jsp】

<body>
    <form action="param" method="post">
        username:<input type="text" name="username"><br>
        password:<input type="text" name="password"><br>
        age:<input type="text" name="age"><br>
        province:<input type="text" name="address.province"><br>
        city:<input type="text" name="address.city"><br>
        county:<input type="text" name="address.county"><br>
        <input type="submit" value="提交">
    </form>
</body>

需要创建 User 类和 Address 类

public class User {
    private String username;
    private String password;
    private String age;
    private Address address;
    ....
}
public class Address {
    private String province;
    private String city;
    private String county;
    ...
}

【ParaController.java】

@RequestMapping(value = "/param",method = RequestMethod.POST)
 public String param(User user){
     System.out.println(user);
     return "success";
 }

6、注意：如果中文出现乱码（idea）

需要配置字符编码过滤器，且配置其他过滤器之前，如（HiddenHttpMethodFilter），否则不起作用。

<!-- 配置字符集 -->
<filter>
	<filter-name>encodingFilter</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>
	<init-param>
		<param-name>forceEncoding</param-name>
		<param-value>true</param-value>
	</init-param>
</filter>
<filter-mapping>
	<filter-name>encodingFilter</filter-name>
	<url-pattern>/*</url-pattern>
</filter-mapping>


<servlet>
     <servlet-name>springmvc</servlet-name>
     <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
     <init-param>
       <param-name>contextConfigLocation</param-name>
       <param-value>classpath:springmvc.xml</param-value>
     </init-param>
     <load-on-startup>1</load-on-startup>
</servlet>
    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

在修改 Tomcat

添加：**-Dfile.encoding=UTF-8**

7、使用 Servlet 原生 API 作为参数

MVC 的 Handler 方法可以接受的 ServletAPI 类型的参数

HttpServletRequest
HttpServletResponse
HttpSession
java.security.Principal
Locale
InputStream
OutputStream
Reader
Writer

代码示例：

需要导入

@RequestMapping(value = "/param", method = RequestMethod.POST)
   public String param(HttpServletRequest request, HttpServletResponse response){
       String username = request.getParameter("username");
       System.out.println(username);
       return "success";
   }

@RequestMapping(value = "/param",method = RequestMethod.POST)
public void param(HttpServletRequest request, HttpServletResponse response, Writer out) throws IOException {
    System.out.println("param" + request +"," + response);
    out.write("hello,world");
    // return "success";
}

五、处理响应数据

1、SpringMVC 输出模型数据的途径

ModelAndView: 处理方法返回值类型为 ModelAndView 时，方法体即可通过该对象添加模型数据。
Map 和 Model: 入参 org.springframework.ui.Model、org.springframework.ui.ModelMap 或 java.uti.Map 时，处理方法返回时， Map 中的数据会自动添加到模型中。

2、处理模型数据之 ModelAndView

两个重要的成员变量: private Object view; 视图信息 private ModelMap model; 模型数据
添加模型数据 MoelAndView addObject(String attributeName, Object attributeValue) 设置模型数据 ModelAndView addAllObject(Map<String, ?> modelMap)
设置视图 void setView(View view) 设置视图对象 void setViewName(String viewName) 设置视图名字
获取模型数据 protected Map<String, Object> getModelInternal() 获取模型数据 public ModelMap getModelMap() public Map<String, Object> getModel()

代码示例：

@RequestMapping(value = "/param", method = RequestMethod.POST)
public ModelAndView param(){
    ModelAndView mav = new ModelAndView();
    mav.addObject("username", "root");//往request作用域中放值
    mav.setViewName("success");//设置视图名称，实现页面跳转
    return mav;
}

【success.jsp】

<body>
    <h1>成功</h1>
    ${requestScope.username}
</body>

3、处理模型数据之 Map Model

第一种方式：

@RequestMapping(value = "/param", method = RequestMethod.POST)
public String param(Map<String, Object> map){
    map.put("username", "root"); // 往作用域中放值
    return "success";// 返回示图名称
}

第二种方式：

@RequestMapping(value = "/param", method = RequestMethod.POST)
public String param(Model model){
    model.addAttribute("username", "张三");// 向作用域中放值
    return "success"; // 返回试图的名称
}

六、视图解析

1、SpringMVC 解析视图概述

2、视图和视图解析器

请求处理方法执行完成后，最终返回一个 ModelAndView 对象。对于那些返回 String，View 或 ModeMap 等类型的处理方法， Spring MVC 也会在内部将它们装配成一个 ModelAndView 对象，它包含了逻辑名和模型对象的视图。
Spring MVC 借助视图解析器（ViewResolver）得到最终的视图对象（View），最终的视图可以是 JSP。

3、常用的试图实现类

4、JstlView

若项目使用了 JSTL，则 SpringMVC 会自动把试图由 InternallResoureView 转为 JstlView （断点调试，将 JSTL 的 jar 包增加到项目中，视图解析器会自动修改为 JstlView）
代码示例：增加 jstl 标签 jar 包（断点调试，这时的 View 对象就是 JstlView）

5、试图解析器

SpringMVC 为逻辑视图名的解析提供了不同的策略，可以在 SpringMVC 上下文中配置一种或多种解析策略，并指定他们之间的先后顺序。每一种映射策略对应一个具体的视图解析器实现类。
视图解析器的作用比较单一：将逻辑视图解析为一个具体的视图对象。
所有的视图解析器都必须实现 ViewResolver 接口：

6、常用的试图解析器实现类

可以选择一个试图解析器或混用多种试图解析器
每个试图解析器都实现了 Ordered 接口并开放一个order 属性，可以通过 order 属性指定解析器的优先顺序， order 越小优先级越高。

<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/view/"></property>
        <property name="suffix" value=".jsp"></property>
        <property name="order" value="1"></property>
</bean>

InternalResourceViewResolver
1. JSP 是最常见的视图技术，可以使用 InternalResourceViewResolve 作为视图解析器：

7、重定向

一般情况下，控制器方法返回字符串类型的值会被当成逻辑试图处理
如果返回的字符串中带 forward: 或 redirect: 前缀时，SpringMVC 会对他们进行特殊的处理：将 forward: 和 redirect: 当成指示符，其后的字符串作为 URL 来处理。
redirect:success.jsp：会完成一个到 success.jsp 的重定向的操作
forward:success.jsp：会完成一个到 success.jsp 的转发操作

代码示例：

【redirect.jsp】在 Web 目录下创建

<body>
    <a href="redirect">redirect测试</a>
    <br>
    <a href="forward">forward测试</a>
</body>

【RedirectTest.java】

@Controller
public class RedirectTest {

    @RequestMapping(value = "/redirect", method = RequestMethod.GET)
    public String redirect(){
        System.out.println("redirect测试");
       return "redirect:/index.jsp";
    }

    @RequestMapping(value = "/forward",method = RequestMethod.GET)
    public String forward(){
        System.out.println("forward测试");
        return "forward:/index.jsp";
    }
}