Android第三方のRetrofit

目录:
1、Retrofit接入
2、使用
3、注解

Android第三方のRetrofit_第1张图片

1. Retrofit接入

Retrofit 是Http的一种请求工具,基于OkHttp。
传送门 ✈✈✈ Retrofit Github
传送门 ✈✈✈ Retrofit Website
官方说明:

A type-safe HTTP client for Android and Java

Retrofit支持Android端、Java端和iOS端。

1.1. 配置Gradle

compile 'com.squareup.retrofit2:retrofit:2.2.0'

1.2. 配置Proguard

如果工程中有使用Proguard,那么在其中配置:

# Platform calls Class.forName on types which do not exist on Android to determine platform.
-dontnote retrofit2.Platform
# Platform used when running on Java 8 VMs. Will not be used at runtime.
-dontwarn retrofit2.Platform$Java8
# Retain generic type information for use by reflection by converters and adapters.
-keepattributes Signature
# Retain declared checked exceptions for use by a Proxy instance.
-keepattributes Exceptions

2. 使用

2.1. 创建Retrofit对象

Retrofit retrofit = new Retrofit.Builder()
                 .baseUrl(http://www.baidu.com)
                 .addConverterFactory(GsonConverterFactory.create())
                 .build();

2.2. 创建发送请求的接口

public interface LoginApi{
      @POST("mobile/login")
      Call login(@Body LoginPost post);
}

2.3. 发送http请求

发送请求的方式分同步和异步,同步调用Call的.execute()方法,异步调用Call的.enqueue()方法。

public void get() {
        Retrofit retrofit = new Retrofit.Builder().baseUrl("https://api.baidu.com/").build();
        LoginApi api = retrofit.create(LoginApi.class);

        Call call = api.contributorsBySimpleGetCall(mUserName, mRepo);
        call.enqueue(new Callback() {
            @Override
            public void onResponse(Call call, Response response) {
                //处理请求成功

            }

            @Override
            public void onFailure(Call call, Throwable t) {
                //处理请求失败
            }
        });
    }

3. 注解

Retrofit通过使用注解的方式来简化请求。
注解主要做三种类型的标记:

  • 标记请求方式
  • 标记请求头
  • 标记请求和响应格式
  • 标记请求参数

3.1. 标记请求方式

@GET:get请求
@POST:post请求
@PUT:put请求
@DELETE:delete请求
@HEAD:head请求
@OPTIONS:options请求
@PATCH,对PUT请求的补充,用于更新局部资源
@HTTP,通用注解,三个属性:method , path , hasBody
举个栗子:

@GET("mobile/capture")
Call getCapture(@Query("phone") String phone);

3.2. 标记请求头

@HEADER:添加不固定请求头,会覆盖原有请求头,作为参数。
@HEADERS:添加固定请求头,支持多个

//使用@HEADER参数
@GET("mobile/active")
Call getActive(@Header("token") String token,@Query("id") int activeId);

//使用@Headers添加单个请求头
@Headers("Cache-Control:public,max-age=120")
@GET("mobile/active")
Call getActive(@Query("id") int activeId);

//使用@Headers添加多个请求头
@Headers({
    "User-Agent:android"
    "Cache-Control:public,max-age=120",
    })
@GET("mobile/active")
Call getActive(@Query("id") int activeId);

3.3. 标记请求和响应格式

@FormUrlEncoded:请求发送表单编码数据,每个键值对使用@Field注解
@Multipart:请求发送multipart数据,配合@Part注解使用
@Streaming:响应用字节流的形式返回

3.4. 标记请求参数

@Body:一般用于Post请求发送非表单数据

@POST("mobile/login")
Call login(@Body LoginPost post);

@Field:用于Post请求中表单字段

@POST("mobile/register")
Call registerDevice(@Field("id") String registerid);

@FieldMap:同@Field,用于不确定的表单参数
@Part:用于表单字段,适合文件上传
@PartMap:用于表单字段,适合多文件上传
@Query:指定Get参数
@QueryMap:同@Query
@Path:用于Url的占位符
@Url:指定Url路径

参考资料:

观战Retrofit开发中的哪点事

你可能感兴趣的:(Android第三方のRetrofit)