您的位置: 首页  >  文章  >  SpringMVC入门（一）

SpringMVC入门（一）

分类: 文章 • 2024-05-11 10:08:16

目录

一、概述

二、HelloWorld入门

1.步骤

2.详细步骤

（1）导入jar包

（2）配置web.xml

（3）配置dispatcher-servlet.xml

（4）创建请求处理器类

（5）访问此处理器类

三、@RequestMapping

1.定义位置

2.映射请求参数、请求方法和请求头

3.映射请求

[email protected]映射URL绑定的占位符

5.REST

（1）示例

（2）代码演示

6.请求处理方法签名

（1）@RequestParam

（2）@RequestHeader

（3）@CookieValue

（4）POJO 对象绑定请求参数值

（5）使用 Servlet API 作为入参

一、概述

  • Spring 为展现层提供的基于 MVC 设计理念的优秀的 Web 框架，是目前最主流的 MVC 框架之一

  • Spring MVC 通过一套 MVC 注解，让 POJO 成为处理请求的控制器，而无须实现任何接口

  • 支持 REST 风格的 URL请求

  • 采用了松散耦合可插拔组件结构，比其他 MVC 框架更具扩展性和灵活性

二、HelloWorld入门

1.步骤

  • 创建SpringMVC工程

  • 在web.xml中配置DispatcherServlet

  • 加入SpringMVC的配置文件

  • 编写处理请求的处理器，并标识为处理器

  • 编写视图

2.详细步骤

（1）导入jar包

SpringMVC入门（一）

（2）配置web.xml

    <!-- 配置DispatcherServlet -->
    <!-- 默认的配置文件为 /WEB-INF/<servlet-name>-servlet.xml -->
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

（3）配置dispatcher-servlet.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
​
    <!-- 默认使用基于注释的适配器和映射器 -->
    <mvc:annotation-driven/>
    <!-- 只把动态信息当做controller处理，忽略静态信息 -->
    <mvc:default-servlet-handler/>
     <!--自动扫描包中的Controlller -->
    <context:component-scan base-package="com.itheima.controller"/>
    <!-- 配置视图解析器: 如何把 handler 方法返回值解析为实际的物理视图 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/jsp/"/><!-- 前缀 -->
        <property name="suffix" value=".jsp"/><!-- 后缀，自动拼接 -->
    </bean>
</beans>

（4）创建请求处理器类

@Controller
public class HelloWorld {
    
    /**
     * 1. 使用 @RequestMapping 注解来映射请求的 URL
     * 2. 返回值会通过视图解析器解析为实际的物理视图, 对于 InternalResourceViewResolver 视图解析器, 会做如下的解析:
     * 通过 prefix + returnVal + 后缀 这样的方式得到实际的物理视图, 然会做转发操作
     *
     *  /WEB-INF/views/success.jsp
     *
     * 超链接： <a href="hello">hello</a>  会请求该页面
     * @return
     */
    @RequestMapping("/hello")
    public String hello() {
        System.out.println("helloworld");
        return "success";
    }
}

（5）访问此处理器类

<a href="hello">hello</a><br/>

三、@RequestMapping

1.定义位置

  • 类定义处：提供初步的请求映射信息。相对于 WEB 应用的根目录

  • 方法处：提供进一步的细分映射信息。相对于类定义处的 URL。若类定义处未标注 @RequestMapping，则方法处标记的 URL 相对于WEB 应用的根目录

/**
 *  <a href="/springmvc/testRequestMapping">hello MVC</a>  会请求该页面
 */
​
@RequestMapping("springmvc")
@Controller
public class SpringMVCTest {
​
    @RequestMapping("testRequestMapping")
    public String hello(){
        return "success";
    }
}

2.映射请求参数、请求方法和请求头

  • @RequestMapping 除了可以使用请求 URL 映射请求外，还可以使用请求方法、请求参数及请求头映射请求

  • value、method、params 及 heads分别表示请求 URL、请求方法、请求参数及请求头的映射条件，他们之间是与的关系，联合使用多个条件可让请求映射更加精确化

  • params和 headers支持简单的表达式：

    • param1: 表示请求必须包含名为 param1 的请求参数

    • !param1: 表示请求不能包含名为 param1 的请求参数

    • param1 != value1: 表示请求包含名为 param1 的请求参数，但其值不能为 value1

    • {“param1=value1”, “param2”}: 请求必须包含名为 param1 和param2的两个请求参数，且 param1 参数的值必须为 value1

 /**
     *  params = {"username","age!=10"}:请求中必须有username参数和age参数，且age参数不为10
     * @return
     */
    @RequestMapping(value="/testMethod",method = RequestMethod.POST, params = {"username","age!=10"})
    public String testMethod(){
        return "success";
    }

