@Path注解

最近用到的一个项目，看到Controller控制层、Method方法都是通篇的@Path注解，由于之前并没有使用过该注解，故记此篇。

首先看一下项目中的使用方式：

@Path("clientWeb")
public class ClientWeb {

    @POST
    @Path("/getData")
    public String getData(@QueryParam("start") Integer start,@QueryParam("limit") Integer limit) {
        return "xxx"
    }
}

如上我们可以看到，@Path注解可以标记在类名之上，也可以标记在方法名上。该注解接收一个value参数，表示定义资源的地址。

另外，资源地址相同，但是HTTP方法不同的两个方法是完全两个不同的REST接口，HTTP方法和资源地址相结合在一起才可以完成对一个资源的定位。

点进@Path注解后查看其源码如下：

package javax.ws.rs;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface Path {
    String value();
}

我们可以发现其属于 javax.ws.rs 包，java.ws.rs 是 jax-rs 规范中定义的包名，什么鬼？

jax-rs 全称是：java API for RESTful Services，这是一套规范，规范文档。

简单点说就是这套规范是为构建restful服务的 [restful可以理解为web接口]，我们知道Spring自带了对restful的支持，但是呢，Spring并没有遵循这个协议，言外之意就是不具有移植特性，怎么讲？

举例：JPA大家应该了解吧，采用JPA开发规范的话，很容易实现Mysql与Oracle等数据库的迁移，因为符合规范。

尽管Spring并不遵循这个协议，但还是Spring好用。

再回到jax-rs，目前能够实现jax-rs标准的框架有很多，比如：

Apache CXF，开源的Web服务框架。
Jersey，由Sun提供的JAX-RS的参考实现。
RESTEasy，JBoss的实现。
Restlet，由Jerome Louvel和Dave Pawson开发，是最早的REST框架，先于JAX-RS出现。
Apache Wink，一个Apache软件基金会孵化器中的项目，其服务模块实现JAX-RS规范。

说这么多，其实是想get一点，就是在当下都用Spring的环境下，还是有许多可以实现web服务的，重新再来看@Path吧。

@Path就当@RequestMapping来用，如下所例。

@Path("/clientWeb")
public class  ClientWeb{    
    @GET    
    @Path("/getData")
    public String getData(String params) {
        return “xxx";
    }
}