在 Android 开发中，访问 RESTful API 已经成为了开发中的一个不可或缺的部分。其中，Retrofit 是目前最流行的 RESTful API 访问框架之一，它使用了简单的注解方式，使得访问 API 变得异常方便。
本文将会详细介绍如何使用 Retrofit 在 Android 开发中访问 RESTful API。我们将会探讨 Retrofit 的基本使用，以及如何配置 Retrofit 以支持 HTTPS。
Retrofit 的基本使用
Retrofit 是一个基于 OkHttp 构建的 RESTful API 访问框架。在开始之前，我们需要在 build.gradle 中添加以下依赖：
dependencies {
implementation 'com.squareup.retrofit2:retrofit:2.9.0'
implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
}其中，com.squareup.retrofit2:retrofit:2.9.0 是 Retrofit 的核心依赖，com.squareup.retrofit2:converter-gson:2.9.0 则是用于将 JSON 数据转换成 Java 对象。
接下来，我们需要定义一个 Retrofit 实例。我们可以在应用程序的 Application 类中定义一个单例，以便在整个应用中使用 Retrofit。
-- -------------------- ---- -------
------ ----- ------------- ------- ----------- -
------- ------ -------- -------- - -----
------ ------ -------- ------------- -
-- --------- -- ----- -
------ ------- - -----------------------
---- ---- - --- ------------------------------------
------------ ------------ - --- ----------------------
------------------- -----------------
---------------- -----------------
----------------- -----------------
---------
---------------- ------- - --- ------------------
-----------------
---------------------
--------------------------------------------------------
-------- - ----------------
-
------ ---------
-
-在上面的代码中，我们定义了一个 MyApplication 类，并在其中定义了一个静态的 getRetrofit() 方法。该方法首先检查 Retrofit 是否为空，如果为空则创建一个新实例，并使用 OkHttp 客户端和 GSON 转换器进行配置。请注意，我们还可以为 OkHttp 客户端添加拦截器，以便记录网络请求，或者添加身份验证信息。
定义了 Retrofit 实例之后，我们可以使用注解方式定义 API 接口。Retrofit 支持 GET/POST/PUT/DELETE 等 HTTP 请求方式。例如，以下代码片段展示了一个 GET 请求的示例：
public interface ApiService {
@GET("users/{user}")
Call<User> getUser(@Path("user") String user);
}上述代码中，我们定义了一个 ApiService 接口，并使用 @GET 注解定义了一个 GET 请求方法。该方法接受一个 user 字符串作为参数，该字符串将会作为 URL 的一部分发送给服务器。@Path("user") 注解告诉 Retrofit，将 user 参数的值替换 URL 中的 {user} 占位符。
接下来，我们可以使用 Retrofit 创建一个 ApiService 对象，并调用其方法：
-- -------------------- ---- -------
---------- ------- - -----------------------------------------------------
---------- ---- - ---------------------------
---------------- ---------------- -
---------
------ ---- --------------------- ----- -------------- --------- -
---- ---- - ----------------
------------ -----------------
-
---------
------ ---- -------------------- ----- --------- -- -
------------ ----------------
-
---在上面的代码中，我们使用 MyApplication.getRetrofit().create(ApiService.class) 方法创建了一个 ApiService 对象。接下来，我们使用这个对象调用 getUser() 方法，并传递一个字符串作为参数。最后，我们通过调用 call.enqueue() 方法异步地发送 HTTP 请求并等待响应，响应将会回调 onResponse() 或 onFailure() 方法，具体取决于请求成功与否。
配置 Retrofit 支持 HTTPS
在生产环境中，我们通常使用 HTTPS 连接来保护网络请求的安全性。在 Retrofit 中配置 HTTPS 的方法非常简单，只需要使用 OkHttp 客户端并添加一个 HTTPS 配置即可。以下代码演示了如何配置 Retrofit 支持 HTTPS：
-- -------------------- ---- -------
------ ------ -------- ------------- -
-- --------- -- ----- -
------ ------- - -----------------------
---- ---- - --- ------------------------------------
-------------------- ------- - --- ----------------------
------------------- -----------------
---------------- -----------------
----------------- ------------------
---------------------------- -- -
------- ------- - ----------------
--------------- -------- - -------------------------------------------- ------- - - -------
------- - -----------------
------ -----------------------
---
--- -
------------------ -- - ----------------------------------------
----------- ----------- - -------------------------------------------------------------------------
----------- ---
--- -
-- - ------------------------------------
-------------------- ----- - ------------------ --------------------
- ------- -
--------------------
-
------ ------------ - --------------------------
-------- -------- - -----------------------------------
------------------- ------
---------------------------------- ----
------ ------------ - ------------------------------------------
------------------- --- - ----------------------------------------------
-------------------
---------- ---------- - ------------------------------
--------------------- ----------------------- ------
------------------------------------------------------- ------------------ ---------------------------
- ----- ---------- -- -
--------------------
-
---------------- -------- - --- ------------------
-----------------
------------------------
--------------------------------------------------------
-------- - -----------------
-
------ ---------
-我们首先在应用程序的 res/raw 目录下添加了一个 cert.pem 文件，该文件包含了服务器的 SSL 证书。在 getRetrofit() 方法中，我们定义了一个 CertificateFactory 对象并使用 generateCertificate() 方法从证书文件中读取证书。接下来，我们创建了一个 KeyStore 对象并将读取到的证书添加到该对象中。然后，我们创建了一个 TrustManagerFactory 并使用其初始化 SSLContext 对象。最后，我们使用 OkHttpClient.Builder 对象将 SSLContext 配置到 OkHttp 客户端中。在此之后，我们就可以使用 Retrofit 发送安全的 HTTPS 请求。
总结
在本文中，我们详细介绍了如何使用 Retrofit 来访问 RESTful API。我们首先讨论了 Retrofit 的基本使用，包括如何定义 Retrofit 实例和 API 接口，并使用注解方式发送 HTTP 请求。接下来，我们讨论了如何配置 Retrofit 支持 HTTPS，保证网络安全。我们希望这篇文章能够帮助 Android 开发者更好地使用 Retrofit，并在开发中提高开发效率和代码质量。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64f00908f6b2d6eab39f9f73