3.映射请求

  • Ant 风格资源地址支持 3 种匹配符

    • ?：匹配文件名中的一个字符

    • *：匹配文件名中的任意字符

    • **： 匹配多层路径

  • @RequestMapping 还支持 Ant 风格的 URL：

    • /user/*/createUser: 匹配

      /user/aaa/createUser、/user/bbb/createUser 等 URL

    • /user/**/createUser: 匹配

      /user/createUser、/user/aaa/bbb/createUser 等 URL

    • /user/createUser??: 匹配

      /user/createUseraa、/user/createUserbb 等 URL

    @RequestMapping("user/**/createUser")
    public String testAnt(){
        System.out.println("ant执行了");
        return "success";
    }
​
    @RequestMapping("user/createUser??")
    public String testAnt1(){
        System.out.println("ant1执行了");
        return "success";
    }

[email protected]映射URL绑定的占位符

  • 带占位符的 URL 是 Spring3.0 新增的功能，该功能在SpringMVC 向 REST 目标挺进发展过程中具有里程碑的意义

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

    @RequestMapping("testVariable/{id}")
    public String testVariable(@PathVariable("id") Integer id) {
        System.out.println(id);
        return "success";
    }

5.REST

HTTP协议里面，四个表示操作方式的动词：GET、POST、PUT、DELETE。它们分别对应四种基本操作：

  • GET:用来获取资源

  • POST:用来新建资源

  • PUT:用来更新资源

  • DELETE:用来删除资源

（1）示例

/order/1 HTTP GET:得到id=1的order
/order/1 HTTP DELETE:删除id=1的order
/order/1 HTTP PUT:更新id=1的order
/order   HTTP POST:新增order

  • HiddenHttpMethodFilter：浏览器 form 表单只支持 GET与 POST 请求，而DELETE、PUT 等 method 并不支持，Spring3.0 添加了一个过滤器，可以将这些请求转换为标准的 http 方法，使得支持 GET、POST、PUT 与DELETE 请求。

（2）代码演示

  • 如何发送PUT请求和DELETE请求

    1.需要在web.xml中配置HiddenHttpMethodFilter

    <!-- 配置HiddenHttpMethodFilter:可以把post请求转为DELETE请求和PUT请求 -->
    <filter>
        <filter-name>HiddenHttpMethodFilter</filter-name>
        <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
    </filter>

2.需要发送POST请求

3.需要在发送POST请求时携带一个methodParam的隐藏域

    <input type="hidden" name="_method" value="DELETE">

  • HiddenHttpMethodFilter中的源代码如下：

    
private String methodParam = "_method";
​
    protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException {
        HttpServletRequest requestToUse = request;
        if ("POST".equals(request.getMethod()) && request.getAttribute("javax.servlet.error.exception") == null) {
            //该方法或获取methodParam参数，并对请求转换为对应的value
            String paramValue = request.getParameter(this.methodParam);
            if (StringUtils.hasLength(paramValue)) {
                String method = paramValue.toUpperCase(Locale.ENGLISH);
                if (ALLOWED_METHODS.contains(method)) {
                    requestToUse = new HiddenHttpMethodFilter.HttpMethodRequestWrapper(request, method);
                }
            }
        }
​
        filterChain.doFilter((ServletRequest)requestToUse, response);
    }

  • CURDTest.java

     
@RequestMapping(value = "order", method = RequestMethod.GET)
    public String testOrderGet(@RequestParam("id") Integer id) {
        System.out.println("查询id为" + id + "的员工");
        return "success";
    }
​
    @RequestMapping(value = "order", method = RequestMethod.DELETE)
    public String testOrderDelete(@RequestParam("id") Integer id) {
        System.out.println("删除id为" + id + "的员工");
        //用delete或put请求转发到success.jsp会报错，这里用redirect
        //tomcat8之后会有此问题
        return "redirect:success.jsp";
    }
