Retrofit 简单使用之二
2016-10-10 09:35
197 查看
上一篇简要总结了一下Retrofit的最基本用法,异步GET请求。
先来个小插曲:有很多网上的资料上来一段代码是这样的:
这里解释一下,因为我在初次使用的时候就发现怎么也找不到RestAdapter这个类,就更不用说里面的静态构造器类Builder了。
其实是这样,网上写的这些都是用的Retrofit1.9这个版本。有的可能在资料里没说清楚。
如果你导入的是下面这个,那么是可以按上面这种方式来做的:
下面来一大波干货。(下面都是按照Retrofit2.0来做的,使用1.9的童鞋自行绕道:http://blog.36dr.net/2015/10/31/Retrofit1.9%E5%9F%BA%E6%9C%AC%E4%BD%BF%E7%94%A8/)
一、续上篇。做个小封装吧
然后你需要根据业务需求写你的Service接口,比如
二、几个重要的注解的使用
(一) GET请求中的常用注解
1.@Path - 替换参数注解
2.@Query - 添加查询参数
3.@QueryMap - 查询一个集合
(二)、POST请求中常用的注解
1.@Body - 请求体注解
参数会被指定的转换器转换成字符串或者字节流提交给服务器。如果没有指定转换器,会使用默认的请求体。
2.@FormUrlEncoded - 提交表单数据给服务器
3.@Mutipart - 多种不同类型的参数上传
注意:@Multipart 中的@Part在未指定转换器时使用默认转换器来转换,也可自定义转换方式(需要 implement TypedOutput,具体百度)
这个例子是用在用户修改或者设置账户头像时,这是一个很普通的操作。
另外,网上有提到@Multipart经常用在上传文件的场景下。在这里了解一下:
4.@Header - 指定请求头
三、基本使用
————————————-不怎么华丽的分割线——————————————-
先来个小插曲:有很多网上的资料上来一段代码是这样的:
public class ServiceGenerator { public static final String API_BASE_URL = "your-base-url"; private static RestAdapter.Builder builder = new RestAdapter.Builder() .setEndpoint(API_BASE_URL) .setClient(new OkClient(new OkHttpClient())); public static <S> S createService(Class<S> serviceClass) { RestAdapter adapter = builder.build(); return adapter.create(serviceClass); } }
这里解释一下,因为我在初次使用的时候就发现怎么也找不到RestAdapter这个类,就更不用说里面的静态构造器类Builder了。
其实是这样,网上写的这些都是用的Retrofit1.9这个版本。有的可能在资料里没说清楚。
如果你导入的是下面这个,那么是可以按上面这种方式来做的:
dependencies { // ... compile 'com.squareup.retrofit:retrofit:1.9.0' compile 'com.squareup.okhttp:okhttp:2.7.2' }
下面来一大波干货。(下面都是按照Retrofit2.0来做的,使用1.9的童鞋自行绕道:http://blog.36dr.net/2015/10/31/Retrofit1.9%E5%9F%BA%E6%9C%AC%E4%BD%BF%E7%94%A8/)
一、续上篇。做个小封装吧
public class ServiceGenerator { // URL基本部分 private static String BASE_URL = "your-base-url"; // 初始化一个OkHttpClient对象 private static OkHttpClient.Builder httpClient = new OkHttpClient.Builder(); // 初始化一个Retrofit构造器对象 private static Retrofit.Builder builder = new Retrofit.Builder() .baseUrl(BASE_URL) .addConverterFactory(GsonConverterFactory.create()); /** * 此方法的目的是为了创建你需要的Service * 注意:这个Service并不是真正的继承了android.app.Service的服务 * 只是一般将请求都放到一个叫做Service的类中,你可以自己取名字~~ * 这里的<S> S也没啥讲究,就是表示泛型 * @params serviceClass 表示的是你写了具体的请求的那个类,里面可以写了@GET... */ public static <S> S createService(Class<S> serviceClass) { Retrofit retrofit = builder.client(httpClient.build()).build(); return retrofit.create(serviceClass); } }
然后你需要根据业务需求写你的Service接口,比如
public interface HttpService { @GET("/part/index.php") Call<JavaBean> getJavaBean(); }
二、几个重要的注解的使用
(一) GET请求中的常用注解
1.@Path - 替换参数注解
// 如果你的接口有多个,并且不同的接口只是其中的某个或者若干个参数不同 @GET("/part/index.php/{id}/users") // 注意:@Path的写法,用字符串标记出要替换的部分,指定形式参数与之对应。 List<User> getList(@Path("id") int id);
2.@Query - 添加查询参数
@GET("/part/index.php/{id}/users") // 此时针对的是这样的URL: .../part/index.php/123/users?sort=desc List<User> getList(@Path("id") int id, @Query("sort") String sort);
3.@QueryMap - 查询一个集合
@GET("/part/index.php/{id}/users") // 理解了第2点,第3点就很好理解了。就是查的时候有很多个参数呗 List<User> getList(@Path("id") int id, @QueryMap Map<String, String> options); // 这时候就传键值对就好了 // 最后URL可能的形式是 .../users?sort=desc&group=A&time=456&page=1
(二)、POST请求中常用的注解
1.@Body - 请求体注解
参数会被指定的转换器转换成字符串或者字节流提交给服务器。如果没有指定转换器,会使用默认的请求体。
@POST("/users/new") void createUser(@Body User user, CallBack<User> callBack);
2.@FormUrlEncoded - 提交表单数据给服务器
@FormUrlEncoded @POST("users/edit") User updateUser(@Field("nickName") String nickName, @Field(email) String email);
3.@Mutipart - 多种不同类型的参数上传
@Multipart @PUT("/users/logo") User updateUser(@Part("logo") TypedFile photo, @Part("individualSign") TypedString sign);
注意:@Multipart 中的@Part在未指定转换器时使用默认转换器来转换,也可自定义转换方式(需要 implement TypedOutput,具体百度)
这个例子是用在用户修改或者设置账户头像时,这是一个很普通的操作。
另外,网上有提到@Multipart经常用在上传文件的场景下。在这里了解一下:
//创建接口 interface HttpService { @Multipart @POST("/images") void upload(@Part("file") TypedFile file, Callback<File> callback); } //使用 httpService.upload(new TypedFile("image/jpg",yourFile), new Callback<File>() { @Override public void success(File file, Response response) { } @Override public void failure(RetrofitError error) { } });
4.@Header - 指定请求头
@POST("...") XX getXXX(@Header("Authorization") String authorization);
@Headers("Authorization: authorization") //这里authorization就是上面方法里传进来变量的值 @POST("widget/list") Call<User> getUser()
三、基本使用
// 在需要的时候进行初始化 HttpService mSevice = ServiceGenerator.createService(HttpService.class); // 根据需求调用在HttpService中的请求回调方法 mService.getXXX(arg0, arg1...);
————————————-不怎么华丽的分割线——————————————-
相关文章推荐
- iPhone开发之创建简单界面视图的三种方式之二 使用Xcode4完全手动构建界面
- Play2.1 简单总结之二:Play Framework 的使用
- Retrofit的(get以及post)的简单使用
- retrofit2.0的简单使用
- android快捷开发之Retrofit网络加载框架的简单使用
- Retrofit基本介绍和简单的使用方式
- log4net的简单使用之二_log4net应用
- Linux vim编辑器简单使用之二:vim操作快捷键、小技巧
- 学习笔记——Retrofit2.0的简单使用
- android快捷开发之Retrofit网络加载框架的简单使用
- 使用nRF51822/nRF51422创建一个简单的BLE应用 ---入门实例手册(中文)之二
- Retrofit三步理解之一 ------------------ Retrofit的简单使用总结
- 简单地使用下RxJava + Retrofit
- Retrofit网络通信库简单封装使用
- Retrofit使用一:超简单先用上
- log4net的简单使用之二_log4net应用
- Retrofit2.0.0-beta2简单使用
- Retrofit简单介绍和使用
- Retrofit的简单使用
- retrofit 2.0 简单使用