nickyhu

REST架构下的接口规范和使用准则

admin — Fri, 10 Oct 2008 16:19:55 +0800

REST架构风格是全新的针对Web应用的开发风格，是当今世界最成功的互联网超媒体分布式系统架构，它使得人们真正理解了Http协议本来面貌。随着 REST架构成为主流技术，一种全新的互联网网络应用开发的思维方式开始流行。

目前，51，校内，海内，阿里软件等都通过REST架构来实现平台数据的开放，与第三方的数据交换。REST已然成为sns开放平台的首要开放标准。下面简单介绍一下REST的原理和使用准则。

wiki介绍见此：http://en.wikipedia.org/wiki/Representational_State_Transfer

REST是什么

REST是英文Representational State Transfer的缩写，中文翻译为“表述性状态转移”，他是由Roy Thomas Fielding博士在他的论文《Architectural Styles and the Design of Network-based Software Architectures》中提出的一个术语。REST本身只是为分布式超媒体系统设计的一种架构风格，而不是标准。

基于Web的架构，实际上就是各种规范的集合，这些规范共同组成了Web架构。比如Http协议，比如客户端服务器模式，这些都是规范。每当我们在原有规范的基础上增加新的规范，就会形成新的架构。而REST正是这样一种架构，他结合了一系列的规范，而形成了一种新的基于Web的架构风格。

传统的Web应用大都是B/S架构，它包括了如下一些规范。

客户－服务器

这种规范的提出，改善了用户接口跨多个平台的可移植性，并且通过简化服务器组件，改善了系统的可伸缩性。最为关键的是通过分离用户接口和数据存储这两个关注点，使得不同用户终端享受相同数据成为了可能。

无状态性

无状态性是在客户－服务器约束的基础上添加的又一层规范。他要求通信必须在本质上是无状态的，即从客户到服务器的每个request都必须包含理解该 request所必须的所有信息。这个规范改善了系统的可见性（无状态性使得客户端和服务器端不必保存对方的详细信息，服务器只需要处理当前 request，而不必了解所有的request历史），可靠性（无状态性减少了服务器从局部错误中恢复的任务量），可伸缩性（无状态性使得服务器端可以很容易的释放资源，因为服务器端不必在多个request中保存状态）。同时，这种规范的缺点也是显而易见得，由于不能将状态数据保存在服务器上的共享上下文中，因此增加了在一系列request中发送重复数据的开销,严重的降低了效率。

缓存

为了改善无状态性带来的网络的低效性，我们填加了缓存约束。缓存约束允许隐式或显式地标记一个response中的数据，这样就赋予了客户端缓存 response数据的功能，这样就可以为以后的request共用缓存的数据，部分或全部的消除一部分交互，增加了网络的效率。但是用于客户端缓存了信息，也就同时增加了客户端与服务器数据不一致的可能，从而降低了可靠性。

B/S架构的优点是其部署非常方便，但在用户体验方面却不是很理想。为了改善这种情况，我们引入了REST。

REST在原有的架构上增加了三个新规范：统一接口，分层系统和按需代码。

统一接口

REST 架构风格的核心特征就是强调组件之间有一个统一的接口，这表现在REST世界里，网络上所有的事物都被抽象为资源，而REST就是通过通用的链接器接口对资源进行操作。这样设计的好处是保证系统提供的服务都是解耦的，极大的简化了系统，从而改善了系统的交互性和可重用性。并且REST针对Web的常见情况做了优化，使得REST接口被设计为可以高效的转移大粒度的超媒体数据，这也就导致了REST接口对其它的架构并不是最优的。

分层系统

分层系统规则的加入提高了各种层次之间的独立性，为整个系统的复杂性设置了边界，通过封装遗留的服务，使新的服务器免受遗留客户端的影响，这也就提高了系统的可伸缩性。

按需代码

REST允许对客户端功能进行扩展。比如，通过下载并执行applet或脚本形式的代码，来扩展客户端功能。但这在改善系统可扩展性的同时，也降低了可见性。所以它只是REST的一个可选的约束。

REST的设计准则

REST架构是针对Web应用而设计的，其目的是为了降低开发的复杂性，提高系统的可伸缩性。REST提出了如下设计准则：

1. 网络上的所有事物都被抽象为资源（resource）；
2. 每个资源对应一个唯一的资源标识符（resource identifier）；
3. 通过通用的连接器接口（generic connector interface）对资源进行操作；
4. 对资源的各种操作不会改变资源标识符；
5. 所有的操作都是无状态的（stateless）。

