38. 网络加载框架Retrofit

38. 网络加载框架Retrofit
38.1 Retrofit简介
Retrofit 是一个 RESTful 的 HTTP 网络请求框架的封装。
原因：网络请求的工作本质上是 OkHttp 完成，而 Retrofit 仅负责 网络请求接口的封装

官方地址：

https://github.com/square/retrofit

最新版本

引入依赖

同步

38.2 Retrofit基本使用

服务器依然使用httpbin

域名：https://www.httpbin.org/

接口：post

参数：username， password

接口：get

参数：username，password

→ 根据接口创建Java接口

package com.dingjiaxiong.myretrofit;

import okhttp3.ResponseBody;
import retrofit2.Call;
import retrofit2.http.Field;
import retrofit2.http.FormUrlEncoded;
import retrofit2.http.GET;
import retrofit2.http.POST;
import retrofit2.http.Query;

public interface HttpBinService { 
    
    @POST("post")
    @FormUrlEncoded
    Call<ResponseBody> post(@Field("username") String userName ,@Field("password") String pwd);

    @GET("get")
    Call<ResponseBody> get(@Query("username") String userName ,@Query("password") String pwd);
    
}

第二步：创建Retrofit对象，并生成接口实现类对象

package com.dingjiaxiong.myretrofit;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;
import android.util.Log;
import android.view.View;

import java.io.IOException;

import okhttp3.ResponseBody;
import retrofit2.Call;
import retrofit2.Callback;
import retrofit2.Response;
import retrofit2.Retrofit;

public class MainActivity extends AppCompatActivity {

    private Retrofit retrofit;
    private HttpBinService httpBinService;

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

        retrofit = new Retrofit.Builder().baseUrl("https://www.httpbin.org/").build();

        httpBinService =retrofit.create(HttpBinService.class);

    }

    public void postAsync(View view) {

        Call<ResponseBody> call = httpBinService.post("dingjiaxiong", "123");
        call.enqueue(new Callback<ResponseBody>() {
            @Override
            public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
                try {
                    Log.e("dingjiaxiong", "onResponse: " + response.body().string() );
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }

            @Override
            public void onFailure(Call<ResponseBody> call, Throwable t) {

            }
        });
    }
}

布局文件

就一个按钮

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity"
    android:orientation="vertical"
    >

    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="post异步请求"
        android:onClick="postAsync"
        />

</LinearLayout>

一定记得在清单文件中加权限，不然会直接退出

运行

OK

38.3 Retrofit中的注解

分类：

方法注解：@GET , @POST , @PUT , @DELETE , @PATH , @HEAD , @OPTIONS , @HTTP
标记注解：@FormUrlEncoded , @Multipart , @Streaming
参数注解：@Query , @QueryMap , @Body , @FieldMap , @Part , @PartMap
其他注解：@Path , @ Header , @Headers , @Url

@HTPP 注解可以自定义请求的方式。

使用上就是调方法、传参。

参数注解@Body演示测试

接口：

@POST("post")
Call<ResponseBody> postBody(@Body RequestBody requestBody);

package com.dingjiaxiong.myretrofit;

import org.junit.Test;

import java.io.IOException;

import okhttp3.FormBody;
import okhttp3.ResponseBody;
import retrofit2.Response;
import retrofit2.Retrofit;

public class AnnitationUnitTest {

    Retrofit retrofit = new Retrofit.Builder().baseUrl("https://www.httpbin.org/").build();
    HttpBinService httpBinService = retrofit.create(HttpBinService.class);

    @Test
    public void bodyTest() throws IOException {
        FormBody formBody = new FormBody.Builder()
                .add("a", "1")
                .add("b", "2").build();
        Response<ResponseBody> response = httpBinService.postBody(formBody).execute();
        System.out.println(response.body().string());
    }
}

@Path注解演示

@POST("{id}")
Call<ResponseBody> postPath(@Path("id") String path);

 

@Test
public void pathTest() throws IOException {
    Response<ResponseBody> response = httpBinService.postPath("post").execute();
    System.out.println(response.body().string());
}

实际上就是完成了一个post 请求。

加个参数。

运行

ok。

@Header注解用于设置请求头

演示

再加一个参数

调用时

OK

@Headers注解

@Test
public void headersTest() throws IOException {
    Response<ResponseBody> response = httpBinService.postWithHeaders().execute();
    System.out.println(response.body().string());
}

运行

@Url注解

测试方法

@Test
public void UrlTest() throws IOException {
    Response<ResponseBody> response = httpBinService.postUrl("https://www.httpbin.org/post").execute();
    System.out.println(response.body().string());
}

运行

报错了，加上@POST

再运行

请求成功。

作用：指定一个地址，作为这次请求的一个完整的请求地址。