RESTFul_专题_帮助文档_Thinkphp手册

RESTFul_专题_帮助文档_Thinkphp手册

REST介绍

REST(Representational State Transfer表述性状态转移)是一种针对网络应用的设计和开发方式,可以降低开发的复杂性,提高系统的可伸缩性。REST提出了一些设计概念和准则:

1、网络上的所有事物都被抽象为资源(resource);

2、每个资源对应一个唯一的资源标识(resource identifier);

3、通过通用的连接器接口(generic connector interface)对资源进行操作;

4、对资源的各种操作不会改变资源标识;

5、所有的操作都是无状态的(stateless)。

需要注意的是,REST是设计风格而不是标准。REST通常基于使用HTTP,URI,和XML以及HTML这些现有的广泛流行的协议和标准。

传统的请求模式和REST模式的请求模式区别:

作用传统模式REST模式
列举出所有的用户GET /users/listGET /users
列出ID为1的用户信息GET /users/show/id/1GET /users/1
插入一个新的用户POST /users/addPOST /users
更新ID为1的用户信息POST /users/mdy/id/1PUT /users/1
删除ID为1的用户POST /users/delete/id/1DELETE /users/1

关于更多的REST信息,可以参考:http://zh.wikipedia.org/wiki/REST

RESTFul支持

3.2的RESTFul支持更为灵活,你不需要使用REST模式,只需要把控制器继承Think/Controller/RestController即可。 继承RestController控制器后你的访问控制器就可以支持下面的一些功能:

  • 支持资源类型自动检测;

  • 支持请求类型自动检测;

  • RESTFul方法支持;

  • 可以设置允许的请求类型列表;

  • 可以设置允许请求和输出的资源类型;

  • 可以设置默认请求类型和默认资源类型;

例如:

REST参数

继承了RestController后,你可以在你的控制器里面设置rest相关的属性参数,包括:allowMethod,defaultMethod,allowType,defaultType以及allowOutputType。

属性名说明默认值
allowMethodREST允许的请求类型列表array('get','post','put','delete')
defaultMethodREST默认请求类型get
allowTypeREST允许请求的资源类型列表array('html','xml','json','rss')
defaultTypeREST默认的资源类型html
allowOutputTypeREST允许输出的资源类型列表array( 'xml' => 'application/xml', 'json' => 'application/json','html' => 'text/html',)

REST方法

RESTFul方法的操作方法定义主要区别在于,需要对请求类型和资源类型进行判断,大多数情况下,通过路由定义可以把操作方法绑定到某个请求类型和资源类型。如果你没有定义路由的话,需要自己在操作方法里面添加判断代码,示例:

在Rest操作方法中,可以使用$this->_type获取当前访问的资源类型,用$this->_method获取当前的请求类型。

REST控制器类还提供了response方法用于REST输出: 用法如下:

Response方法会自动对data数据进行输出类型编码,目前支持的包括xml/json/html。

除了普通方式定义Restful操作方法外,系统还支持另外一种自动调用方式,就是根据当前请求类型和资源类型自动调用相关操作方法。系统的自动调用规则是:

定义规范说明
操作名提交类型资源后缀标准的Restful方法定义,例如 read_get_pdf
操作名_资源后缀当前提交类型和defaultMethod属性相同的时候,例如read_pdf
操作名_提交类型当前资源后缀和defaultType属性相同的时候,例如read_post

要使用这种方式的前提就是不能为当前操作定义方法,这样在空操作的检查之前系统会首先按照上面的定义规范顺序检查是否存在方法定义,如果检测到相关的restful方法则不再检查后面的方法规范,例如我们定义了InfoController如下:

如果我们访问的URL是:

假设我们没有定义路由,这样访问的是Info控制器的read操作,那么上面的请求会调用InfoController类的 read_get_xml方法,而不是read_xml方法,但是如果访问的URL是:

那么则会调用read_json方法。

如果我们访问的URL是

由于我们不允许rss资源类型的访问,所以,调用的方法其实是read_html方法。

REST路由

我们可以借助3.2的路由参数功能,来解决REST的路由定义问题。 例如,

上面的路由定义,把blog/5路由到了blog/read/id/5 并且,约束了后缀是xml 请求类型是get。 我们还可以定义其他的路由参数,例如:

为了确保定义不冲突,REST路由定义我们通常改成下面的定义方式:

这样就可以给相同的路由规则定义不同的参数支持。定义了REST路由后,你的rest方法定义就不受任何约束,当然,如果路由定义的操作方法不存在的时候,系统默认的rest方法规范仍然会有效。

未经允许不得转载:淘淘源码吧 » RESTFul_专题_帮助文档_Thinkphp手册