JAX-RS@QueryParam和@PathParam比较

来源：http://jackyrong.iteye.com/blog/1128364

1 先来看@queryparam
   先看例子:
 

Java代码  

1. Path("/users")  
2. public class UserService {  
3.    
4.     @GET  
5.     @Path("/query")  
6.     public Response getUsers(  
7.         @QueryParam("from") int from,  
8.         @QueryParam("to") int to,  
9.         @QueryParam("orderBy") List<String> orderBy) {  
10.    
11.         return Response  
12.            .status(200)  
13.            .entity("getUsers is called, from : " + from + ", to : " + to  
14.             + ", orderBy" + orderBy.toString()).build();  
15.    
16.     }  
17.    
18. }  

   URL输入为:users/query?from=100&to=200&orderBy=age&orderBy=name
  此时,输出为:
getUsers is called, from : 100, to : 200, orderBy[age, name]
   要注意的是,跟@pathparam不同,@queryparam
中,指定的是URL中的参数是以键值对的形式出现的,而在程序中
@QueryParam("from") int from则读出URL中from的值,
而@pathparem中,URL中只出现参数的值,不出现键值对,比如:
“/users/2011/06/30”

则:
 

Java代码  

1. @GET  
2.     @Path("{year}/{month}/{day}")  
3.     public Response getUserHistory(  
4.             @PathParam("year") int year,  
5.             @PathParam("month") int month,   
6.             @PathParam("day") int day) {  
7.    
8.        String date = year + "/" + month + "/" + day;  
9.    
10.        return Response.status(200)  
11.         .entity("getUserHistory is called, year/month/day : " + date)  
12.         .build();  
13.    
14.     }  

输出为:
getUserHistory is called, year/month/day : 2011/6/30

2 以动态的方式获得:
  

Java代码  

1. @Path("/users")  
2. public class UserService {  
3.    
4.     @GET  
5.     @Path("/query")  
6.     public Response getUsers(@Context UriInfo info) {  
7.    
8.         String from = info.getQueryParameters().getFirst("from");  
9.         String to = info.getQueryParameters().getFirst("to");  
10.         List<String> orderBy = info.getQueryParameters().get("orderBy");  
11.    
12.         return Response  
13.            .status(200)  
14.            .entity("getUsers is called, from : " + from + ", to : " + to  
15.             + ", orderBy" + orderBy.toString()).build();  
16.    
17.     }  
18.    

URL;users/query?from=100&to=200&orderBy=age&orderBy=name
输出为:
getUsers is called, from : 100, to : 200, orderBy[age, name]
注意这里把orderby后的两个参数读入为LIST处理了.


3 @DefaultValue,默认值

  例子:
 

Java代码  

1. @Path("/users")  
2. public class UserService {  
3.    
4.     @GET  
5.     @Path("/query")  
6.     public Response getUsers(  
7.         @DefaultValue("1000") @QueryParam("from") int from,  
8.         @DefaultValue("999")@QueryParam("to") int to,  
9.         @DefaultValue("name") @QueryParam("orderBy") List<String> orderBy) {  
10.    
11.         return Response  
12.            .status(200)  
13.            .entity("getUsers is called, from : " + from + ", to : " + to  
14.             + ", orderBy" + orderBy.toString()).build();  
15.    
16.     }  

URL:users/query
输出:getUsers is called, from : 1000, to : 999, orderBy[name]