JAX-RSでは、 `@ Path`を使用してURIパターンをJavaメソッドにバインドできます。どのように動作するかは、次の例を参照してください。
1.通常のURIマッチング
@Pathアノテーションと一致する通常のURIを参照してください。
import javax.ws.rs.GET; import javax.ws.rs.Path; import javax.ws.rs.core.Response; @Path("/users") public class UserRestService { @GET public Response getUser() { return Response.status(200).entity("getUser is called").build(); } @GET @Path("/vip") public Response getUserVIP() { return Response.status(200).entity("getUserVIP is called").build(); } }
URIパターン: " /users "
getUser is called
URIパターン: " /users/vip "
getUserVIP is called
2. URIマッチングとパラメータ
中括弧 "\ {"と中かっこ "}"内の値はパラメータを表し、 `@ PathParam`でアクセスできます。
import javax.ws.rs.GET; import javax.ws.rs.Path; import javax.ws.rs.PathParam; import javax.ws.rs.core.Response; @Path("/users") public class UserRestService { @GET @Path("{name}") public Response getUserByName(@PathParam("name") String name) { return Response.status(200) .entity("getUserByName is called, name : " + name).build(); } }
URIパターン: " /users/mkyong "
getUserByName is called, name : mkyong
URIパターン: " /users/abcdefg "
getUserByName is called, name : abcdefg
3. URIマッチングと正規表現
`@ Path`は正規表現と一致する複合URIを次の式でサポートします:
{" variable-name[":" regular-expression]"}
import javax.ws.rs.GET; import javax.ws.rs.Path; import javax.ws.rs.PathParam; import javax.ws.rs.core.Response; @Path("/users") public class UserRestService { @GET @Path("{id : \\d+}")//support digit only public Response getUserById(@PathParam("id") String id) { return Response.status(200).entity("getUserById is called, id : " + id).build(); } @GET @Path("/username/{username :[a-zA-Z][a-zA-Z__0-9]}") public Response getUserByUserName(@PathParam("username") String username) { return Response.status(200) .entity("getUserByUserName is called, username : " + username).build(); } @GET @Path("/books/{isbn : \\d+}") public Response getUserBookByISBN(@PathParam("isbn") String isbn) { return Response.status(200) .entity("getUserBookByISBN is called, isbn : " + isbn).build(); } }
URIパターン: " /users/999 "
getUserById is called, id : 999
URIパターン: " /users/123456 "
getUserById is called, id : 123456
"[a-zA-Z][a-zA-Z 0-9]、最初の文字が必要[" a-zA-Z]"と一致しない" /users/username/aaa "、2文字目に"[a-zA-Z 0-9]"が必要です。
Could not find resource for relative :/users/username/aaa
URIパターン: " /users/username/a9 "
getUserByUserName is called, username : a9
URIパターン: " users/books/999 "
getUserBookByISBN is called, isbn : 999
ソースコードをダウンロードする
ダウンロードする - リンク://wp-content/uploads/2011/07/JAX-RS-Path-URI-Matching-Example.zip[JAX-RS-Path-URI- Matching-Example.zip](6 KB)