@PathParam

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

 

 

1. @Path("/library")  
2. public class Library {  
3.   
4.    @GET  
5.    @Path("/book/{isbn}")  
6.    public String getBook(@PathParam("isbn") String id) {  
7.       // search my database and get a string representation and return it  
8.    }  
9. }  

 

（很简单，当你发出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是一个对象，我们可以

1. @GET  
2. @Path("/book/{isbn}")  
3. public String getBook(@PathParam("isbn") ISBN id) {...}  
4.   
5.   
6. public class ISBN {  
7.    public ISBN(String str) {...}  
8. }  

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

 

1. <span style="font-size:16px;">  public class ISBN {  
2.        
3.      public static ISBN valueOf(String isbn) {...}  
4.   }</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中使用正则表达式

 

[java]  view plain copy print ?

1. @GET  
2. @Path("/aaa{param:b+}/{many:.*}/stuff")  
3. 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:

1. public interface PathSegment {  
2.   
3.     /** 
4.      * Get the path segment. 
5.      * <p> 
6.      * @return the path segment 
7.      */  
8.     String getPath();  
9.     /** 
10.      * Get a map of the matrix parameters associated with the path segment 
11.      * @return the map of matrix parameters 
12.      */  
13.     MultivaluedMap<String, String> getMatrixParameters();  
14.       
15. }  

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

1. @GET  
2. @Path("/book/{id}")  
3. 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