當前版本:2.7.1
官方文檔:https://square.github.io/retrofit/
Retrofit 是一個 RESTful 的 HTTP 網絡請求框架的封裝。
簡介
使用
- 添加Retrofit庫的依賴
- 依賴
dependencies {
...
implementation 'com.squareup.retrofit2:retrofit:2.7.1'
implementation 'com.squareup.retrofit2:converter-gson:2.3.0'
}
- 權限
<uses-permission android:name="android.permission.INTERNET"/>
- 創建 接收服務器返回數據 的類
Translation.java
/**
* created on 2020/2/11 10:18
*
* @author Scarf Gong
*/
public class Translation {
/**
* status : 1
* content : {"from":"en-EU","to":"zh-CN","vendor":"wps","out":"你好世界","ciba_use":"來自機器翻譯。","ciba_out":"","err_no":0}
*/
private int status;
private ContentBean content;
public int getStatus() {
return status;
}
public void setStatus(int status) {
this.status = status;
}
public ContentBean getContent() {
return content;
}
public void setContent(ContentBean content) {
this.content = content;
}
public static class ContentBean {
/**
* from : en-EU
* to : zh-CN
* vendor : wps
* out : 你好世界
* ciba_use : 來自機器翻譯。
* ciba_out :
* err_no : 0
*/
private String from;
private String to;
private String vendor;
private String out;
private String ciba_use;
private String ciba_out;
private int err_no;
public String getFrom() {
return from;
}
public void setFrom(String from) {
this.from = from;
}
public String getTo() {
return to;
}
public void setTo(String to) {
this.to = to;
}
public String getVendor() {
return vendor;
}
public void setVendor(String vendor) {
this.vendor = vendor;
}
public String getOut() {
return out;
}
public void setOut(String out) {
this.out = out;
}
public String getCiba_use() {
return ciba_use;
}
public void setCiba_use(String ciba_use) {
this.ciba_use = ciba_use;
}
public String getCiba_out() {
return ciba_out;
}
public void setCiba_out(String ciba_out) {
this.ciba_out = ciba_out;
}
public int getErr_no() {
return err_no;
}
public void setErr_no(int err_no) {
this.err_no = err_no;
}
@Override
public String toString() {
return "ContentBean{" +
"from='" + from + '\'' +
", to='" + to + '\'' +
", vendor='" + vendor + '\'' +
", out='" + out + '\'' +
", ciba_use='" + ciba_use + '\'' +
", ciba_out='" + ciba_out + '\'' +
", err_no=" + err_no +
'}';
}
}
}
- 創建 用於描述網絡請求 的接口
/**
* created on 2020/2/11 10:22
*
* @author Scarf Gong
*/
public interface IRequest {
@GET("ajax.php?a=fy&f=auto&t=auto&w=hello%20world")
Call<Translation> getCall();
}
- 創建 Retrofit 實例
- 創建 網絡請求接口實例 並 配置網絡請求參數
- 發送網絡請求(異步 / 同步)
public class MainActivity extends AppCompatActivity {
private static final String TAG = "MainActivity";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
request();
}
private void request() {
Retrofit retrofit = new Retrofit.Builder()
.baseUrl("http://fy.iciba.com/") // 設置 網絡請求 Url
.addConverterFactory(GsonConverterFactory.create()) //設置使用Gson解析(記得加入依賴)
.build();
IRequest request = retrofit.create(IRequest.class);
//對發送請求進行封裝
Call<Translation> call = request.getCall();
call.enqueue(new Callback<Translation>() {
//請求成功時回調
@Override
public void onResponse(Call<Translation> call, Response<Translation> response) {
//處理返回的數據結果
int status = response.body().getStatus();
Log.d(TAG, "onResponse: " + status);
}
//請求失敗時回調
@Override
public void onFailure(Call<Translation> call, Throwable throwable) {
Log.d(TAG, "連接失敗");
}
});
}
}
對比
除了Retrofit,如今Android中主流的網絡請求框架有:
- Android-Async-Http
- Volley
- OkHttp