REST中的资源所指的不是数据，而是数据和表现形式的组合，比如“最新访问的10位会员”和“最活跃的10为会员”在数据上可能有重叠或者完全相同，而由于他们的表现形式不同，所以被归为不同的资源，这也就是为什么REST的全名是Representational State Transfer的原因。资源标识符就是URI(Uniform Resource Identifier)，不管是图片，Word还是视频文件，甚至只是一种虚拟的服务，也不管你是xml格式,txt文件格式还是其它文件格式，全部通过 URI对资源进行唯一的标识。

REST是基于Http协议的，任何对资源的操作行为都是通过Http协议来实现。以往的Web开发大多数用的都是Http协议中的GET和POST方法，对其他方法很少使用，这实际上是因为对Http协议认识片面的理解造成的。Http不仅仅是一个简单的运载数据的协议，而是一个具有丰富内涵的网络软件的协议。他不仅仅能对互联网资源进行唯一定位，而且还能告诉我们如何对该资源进行操作。Http把对一个资源的操作限制在4个方法以内：GET, POST,PUT和DELETE，这正是对资源CRUD操作的实现。由于资源和URI是一一对应的，执行这些操作的时候URI是没有变化的，这和以往的 Web开发有很大的区别。正由于这一点，极大的简化了Web开发，也使得URI可以被设计成更为直观的反映资源的结构，这种URI的设计被称作 RESTful的URI。这位开发人员引入了一种新的思维方式：通过URL来设计系统结构。当然了，这种设计方式对一些特定情况也是不适用的，也就是说不是所有的URI都可以RESTful的。

