前言

在開發專案中經常會遇到上傳頭像的問題，那我們如果使用Retrofit做網路請求時，如何進行使用，在文章的最後有最清晰的使用方法

Retrofit可以認為是Okhttp的 “升級版”，為什麼這麼說？那是因為其內部預設是基於OkHttp來進行封裝的，它們屬於同一家公司Square

介紹

常用的網路請求方法

@GET

 使用@Query單個引數   @QueryMap多個引數

@POST

使用@Field 單個引數   @FieldMap 多個引數   @Part 上傳檔案 @PartMap 上傳多個檔案

總體使用步驟：

1.新增Retrofit依賴庫
2.建立接受伺服器返回資料的類
3.建立用於描述網路請求的介面
4.建立Rerofit例項
5.建立網路請求介面例項
6.傳送網路請求（非同步和同步）
7.處理返回資料 
8.進階理解從複雜到精簡的過程
9.上傳檔案使用
 

使用

當你想要做任何網路請求的操作時，一定要提前首先加上網路許可權，這是很多新手容易忘記的通病，以前我也老忘哈哈。。。。。

下面來看具體使用方法：

1.匯入依賴包

    implementation 'com.squareup.retrofit2:retrofit:2.4.0'
    implementation 'com.google.code.gson:gson:2.2.4'
    compile 'com.squareup.retrofit2:converter-gson:2.0.2'

2.建立Bean類

用gson 快捷方式，生成一個數據類，這個大家都會把，如果不會的話百度搜gosn 外掛即可

3.建立存放網路請求的介面

//{name}是一個替換塊,搭配@Path（"name"）動態傳引數 
public interface PostService{
  @GET("{name}/index?key=d05b58fa6901ad9bed77a1ef08bd6ccb")
  Call<Getbean> getString(@Path("name") String name);
}

4..建立並初始化Retrofit例項

       Retrofit retrofit = new Retrofit.Builder()
               .baseUrl
 
("http://v.juhe.cn/")//設定網路請求的Url地址
               .addConverterFactory(GsonConverterFactory.create()) //設定資料解析器
               .build();

5.連線網路請求介面呼叫其方法

GetService service = retrofit.create(GetService.class);
Call<GetBean> call = service.getString3("toutiao");

6.同步和非同步請求方式

