ASP.NET Web API设计PDF电子书下载

第一部分 基础知识 3

第1章 因特网、万维网和HTTP协议 3

1.1 Web体系结构 4

1.1.1资源 5

1.1.2 URI 5

1.1.3酷URI 6

1.1.4表示 6

1.1.5媒体类型 7

1.2 HTTP协议 8

1.2.1 HTTP 1.1之后 9

1.2.2 HTTP消息交换 9

1.2.3中间层 10

1.2.4中间层类型 11

1.2.5 HTTP方法 12

1.2.6标头 15

1.2.7 HTTP状态码 16

1.2.8内容协商 16

1.2.9缓存 16

1.2 10身份验证 19

1.2.11身份验证方案 20

1.2.12附加身份验证方案 20

1.3小结 21

第2章 Web API 22

2.1什么是Web API 22

2.2 SOAP Web服务 22

2.3 Web API的起源 23

2.4 Web API革命开始 23

2.5关注Web 23

2.6 Web API指南 24

2.7特定领域的媒体类型 24

2.8媒体类型档案 25

2.9多个表示 26

2.10 API风格 27

2.10.1 Richardson成熟度模型 28

2.10.2 RPC（RMM第0级） 28

2.10.3资源（RMM第1级） 30

2.10.4 HTTP谓词（RMM第2级） 32

2.10.5以资源为中心的API 34

2.10.6超媒体（RMM第3级） 35

2.10.7 REST 39

2.10.8 REST约束 39

2.11小结 41

第3章 ASP.NETWeb API 101 42

3.1核心场景 42

3.1.1第一类HTTP编程 43

3.1.2对称的客户端和服务器编程体验 44

3.1.3对不同格式的灵活支持 45

3.1.4告别“尖括号编码” 45

3.1.5支持单元测试 45

3.1.6多种托管选项 46

3.2 ASP.NET Web API入门 46

3.3新建Web API项目 50

3.3.1 WebApiConfig 50

3.3.2 ValuesController 52

3.4 “Hello Web API！” 53

3.4.1创建服务 53

3.4.2客户端 60

3.4.3宿主 60

3.5小结 61

第4章 处理架构 62

4.1托管层 64

4.2消息处理程序管道 65

4.3控制器处理 69

4.4小结 75

第二部分 真实世界的API开发 79

第5章 应用程序 79

5.1为什么要可演化 80

5.1.1演化的障碍 81

5.1.2代价是什么 81

5.1.3为什么不创建新版本 83

5.1.4付诸实践 86

5.2应用程序目标 86

5.2.1目标 86

5.2.2机会 87

5.3信息模型 87

5.3.1子域 88

5.3.2相关资源 88

5.3.3属性组 89

5.3.4属性组的集合 90

5.3.5信息模型与媒体类型 90

5.3.6问题集合 91

5.4资源模型 92

5.4.1根资源 92

5.4.2搜索资源 92

5.4.3集合资源 92

5.4.4个体资源 93

5.5小结 95

第6章 媒体类型选择与设计 96

6.1自描述 96

6.2协议类型 97

6.3媒体类型 97

6.3.1原始格式 97

6.3.2流行格式 99

6.3.3新格式 100

6.3.4超媒体类型 102

6.3.5媒体类型爆炸 102

6.3.6通用媒体类型和档案 102

6.3.7其他超媒体类型 106

6.4链接关系类型 107

6.4.1语义 107

6.4.2替换嵌入资源 109

6.4.3间接层 109

6.4.4引用数据 110

6.4.5工作流 111

6.4.6语法 112

6.4.7完美结合 114

6.5设计新的媒体类型协议 114

6.5.1选择格式 115

6.5.2支持超媒体 116

6.5.3可选、强制、省略和适用 116

6.5.4嵌入元数据和外部元数据 117

6.5.5可扩展性 117

6.5.6注册媒体类型 119

6.6设计新的链接关系 119

6.6.1标准链接关系 119

6.6.2扩展链接关系 120

6.6.3嵌入链接关系 121

6.6.4注册链接关系 121

6.7问题跟踪域中的媒体类型 121

6.7.1 list资源 122

6.7.2 item资源 123

6.7.3 discovery资源 124

6.7.4 search资源 125

6.8小结 125

第7章 构建API 126

7.1设计 126

7.2获得源代码 127

7.3使用行为驱动开发构建实现 127

7.4浏览解决方案 127

7.5软件包和程序库 128

7.6自托管 128

7.7模型和服务 130

7.7.1问题和问题库 130

7.7.2IssueState 130

7.7.3IssuesState 131

7.7.4 Link 133

7.7.5 LinkeStateFactory 133

7.7.6 LinkFactory 134

7.7.7IssueLinkFactory 135

7.8验收标准 136

7.9功能：获取问题 139

7.9.1获取一个问题 142

7.9.2获取未关闭的和已关闭的问题 144

7.9.3获取不存在的问题 146

7.9.4获取所有问题 147

7.9.5获取所有问题的Collection+Json表示 150

7.9.6搜索问题 152

7.10功能：创建问题 153

7.11功能：更新问题 156

7.11.1更新一个问题 156

7.11.2更新不存在的问题 158

7.12功能：删除问题 159

7.12.1删除一个问题 159

7.12.2删除不存在的问题 160

7.13功能：处理问题 161

7.13.1测试 161

7.13.2实现 161

7.14小结 163

第8章 改进API 164

8.1新功能的验收标准 164