REST 之所以可以提高系统的可伸缩性，就是因为它要求所有的操作都是无状态的。由于没有了上下文(Context)的约束，做分布式和集群的时候就更为简单，也可以让系统更为有效的利用缓冲池(Pool）。并且由于服务器端不需要记录客户端的一系列访问，也减少了服务器端的性能。

使用REST架构

对于开发人员来说，关心的是如何使用REST架构，这里我们来简单谈谈这个问题。REST不仅仅是一种崭新的架构，它带来的更是一种全新的Web开发过程中的思维方式：通过URL来设计系统结构。在REST中，所有的URL都对应着资源，只要URL的设计是良好的，那么其呈现的系统结构也就是良好的。这点和TDD (Test Driven Development)很相似，他是通过测试用例来设计系统的接口，每一个测试用例都表示一系列用户的需求。开发人员不需要一开始就编写功能，而只需要把需要实现的功能通过测试用例的形式表现出来即可。这个和REST中通过URL设计系统结构的方式类似，我们只需要根据需求设计出合理地URL，这些 URL不一定非要链接到指定的页面或者完成一些行为，只要它们能够直观的表现出系统的用户接口。根据这些URL，我们就可以方便的设计系统结构。从 REST架构的概念上来看，所有能够被抽象成资源的东西都可以被指定为一个URL，而开发人员所需要做的工作就是如何能把用户需求抽象为资源，以及如何抽象的精确。因为对资源抽象的越为精确，对REST的应用来说就越好。这个和传统MVC开发模式中基于Action的思想差别就非常大。设计良好的URL，不但对于开发人员来说可以更明确的认识系统结构，对使用者来说也方便记忆和识别资源，因为URL足够简单和有意义。按照以往的设计模式，很多URL后面都是一堆参数，对于使用者来说也是很不方便的。

既然REST这么好用，那么是不是所有的Web应用都能采取此种架构呢？答案是否定的。我们知道，直到现在为止，MVC(Model-View-Controller) 模式依然是Web开发最普遍的模式，绝大多数的公司和开发人员都采取此种架构来开发Web应用，并且其思维方式也停留于此。MVC模式由数据，视图和控制器构成，通过事件(Event)触发Controller来改变Model和View。加上Webwork,Struts等开源框架的加入，MVC开发模式已经相当成熟，其思想根本就是基于Action来驱动。从开发人员角度上来说，贸然接受一个新的架构会带来风险，其中的不确定因素太多。并且REST新的思维方式是把所有用户需求抽象为资源，这在实际开发中是比较难做到的，因为并不是所有的用户需求都能被抽象为资源，这样也就是说不是整个系统的结构都能通过REST的来表现。所以在开发中，我们需要根据以上2点来在REST和MVC中做出选择。我们认为比较好的办法是混用REST和MVC，因为这适合绝大多数的Web应用开发，开发人员只需要对比较容易能够抽象为资源的用户需求采取REST的开发模式，而对其它需求采取MVC开发即可。这里需要提到的就是ROR(Ruby on Rails)框架，这是一个基于Ruby语言的越来越流行的Web开发框架，它极大的提高了Web开发的速度。更为重要的是，ROR(从1.2版本起)框架是第一个引入REST做为核心思想的Web开发框架，它提供了对REST最好的支持，也是当今最成功的应用REST的Web开发框架。实际上，ROR的 REST实现就是REST和MVC混用，开发人员采用ROR框架，可以更快更好的构建Web应用。

对开发人员来说，REST不仅仅在Web开发上贡献了自己的力量，同时也让我们学到了如何把软件工程原则系统地应用于对一个真实软件的设计和评估上

Codeigniter升级到1.7

admin — Thu, 09 Oct 2008 17:57:42 +0800

Codeigniter Version 1.7

Release Date: In development
SVN Revision: XXXX

Libraries
- Added a new Form Validation Class. It simplifies setting rules and field names, supports arrays as field names, allows groups of validation rules to be saved in a config file, and adds some helper functions for use in view files. Please note that the old Validation class is now deprecated. We will leave it in the library folder for some time so that existing applications that use it will not break, but you are encouraged to migrate to the new version.
- Updated the Sessions class so that any custom data being saved gets stored to a database rather than the session cookie (assuming you are using a database to store session data), permitting much more data to be saved.
- Added the ability to store libraries in subdirectories within either the main “libraries” or the local application “libraries” folder. Please see the Loader class for more info.
- Added the ability to assign library objects to your own variable names when you use $this->load->library(). Please see the Loader class for more info.
- Added controller class/method info to Profiler class.
- Improved the “auto typography” feature and moved it out of the helper into its own Typography Class.
- Added max_filename option to set a file name length limit in the File Upload Class.
- Added set_status_header() function to Output class.
- Changed the output of the profiler to use style attribute rather than clear, and added the id “codeigniter_profiler” to the container div.
Database
- Added removal of non-printing control characters in escape_str() of DB drivers that do not have native PHP escaping mechanisms (mssql, oci8, odbc), to avoid potential SQL errors, and possible sources of SQL injection.
Helpers
- Added several new “setting” functions to the Form helper that allow POST data to be retrieved and set into forms. These are intended to be used on their own, or with the new Form Validation Class.
- Added current_url() and uri_segments() to URL helper.
- Altered auto_link() in the URL helper so that email addresses with “+” included will be linked.
- Improved accuracy of calculations in Number helper.
- Removed added newlines (”\n”) from most form and html helper functions.
- Tightened up validation in the Date helper function human_to_unix(), and eliminated the POSIX regex.
- Updated Date helper to match the world’s current time zones and offsets.
Other changes
- Improved performance and accuracy of xss_clean(), including reduction of false positives on image/file tests.
- Added sanitization in xss_clean() for a deprecated HTML tag that could be abused in user input in Internet Explorer.
- Added a few openxml document mime types, and an additional mobile agent to mimes.php and user_agents.php respectively.
- Added PHP Style Guide to docs.
- Added backticks around column names in MySQL when using insert_string and update_string functions, and in where() function.
- Modified Pagination library to only output the “First” link when the link for page one would not be shown.
- Added a file lock check during caching, before trying to write to the file.
- Added driver name variable in each DB driver, based on bug report #4436.
- Modified Cookie key cleaning to unset a few troublesome key names that can be present in certain environments, preventing CI from halting execution.

sns开放平台里的淘金术

admin — Thu, 09 Oct 2008 15:47:06 +0800

sns平台如果说是一座座金矿，那么如何在这些金矿中淘金呢？有位叫付宁的哥们给出了自己的成绩，并分享了自己的经验。看到成绩下面那一堆的评论，我知道，sns在今天的中国是真火了。

过去的几周里，不断听到朋友，同事，友人说起开心网，开始我抱着鄙夷的心态，想sns这玩意都是偶2年前玩剩下的，跟我谈sns？有没有搞错。当听到越来越多娱乐的笑声后，我不禁有点妒嫉起开心网来。

sns在校园中火了，因为有校内。sns在白领中也火了，现在有开心网。还有几家不错的sns还在努力着，甚至豆瓣也都改造成了半个sns，并且开放了平台数据。

蓝海已然成了红海，沙漠变成了黄金。

我想现阶段要再靠什么重金打造出一个重练级的sns来，有些困难，对于中小开发者而言，利用现有这些sns巨人们开放的数据平台，好好下一点功夫，这可能是继ggad，sp，联盟，seo之后的又一个站长黄金爆发点。

做好了，一夜成名。

是地，这不就是多少人梦寐以求的么？！

既然话都说到这里，Nickyhu粗粗整理了一些sns开放平台的开发者入口，希望对大家有所帮助。如果有遗漏还请留言补充。

51：http://developers.51.com/index.php

校内：http://app.xiaonei.com/developers/portal.do

豆瓣：http://www.douban.com/service/apidoc/

海内网：http://www.hainei.com/developer

寓言

admin — Wed, 08 Oct 2008 16:12:24 +0800

当浏览器能够代替操作系统，互联网差不多走到了桌面的尽头。如果把电脑桌面换成手机屏幕，那么，这将是互联网的第二春。

桌面阶段的大家伙们将会意识到手机屏幕的威胁，但因为太过笨重，始终无法灵巧转身，以至于错失良机，被第二次浪潮淹没。

新的规则依托于旧的体系，但创新永不停止。

随机日志

谁需要整站优化？

admin — Tue, 07 Oct 2008 17:15:54 +0800

网站优化有很多方面，是一个很多细致工作累积的过程。专业与不专业相比，专业通过长期的摸索，能够少走弯路，直达要害处。解决你网站很多熟视无睹的毛病。

整站优化是一个庞大的工程，牵涉到很多方面的维护。如同给你的网站看医生，当你的网站排名不佳，网页收录遇到瓶颈，关键字不见踪影，甚至连百度爬虫都无心路过。那么给你的网站好好做一个检查，找到病根，并解决之，才能让网站恢复健康。

一个健康的网站才能吸引更多用户，带来更多高质量的流量。

Nickyhu拥有3年以上互联网行业经验，全职做网站（电子商务）产品经理，能够帮助您在搜索引擎优化（SEO）之外，发现更多网站的问题与毛病，帮助您的网站摆脱瓶颈，发现蓝海中的盈利点。

如果您需要整站优化，请看这里：http://www.nickyhu.com/youhua

火星

admin — Mon, 06 Oct 2008 14:48:03 +0800

随着神七的成功，中央台开始放愚公移山了。看到这样题材的片子，我只能脑残地把它与火星联系起来。星际探索，宇宙揭秘这样很终极的课题，在我们看来，和嫦娥奔月，夸父追月以及愚公移山这些神话似乎很接近。

要么是古人早干过的。要么是我孙子该干的。反正，当下，与我无关。

看看美国，俄罗斯在这方面的投入和产出，再看看邻国印度号称的2020年登月。我们中国人也不甘落后，作为大国，也开始自己的星际征程。从外太空看着我们美丽的地球，对于一个人来说，实在是太神奇，也太超脱了。

也许，宇宙能够帮助人类摆脱愚昧，看清物质本源，并加以合理利用。然而，天文学这个细分的类目，在中国互联网的一片娱乐大潮中，还显得很小众。也许，天文科学知识的普及和对宇宙未知领域探索的好奇心，需要在互联网中给予激烈。

因为，从某种角度看来，互联网与神秘的宇宙有着多么相似的特性啊。

PS：有报道称，火星上有水蒸汽！

随机日志

手机

admin — Sat, 27 Sep 2008 11:35:39 +0800

诺基亚的手机哪里都好，就是一点不好，太坚固了，怎么折磨它都不坏。没辙，只好旧的没去，准备新的了。老手机用了这些年，再一头扎进现在的手机市场里，有些刘姥姥进大观园，看得眼花。

最头疼的是水货和行货，这一对“宝货”。水货便宜，但售后和质量叫人不敢放心。行货有保障，但是那个价格，在你看了水货的价格之后，就感觉很水，心里别扭。同样的机子，渠道不同，关税一加，价格直线上去。

水货在网上很泛滥，无论价格和图文宣传都非常有诱惑力。很容易叫人心动，但同时也问号多多。我总是怀疑，这样的低价，商家还怎么赚钱？是不是传说的中精仿山寨机？比如这个港版的iphone。

行货很正儿八经地躺在货架上，一副死猪不怕开水烫的样子。老娘就这价，你看着办吧。

是花钱买个安心呢？在中国，买安心是最贵的。还是图个便宜，买一个冒险？多普达的P660不错，只是不支持wifi，其他都满意。S600也挺酷，据说支持wifi，但是欧版和亚太版的价格有些差距，水货这里头还真搞。

随机日志

金融危机还是金融阴谋？

admin — Thu, 25 Sep 2008 15:03:07 +0800

先看这里：

官方已披露的数据显示，截至2008年6月底，中国外汇储备总额已达1.81万亿美元，美国债券在其中占据半壁江山，达9220亿美元。而在这些美国债券中，美国国债与“两房”为代表的美国政府相关企业(GSE)债券，各有约5000亿美元和3400亿美元。

再看这里：

9月23日，美联储与美国财政部联手抛出的7000亿美元华尔街拯救方案提交国会审议，在国会山的参议院辩论中，民主党尽管提出反对意见，但已仅限于救助的对象如何扩大至购房者债务等方面。而作为救助资金的来源，美国财政部已经提请国会批准将美国国债的发行额度上限从10.6万亿美元提升到11.3万亿美元。

是不是说？

当美元这么一贬值，中国人民这么多年来辛苦积累的这些外汇储备都将成为一张废纸？

随机日志

面试

admin — Thu, 25 Sep 2008 14:37:28 +0800

第一次做面试官，坐在桌子的另一边。对面坐着自信满满（至少装得）的应聘者，我走进会议室的那一刻，是否决定着他人生中这一次的选择呢？第一次有主宰者的幻觉。

86年的他已经毕业1年，在一家小网站做过，自己又出来创业半年，做企业营销咨询。来自江西，毕业于东华的他，是年轻而又有活力的。面对漫长的职业生涯，处于起跑阶段的他，脸上写满了期待和热忱。

先是简单的自我介绍，而后就他有限的工作经历做了提问。唯一的缺点是自顾自说得太多，有些话不够关键，离主题太远。我想起当初我面试的经历，人在微微紧张，又想充分表现自己的时候，嘴巴不太容易合拢。

其实问题的关键还在于他对应聘岗位的陌生，有一些小经验就当莫大的收获，谈来虽然畅快，但缺少主心骨和核心竞争力。

他是个专业的面试者，可惜遇到我这个不太热的面试官，不来电，或者说没有交互的对话，让他的这次面试显得有些失败。为了弥补他对岗位的陌生，我最后开导了他对于PM的工作流程，看得出，他很聪明，最后的握手，握得有些用力。

祝他顺利。

魔兽争霸如何让你摆脱脑残？

admin — Tue, 23 Sep 2008 17:51:58 +0800

玩物丧志。加个前提我就基本认同，否则绝不认同。前提就是：对于那些仅供脑残人士娱乐的网游，仅供BT人士玩赏的成人游戏和仅供无聊人士谋杀时间的弱智游戏。
这个前提之外的玩游戏，就不是什么丧志，而是开发大脑的最好锻炼。比如魔兽争霸就是其中出类拔萃的佼佼者。如果将来有儿子，得培养他成为像sky那样的高手。
最近每日工作完毕，都会操两盘魔兽。有时候人兽大战，有时候人妖大战。Nickyhu擅长人类，对付不死基本靠坦克，对付兽族基本靠女妖，对付暗夜基本靠枪手。这么一说，高手就知道遇见菜鸟了。
Nickyhu觉得，魔兽争霸这玩意的好在于：弹指之间把瞬间决策的魅力放大到战场的每个角落，英雄是自我化身，主宰着战场的进程。
发动大家一起玩玩魔兽，开发智力的同时，还能锻炼手指灵活度，对于鼠标和键盘的操作灵敏度极高。更多游戏教程可以看这里：http://www.nickyhu.com/moshouzhenba

nickyhu

REST架构下的接口规范和使用准则

相关日志

Codeigniter升级到1.7

Codeigniter Version 1.7

相关日志

sns开放平台里的淘金术

相关日志

寓言

随机日志

谁需要整站优化？

相关日志

火星

随机日志

手机

随机日志

金融危机还是金融阴谋？

随机日志

面试

相关日志

魔兽争霸如何让你摆脱脑残？

随机日志