对于一个后端来说，什么是RESTful API

不知道从什么时候开始，在招聘要求中出现这么一条：能够写出RESTful风格 API。

先看概念：

RSET即表述状态传递（Representational State Transfer）。表述性状态转移是一组织架构约束条件和原则。而满足这些约束条件和原则的应用程序或设计就是RESTful。需要注意，是设计风格而不是标准。另外REST 通常使用 JSON 数据格式。

想想：当其他程序员看到你的Get字样的接口，就知道是获取数据的,Delete就是删除数据的。

以下为 REST 基本架构的四个方法：

• GET - 用于获取数据。

• PUT - 用于更新或添加数据。

• DELETE - 用于删除数据。

• POST - 用于添加数据。

另外，在后端的Controller中方法上加注释一般就会有GET、POST、DELETE等字样的注释。这样做，一是代码的可读性更好。另外一个原因就是类似权限或者请求的特殊处理，比如delete方法如果是删除数据的操作，当然要做重点关注，万一删除了不该删除的数据，那麻烦就大了。不是跑路能解决的。

一种好的编程习惯，应该成为一个优秀程序员的职业素养。

 

JAX-RS 是将在Java EE 6中引入的一 种新技术。JAX-RS即Java API for RESTful Web Services, 是一 个Java编程语言的应用程序接口，支持按照表述性状态转移(REST)架构凤格创建Web服务。JAX-RS使用了Java SE 5引入的Java标注未简化Web服务的客户端和服务瑞的开发和部署。包括：
• @Path, 标注资原类或者方法的相对路径 。
• @GET 、 @PUT 、 @POST 、 @DELETE, 标注方法是HTTP请求的类型。
• @Produces, 标注返回的MIME媒体类型。
• @Consumes , 标注可接受请求的MIME媒体类型。
• @PathParam 、 @QueryPararn 、 @HeaderParam 、 @CookieParam 、 @MatrixParam 、@FormParam, 标注方法的参数未自HTTP请求的不同位置 ， 例如 ， @PathParam来自URL 的路径 ， @QueryParam来自URL的查询参数 ， @HeaderParam未自HTTP请求的头信息 ， @CookieParam未自HTTP请求的Cookie。