RetrofitUrlManager 使用教程

RetrofitUrlManager 使用教程

RetrofitUrlManager🔮 Let Retrofit support multiple baseUrl and can be change the baseUrl at runtime (以最简洁的 Api 让 Retrofit 同时支持多个 BaseUrl 以及动态改变 BaseUrl).项目地址:https://gitcode.com/gh_mirrors/re/RetrofitUrlManager

本教程将引导你了解并开始使用 RetrofitUrlManager，这是一个让 Retrofit 支持多个基础 URL 并能在运行时动态切换的开源库。

1. 项目目录结构及介绍

在克隆或下载项目后，你会看到以下主要的目录结构：

RetrofitUrlManager/
├── app/            // 示例应用模块
│   ├── src/
│   │   └── main/     // 主要源码目录
│   ├── build.gradle  // 示例应用构建文件
├── library/        // 库模块
│   ├── src/
│   │   └── main/     // 库源码目录
│   ├── build.gradle  // 库构建文件
└── README.md       // 项目README文档

• app 目录包含了使用 RetrofitUrlManager 的示例应用程序。
• library 目录包含了核心库代码，包括 RetrofitUrlManager 类和其他相关辅助类。

2. 项目的启动文件介绍

在示例应用 app 模块中的 MainActivity.java 是入门点。它展示了如何初始化 RetrofitUrlManager 和使用它进行 HTTP 请求。

package me.jessyan.retrofiturlmanager.demo;

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;

import retrofit2.Call;
import retrofit2.Callback;
import retrofit2.Response;

import me.jessyan.retrofiturlmanager.RetrofitUrlManager;
import me.jessyan.retrofiturlmanager.demo.api.ApiService;
import me.jessyan.retrofiturlmanager.demo.bean.User;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 初始化 RetrofitUrlManager
        RetrofitUrlManager.getInstance().with(new OkHttpClient.Builder());

        // 添加基础 URL 到管理器
        RetrofitUrlManager.getInstance().addUrl("wanandroid", "https://raw.githubusercontent.com/JessYanCoding/MVPHero/master/app/src/main/assets/json/wanandroid/");

        // 创建 Retrofit 对象
        ApiService service = new Retrofit.Builder()
                .baseUrl(RetrofitUrlManager.DEFAULT)
                .build();

        // 发起请求
        service.getUser().enqueue(new Callback<User>() {
            @Override
            public void onResponse(Call<User> call, Response<User> response) {
                Log.d("MainActivity", "Response: " + response.body());
            }

            @Override
            public void onFailure(Call<User> call, Throwable t) {
                Log.e("MainActivity", "Failure: " + t.getMessage());
            }
        });
    }
}

这里的关键步骤是初始化 RetrofitUrlManager 并添加至少一个基础 URL，然后你可以通过 baseUrl(RetrofitUrlManager.DEFAULT) 来创建你的 Retrofit 实例。

3. 项目的配置文件介绍

库模块的配置

在 library/build.gradle 文件中，你会发现项目的依赖项和版本声明，例如 Retrofit 和 OkHttp。这些配置决定了库使用的第三方库版本。

dependencies {
    api 'com.squareup.retrofit2:retrofit:2.9.0'
    api 'com.squareup.retrofit2:converter-gson:2.9.0'
    api 'com.squareup.okhttp3:okhttp:4.9.1'
}

示例应用模块的配置

在 app/build.gradle 文件中，除了基本的 Gradle 设置外，还包含了一个应用模块级别的依赖，即引入了刚刚创建的库模块。

dependencies {
    implementation project(':library')
}

这样设置之后，示例应用就可以使用 RetrofitUrlManager 库了。

以上就是关于 RetrofitUrlManager 的简要介绍和初始化。你可以参考示例代码和库代码进一步了解其功能，如动态切换基础 URL 和处理不同环境下的网络请求。记得查阅项目的官方文档以获取更详细的信息和最佳实践。

RetrofitUrlManager🔮 Let Retrofit support multiple baseUrl and can be change the baseUrl at runtime (以最简洁的 Api 让 Retrofit 同时支持多个 BaseUrl 以及动态改变 BaseUrl).项目地址:https://gitcode.com/gh_mirrors/re/RetrofitUrlManager