SpringMVC系列(二): SpringMVC各个注解的使用

1、@RequestMapping
1.@RequestMapping除了能修饰方法,还能修饰类
(1)修饰类:提供初步的请求映射信息,相对于web请求的根目录
(2)修饰方法:提供进一步的细分映射信息
相对于类定义处的URL,若类定义处未标注@RequestMapping,则方法处标记的URL相对于web应用的根目录
2.@RequestMapping的请求方式
@RequestMapping 的 value、method、params 及 heads 分别表示请求 URL、请求方法、请求参数及请求头的映射条
件,他们之间是与的关系,联合使用多个条件可让请求映射更加精确化。
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
[Java] 纯文本查看 复制代码
?

package com.study.springmvc.handlers;

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

@RequestMapping("/requestMappingTest")
@Controller
public class RequestMappingTest {

public static final String SUCCESS="success";
/**
 * 1.@RequestMapping除了能修饰方法,还能修饰类
 *(1)修饰类:提供初步的请求映射信息,相对于web请求的根目录
 *(2)修饰方法:提供进一步的细分映射信息
 * 相对于类定义处的URL,若类定义处未标注@RequestMapping,则方法处标记的URL相对于web应用的根目录
 * @return 成功
 */
@RequestMapping("/testRequestMapping")
public String testRequestMapping() {
    System.out.println("testRequestMapping");
    return SUCCESS;
}
 
/**
 * 2.@RequestMapping的请求方式
   @RequestMapping 的 value、method、params 及 heads 分别表示请求 URL、请求方法、请求参数及请求头的映射条
     件,他们之间是与的关系,联合使用多个条件可让请求映射更加精确化。
 * @return
 */
@RequestMapping(value="/testMethod",method=RequestMethod.POST)
public String testMethod() {
    System.out.println("testMethod的post方式");
    return SUCCESS;
} 
 
/**
 * 3.了解: 可以使用 params 和 headers 来更加精确的映射请求. params 和 headers 支持简单的表达式.
 * 
 * @return
 */
@RequestMapping(value = "testParamsAndHeaders", params = { "username",
        "age!=10" }, headers = { "Accept-Language=zh-CN,zh;q=0.8" })
public String testParamsAndHeaders() {
    System.out.println("testParamsAndHeaders");
    return SUCCESS;
}
/**
 * 4.Ant 风格资源地址支持 3 种匹配符:
 *    – ?:匹配文件名中的一个字符
 *    – *:匹配文件名中的任意字符
 *    – **:** 匹配多层路径
 * @return
 */
@RequestMapping("/testAntPath/*/abc")
public String testAntPath() {
    System.out.println("testAntPath");
    return SUCCESS;
}

}

[HTML] 纯文本查看 复制代码
?

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

pageEncoding="UTF-8"%>
 

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<body>
<!-- href="helloworld"和HelloWorld.java的@RequestMapping("/helloworld")对应 -->
Hello World

<br/>
@RequestMapping修饰类和方法

<br/>
<form action="requestMappingTest/testMethod" method="POST">
<input type="submit" value="测试@RequestMappin的post请求方式">
</form>

<br/>
testParamsAndHeaders

<br/>
testAntPath

</body>
</html>

2、@PathVariable
@PathVariable 映射 URL 绑定的占位符
• 带占位符的 URL 是 Spring3.0 新增的功能,该功能在SpringMVC 向 REST 目标挺进发展过程中具有里程碑的意义
• 通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中:URL 中的 {xxx} 占位符可以通过@PathVariable("xxx") 绑定到操作方法的入参中。
1 testPathVariable
[Java] 纯文本查看 复制代码
?

package com.study.springmvc.handlers;

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

@RequestMapping("/pathVariableTest")
@Controller
public class PathVariableTest {

public static final String SUCCESS="success";
 
/**
 * @PathVariable 可以来映射 URL 中的占位符到目标方法的参数中.
 * @param id
 * @return
 */
@RequestMapping("/testPathVariable/{id}")
public String testPathVariable(@PathVariable("id") Integer id) {
    System.out.println("testPathVariable: " + id);
    return SUCCESS;
}

}

3、@RequestParam
@RequestParam 来映射请求参数
value 值即请求参数的参数名
required 该参数是否必须. 默认为 true
defaultValue 请求参数的默认值
index.jsp代码
1 <!--@RequestParam测试 begin --> 2 <br/>3 testRequestParam4 <!--@RequestParam测试 end -->
handlers代码
[Java] 纯文本查看 复制代码
?

package com.study.springmvc.handlers;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;

@RequestMapping("/requestParamTest")
@Controller
public class RequestParamTest {

public static final String SUCCESS="success";
 

/**
 * @RequestParam 来映射请求参数. 
 * value 值即请求参数的参数名 
 * required 该参数是否必须. 默认为 true
 * defaultValue 请求参数的默认值
 */
@RequestMapping(value = "/testRequestParam")
public String testRequestParam(
        @RequestParam(value = "username") String username,
        @RequestParam(value = "age", required = false, defaultValue = "0") int age) {
    System.out.println("testRequestParam, username: " + username + ", age: "
            + age);
    return SUCCESS;
}

}

  1. @RequestHeader

