RESTful API开发实战 　　《RESTful API开发实战 使用REST JSON XML和JAX-RS构建微服务 大数据和Web服务应用》讲述如何使用RESTful技术(包括REST、JSON、XML、JAX-RS Web服务和SOAP等)来构建当今的微服务、大数据应用以及Web服务应用。作者Sanjay Patni曾在加州大学圣克鲁兹分校讲授架构、*设计实践和编码实验课程，本书就是在此基础上撰写的。 　　本书自上而下呈现所有基础知识：从顶部的架构到中间的设计，再到底部的编码。本书是任何微服务(或Web服务)开发人员构建应用程序和服务的必 备参考书籍。 主要内容： ● 介绍主要的RESTful API，包括REST、JSON、XML、JAX-RS和SOAP等。 ● 将RESTful技术用于Web服务和数据交换开发中，尤其用于当今的大数据环境。 ● 在示例和案例研究的引导下学习使用XML、JSON、REST和JAX-RS。

对于Web 系统的交换来说，你将学习HTTP 协议，包括如何使用XML。《RESTful API开发实战 使用REST JSON XML和JAX-RS构建微服务 大数据和Web服务应用》还比较了SOAP 和REST，介绍无状态转移的概念。同时介绍软件API 设计和*实践等。后半部分将重点讨论遵循JAX-RS 标准的RESTful API 的设计和实现，以及通过Java API 构建RESTful Web 服务。你将学习如何使用JSON 和XML 构建和使用JAX-RS 服务，并通过实际案例使用RESTful API 将众多不同的数据源集成在一起(包括关系型数据库和NoSQL 数据库等)。你将应用这些*实践完成一个小型软件系统API 的设计与实现，并以RESTful API 的方式公开可用的API 服务。

前 言

众所周知，数据库、网站以及业务应用之间都需要数据交换。这通过定义标准的数据格式、传输协议或Web服务来实现，常见的数据格式有XML(Extensible Markup Language，可扩展标记语言)、JSON(JavaScript Object Notation，JavaScript对象表示法)等，常见的传输协议或Web服务包括SOAP(Simple Object Access Protocol，简单对象访问协议)，以及目前更受欢迎的REST(Representational State Transfer，表述性状态传递)等。开发人员通常需要设计自身应用的API接口，使得应用能集成特定的业务逻辑并运行在操作系统或服务器上。《RESTful API开发实战 使用REST JSON XML和JAX-RS构建微服务 大数据和Web服务应用》涵盖以上数据交换概念和通用的数据格式，并重点阐述如何构建REST风格的API。

对于Web系统的交换来说，你将学习HTTP协议，包括如何使用XML。另外《RESTful API开发实战 使用REST JSON XML和JAX-RS构建微服务 大数据和Web服务应用》还比较了SOAP和REST，介绍无状态转移的概念。同时介绍软件API设计和最佳实践等。《RESTful API开发实战 使用REST JSON XML和JAX-RS构建微服务 大数据和Web服务应用》后半部分将重点讨论遵循JAX-RS标准的RESTful API的设计和实现，以及通过Java API构建RESTful Web服务。你将学习如何使用JSON和XML构建和使用JAX-RS服务，并通过实际案例使用RESTful API将众多不同的数据源集成在一起(包括关系型数据库和NoSQL数据库等)。你将应用这些最佳实践完成一个小型软件系统API的设计与实现，并以RESTful API的方式公开可用的API服务。

《RESTful API开发实战 使用REST JSON XML和JAX-RS构建微服务 大数据和Web服务应用》适用于那些在实际项目中使用数据交换的软件开发人员，对那些希望了解数据交换方法以及如何与业务应用交互的数据专家同样有所帮助。书中的案例练习要求读者具有Java编程经验。

《RESTful API开发实战 使用REST JSON XML和JAX-RS构建微服务 大数据和Web服务应用》的主题包括：

数据交换和Web服务

SOAP与REST，有状态与无状态

XML与JSON

API设计简介：REST和JAX-RS

API设计实践

设计RESTful API

构建RESTful API

与RDBMS(MySQL)进行交互

使用RESTful API(比如JSON、XML)

API安全性-OAuth

API缓存

源代码下载

读者可访问www.apress.com/9781484226643下载源代码，也可扫描《RESTful API开发实战 使用REST JSON XML和JAX-RS构建微服务 大数据和Web服务应用》封底的二维码直接下载。

