iOS开发笔记之九十七——关于Restful API的一些总结

*****阅读完此文，大概需要3分钟******

一、什么是 Restful API？

Restful（Representational State Transfer表现层状态转换）是目前最流行的接口设计规范。Restful API 是一种设计风格（是设计风格而不是标准），用于创建可靠、可扩展和易于维护的 Web 服务。它遵循 REST（Representational State Transfer）架构风格，以资源为中心，通过 HTTP 协议进行通信。

Restful API 基于客户端和服务器之间的请求和响应模型，客户端通过请求方法（GET、POST、PUT、DELETE 等）向服务器请求资源，服务器根据请求方法和请求的资源路径进行响应，返回相应的资源或状态码。Restful API 的请求和响应数据格式通常为 JSON 或 XML。

二、Restful API的特点

它有以下几个特点：

基于HTTP协议：RESTful API使用HTTP协议作为通信协议，客户端通过HTTP协议向服务器发送请求，并且服务器通过HTTP协议向客户端发送响应。

无状态性：RESTful API是无状态的，每个请求都包含足够的信息，使得服务器不需要保存关于客户端的任何状态信息。

资源导向：RESTful API是一种资源导向的API，它将所有的操作都视为对资源的操作。每个资源都有一个唯一的标识符（URI），客户端可以通过URI来请求资源的表示。

统一接口：RESTful API使用一组标准的HTTP方法（GET、POST、PUT、DELETE等）来操作资源，客户端通过这些方法来执行对资源的操作。

可缓存性：RESTful API支持缓存机制，客户端可以缓存响应以提高性能，并且服务器可以使用缓存来减轻负载。

分层系统：RESTful API支持分层系统，它允许服务器将负载分布到多个层次结构中，并且允许客户端通过访问不同的层次结构来访问资源。

Restful API常见的状态码：

200 OK：表示请求成功。
201 Created：表示成功创建了资源。
204 No Content：表示成功执行了请求，但没有返回任何内容。
400 Bad Request：表示请求有错误，例如请求参数格式不正确或缺失。
401 Unauthorized：表示未授权访问，需要提供有效的凭据才能访问资源。
403 Forbidden：表示已经授权访问，但是不允许访问该资源。
404 Not Found：表示请求的资源不存在。
405 Method Not Allowed：表示请求的 HTTP 方法不支持该资源，例如使用 POST 请求只读资源。
409 Conflict：表示请求冲突，例如在更新资源时发生版本冲突。
500 Internal Server Error：表示服务器内部错误，例如无法连接数据库或处理请求时出现异常。

三、客户端调用Restful API示例代码

以下是一个基本的 Restful API 请求示例代码，使用 Swift 编写：

import Foundationlet url = URL(string: "https://example.com/api/users/1")!var request = URLRequest(url: url)
request.httpMethod = "GET"let task = URLSession.shared.dataTask(with: request) { data, response, error inguard let data = data, let response = response as? HTTPURLResponse, error == nil else {print("Error: \(error?.localizedDescription ?? "Unknown error")")return}if (200..<300).contains(response.statusCode) {if let jsonObject = try? JSONSerialization.jsonObject(with: data) {print(jsonObject)}} else {print("Error: \(response.statusCode)")}
}task.resume()

以上代码是一个 GET 请求示例，通过 URL 请求用户资源的信息，并打印响应数据。代码使用了 Swift 的 URLSession 进行网络请求，其中 dataTask 方法用于创建并执行一个 HTTP/HTTPS 请求，并在请求完成后调用回调函数，处理请求的响应数据。

四、Restful API的优缺点

Restful API 的优点包括：

简单易用：Restful API 遵循 HTTP 协议，易于理解和实现。

可扩展性强：Restful API 的资源中心化设计，使得服务端可以轻松添加或删除资源，而客户端只需通过 URL 获取所需的资源。

可缓存：Restful API 支持缓存，可以提高性能和减少网络传输量。

跨平台兼容：Restful API 支持多种数据格式，如 JSON、XML 等，可以与不同平台和语言进行交互。

Restful API 的缺点包括：

安全性问题：Restful API 通常基于 HTTP 协议，传输过程中可能存在安全隐患。

性能问题：由于 Restful API 基于 HTTP 协议，每次请求都需要建立连接，对于大量并发请求或大量数据传输，可能存在性能瓶颈。

五、RPC与WebSocket

但是要注意的，Restful API并不是唯一的通讯与数据交换方式。其他常见的还有RPC、WebSocket等方式。

RPC：远程过程调用，一种标准，屏蔽底层通信细节，可以直接调用。简单地说，RPC就是从一台机器(客户端)上通过参数传递的方式调用另一台机器(服务器)上的一个函数或方法(可统称为服务)并得到返回的结果。RPC在使用形式上像调用本地函数(或方法)一样去调用远程的函数(或方法)。

有这样一个原则：服务内部：首要使用RPC，RPC适合内部间，高效，快速通信。 缺点是 两边最好都是Java的系统。服务外部：首要使用RESTful，REST适合外部间，简单易用，且跨语言。 缺点是 操作有限(CRUD)，且不够高效。所以，RPC偏向应用于微服务架构、分布式系统、数据库访问、高性能计算等对性能和可靠性有高要求的场景。

WebSocket：WebSocket是一种在单个TCP连接上的全双工的通信协议，它允许客户端和服务器之间建立持久性的连接，实现实时的数据传输。WebSocket可以通过简单的API实现，支持跨平台和跨浏览器使用。所以，WebSocket更适合一些即时通讯（在线聊天）、实时数据推送（股票数据）、远程监控和控制实时协作等场景。

参考资料

[1] https://zhuanlan.zhihu.com/p/334809573

[2] https://blog.csdn.net/The_Time_Runner/article/details/86518448

[3] https://www.cnblogs.com/zhongyuanzhao000/p/11700815.html

关注公众号ios_hunter，可与作者直接沟通，后续也会有更多文章更新。