RestEasy+用户指南----第5章．@PathParam

分类： WebService 翻译2011-10-13 16:08 102人阅读 评论(0) 收藏 举报

@PathParam 的声明允许你在URI路径中去映射你的方法将使用的参数。

view plainprint?

@Path("/library")

public class Library {

@GET

@Path("/book/{isbn}")

public String getBook(@PathParam("isbn") String id) {

// search my database and get a string representation and return it

}

}

（很简单，当你发出get请求 /book/152-963参数152-963就在isbn中存储着，然后交给变量id，这样你的方法就算是成功的接收了该参数）

这将允许你在uri中内嵌一个变量标识符。在上边的例子中，参数isbn被用来传递book的信息。你所嵌入的数据类型可以是任何元数据类型，例如String，具有String参数的构造函

数的一个类对象，或者a static valueOf method that takes a String as a parameter。例如，假设ISBN是一个对象，我们可以

view plainprint?

@GET

@Path("/book/{isbn}")

public String getBook(@PathParam("isbn") ISBN id) {...}

public class ISBN {

public ISBN(String str) {...}

}

或者是一个public方法String构造，包含一个valueOf 方法

view plainprint?

<span style="font-size:16px;">  public class ISBN {

public static ISBN valueOf(String isbn) {...}

}</span>

（运行中应该能够自动调用类的valueOf方法进行转换，对java不是很熟悉，我想大概应该是这样）

5.1. @PathParam深入 以及正则表达式

下边是一些更复杂的应用，这些在前边的章节并没有讨论

你可以指定一个或者多个参数用以内嵌到你的uri中，下边是一些例子

1.@Path("/aaa{param}bbb")

2.@Path("/{name}-{zip}")

3.@Path("/foo{name}-{zip}bar")

那么，路径 "/aaa111bbb" 将会匹配#1. "/bill-02115"将会匹配 #2. 路径"foobill-02115bar" 将会匹配 #3.

之前，我们已经讨论过如何在@Path中使用正则表达式

view plainprint?

@GET

@Path("/aaa{param:b+}/{many:.*}/stuff")

public StringgetIt(@PathParam("param") String bs, @PathParam("many")String many) {...}

在如下的请求中，我们可以了解到“param”以及“many”值是多少

Request

param

many

GET /aaabb/some/stuff

bb

some

GET /aaab/a/lot/of/stuff

b

a/lot/of

5.2@PathParam 和 PathSegment

Thespecification has a very simple abstraction for examining a fragment of the URIpath being invoked on javax.ws.rs.core.PathSegment:

view plainprint?

public interface PathSegment {

/**

* Get the path segment.

* <p>

* @return the path segment

*/

String getPath();

/**

* Get a map of the matrix parameters associated with the path segment

* @return the map of matrix parameters

*/

MultivaluedMap<String, String> getMatrixParameters();

}

你可以使用resteasy注入一个PathSegment而不是用一个值

view plainprint?

@GET

@Path("/book/{id}")

public String getBook(@PathParam("id") PathSegment id) {...}

当你使用matrix parameters传递诸多参数时，浙江爱那个非常有用。你可以将任意个name和value的键值对潜入到uri path segment中。PathSegment对象将会负责去获取这些参数。

你也可以看一下MatrixParam（后边会讲到）

一个matrix parameter的例子是

GEThttp://host.com/library/book;name=EJB 3.0;author=Bill Burke

Thebasic idea of matrix parameters is that it represents resources that areaddressable by their attributes as well as their raw id.

（好吧，5.2我表示不怎么理解，自己还没有试过这个部分。）