8.2实现输出缓存支持 166

8.3添加输出缓存测试 167

8.4实现缓存重验证 169

8.5为缓存重验证实现条件GET 170

8.6冲突检测 173

8.7实现冲突检测 174

8.8变更审计 176

8.9使用Hawk认证实现变更审计 177

8.10跟踪 181

8.11实现跟踪 182

8.12小结 184

第9章 构建客户端 185

9.1客户端程序库 186

9.1.1封装库 186

9.1.2链接用作函数 189

9.2应用程序工作流 194

9.2.1用户需知 195

9.2.2带有使命的客户端 198

9.2.3客户端状态 201

9.3小结 201

第三部分 Web API细节 205

第10章 HTTP编程模型 205

10.1消息 206

10.2标头 210

10.3消息内容 215

10.3.1使用消息内容 216

10.3.2创建消息内容 218

10.4小结 226

第11章 托管 227

11.1 Web托管 228

11.1.1 ASP. NET基础结构 228

11.1.2 ASP.NET路由 230

11.1.3 Web API路由 232

11.1.4全局配置 234

11.1.5 Web API ASP.NET处理程序 235

11.2自托管 238

11.2.1 WCF架构 238

11.2.2 HttpSelfHostServer类 240

11.2.3 HttpSelfHostConfiguration类 241

11.2.4 URL预留和访问控制 242

11.3用OWIN和Katana托管Web API 243

11.3.1 OWIN 244

11.3.2 Katana项目 245

11.3.3 Web API配置 247

11.3.4 Web API中间件 248

11.3.5 OWIN生态环境 250

11.4内存托管 250

11.5 Azure Service Bus Host 252

11.6小结 256

第12章 控制器和路由 257

12.1 HTTP消息流概览 257

12.2消息处理程序管道 258

12.2.1分发程序 262

12.2.2 HttpControllerDispatcher 263

12.2.3控制器选择 263

12.2.4控制器激活 266

12.3控制器管道 267

12.3.1 ApiController 267

12.3.2 ApiController处理模型 268

12.4小结 279

第13章 格式化程序和模型绑定 280

13.1 ASP.NET Web API中模型的重要性 280

13.2模型绑定如何工作 281

13.3内建的模型绑定器 284

13.3.1 ModelBindingParameterBinder 284

13.3.2值提供程序 285

13.3.3模型绑定器 288

13.3.4只对URI进行模型绑定 290

13.3.5 FormatterParameterBinder实现 291

13.3.6 HttpParameterBinding的默认选择 296

13.4模型验证 296

13.4.1将数据标记属性用于模型 296

13.4.2查询验证结果 297

13.5小结 299

第14章 Http Client 300

14.1 HttpClient类 300

14.1.1生存周期 301

14.1.2封装类 301

14.1.3多个实例 302

14.1.4线程安全 302

14.1.5辅助方法 302

14.1.6抽丝剥茧 303

14.1.7完成的请求无异常 303

14.1.8 内容为王 303

14.1.9取消请求 304

14.1.10 SendAsync 305

14.2客户端消息处理程序 306

14.2.1代理处理程序 308

14.2.2伪响应处理程序 309

14.2.3创建可以重用的响应处理程序 310

14.3小结 311

第15章 安全 312

15.1传输安全 312

15.2在ASP.NET Web API中使用TLS 314

15.2.1 IIS托管时使用TLS 314

15.2.2自托管时使用TLS 316

15.3身份验证 316

15.3.1声明模型 317

15.3.2获取和设置当前用户对象 321

15.3.3基于传输的身份验证 321

15.3.4服务器身份验证 322

15.3.5客户端身份验证 325

15.3.6 HTTP身份验证框架 331

15.3.7实现基于HTTP的身份验证 333

15.3.8 Katana身份验证中间件 334

15.3.9主动和被动的身份验证中间件 338

15.3.10 Web API身份验证筛选器 339

15.3.11基于令牌的身份验证 342

15.3.12 Hawk身份验证方案 348

15.4授权 350

15.4.1授权执行 351

15.4.2跨域资源共享 354

15.4.3 ASP.NET Web API的CORS支持 357

15.5小结 359

第16章 OAuth 2.0授权框架 360

16.1客户端应用程序 362

16.2访问受保护资源 364

16.3获得访问令牌 365

16.4授权码授予 367

16.5范围 369

16.6前通道与后通道 370

16.7刷新令牌 371

16.8资源服务器和授权服务器 372

16.9在ASP.NET Web API中处理访问令牌 373

16.10 OAuth 2.0与身份验证 375

16.11基于范围的授权 378

16.12小结 379

第17章 可测试性 380

17.1单元测试 380

17.1.1使用测试框架 381

17.1.2 Visual Studio单元测试入门 381

17.1.3 xUnit.NET 383

17.1.4单元测试在测试驱动开发中的作用 384

17.2对ASP.NET Web API实现进行单元测试 387

17.2.1测试ApiController 387

17.2.2测试MediaTypeFormmater 393

17.2.3单元测试Http MessageHandler 396

17.2.4 测试ActionFilterAttribute 397

17.3对路由进行单元测试 401

17.4 ASP.NET Web API的集成测试 402

17.5小结 404

附录A媒体类型 405

附录B HTTP标头 406

附录C内容协商 409

附录D缓存实战 413

附录E身份验证工作流 417

附录F application/issue+j son媒体类型规范 420

附录G公钥加密和证书 422