JAX-RS @Path URIにマッチする例
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）
