南国倾城

左手代码,右手年华


  • 首页

  • 标签

  • 归档

  • 搜索

RESTful API规范补充以及JAX-RS传递参数的方法

发表于 2016-08-23 | 阅读次数:

搜索的过滤与排序

  搜索在RESTful API里是用GET方法实现的,URI一般是某个对象,可以是单个也可以是列表。以微博搜索为例,如果不加任何条件,其URI一般是这样的:

/api/weibo
/api/weibo/6

  但往往还需要限制一下搜索条件,例如评论数大于某个数,或者含有什么关键字,如果是搜索微博列表,也可能加上对日期作升序或降序排序的要求。这些附加条件,是作为query param附加在http请求里的。例如:

阅读全文 »

RESTful API 入门二(JAX-RS实现)

发表于 2016-08-22 | 阅读次数:

为什么要用Provider

  provider是在程序运行时自动调用的一些类,起到配置与修改http请求与回应的作用,是JAX-RS里不可或缺的一项组件。从上一讲可以看到,Resource组件已经能够完全实现RESTful API,在JAX-RS标准里无非就是添加一些注解的事。然而,实现功能只是最基本的要求,要做出企业级的应用,必须符合一些标准和规范,才能最大程度地提高团队的开发效率,并从最佳实践的角度去吻合市场的需求。RESTful API的一些设计规范,就必须要使用到provider去做配置。

几种provider的介绍

  所有类名上添加了@provider注解的类,都属于provider组件。下面将介绍一下常用的provider。

阅读全文 »

RESTful API 入门一(JAX-RS实现)

发表于 2016-08-21 | 阅读次数:

前言

  关于RESTful API的概念网上已经说过很多,可以用很多语言与框架实现,其规范也十分详尽。我这篇入门教程尽量用自己的理解去总结RESTful API的一些要点,并以JaveEE规范的JAX-RS框架为例,以实战的形式去讲述怎么搭建一套RESTful API,并在实践过程中体现RESTful API的设计规范。

什么是RESTful API

  1. 服务器端提供给开发者的一套接口,开发者通过调用这些接口,访问服务器的资源。这些资源通常是数据库的表抽象出来的对象,程序员通过获取这些对象,把对这些对象的增删改查映射到数据库,从而实现自己前后端的其他业务逻辑。目前移动端很多都是使用RESTful API来访问后台,受移动端影响,浏览器端也越来越多地使用这种规范。
  2. 本质就是http协议。RESTful API的所有操作无非是CRUD,全部映射成http的POST,GET,PUT,PATCH,DELETE等方法,操作RESTful API实际上就是操作http报文,其只是在http协议外面再封装一层。因此操作十分简洁,直观,代码优雅。
  3. 用URI定位所有资源。服务器端把所有供开发者访问的资源都以特定的URI表示。URI与http方法(上述的POST,GET等)组合,便可以实现对所有资源的所有操作。以微博和评论为例,假如新浪微博开放了所有微博和评论允许开发者访问。那么所有微博的URI可能是:
阅读全文 »
1…45
Gavin Wong

Gavin Wong

蟾宫桂花千里香,暖风拂面惹人狂。我欲因之凌霄起,嫦娥丹桂尽入囊。

43 日志
39 标签
© 2019 Gavin Wong
由 Hexo 强力驱动
|
主题 — NexT.Pisces v5.1.4