//同步操作，必須開啟子執行緒
     new Thread(new Runnable() {
            @Override
            public void run() {
                try {
                    Response<GetBean> execute = call.execute();
                    GetBean bean = execute.body();
                    Message msg=hand.obtainMessage();
                    msg.obj=bean.toString();
                    msg.what=102;
                    hand.sendMessage(msg);
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }).start();
//非同步操作
  call.enqueue(new Callback<GetBean>() {
            @Override
            public void onResponse(Call<GetBean> call, Response<GetBean> response) {
                GetBean bean = response.body();
                Log.e("zhoukang", "" + bean.toString());
            }
            @Override
            public void onFailure(Call<GetBean> call, Throwable t) {
            }
        });

7.處理返回資料

 Handler hand=new Handler(){
        @Override
        public void handleMessage(Message msg) {
            super.handleMessage(msg);
            //TODO 處理邏輯
        }
    };

8.進階理解從複雜到精簡的過程

• GET 請求方式

 //直接拼接,記得加問號
    @GET("toutiao/index?type=shehui&key=d05b58fa6901ad9bed77a1ef08bd6ccb")
    Call<GetBean> getString();

 //{name}可以最簡單的將其理解為路徑替換塊，用”{}”表示，與註解@path配合使用 ,為了解耦,引數name==toutiao
    @GET("{name}/index?type=shehui&key=d05b58fa6901ad9bed77a1ef08bd6ccb")
    Call<GetBean> getString2(@Path("name") String name);

 //對於@GET來說，引數資訊是可以直接放在url中上傳的。那麼你馬上就反應過來了，這一樣也存在嚴重的耦合！
 //於是，就有了@query
    @GET("{name}/index")
    Call<GetBean> getString3(@Path("name")String name,@Query("type") String type 
    ,@Query("key") String key);

 //假設我要在引數中上傳10個引數呢？這意味著我要在方法中宣告10個@Query引數？當然不是！
    //Retrofit也考慮到了這點，所以針對於複雜的引數上傳，為我們準備了@QueryMap
    @GET("{name}/index")
    Call<GetBean> getString4(@Path("name") String name, @QueryMap HashMap<String,String> hashMap);

• Post方式

    //注意：千萬別忘了標記 @FormUrlEncoded
    @FormUrlEncoded
    @POST("toutiao/index")
    Call<PostBean> postString(@Field("type") String type, @Field("key") String key);

   // Post表單提交-多個引數[email protected]
    @FormUrlEncoded
    @POST("toutiao/index")
    Call<PostBean> postString2(@FieldMap HashMap<String,String> params);

• MainActivity檔案

/**
 *   https://blog.csdn.net/carson_ho/article/details/73732076
 */
public class MainActivity extends AppCompatActivity {

    private TextView mTv;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mTv = findViewById(R.id.tv);
        //        initGet();
        try {
            initPost();
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
    }

    private void initPost() throws UnsupportedEncodingException {
        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl("http://v.juhe.cn/")
                .addConverterFactory(GsonConverterFactory.create())
                .build();
        PostService service = retrofit.create(PostService.class);
        //解決中文亂碼，伺服器後臺不認識造成資料為響應
        String name = URLEncoder.encode("社會", "UTF-8");
        HashMap<String, String> map = new HashMap<>();
        map.put("type", name);
        map.put("key", "d05b58fa6901ad9bed77a1ef08bd6ccb");
        Call<PostBean> call = service.postString2(map);

        call.enqueue(new Callback<PostBean>() {
            @Override
            public void onResponse(Call<PostBean> call, Response<PostBean> response) {
                if (response.isSuccessful()) {
                    PostBean bean = response.body();
                    Message msg = hand.obtainMessage();
                    msg.obj = bean.toString();
                    msg.what = 102;
                    hand.sendMessage(msg);
                    Log.e("zhoukang", "" + bean.toString());
                }
            }
            @Override
            public void onFailure(Call<PostBean> call, Throwable t) {
                Log.e("zhoukang", "R1++ 失敗" + t.getMessage());
            }
        });


    }


    private void initGet() {
        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl("http://v.juhe.cn/")
                .addConverterFactory(GsonConverterFactory.create())
                .build();
        GetService service = retrofit.create(GetService.class);
        final Call<GetBean> call = service.getString3("toutiao", "shehui", "d05b58fa6901ad9bed77a1ef08bd6ccb");
        //非同步請求操作
        new Thread(new Runnable() {
            @Override
            public void run() {
                try {
                    Response<GetBean> execute = call.execute();
                    GetBean bean = execute.body();
                    Message msg = hand.obtainMessage();
                    msg.obj = bean.toString();
                    msg.what = 102;
                    hand.sendMessage(msg);
                    Log.e("zhoukang", "" + bean.toString());
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }).start();

    }

    Handler hand = new Handler() {
        @Override
        public void handleMessage(Message msg) {
            super.handleMessage(msg);
            //TODO 處理邏輯
            if (msg.what == 102) {
                String result = (String) msg.obj;
                mTv.setText(result);
            }
        }
    };

}

9.圖片檔案上傳

無聊自己寫了一個工具類，可以進行擴充套件使用

public class RetrofitHelper {

    Retrofit retrofit = null;
    String   BASEURL  = "介面地址";
    private final PostService mService;
    public static RetrofitHelper retrofitHelper = new RetrofitHelper();

    private RetrofitHelper() {
        if (retrofit == null) {
            retrofit = new Retrofit.Builder()
                    .baseUrl(BASEURL)
                    .addConverterFactory(GsonConverterFactory.create())
                    .build();
        }
        //通過retrofit類去把我們的網路請求service例項化出來
        mService = retrofit.create(PostService.class);
    }


    public static RetrofitHelper getInstance() {
        return retrofitHelper;
    }

        //提供一些方法去呼叫service實體類的方法，RequestBody上傳單個檔案
    public void uploadFile(RequestBody body, final OnSuccessListener listener) {
        Call<TestBean> call = mService.postFile(body, "");
        call.enqueue(new Callback<TestBean>() {
            @Override
            public void onResponse(Call<TestBean> call, Response<TestBean> response) {
                listener.onSuccess(response);
            }

            @Override
            public void onFailure(Call<TestBean> call, Throwable t) {
                listener.onFaile();
            }
        });
    }

    //提供一些方法去呼叫service實體類的方法，HashMap上傳多個檔案
    public void uploadFile2(HashMap<String, RequestBody> map, final OnSuccessListener listener) {
        Call<TestBean> call = mService.postFile2(map, "");
        call.enqueue(new Callback<TestBean>() {
            @Override
            public void onResponse(Call<TestBean> call, Response<TestBean> response) {
                listener.onSuccess(response);
            }

            @Override
            public void onFailure(Call<TestBean> call, Throwable t) {
                listener.onFaile();
            }
        });
    }
    //當我獲取資料成功後要做什麼處理
    public interface OnSuccessListener {
        void onSuccess(Object o);

        void onFaile();
    }
}

MainAtivity.java

    /**
     * 單張圖片上傳
     *
     * @throws IOException
     */
    private void initUpateBitmap() {

        //獲取圖片路徑,這只是個簡單的例子，專案開發中會有很多圖片需要上傳，一般從相簿和相機裡獲取，並且儲存到後臺伺服器時必須自己定義名字
        // ，這樣就不會發生圖片替換（原因名字重複）
        File file = new File(Environment.getExternalStorageDirectory() + "/" + "retrofit/" + "ceshi.jpg");
        RequestBody body = RequestBody.create(MediaType.parse("multipart/form-data"), file);
        RetrofitHelper.getInstance().uploadFile(body, new RetrofitHelper.OnSuccessListener() {
            @Override
            public void onSuccess(Object o) {
                Log.e("", "成功");
            }

            @Override
            public void onFaile() {
                Log.e("", "失敗");

            }
        });
    }
 /**
     * 多張圖片上傳
     */
    private void initUpateBitmap2() {

        //獲取圖片路徑,這只是個簡單的例子，專案開發中會有很多圖片需要上傳，一般從相簿和相機裡獲取，並且儲存到後臺伺服器時必須自己定義名字
        // ，這樣就不會發生圖片替換（原因名字重複）
        File file = new File(Environment.getExternalStorageDirectory() + "/" + "retrofit/" + "ceshi.jpg");
        File file2 = new File(Environment.getExternalStorageDirectory() + "/" + "retrofit/" + "ceshi2.jpg");
        File file3 = new File(Environment.getExternalStorageDirectory() + "/" + "retrofit/" + "ceshi3.jpg");
        File file4 = new File(Environment.getExternalStorageDirectory() + "/" + "retrofit/" + "ceshi4.jpg");

        RequestBody requestBody = RequestBody.create(MediaType.parse("multipart/form-data"), file);
        RequestBody requestBody2 = RequestBody.create(MediaType.parse("multipart/form-data"), file2);
        RequestBody requestBody3 = RequestBody.create(MediaType.parse("multipart/form-data"), file3);
        RequestBody requestBody4 = RequestBody.create(MediaType.parse("multipart/form-data"), file4);
        RequestBody body = RequestBody.create(MediaType.parse("multipart/form-data"), file);
        //傳一張圖片就要增加一個引數
        String name = "photo\"; filename=\"ceshi.jpg\"";
        String name2 = "photo\"; filename=\"ceshi2.jpg\"";
        String name3 = "photo\"; filename=\"ceshi3.jpg\"";
        String name4 = "photo\"; filename=\"ceshi4.jpg\"";
        HashMap<String, RequestBody> map = new HashMap<>();
        map.put(name, requestBody);
        map.put(name2, requestBody2);
        map.put(name3, requestBody3);
        map.put(name4, requestBody4);

        RetrofitHelper.getInstance().uploadFile2(map, new RetrofitHelper.OnSuccessListener() {
            @Override
            public void onSuccess(Object o) {
                Log.e("", "成功");
            }

            @Override
            public void onFaile() {
                Log.e("", "失敗");

            }
        });
    }

介面

    //Post檔案提交 ，每個鍵值對都需要用@Part註解鍵名字
    //Multipart 支援檔案上傳
    @Multipart
    @POST("拼接引數")

    @Multipart
    @POST("拼接引數")
    Call<TestBean> postFile2(@PartMap HashMap<String,RequestBody> bodyMap, @Field("token") String token);

總結

Retrofit2 的.baseUrl( xxxxxxx / )方法必須以 /（斜線） 結束，
不然會丟擲一個IllegalArgumentException,所以如果你看到別的教程沒有以 / 結束，
那麼多半是直接從Retrofit 1.X 照搬過來的。

這其實都是簡單的使用方式，希望你們能看懂，谷歌推薦搭配Rxjava+Rxandroid+gson 去使用，效率快，邏輯也更加簡單