SpringMVC学习 -- 使用 @RequestMapping 映射请求

在控制器的类定义及方法出定义出都可以标注 @RequestMapping：

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

DispatcherServlet 截获请求后 , 就通过控制器上 @RequestMapping 提供的映射信息确定请求所对应的处理方法。

web.xml 

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">

    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/applicationContext.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    <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>
</web-app>

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: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/context http://www.springframework.org/schema/context/spring-context.xsd">
    <!-- 扫描自定义包 -->
    <context:component-scan base-package="com.itdoc.springmvc"/>

    <!-- 配置试图解析器: 把 Controller 返回值解析成实际的物理视图 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/views/"/>
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

TestRequestMapping.java

package com.itdoc.springmvc;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

/**
 * @BLOG http://www.cnblogs.com/goodcheap
 * @DESCRIBE RequestMapping 测试
 * @AUTHOR WángChéngDá
 * @DATE 2017-03-08 14:30
 */
@Controller
@RequestMapping("/springmvc")
public class TestRequestMapping {

    private final static String SUCCESS = "success";

    /**
     * 1.@RequestMapping 除了修饰方法还可以修饰类。
     * 2.修饰类和修饰方法
     * 1) 修饰类: 提供初步的请求映射信息, 相对于 WEB 应用的根目录。
     * 2) 修饰方法: 提供进一步细化的请求映射信息, 相对于修饰类处的 URL。
     * 若修饰类处未标注 @RequestMapping, 则修饰方法处的 URL 相对于 WEB 应用的根目录。
     */
    @RequestMapping("/testreqmap")
    public String testReqMap() {
        System.out.println("I am TestRequestMapping's testReqMap method...");
        return SUCCESS;
    }
}

映射请求参数、请求方式或请求头

@RequestMapping 的 value , method , params 及 headers 分别表示请求 URL , 请求方式 , 请求参数及请求头的映射条件 , 联合使用多个条件可让请求映射更加精确化。

method 请求方式常用有四种：

• method = RequestMethod.POST
• method = RequestMethod.GET
• method = RequestMethod.PUT
• method = RequestMethod.DELETE

package com.itdoc.springmvc;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

/**
 * @BLOG http://www.cnblogs.com/goodcheap
 * @DESCRIBE RequestMapping 测试
 * @AUTHOR WángChéngDá
 * @DATE 2017-03-08 14:30
 */
@Controller
@RequestMapping("/springmvc")
public class TestRequestMapping {

    private final static String SUCCESS = "success";

    /**
     * 使用 method 属性来制定请求方式。
     *
     * @return
     */
    @RequestMapping(value = "/testMethod", method = RequestMethod.POST)
    public String testMethod() {
        System.out.println("I am TestRequestMapping's testMethod method...");
        return SUCCESS;
    }
}

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

•  param：表示请求必须包含名为 param 的请求参数。
• !param：表示请求不能包含名为 param 的请求参数。
• param != value: 表示请求包含名为 param 的请求参数 , 但其值不能为 value。
• params 可以有多个参数 , 用逗号隔开。示例：params = {"username", "age!=20"}

package com.itdoc.springmvc;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

/**
 * @BLOG http://www.cnblogs.com/goodcheap
 * @DESCRIBE RequestMapping 测试
 * @AUTHOR WángChéngDá
 * @DATE 2017-03-08 14:30
 */
@Controller
@RequestMapping("/springmvc")
public class TestRequestMapping {

    private final static String SUCCESS = "success";

    /**
     * 可以使用 params 和 headers 来更加精确的映射请求, params 和 headers 支持简单的表达式。
     * @return
     */
    @RequestMapping(value = "testParamsAndHeaders", params = {"username", "age!=20"},
            headers = {"Accept-Language=zh-CN,zh;q=0.8"})
    public String testParamsAndHeaders() {
        System.out.println("I am TestRequestMapping's testParamsAndHeaders method...");
        return SUCCESS;
    }
}

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

• ?：匹配文件名中的一个字符。
• *：匹配文件名中的任意字符。
• **：匹配多层路径。

package com.itdoc.springmvc;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

/**
 * @BLOG http://www.cnblogs.com/goodcheap
 * @DESCRIBE RequestMapping 测试
 * @AUTHOR WángChéngDá
 * @DATE 2017-03-08 14:30
 */
@Controller
@RequestMapping("/springmvc")
public class TestRequestMapping {

    private final static String SUCCESS = "success";

    @RequestMapping("/testAndPath/*/abc")
    public String testAndPath() {
        System.out.println("I am TestRequestMapping's testAntPath method...");
        return SUCCESS;
    }
}

 

@PathVariable 映射 URL 绑定占位符：

• 带占位符的 URL 是 Spring3.0 新增的功能 , 该功能在 SpringMVC 的 REST 目标挺进发展过程中具有里程碑的意义。
• 通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中：URL 中的{xxx} 占位符可以通过 @PathVariable("xxx") 绑定到操作方法的入参中。
• 注意：@PathVariable("xxx") 中的 xxx 必须与占位符 {xxx} 中的 xxx 相同。 

package com.itdoc.springmvc;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

/**
 * @BLOG http://www.cnblogs.com/goodcheap
 * @DESCRIBE RequestMapping 测试
 * @AUTHOR WángChéngDá
 * @DATE 2017-03-08 14:30
 */
@Controller
@RequestMapping("/springmvc")
public class TestRequestMapping {

    private final static String SUCCESS = "success";

    /**
     * @PathVariable 可以来映射 URL 中的占位符到目标方法的参数中。
     * @param id
     * @return
     */
    @RequestMapping("/testPathVariable/{id}")
    public String testPathVariable(@PathVariable("id") Integer id) {
        System.out.println("I am TestRequestMapping's testPathVariable method...	 id=" + id);
        return SUCCESS;
    }
}