https://github.com/jessyancoding/retrofiturlmanager
🔮 Let Retrofit support multiple baseUrl and can be change the baseUrl at runtime (以最简洁的 Api 让 Retrofit 同时支持多个 BaseUrl 以及动态改变 BaseUrl).
https://github.com/jessyancoding/retrofiturlmanager
arms baseurl baseurl-domain mvparms okhttp okhttp3 retrofit retrofit2
Last synced: 28 days ago
JSON representation
🔮 Let Retrofit support multiple baseUrl and can be change the baseUrl at runtime (以最简洁的 Api 让 Retrofit 同时支持多个 BaseUrl 以及动态改变 BaseUrl).
- Host: GitHub
- URL: https://github.com/jessyancoding/retrofiturlmanager
- Owner: JessYanCoding
- License: apache-2.0
- Created: 2017-07-16T13:37:29.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2020-04-18T03:44:26.000Z (about 5 years ago)
- Last Synced: 2025-03-31T22:20:06.561Z (about 1 month ago)
- Topics: arms, baseurl, baseurl-domain, mvparms, okhttp, okhttp3, retrofit, retrofit2
- Language: Java
- Homepage:
- Size: 15.4 MB
- Stars: 2,195
- Watchers: 45
- Forks: 309
- Open Issues: 12
-
Metadata Files:
- Readme: README-zh.md
- License: LICENSE
Awesome Lists containing this project
README
# RetrofitUrlManager
[  ](https://bintray.com/jessyancoding/maven/retrofit-url-manager/1.4.0/link)
[  ](https://travis-ci.org/JessYanCoding/RetrofitUrlManager)
[  ](https://android-arsenal.com/details/1/6007)
[  ](https://developer.android.com/about/versions/android-2.3.html)
[  ](http://www.apache.org/licenses/LICENSE-2.0)
[  ](https://www.jianshu.com/u/1d0c0bc634db)
[  ](https://shang.qq.com/wpa/qunwpa?idkey=7e59e59145e6c7c68932ace10f52790636451f01d1ecadb6a652b1df234df753)
## Let Retrofit support multiple baseUrl and can be change the baseUrl at runtime.
## Overview
## Introduction
以最简洁的 **Api** 让 **Retrofit** 同时支持多个 **BaseUrl** 以及动态改变 **BaseUrl**.
## Notice
[**框架的分析和思路 (一)**](http://www.jianshu.com/p/2919bdb8d09a)
[**框架的分析和思路 (二)**](https://www.jianshu.com/p/35a8959c2f86)
[**更完整的 Sample**](https://github.com/JessYanCoding/ArmsComponent)
## Download
``` gradle
implementation 'me.jessyan:retrofit-url-manager:1.4.0'
```
## Usage
### Initialize
``` java
// 构建 OkHttpClient 时,将 OkHttpClient.Builder() 传入 with() 方法,进行初始化配置
OkHttpClient = RetrofitUrlManager.getInstance().with(new OkHttpClient.Builder())
.build();
```
### Step 1
``` java
public interface ApiService {
@Headers({"Domain-Name: douban"}) // 加上 Domain-Name header
@GET("/v2/book/{id}")
Observable getBook(@Path("id") int id);
}
```
### Step 2
``` java
// 可在 App 运行时,随时切换 BaseUrl (指定了 Domain-Name header 的接口)
RetrofitUrlManager.getInstance().putDomain("douban", "https://api.douban.com");
```
### If you want to change the global BaseUrl
```java
// 全局 BaseUrl 的优先级低于 Domain-Name header 中单独配置的,其他未配置的接口将受全局 BaseUrl 的影响
RetrofitUrlManager.getInstance().setGlobalDomain("your BaseUrl");
```
## About Me
* **Email**:
* **Home**:
* **掘金**:
* **简书**:
## License
```
Copyright 2017, jessyan
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```