@MatrixVariable的使用

在Spring3.2 后，一个@MatrixVariable出现了，这个注解的出现拓展了URL请求地址的功能。
Matrix Variable中，多个变量可以使用“;”（分号）分隔，例如：

/cars;color=red;year=2012

如果是一个变量的多个值那么可以使用“,”（逗号）分隔

color=red,green,blue

或者可以使用重复的变量名：

color=red;color=green;color=blue

下面来一个例子说明：

//请求URL: GET /pets/42;q=11;r=22
@RequestMapping(value = "/pets/{petId}", method = RequestMethod.GET)
public voidfindPet(@PathVariableString petId, @MatrixVariable intq) {
// petId == 42
// q == 11
}

再复杂一点就是这个例子：

// GET /owners/42;q=11/pets/21;q=22
@RequestMapping(value = "/owners/{ownerId}/pets/{petId}", method = RequestMethod.GET)
public voidfindPet(
@MatrixVariable(value="q", pathVar="ownerId") intq1,
@MatrixVariable(value="q", pathVar="petId") intq2) {
// q1 == 11
// q2 == 22
}

针对每一个Parh Variable绑定一个Matrix Variable，然后使用 value 和 pathVar属性就能找到该值。
另外，正对Matrix Variable也是可以指定自身的的属性，例如，是否必须，默认值。
下面这个例子说明：

// GET /pets/42
@RequestMapping(value = "/pets/{petId}", method = RequestMethod.GET)
public voidfindPet(@MatrixVariable(required=true, defaultValue="1") intq) {
// q == 1
}

最后说明一下，如果要开启Matrix Variable功能的话，必须设置 RequestMappingHandlerMapping 中的 removeSemicolonContent 为false.
一般情况不用你手动去设置这个属性，因为这个属性默认就是false ，如果你碰见Matrix Variable功能未开启的时候就可以看看是不是误设置这个属性为true了。

结束

评论

2 楼 lucky16 2013-07-08  

jinnianshilongnian 写道

还有一个bug需要注意下：

@RequestMapping(value = "/owners/{ownerId}/pets/{petId}", method = RequestMethod.GET)  
    public void findPet(@MatrixVariable Map<String, String> matrixVars, @MatrixVariable(pathVar = "petId") Map<String, String> petMatrixVars) {  
        System.out.println(matrixVars);  
        System.out.println(petMatrixVars);  
    }  

url:http://localhost:8080/owners/42;q=11;r=12/pets/55;q=22,33;s=23会有问题

http://jinnianshilongnian.iteye.com/blog/1872760

谢谢开涛的提醒

1 楼 jinnianshilongnian 2013-07-08  

还有一个bug需要注意下：

@RequestMapping(value = "/owners/{ownerId}/pets/{petId}", method = RequestMethod.GET)  
    public void findPet(@MatrixVariable Map<String, String> matrixVars, @MatrixVariable(pathVar = "petId") Map<String, String> petMatrixVars) {  
        System.out.println(matrixVars);  
        System.out.println(petMatrixVars);  
    }  

url:http://localhost:8080/owners/42;q=11;r=12/pets/55;q=22,33;s=23会有问题

http://jinnianshilongnian.iteye.com/blog/1872760