​
    @RequestMapping(value = "order", method = RequestMethod.PUT)
    @ResponseBody()
    public String testOrderPut(@RequestParam("id") Integer id) {
       //用delete或put请求转发到success.jsp会报错，这里用@ResponseBody()注解返回一个字符串
        System.out.println("更新id为" + id + "的员工");
        return "success";
    }
​
    @RequestMapping(value = "order", method = RequestMethod.POST)
    public String testOrderPost() {
        System.out.println("新增员工");
        return "success";
    }

  • CURD.html

  <！-- 获得员工，GET请求 -->
  <form action="order" method="get">
      id:<input type="text" name="id">
      <input type="submit" value="order提交get">
  </form>
​
  <！-- 删除员工，隐藏域中设置mehodParam为delete -->
<form action="order" method="post">
    id:<input type="text" name="id">
    <input type="hidden" name="methodParam" value="DELETE">
    <input type="submit" value="order提交delete">
</form>
      
  <！-- 修改员工，隐藏域中设置mehodParam为put -->
<form action="order" method="post">
    id:<input type="text" name="id">
    <input type="hidden" name="methodParam" value="PUT">
    <input type="submit" value="order提交put">
</form>
​
  <！-- 新增员工，POST请求 -->
<form action="order" method="post">
    <input type="submit" value="order提交post">
</form>

6.请求处理方法签名

  • Spring MVC 通过分析处理方法的签名，将 HTTP 请求信息绑定到处理方法的相应人参中。

  • Spring MVC 对控制器处理方法签名的限制是很宽松的，几乎可以按喜欢的任何方式对方法进行签名。

  • 必要时可以对方法及方法入参标注相应的注解（@PathVariable、@RequestParam、@RequestHeader 等）、Spring MVC 框架会将 HTTP 请求的信息绑定到相应的方法入参中，并根据方法的返回值类型做出相应的后续处理。

（1）@RequestParam

    /**
     *  在处理方法入参处使用 @RequestParam 可以把请求参数传递给请求方法
     *  value:参数名
     *  required:默认为true。指定参数名是否必须
     *  defaultValue:没有此参数时指定默认值
     */
    @RequestMapping("testParam")
    public String testParam(@RequestParam(value = "username", required = true) String username,
                            @RequestParam(value = "age", defaultValue = "0") int age) {
        System.out.println("username:" + username);
        System.out.println("age:" + age);
        return "success";
    }

（2）@RequestHeader

 /**
     * 请求头中包含了若干属性,服务器可据此获知客户端的信息。
     * 通过 @RequestHeader 即可将请求头中的属性值绑定到处理方法的入参中
     */
    @RequestMapping("testRequestHeader")
    public String testRequestHeader(@RequestHeader("Accept-Encoding") String encoding) {
        System.out.println(encoding);
        return "success";
    }

（3）@CookieValue

 /**
     * @CookieValue 可以让处理方法入参绑定某个 Cookie 值
     * 请求头中包含了若干属性,服务器可据此获知客户端的信息。
     * 通过 @CookieValue 即可将请求头中的属性值绑定到处理方法的入参中
     */
    @RequestMapping("testCookieValue")
    public String testCookieValue(@CookieValue("JSESSIONID") String sessionId) {
        System.out.println("ssesionId:" + sessionId);
        return "success";
    }

（4）POJO 对象绑定请求参数值

  /**
     * Spring MVC 会按请求参数名和 POJO 属性名进行自动匹配，自动为该对象填充属性值。支持级联属性。
     */
    @RequestMapping("testPOJO")
    public String testPOJO(User user) {
        System.out.println(user);
        return "success";
    }
    <a href="/testPOJO?name=zhangsan&password=root123">testPOJO</a>

（5）使用 Servlet API 作为入参

    @RequestMapping("testServletAPI")
    public String testServletAPI(HttpServletResponse response, HttpServletRequest request) {
        System.out.println("response:"+response);
        System.out.println("request:"+request);
        return "success";
    }

MVC 的 Handler 方法可以接受以下这些 ServletAPI 类型的参数：

  • HttpServletRequest

  • HttpServletResponse

  • HttpSession

  • java.security.Principal

  • Locale

  • InputStream

  • OutputStream

  • Reader

  • Writer

相关推荐