PDF《RESTful API 开发实战》

Web 开发经典丛书 RESTful API 开发实战 使用 REST JSON XML 和JAX-RS 构建微服务 大数据和 Web 服务应用 [美] Sanjay Patni 著 郭理勇 译北京Sanjay Patni Pro RESTful APIs: Design, Build and Integrate with REST, JSON, XML and JAX-RS, First Edition EISBN:978-1-4842-2664-3 Original English language edition published by Apress Media.

Copyright ?

2017 by Apress Media. Simplified Chinese-Language edition copyright ?

2018 by Tsinghua University Press. All rights reserved. 本书中文简体字版由 Apress 出版公司授权清华大学出版社出版.未经出版者书面许可, 不得以任何方式复制或抄袭本书内容. 北京市版权局著作权合同登记号 图字:01-2017-5755-2 011-7430 本书封面贴有清华大学出版社防伪标签,无标签者不得销售. 版权所有,侵权必究.侵权举报

电话:010-62782989

13701121933 图书在版编目(CIP)数据 RESTful API 开发实战 使用 REST JSON XML 和JAX-RS 构建微服务 大数据和 Web 服务应用/ (美) 桑杰・帕特尼(Sanjay Patni) 著;

郭理勇译. ―北京:清华大学出版社,2018 (Web 开发经典丛书) 书名原文:Pro RESTful APIs: Design, Build and Integrate with REST, JSON, XML and JAX-RS, First Edition ISBN 978-7-302-49211-5 Ⅰ. ①R… Ⅱ. ①桑… ②郭… Ⅲ. ①互联网络-网络服务器-程序设计 Ⅳ. ①TP368.5 中国版本图书馆 CIP 数据核字(2017)第331724 号 责任编辑:王军韩宏志 封面设计:牛艳敏 版式设计:思创景点 责任校对:曹阳责任印制:杨艳出版发行:清华大学出版社

网址:http://www.tup.com.cn,http://www.wqbook.com 地址:北京清华大学学研大厦 A 座邮编:100084 社总机:010-62770175 邮购:010-62786544 投稿与读者服务:010-62776969,c-service@tup.tsinghua.edu.cn 质量反馈:010-62772015,zhiliang@tup.tsinghua.edu.cn 印装者:三河市金元印装有限公司 经销:全国新华书店 开本:148mm*210mm 印张:4.625 字数:125 千字 版次:2018 年2月第

1 版印次:2018 年2月第

1 次印刷 印数:1~3200 定价:48.00 元――――――――――――――――――――――――――――――――――――――――――――――――产品编号:076424-01 译者序 每个互联网从业人员都有这样一种感觉:RESTful API 概念既熟悉 又陌生.熟悉的是我们能在大量开放平台或开源项目中看到它的身影, 如常见的 OpenStack、Kubernetes API 等,众多企业基于开放的 RESTful API 实现了业务扩展和资产获利;

而陌生的是我们似乎很难找到 RESTful API 的准确定义,也不了解如何真正在实际项目中使用它.如REST 和SOAP 协议到底有何区别?RESTful API 和HTTP 协议到底存在什么关 系?REST 的安全性如何保证?令人欣慰的是,拜读 Sanjay Patni 先生 这本著作后,这些问题都将迎刃而解. REST 一词是由Roy Fielding 博士于2000 年在他的博士论文Architectural Styles and the Design of Network-based Software Architecture 中提出的, 实 际指一种有助于创建和组织分布式系统的架构风格. 它并不是一个标准 或准则,而是一种基于资源的架构风格.基于 REST 风格构建的 API 应 该满足 CS 模式交互、统一的资源接口、透明的分层系统以及支持无状 态和缓存等条件约束,另外需要保证 API 的安全性等.以REST 风格构 建的系统将在性能、可扩展性、可移植性、可靠性等多个方面得到提升 和优化. 本书作者 Sanjay Patni 拥有

15 年以上的企业级软件开发经验, 尤其 在构建 RESTful API 方面有深厚的理论研究和技术实践背景.本书主要 RESTful API 开发实战 II 从RESTful API 的架构、设计和编码三个方面进行深入介绍.首先阐述 REST 的基本原理和准确定义,并对 REST 与SAOP 协议的差异,以及 XML/JSON 等数据交换格式等进行全方位比较. 其次在 API 设计和建模 方面讨论 API 的完整生命周期和 RESTful API 设计的最佳实践,着重介 绍API 组合和框架如何实现 API 的一致性和可重用性,以及 API 平台 管理、API 安全性和缓存机制等.另外通过一个实际案例(播客 podcast) 演示如何通过 RAML 建模工具实现 API 接口的完整定义,并基于 JAX-RS 规范实际编写了一个 REST 应用,包括 API 的外观层、数据访 问层以及服务层的实现等, 为我们提供了可应用于企业实际场景的标准 应用示范,使得 RESTful API 不再是虚无的概念描述,而是可真正用于 企业实践的架构风格实现. 书中很多内容都给译者留下了深刻印象,首先在构建 RESTful API 的基础 URL 时, 我们需要从原有的 动词+名词 的设计向 名词+HTTP 动词 的观念转变,使得基础 URL 简单而又直观.其次在 API 组合的 管理中,我们需要解决稳定高效的 API 服务提供与企业创新(和实验) 之间的矛盾,因此我们需要通盘考虑 API 的一致性、可重用、版本和 变更管理等. 此外, 企业级应用需要关注 JavaScript 跨域访问解决方案、 OAuth