RESTful Web Services中文版
点击看大图基本信息
- 原书名： RESTful Web Services
- 原出版社： O'Reilly Media, Inc.
编辑推荐
“所有从事Web相关开发的人员都应阅读本书。”
——David}teinemeiei Heinsson，Rails框架发明人
“终于有一本书为我们制定了关于构建贴近而不是绕开Web理念的服务的路线图——这本书就是RESTful Web Services。”
——Adam Trachtenberg，PHP作家，eBay Web服务传道者
你已经知道如何构建面向人类用户的网站，但你知道如何构建面向计算机程序的网站吗?万维网（World wide Web）不仅仅是一个超大的分布式应用——它更是一个用于分布式计算的平台。Web服务、mashup及Ajax应用都把Web作为平台使用，而如今的Web服务技术却忽视了简单性这一Web赖以成功的重要特性，它们没有遵从Web的理念，自然也不具有Web的优势。
本书要让Web服务回归“Web”的理念。它向你展示了如何用你日常使用的技术来访问programmable web，此处的关键是REST——它是支撑Web的架构风格。本书：
强调Web基础技术——HTTP应用协议、uRI命名标准，以及xML标记语言——的强大能力
介绍了面向资源的架构（Resource-Oriented Architecture，ROA），即一组用于设计REST式Web服务的原则揭示了REST式设计为何比RPC式设计更简单、更具多功能性及可伸缩性
给出了REST式Web服务的真实案例，比如Amazon s3和Atom发布协议
讨论了各种流行的编程语言的Web服务客户端
展示了如何用三种流行的框架——Ruby on Rails、Restlet（Java）和Django（Python）——实现REST式服务
聚焦实际问题，比如如何设计与实现REST式Web服务及客户端
《RESTful Web Services 中文版》是一本将REST设计理念应用于真实Web服务的书，它向你提供了一些成功设计所需的最佳实践，以及把设计转化为代码所需的技巧。你可以利用Web的强大能力来构建可编程应用——只要你遵从Web的理念，而不是违反它。本书向你解释了具体做法。
内容简介回到顶部↑
本书向读者介绍了什么是REST、什么是面向资源的架构（Resource-Oriented Architecture，ROA）、REST式设计的优点、REST式Web服务的真实案例分析、如何用各种流行的编程语言编写Web服务客户端、如何用三种流行的框架（Ruby on Rails、Restlet和Django）实现REST式服务等。不仅讲解REST与面向资源的架构（ROA）的概念与原理，还向读者介绍如何编写符合REST风格的Web 2．0应用。本书详实、易懂，实战性强，提供了大量RESTful Web服务开发的最佳实践和指导，适合广大的Web开发人员、Web架构师及对Web开发或Web架构感兴趣的广大技术人员与学生阅读。
作译者回到顶部↑
本书提供作译者介绍
Leonard Richardson（http://www.crummy.com/）是《Ruby Cookbook》（O’Reilly）和包括Beautiful Soup 在内的若干开源库的作者。他是加利福利亚人，现在纽约生活。
.. << 查看详细
.. << 查看详细
目录回到顶部↑
序
前言
第1章：programmable web及其分类
programmable web的分类
http：信封里的文档
方法信息
作用域信息
相到嬜的服务架构
programmable web涉及的技术
其他术语
第2章：编写web服务客户端
web服务就是网站
del,icio.us：示例应用
用http库发送请求
用xml解析器处理响应
json parsers：处理序列化数据
wadl简化客户端的编写
第3章：rest式服务有什么特别不同？
介绍simple storage service
s3的面向对象设计
前言
第1章：programmable web及其分类
programmable web的分类
http：信封里的文档
方法信息
作用域信息
相到嬜的服务架构
programmable web涉及的技术
其他术语
第2章：编写web服务客户端
web服务就是网站
del,icio.us：示例应用
用http库发送请求
用xml解析器处理响应
json parsers：处理序列化数据
wadl简化客户端的编写
第3章：rest式服务有什么特别不同？
介绍simple storage service
s3的面向对象设计
译者序回到顶部↑
也许你已经通过杂志、报刊、论坛、邮件列表或博客等知道了REST与SOAP/RPC之争，不过当你读到大量持不同甚至相反观点的文章时，可能难免产生一些疑惑：究竟什么样的服务才叫REST式服务？应当从哪些方面来分析REST与RPC的异同，并评判二者的优劣？.
Roy Fielding的博士论文为Web架构的设计与评判奠定了理论基础，不过它并未就一些实际问题给出答案。而本书的最大贡献就在于，它在现有理论基础之上，根据作者对问题的深刻见解与丰富的实践经验，为这些实际问题给出了答案，并且提出了一种具体的REST式架构——面向资源的架构（Resource-Oriented Architecture）。
《RESTful Web Services》全面深入讲解了REST及ROA的有关概念与原理。此类“概念性”书籍通常给人以抽象、不易理解的印象，不过本书是一个例外。详细、易懂、实用是本书的特点，它不但向读者讲解概念、阐明原理，而且还通过丰富的示例与案例分析（如Google、Yahoo!、Amazon、Flickr、del.icio.us等）来举例说明这些概念与原理，以确保书中内容能够被不同层次的读者所理解。..
本书作者Leonard Richardson和Sam Ruby在Web开发方面有着丰富的经验与广博的见识，本书除了阐述概念与原理，还教你如何用流行的语言和框架（如Ruby on Rails、Restlet、Django等）来编写符合REST风格的Web 2.0应用。另外，他们还为各种流行的编程语言精挑细选了一些优秀的工具和库，并就如何解决一些棘手或易忽视的问题分享了经验与技巧。总之，这是一本理论与实践相结合、通俗易懂的好书。
本书由李红军、胡伟和我三人共同完成。李红军和胡伟分别负责11~12章和附录部分的初译工作，我负责其余章节的翻译与全书统稿工作。本书在翻译过程中整合了2008年2月11日O’Reilly官方发布的69处勘误，另外还在本书作者的帮助下确认并更正了百余处勘误。这些勘误大多是一些排版或编辑错误，虽对内容要旨的领会并无大碍，但更正过来可以减少细心读者的疑惑，以免影响阅读速度。
感谢博文视点周筠女士、编辑杨绣国女士令译者有机会翻译这本好书，感谢编辑何艳女士及众多幕后的博文视点同事们在本书后期制作过程中付出的辛勤工作。特别感谢本书作者Leonard Richardson先生就书中许多细节为译者进行了解答，并确认了一些勘误。感谢赵文峰、李红军、王栒、李勇、林勇、高宇翔、蔡世友、李胜等朋友在本书翻译过程中给予的大力支持与建议。虽译者已为翻译之精确付出了不懈努力，不当之处可能仍有存在，若有发现，欢迎读者朋友指正。译者也为本书开放了网站，提供本书的勘误及其他服务支持，网址为http://restfulwebservices.cn/。大家可以通过发送电子邮件（hanxu@w3china.org）或访问本书网站进行交流。...
徐 涵
2008年4月
Roy Fielding的博士论文为Web架构的设计与评判奠定了理论基础，不过它并未就一些实际问题给出答案。而本书的最大贡献就在于，它在现有理论基础之上，根据作者对问题的深刻见解与丰富的实践经验，为这些实际问题给出了答案，并且提出了一种具体的REST式架构——面向资源的架构（Resource-Oriented Architecture）。
《RESTful Web Services》全面深入讲解了REST及ROA的有关概念与原理。此类“概念性”书籍通常给人以抽象、不易理解的印象，不过本书是一个例外。详细、易懂、实用是本书的特点，它不但向读者讲解概念、阐明原理，而且还通过丰富的示例与案例分析（如Google、Yahoo!、Amazon、Flickr、del.icio.us等）来举例说明这些概念与原理，以确保书中内容能够被不同层次的读者所理解。..
本书作者Leonard Richardson和Sam Ruby在Web开发方面有着丰富的经验与广博的见识，本书除了阐述概念与原理，还教你如何用流行的语言和框架（如Ruby on Rails、Restlet、Django等）来编写符合REST风格的Web 2.0应用。另外，他们还为各种流行的编程语言精挑细选了一些优秀的工具和库，并就如何解决一些棘手或易忽视的问题分享了经验与技巧。总之，这是一本理论与实践相结合、通俗易懂的好书。
本书由李红军、胡伟和我三人共同完成。李红军和胡伟分别负责11~12章和附录部分的初译工作，我负责其余章节的翻译与全书统稿工作。本书在翻译过程中整合了2008年2月11日O’Reilly官方发布的69处勘误，另外还在本书作者的帮助下确认并更正了百余处勘误。这些勘误大多是一些排版或编辑错误，虽对内容要旨的领会并无大碍，但更正过来可以减少细心读者的疑惑，以免影响阅读速度。
感谢博文视点周筠女士、编辑杨绣国女士令译者有机会翻译这本好书，感谢编辑何艳女士及众多幕后的博文视点同事们在本书后期制作过程中付出的辛勤工作。特别感谢本书作者Leonard Richardson先生就书中许多细节为译者进行了解答，并确认了一些勘误。感谢赵文峰、李红军、王栒、李勇、林勇、高宇翔、蔡世友、李胜等朋友在本书翻译过程中给予的大力支持与建议。虽译者已为翻译之精确付出了不懈努力，不当之处可能仍有存在，若有发现，欢迎读者朋友指正。译者也为本书开放了网站，提供本书的勘误及其他服务支持，网址为http://restfulwebservices.cn/。大家可以通过发送电子邮件（hanxu@w3china.org）或访问本书网站进行交流。...
徐 涵
2008年4月
前言回到顶部↑
复杂的系统总是由简单的系统演变而来的。.
—John Gall
Systemantics
我们写这本书，是要告诉你一项令人瞩目的新技术。喏，它很热门，它会彻底改变我们编写分布式系统的方式。我们要讲的是万维网（World Wide Web，简称Web）。
没错，Web 不是什么新技术，也不如昔日那么火了，而且从技术角度来看，它并不是那么令人瞩目。但它的确改变了我们许多。这10 年来，Web 已经改变了我们生活的方式；不过，更多潜在的改变将等待我们。Web 是简单的、无所不在的；然而，它作为分布式编程平台的潜力却被忽视了。我们编写本书的目的，就是要让大家体验Web 的这种潜力。说Web 作为分布式编程平台的潜力被忽视了，这听上去也许令人感到诧异。毕竟，本书还要与其他Web 服务相关书籍竞争。问题是，大部分如今的“Web 服务”都与Web 毫无干系。它们采用像COM、CORBA 那样的重量级分布式对象访问架构——这与Web 的简单性背道而驰。如今的“Web 服务”架构重复或忽略了Web 赖以成功的每一种特性。其实并不需要那样。Web 背后的（underlying）技术足以支撑强大的远程服务——其实那些服务就存在着，而且我们每天都在使用它们。这种服务可以延伸到巨大的规模——其实这已经实现了。以Google 搜索引擎为例，它不就是一个对海量数据库进行查询并返回结构化搜索结果的远程服务吗？通常，我们不把网站（web site）当作“服务（service）”来看，因为网站的最终用户是人，而服务是程序之间的对话。但网站就是服务。每个Web 应用（包括每个网站）都是一个服务（service）。只要遵从Web 的理念而不是违反它，只要不把Web 特有的能力隔离在很多层抽象之下，你就能够让可编程应用（programmableapplications）利用这种能力。现在是让“Web 服务”回归“Web”理念的时候了。
《RESTful Web Services中文版》官方网站 http://restfulwebservices.cn
令网站易于被上网者使用的那些特性，同样也令Web 服务API 易于被程序员所使用。为寻找服务的设计原则，我们可以从网站的设计原则着手，并思考如果网站的使用者不是人而是程序，那最终将得到什么样的设计原则。
本书就是这么做的。我们的中心目标，就是展示Web 基础技术（HTTP 应用协议、URL命名标准、XML 标记语言）的强大能力、适用场合及局限等。本书主要讲的是Web 背后的（underlying）一套设计原则——表示性状态转移（Representational State Transfer），或简称为REST。我们率先为“REST 式（RESTful）”Web 服务提出了最佳实践（best practices）。我们不会采用含糊或臆断性的语言，相反，将用具体的建议来取代那些坊间传言（folklore）和隐性知识。
我们引入了面向资源的架构（Resource-Oriented Architecture，ROA）作为用于设计REST式Web 服务（RESTful web services）的一组切合实际的原则。我们还会教你如何编写客户端程序来调用REST 式服务。我们将采用一些真实的REST 式服务作为案例，比如：Amazon S3（Simple Storage Service）、各种Atom 发布协议的变形，以及Google Maps 等。我们也会举一些流行的但不符合REST 原则的例子（比如 del.icio.us 的社会性书签API），然后对它们进行重构。
简单的Web
The Web Is Simple
为何我们对Web 如此着迷，以至于认为它能解决所有问题？也许我们上当了，成为炒作的受害者。尽管HTTP 并不是最受欢迎的Internet 协议，但Web 无疑是被炒作得最凶的一种Internet 技术。据统计，全球Internet 流量中的大部分源自电子邮件（归因于垃圾邮件）或BitTorrent（归因于侵犯版权）。假如明天Internet 就不复存在，那么人们最为怀念的将是电子邮件。那为何要如此重视Web 呢？是什么使得HTTP——一种为物理实验室之间传递研究记录而设计的协议——同时能够适合分布式Internet 应用呢？
实际上，说HTTP 是为某某目的而设计的，对它是一种极大的恭维。已经有人说了，HTTP与HTML 是“Internet 协议里的放屁坐垫（Whoopee Cushion）与欢乐蜂鸣器（Joy Buzzer），只能搞些小把戏”（译注1）——这还是一个喜爱它们的人说的。（注1）第一版HTTP（即HTTP 0.9）的确看上去像是搞小把戏，比如下面这个客户端与服务器交互的例子：客户端请求 服务器响应
GET /hello.txt Hello, world!
译注1：屁坐垫和欢乐蜂鸣器都是廉价的整人玩具。放屁坐垫（Whoopee Cushion）是一种充气坐垫，当人坐上去后会发出放屁似的声音。欢乐蜂鸣器（Joy Buzzer）是一种装置，当佩戴此装置的人与人握手时，它会发出剧烈振动和蜂鸣声。这个比喻的言下之意是说，HTTP 与HTML 是不起眼的，只能搞些小把戏，做不了正经事。
注1：Clay Shirky，《In Praise of Evolvable Systems》（http://www.shirky.com/writings/evolve.html）。《RESTful Web Services中文版》官方网站 http://restfulwebservices.cn
就这么简单。你连接到服务器，把文档路径给它，然后服务器就把文档内容返回给你。
HTTP 0.9 差不多就只支持这么些了，看似只是毫无特色地照搬比它复杂一点的文件传输协议（FTP）。
令人意外的是，答案基本就是这样。我们可以半开玩笑地讲，HTTP 是特别适合分布式Internet 应用的，因为它没有值得一提的特性。你讲要什么，它就给什么。跟功夫片里的手法同出一辙，（注2）HTTP 的缺点转化成了优势，它的简单性转化成了强大能力。
HTTP 0.9 是特地设计成那么简单的。从HTTP 0.9 中我们可以看到可寻址性（addressability）和无状态性（statelessness）——正是这两条基本设计原则，令HTTP 较其同类更加优秀，并得以延伸到今天如此巨大的规模。在HTTP 0.9 所缺少的特性中，大部分已被证实是多余的，甚至是有副作用的（其实，添加那些特性将有损于Web），而其余的许多特性已在HTTP 1.0 和1.1 版中实现了。Web 赖以成功的另两项重要技术是URL 和HTML（以及后来的XML）——它们在许多重要方面也是简单的。
—John Gall
Systemantics
我们写这本书，是要告诉你一项令人瞩目的新技术。喏，它很热门，它会彻底改变我们编写分布式系统的方式。我们要讲的是万维网（World Wide Web，简称Web）。
没错，Web 不是什么新技术，也不如昔日那么火了，而且从技术角度来看，它并不是那么令人瞩目。但它的确改变了我们许多。这10 年来，Web 已经改变了我们生活的方式；不过，更多潜在的改变将等待我们。Web 是简单的、无所不在的；然而，它作为分布式编程平台的潜力却被忽视了。我们编写本书的目的，就是要让大家体验Web 的这种潜力。说Web 作为分布式编程平台的潜力被忽视了，这听上去也许令人感到诧异。毕竟，本书还要与其他Web 服务相关书籍竞争。问题是，大部分如今的“Web 服务”都与Web 毫无干系。它们采用像COM、CORBA 那样的重量级分布式对象访问架构——这与Web 的简单性背道而驰。如今的“Web 服务”架构重复或忽略了Web 赖以成功的每一种特性。其实并不需要那样。Web 背后的（underlying）技术足以支撑强大的远程服务——其实那些服务就存在着，而且我们每天都在使用它们。这种服务可以延伸到巨大的规模——其实这已经实现了。以Google 搜索引擎为例，它不就是一个对海量数据库进行查询并返回结构化搜索结果的远程服务吗？通常，我们不把网站（web site）当作“服务（service）”来看，因为网站的最终用户是人，而服务是程序之间的对话。但网站就是服务。每个Web 应用（包括每个网站）都是一个服务（service）。只要遵从Web 的理念而不是违反它，只要不把Web 特有的能力隔离在很多层抽象之下，你就能够让可编程应用（programmableapplications）利用这种能力。现在是让“Web 服务”回归“Web”理念的时候了。
《RESTful Web Services中文版》官方网站 http://restfulwebservices.cn
令网站易于被上网者使用的那些特性，同样也令Web 服务API 易于被程序员所使用。为寻找服务的设计原则，我们可以从网站的设计原则着手，并思考如果网站的使用者不是人而是程序，那最终将得到什么样的设计原则。
本书就是这么做的。我们的中心目标，就是展示Web 基础技术（HTTP 应用协议、URL命名标准、XML 标记语言）的强大能力、适用场合及局限等。本书主要讲的是Web 背后的（underlying）一套设计原则——表示性状态转移（Representational State Transfer），或简称为REST。我们率先为“REST 式（RESTful）”Web 服务提出了最佳实践（best practices）。我们不会采用含糊或臆断性的语言，相反，将用具体的建议来取代那些坊间传言（folklore）和隐性知识。
我们引入了面向资源的架构（Resource-Oriented Architecture，ROA）作为用于设计REST式Web 服务（RESTful web services）的一组切合实际的原则。我们还会教你如何编写客户端程序来调用REST 式服务。我们将采用一些真实的REST 式服务作为案例，比如：Amazon S3（Simple Storage Service）、各种Atom 发布协议的变形，以及Google Maps 等。我们也会举一些流行的但不符合REST 原则的例子（比如 del.icio.us 的社会性书签API），然后对它们进行重构。
简单的Web
The Web Is Simple
为何我们对Web 如此着迷，以至于认为它能解决所有问题？也许我们上当了，成为炒作的受害者。尽管HTTP 并不是最受欢迎的Internet 协议，但Web 无疑是被炒作得最凶的一种Internet 技术。据统计，全球Internet 流量中的大部分源自电子邮件（归因于垃圾邮件）或BitTorrent（归因于侵犯版权）。假如明天Internet 就不复存在，那么人们最为怀念的将是电子邮件。那为何要如此重视Web 呢？是什么使得HTTP——一种为物理实验室之间传递研究记录而设计的协议——同时能够适合分布式Internet 应用呢？
实际上，说HTTP 是为某某目的而设计的，对它是一种极大的恭维。已经有人说了，HTTP与HTML 是“Internet 协议里的放屁坐垫（Whoopee Cushion）与欢乐蜂鸣器（Joy Buzzer），只能搞些小把戏”（译注1）——这还是一个喜爱它们的人说的。（注1）第一版HTTP（即HTTP 0.9）的确看上去像是搞小把戏，比如下面这个客户端与服务器交互的例子：客户端请求 服务器响应
GET /hello.txt Hello, world!
译注1：屁坐垫和欢乐蜂鸣器都是廉价的整人玩具。放屁坐垫（Whoopee Cushion）是一种充气坐垫，当人坐上去后会发出放屁似的声音。欢乐蜂鸣器（Joy Buzzer）是一种装置，当佩戴此装置的人与人握手时，它会发出剧烈振动和蜂鸣声。这个比喻的言下之意是说，HTTP 与HTML 是不起眼的，只能搞些小把戏，做不了正经事。
注1：Clay Shirky，《In Praise of Evolvable Systems》（http://www.shirky.com/writings/evolve.html）。《RESTful Web Services中文版》官方网站 http://restfulwebservices.cn
就这么简单。你连接到服务器，把文档路径给它，然后服务器就把文档内容返回给你。
HTTP 0.9 差不多就只支持这么些了，看似只是毫无特色地照搬比它复杂一点的文件传输协议（FTP）。
令人意外的是，答案基本就是这样。我们可以半开玩笑地讲，HTTP 是特别适合分布式Internet 应用的，因为它没有值得一提的特性。你讲要什么，它就给什么。跟功夫片里的手法同出一辙，（注2）HTTP 的缺点转化成了优势，它的简单性转化成了强大能力。
HTTP 0.9 是特地设计成那么简单的。从HTTP 0.9 中我们可以看到可寻址性（addressability）和无状态性（statelessness）——正是这两条基本设计原则，令HTTP 较其同类更加优秀，并得以延伸到今天如此巨大的规模。在HTTP 0.9 所缺少的特性中，大部分已被证实是多余的，甚至是有副作用的（其实，添加那些特性将有损于Web），而其余的许多特性已在HTTP 1.0 和1.1 版中实现了。Web 赖以成功的另两项重要技术是URL 和HTML（以及后来的XML）——它们在许多重要方面也是简单的。
序言回到顶部↑
自从架构师们发现了另一个可以搞复杂了再卖给大公司的点子以来，Web 服务领域就处在一条快速成为超级新秀的道路上。不过谢天谢地，还没有完全迷失方向。对HTTP 的再度重视正在兴起，而且在REST 的旗号下，HTTP 显示出了取代那些大公司试图强加在人们头上的技术的相当实力；REST 是一套简单的原则，开发者们可以根据这些原则按贴近Web 的方式来把应用连接起来。..
《RESTful Web Services》将教你如何使用这些原则。它的讲解是实实在在的，无夸大之辞，也没有绕弯子——那种做法，已经害得一批Web 开发者认为Web 服务难得只有依靠大公司来做了。每位从事Web 开发的人员都应该读读这本书。.
—David Heinemeier Hansson
《RESTful Web Services》将教你如何使用这些原则。它的讲解是实实在在的，无夸大之辞，也没有绕弯子——那种做法，已经害得一批Web 开发者认为Web 服务难得只有依靠大公司来做了。每位从事Web 开发的人员都应该读读这本书。.
—David Heinemeier Hansson
书摘回到顶部↑
第1章：Programmable Web及其分类
在编写计算机程序时，并非只能使用自己设计的算法，你还可以使用编程语言标准库里的算法；另外，也可以从相关图书或第三方库里找到更多的算法。除非在做非常前沿的东西，否则一般不必自己设计算法。
运气好的话，数据也能找到现成的。某些应用是完全由用户所提供数据驱动的。有时，获得数据是轻而易举的。
……
在编写计算机程序时，并非只能使用自己设计的算法，你还可以使用编程语言标准库里的算法；另外，也可以从相关图书或第三方库里找到更多的算法。除非在做非常前沿的东西，否则一般不必自己设计算法。
运气好的话，数据也能找到现成的。某些应用是完全由用户所提供数据驱动的。有时，获得数据是轻而易举的。
……
)
加载中...