映射请求头信息 用法同 @RequestParam,使用机会较少了解就行
index.jsp代码
1 <!--@RequestHeader测试 begin --> 2 <br/>3 testRequestHeader4 <!--@RequestHeader测试 end -->
handlers代码
[Java] 纯文本查看 复制代码
?

package com.study.springmvc.handlers;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestHeader;
import org.springframework.web.bind.annotation.RequestMapping;

@RequestMapping("/requestHeaderTest")
@Controller
public class RequestHeaderTest {

public static final String SUCCESS="success";
 
/**
 * 使用机会较少了解就行
 * 映射请求头信息 用法同 @RequestParam
 */
@RequestMapping("/testRequestHeader")
public String testRequestHeader(
        @RequestHeader(value = "Accept-Language") String al) {
    System.out.println("testRequestHeader, Accept-Language: " + al);
    return SUCCESS;
}

}

  1. @CookieValue

映射一个 Cookie 值. 属性同 @RequestParam,使用机会较少了解就行
index.jsp代码
1 <!--@CookieValue测试 begin --> 2 <br/>3 testCookieValue4 <!--@CookieValue测试 end -->
handlers代码
[Java] 纯文本查看 复制代码
?

package com.study.springmvc.handlers;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.CookieValue;
import org.springframework.web.bind.annotation.RequestMapping;

@RequestMapping("/cookieValueTest")
@Controller
public class CookieValueTest {

public static final String SUCCESS="success";
 
/**
 * 使用机会较少了解就行
 * 
 * @CookieValue: 映射一个 Cookie 值. 属性同 @RequestParam
 */
@RequestMapping("/testCookieValue")
public String testCookieValue(@CookieValue(value = "JSESSIONID") String sessionId) {
    System.out.println("testCookieValue: sessionId: " + sessionId);
    return SUCCESS;
}

}

  1. @InitBinder

• 由 @InitBinder 标识的方法,可以对 WebDataBinder 对象进行初始化。WebDataBinder 是 DataBinder 的子类,用于完成由表单字段到 JavaBean 属性的绑定
• @InitBinder方法不能有返回值,它必须声明为void。
• @InitBinder方法的参数通常是是 WebDataBinder
1 @InitBinder2 public void initBinder(WebDataBinder binder){3 binder.setDisallowedFields("lastName");4 }

  1. @DateTimeFormat

对界面提交过来的日期进行格式化
@DateTimeFormat 注解可对java.util.Date、java.util.Calendar、java.long.Long 时间类型进行标注:
– pattern 属性:类型为字符串。指定解析/格式化字段数据的模式,如:”yyyy-MM-dd hh:mm:ss”
– iso 属性:类型为 DateTimeFormat.ISO。指定解析/格式化字段数据的ISO模式,包括四种:ISO.NONE(不使用) -- 默认、ISO.DATE(yyyy-MM-dd)、ISO.TIME(hh:mm:ss.SSSZ)、ISO.DATE_TIME(yyyy-MM-dd hh:mm:ss.SSSZ)
– style 属性:字符串类型。通过样式指定日期时间的格式,由两位字符组成,第一位表示日期的格式,第二位表示时间的格式:S:短日期/时间格式、M:中日期/时间格式、L:长日期/时间格式、F:完整日期/时间格式、-:忽略日期或时间格式
1 @DateTimeFormat(pattern="yyyy-MM-dd")2 private Date birth;

备注:必须在springmvc.xml里面配置<mvc:annotation-driven/>,因为配置了以后才会默认实例化数据集类型转换和格式化的工厂类FormattingConversionServiceFactroyBean,如果自定义了类型转换器则需要这样配置
[Java] 纯文本查看 复制代码
?

<mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven>

 
<!-- 配置 ConversionService -->
<bean id="conversionService"
    class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
    <property name="converters">
        <set>
            <ref bean="employeeConverter"/>
        </set>
    </property>    
</bean>
  1. @NumberFormat

对界面提交过来的数值进行格式化
@NumberFormat 可对类似数字类型的属性进行标注,它拥有两个互斥的属性:
– style:类型为 NumberFormat.Style。用于指定样式类型,包括三种:Style.NUMBER(正常数字类型)、Style.CURRENCY(货币类型)、 Style.PERCENT(百分数类型)
– pattern:类型为 String,自定义样式,如patter="#,###"
1 @NumberFormat(pattern="#,###,###.#")2 private Float salary;
备注:必须在springmvc.xml里面配置<mvc:annotation-driven/>,因为配置了以后才会默认实例化数据集类型转换和格式化的工厂类FormattingConversionServiceFactroyBean,如果自定义了类型转换器则需要和@NumberFormat 一样配置

评论

暂无评论