Sanjay Patni是一位注重实际成果的技术专家，在创新技术方案与业务实际需求的协调上具有丰富的经验，长期致力于企业业务流程的优化和运营效率的提升。在过去五年中，他一直在Oracle公司的Fusion Apps产品研发团队任职，在那里他发现了对Fusion Apps代码管理实现自动化的机会，其中不仅涉及GA版本的交付发行，还包括正在进行的演示、开发和测试代码。他提出并开发了自助服务UX用于代码请求和审核，减少了80%的手工步骤。他还发起了12次代码快速迭代，通过使用工作流和RESTful API等自动化技术与其他子系统进行集成，使得大约100多个手工步骤实现了自动化。在加盟Oracle前，他已经在软件行业工作了15年以上，为不同的行业提供关键技术解决方案。他的职责包括对基于Web的企业级产品和解决方案提供技术创新、需求理解和分析，技术架构设计，以及推进软件敏捷开发等。他率先创新使用Java来构建业务应用，不断推动和完善用于企业级业务应用构建的Java API，并获得Sun Microsystems公司颁发的奖项。Sanjay曾担任RESTful API设计和集成培训或课程的客座讲师、技术导师。他拥有强大的计算机科学教育背景，硕士毕业于印度理工学院(IIT)。

目 录

第1章　RESTful API的基本原理 1

1.1 SOAP和REST的比较 3

1.2　Web架构风格 4

1.2.1　CS模式 5

1.2.2　统一资源接口 5

1.2.3　分层系统 5

1.2.4　缓存机制 6

1.2.5　无状态 6

1.2.6　按需编码 6

1.2.7　HATEOAS 6

1.3　安全性 7

1.4　什么是REST？ 8

1.4.1　REST基础知识 8

1.4.2　REST基本原理 9

1.5　小结 10

第2章　API设计和建模 11

2.1　API设计策略 11

2.2　API创建流程和方法论 13

2.2.1　流程 13

2.2.2　API方法论 14

2.2.3　域分析或API描述 14

2.2.4　架构设计 15

2.2.5　原型设计 16

2.2.6　实现 16

2.2.7　发布 16

2.2.8　API建模 16

2.2.9　API建模的比较 18

2.3　最佳实践 19

2.3.1　保持基础URL简明直观 19

2.3.2　错误处理 20

2.3.3　版本控制 22

2.3.4　局部响应 23

2.3.5　分页 23

2.3.6　多格式 24

2.3.7　API Façade 24

2.4　API解决方案架构 24

2.4.1　移动解决方案 25

2.4.2　云端解决方案 25

2.4.3　Web端解决方案 26

2.4.4　集成解决方案 26

2.4.5　多终端解决方案 26

2.4.6　智能电视解决方案 26

2.4.7　物联网 26

2.5　API解决方案中的利益相关者 26

2.5.1　API提供者 27

2.5.2　API消费者 27

2.5.3　最终用户 27

2.6　小结 33

第3章　XML与JSON介绍 35

3.1　XML简介 35

3.1.1　XML注释 36

3.1.2　XML的重要性 37

3.1.3　如何使用XML 38

3.1.4　XML的优缺点 38

3.2　JSON简介 38

3.2.1　JSON语法 39

3.2.2　JSON的重要性 40

3.2.3　如何使用JSON 41

3.2.4　JSON的优缺点 42

3.3　XML和JSON的比较 42

第4章　JAX-RS介绍 51

4.1　JAX-RS简介 51

4.1.1　输入和输出内容类型 52

4.1.2　JAX-RS注入 53

4.2　REST实现 55

第5章　API组合和框架 65

5.1　API组合架构 65

5.1.1　需求 65

5.1.2　一致性 65

5.1.3　可重用 66

5.1.4　可定制 66

5.1.5　可发现 66

5.1.6　持久性 66

5.2　如何实施这些需求治理？ 67

5.2.1　一致性 67

5.2.2　可重用 67

5.2.3　可定制 67

5.2.4　可发现 68

5.2.5　变更管理 68

5.3　API框架 68

5.3.1　流程API服务层 69

5.3.2　系统API-数据访问对象 69

5.3.3　体验API-API外观 70

5.3.4　服务层实现 70

第6章　API平台和数据处理器 81

6.1　API平台架构 81

6.1.1　我们为什么需要API平台 81

6.1.2　什么是API平台 82

6.1.3　API平台需要具备的功能 82

6.1.4　API平台是如何组织的，什么是API平台的架构 84

6.1.5　API架构如何适应围绕企业的技术架构 85

6.2　数据处理器 86

6.2.1　数据访问对象(DAO) 86

6.2.2　命令查询职责分离(CQRS) 86

6.3　小结 101

第7章　API管理和API客户端 103

7.1　外观 103

7.1.1　外观模式 103

7.1.2　API外观 104

7.2　API管理 105

7.2.1　API生命周期 106

7.2.2　API下线 107

7.2.3　API盈利 108

第8章　API安全性与缓存机制 115

8.1　API安全性-OAuth 2 115

8.1.1　角色 116

8.1.2　令牌 116

8.1.3　注册成客户端 117

8.1.4　授权授予类型 118

8.1.5　隐式授予流程 119

8.1.6　资源拥有者密码凭据授予 121

8.1.7　客户端凭据授予 122

8.2　缓存机制 123

8.2.1　服务器缓存机制 124

8.2.2　HTTP缓存机制 124

8.2.3　Web缓存机制 126

8.3　小结 129