使用 @Path and @GET, @POST, 等

RESTEasy 系列 Chapter 4 使用 @Path and @GET, @POST, 等

@Path("/library")
public class Library {
 
    @GET
    @Path("/books")
    public String getBooks() {...}
 
    @GET
    @Path("/book/{isbn}")
    public String getBook(@PathParam("isbn") String id) {
        // search my database and get a string representation and return it
    }
 
    @PUT
    @Path("/book/{isbn}")
    public void addBook(@PathParam("isbn") String id, @QueryParam("name") String name) {...}
 
    @DELETE
    @Path("/book/{id}")
    public void removeBook(@PathParam("id") String id {...}
 
 
}

比方说，如果你拥有Resteasy的servlet配置并且得到一个根路径http://myhost.com/services。

Library类的请求将被处理：

• GET http://myhost.com/services/library/books
• GET http://myhost.com/services/library/book/333
• PUT http://myhost.com/services/library/book/333
• DELETE http://myhost.com/services/library/book/333

@javax.ws.rs.Path注解必须存在于类和/或资源方法。如果类和方法都存在，这个资源方法的相对路径是连接类和方法。

在@javax.ws.rs包注解的每个HTTP方法，@GET, @POST, @PUT, @DELETE, 和 @HEAD。你可以将这些公共方法映射到某些想要的HTTP方法。只要有一个@Path注解在类上，你要映射的方法不用再有@Path注解。你可以有一个以上的HTTP方法，只要它们能区别于其它的方法。

当你有一个@Path注解的不是HTTP的方法，它们被叫做JAXRSResourceLocators。

4.1. @Path和正则表达式映射

@Path 注解不限于简单的路径表达式。你也能够插入正则表达式到@Path的value。示例：

@Path("/resources)
        public class MyResource {
 
        @GET
        @Path("{var:.*}/stuff")
        public String get() {...}
        }

下面的GET方法将路由到getResource()方法：

GET /resources/stuff
GET /resources/foo/stuff
GET /resources/on/and/on/stuff

表达式的格式是：

"{" variable-name [ ":" regular-expression ] "}"

正则表达式部分是可选的。当表达式不提供时，它默认为一个通配符匹配特定的部分。在正则表达式条件下，这个表达式默认为是：

"([]*)"

示例：

@Path("/resources/{var}/stuff")

将匹配它们：

GET /resources/foo/stuff 
GET /resources/bar/stuff

但是不能匹配：

GET /resources/a/bunch/of/stuff