RestEasy 用户指南----第5章.@PathParam

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

 

 

@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是一个对象,我们可以

   @GET
   @Path("/book/{isbn}")
   public String getBook(@PathParam("isbn") ISBN id) {...}


   public class ISBN {
      public ISBN(String str) {...}
   }

 

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

 

 

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

 

 

(运行中应该能够自动调用类的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中使用正则表达式

 

@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:

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而不是用一个值

   @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我表示不怎么理解,自己还没有试过这个部分。)

 

 

 

 

你可能感兴趣的:(职场,REST,resteasy,休闲)