RESTful 两个注解@PathParam 和 @QueryParam 以及@PathVariable

@PathVariable 映射 URL 绑定的占位符

通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中:URL 中的 {xxx} 占位符可以通过

@PathVariable("xxx") 绑定到操作方法的入参中。

一般与@RequestMapping(method = RequestMethod.GET)一起使用

@RequestMapping("/getUserById/{name}")
    public User getUser(@PathVariable("name") String name){
        return userService.selectUser(name);
    }

若方法参数名称和需要绑定的uri中变量名称一致时,可以简写:

@RequestMapping("/getUser/{name}")
    public User getUser(@PathVariable String name){
        return userService.selectUser(name);
    }

---------------------------------------------------

关于@PathParam 和 @QueryParam，两个注解都是取路径的，但是方式不同。这里我之前也遇到问题了。主要是看你怎么传入的路径。

@QueryParam 主要通过键值对这样取 如 a=1     QueryParam("a")

@PathParam   主要通过路径映射取(后面解释)

 
1 关于@QueryParam用法，我们直接取参数传入的名字。

如  localhost:8080/introduction?booId=1?gg=2?version=3?platform=4?vps=5

.此时我们就用QueryParam   通过@QueryParam("bookId") Integer bookId 实际代码如下

    @GET
    @Path("/introduction")
    Response introduction(
            @QueryParam("bookId") Integer bookId,
            @QueryParam("gg") Integer gg,
            @QueryParam("version") String version,
            @QueryParam("platform") String platform,
            @QueryParam("vps") String vps
    );

后台就获得booId=1    gg=2    version=3       platform=4       vps=5

 
2  如果使用PathParam ，传参就应该为

localhost:8080/introduction/1/2/3/4/5  对应下面的  /{bookId}/{gg}/{version}/{plarform}/{vps}

@Path("/introduction/{bookId}/{gg}/{version}/{plarform}/{vps}")

也就是让booId=1    gg=2    version=3       platform=4       vps=5  然后通过

@PathParam ("bookId") Integer bookId                把bookId的值取出来

    @GET
    @Path("/introduction/{bookId}/{gg}/{version}/{plarform}/{vps}")
    Response introduction(
            @PathParam ("bookId") Integer bookId,
            @PathParam ("gg") Integer gg,
            @PathParam ("version") String version,
            @PathParam ("platform") String platform,
            @PathParam ("vps") String vps
    );

后台同样获得booId=1    gg=2    version=3       platform=4       vps=5

最后附上简单常用的注解，和一个讲restful 框架的一个帖子
@PathParam注解

该注解定义路径的参数信息，用于指定的URI路径参数，@PathParam 用在接收请求的方法的参数上。

    @GET
    @Path("/user/{username}")
    public String getUser(@PathParam("username") String userName) {
        return "hello," + userName;
    }


@PathParam注解提供更精确的匹配方式，如要求变量只能由字母和数字构成，则可以使用表达式覆盖默认的表达式[^/]+?
如@Path("users/{username: [a-zA-Z][a-zA-Z_0-9]*}")

---------------------------------------------------------------------------

什么是资源(Resource)

所谓"资源"，就是网络上的一个实体，或者说是网络上的一个具体信息。它可以是一段文本、一张图片、一首歌曲、一种服务，总之就是一个具体的实在。你可以用一个URI（统一资源定位符）指向它，每种资源对应一个特定的URI。要获取这个资源，访问它的URI就可以，因此URI就成了每一个资源的地址或独一无二的标识符。
应用，资源和子资源

一个完整的资源访问路径（URI）由以下部分构成
<协议>://<主机地址>:<端口>/应用域/<资源路径>/<子资源路径>
如系统应用中获取用户详细信息的URI可表示为
http://192.169.1.10:8080/system/user/1000001
协议：常用的协议有http、https、ws

    主机地址：IP地址或域名
    端口：服务端口
    应用域：应用中根据业务属性划定的访问范围，如/system代表系统业务域，/product代表产品业务域
    资源路径：包含所有子资源的路径
    子资源路径：具体的资源访问地址

Jersey中应用域在服务器的启动类中，通过ServletContextHandler提供的setContextPath方法指定。

ServletContextHandler apiContext = new ServletContextHandler(
                ServletContextHandler.SESSIONS);
apiContext.addServlet(sh, "/*");
//指定应用域
apiContext.setContextPath("/system");

@Path注解

@Path注解的源码如下，可以看到该注解可以标记在类上，也可以标记在方法上,接收一个value参数，标识资源的地址。

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Path {
    String value();
}

@Path使用举例

@Path("")
@WebService
public class WelcomeRes {
    @Path("")
    @GET
    public String sayHello(@Context HttpServletRequest request) {
        return "hello, jetty!";
    }
}

根资源类(Root Resource Classes)

在JAX-RS标准中，根资源类是带有@PATH 注解的类，且包含至少一个@Path 注解的方法或者方法带有 @GET、@PUT、@POST、 @DELETE 资源方法指示器的 POJO。
资源方法(Resource Method)

资源方法是带有资源方法指示器（resource method designator）注解的方法，在Jersey中，资源方法指示器即@GET、@HEAD、@PUT、@POST、 @DELETE。
关于@Path注解的理解

    @Path("")相当于@Path("/")，即使注解的value中不显示指定"/"，框架会自动加上。

如以下示例中路径注解加"/"和不加，最后的访问地址都为/user

    @Path的内容是否以”/”开头都没有区别
    是否以”/”结尾也没有什么区别