这一篇文章就正式开始讲解Retrofit的使用:
1、先去官网找到依赖:
官网地址:https://github.com/square/retrofit
添加依赖:
implementation "com.squareup.retrofit2:retrofit:2.9.0"
温馨提示:在这里因为我打算要用拦截器,然后发现是要添加依赖:
implementation("com.squareup.okhttp3:logging-interceptor:4.8.1")
但是后来想了下,虽然Retrofit是已经封装了Okhttp,但是我用的版本号可以对得上么?
于是就找了下,果然对不上,这里先说下怎么核对哈:
(提示下:我目前还是在用windows10系统的,但是大致方法应该是一样的)
①、打开项目的
②、找到
③、打开本地的文件
④、打开这个文件
⑤、搜索下okhttp,然后就找到下面的版本号啦!
老衲欣慰露出了微笑,又get了一个小技巧。
2、添加转换方法,因为服务器返回的都是json字符串,但是retrofit的转换方法需要你去告诉它,怎么转化,所以需要添加转换的方法,点开官网的retrofit-converters然后找到你需要的转化的类型,添加对应的依赖就可以了
这里就特别说明下:在我们添加官网转换类型的依赖时:
implementation 'com.squareup.retrofit2:converter-gson:latest.version'
会出现报错,说找不到对应的api配置。这个时候就需要更换下:
implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
把latest.version替换成最新版本号,也就是跟retrofit2的版本号保持一直就好了
使用方法如下:
1、创建RetrofitImpl,对于配置需求的话,都在这里进行配置,因为Retrofit是封装了Okhttp的,所以对于OkHttpClient也是需要Okhttpde 知识的
public class RetrofitImpl {
private static RetrofitImpl sInstance=new RetrofitImpl();
public static RetrofitImpl getsInstance(){
return sInstance;
}
private Retrofit mRetrofit;
public static Retrofit getmRetrofit(){
return sInstance.mRetrofit;
}
private RetrofitImpl(){
HttpLoggingInterceptor logging = new HttpLoggingInterceptor(new HttpLoggingInterceptor.Logger() {
@Override
public void log(String message) {
Log.d("jeffrey",message);
}
});
logging.setLevel(HttpLoggingInterceptor.Level.BODY);
OkHttpClient client = new OkHttpClient.Builder()
.addInterceptor(logging)
.build();
mRetrofit=new Retrofit.Builder()
.client(client)
//添加转化的类型
.addConverterFactory(GsonConverterFactory.create())
.baseUrl("")
.build();
}
}
2、创建接口,请求类型以及参数需要在这里进行声明,然后说下上面的baseUrl是接口地址前一截相同的部分,然后在@GET("")填写对应的后半截
public interface IApi {
@GET("")
Call<Result> get(@Header ("anthor") String author,@Query("username") String username);
@POST("")
@FormUrlEncoded
Call<Result> post(@Field("username")String username);
@POST("")
@Multipart
Call<Result> postMultipart(@Part("username")RequestBody username);
@POST("")
Call<Result> postJson(@Body RequestBody jsonBody);
}
3、创建实体类,这个是依据接口文档返回的参数进行配置
public class Result {
public int errorCode;
public String errorMsg;
public Data data;
public static class Data{
public String ip;
public String params;
public HashMap<String,String> headers;
public String json;
}
}
4、在java后台这里编写逻辑
public class Retrofit extends AppCompatActivity {
private Button mBtnGet,mBtnPost,mBtnPostMultipart,mBtnPostJson;
private TextView mTvContent;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_retrofit);
initViews();
initEvents();
}
private void initEvents() {
mBtnGet.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
IApi api= RetrofitImpl.getmRetrofit().create(IApi.class);
api.get("jeffrey","123").enqueue(new Callback<Result>() {
@Override
public void onResponse(Call<Result> call, Response<Result> response) {
Result result=response.body();
mTvContent.setText(result.errorCode+","+result.errorMsg+","+result.data);
}
@Override
public void onFailure(Call<Result> call, Throwable t) {
Toast.makeText(Retrofit.this,"网络发生错误",Toast.LENGTH_SHORT).show();
}
});
}
});
mBtnPost.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
IApi api= RetrofitImpl.getmRetrofit().create(IApi.class);
api.post("jeffrey").enqueue(new Callback<Result>() {
@Override
public void onResponse(Call<Result> call, Response<Result> response) {
Result result=response.body();
mTvContent.setText(result.errorCode+","+result.errorMsg+","+result.data);
}
@Override
public void onFailure(Call<Result> call, Throwable t) {
Toast.makeText(Retrofit.this,"网络发生错误",Toast.LENGTH_SHORT).show();
}
});
}
});
mBtnPostMultipart.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
IApi api= RetrofitImpl.getmRetrofit().create(IApi.class);
MediaType mediaType=MediaType.get("text/plain;charset=utf-8");
RequestBody username=RequestBody.create(mediaType,"jeffrey");
api.postMultipart(username).enqueue(new Callback<Result>() {
@Override
public void onResponse(Call<Result> call, Response<Result> response) {
Result result=response.body();
mTvContent.setText(result.errorCode+","+result.errorMsg+","+result.data);
}
@Override
public void onFailure(Call<Result> call, Throwable t) {
Toast.makeText(Retrofit.this,"网络发生错误",Toast.LENGTH_SHORT).show();
}
});
}
});
mBtnPostJson.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
IApi api= RetrofitImpl.getmRetrofit().create(IApi.class);
MediaType mediaType=MediaType.get("application/json;charset=utf-8");
RequestBody username=RequestBody.create(mediaType,"{\"name\":\"jeffrey\",\"age\":18}");
api.postJson(username).enqueue(new Callback<Result>() {
@Override
public void onResponse(Call<Result> call, Response<Result> response) {
Result result=response.body();
mTvContent.setText(result.errorCode+","+result.errorMsg+","+result.data.json);
}
@Override
public void onFailure(Call<Result> call, Throwable t) {
Toast.makeText(Retrofit.this,"网络发生错误",Toast.LENGTH_SHORT).show();
}
});
}
});
}
private void initViews() {
mBtnGet=findViewById(R.id.bt_get);
mTvContent=findViewById(R.id.tv_content);
mBtnPost=findViewById(R.id.bt_post);
mBtnPostMultipart=findViewById(R.id.bt_post_multipart);
mBtnPostJson=findViewById(R.id.bt_post_json);
}
}
这里小结一下:对比使用okhttp来说,retrofit使用起来方便了不少,在配置好Retrofit的构造之后,只需要在声明中的添加对应的声明,就可以直接使用,emmmm的确是个神兵利器,然后下一章会写关于EventBus的介绍,感谢各位的支持!