【Retrofit】Retrofit原理解析之注解详解篇

最新推荐文章于 2024-06-24 18:08:43 发布
最新推荐文章于 2024-06-24 18:08:43 发布
阅读量948 收藏 4
点赞数 1
分类专栏： Retrofit 文章标签： java Retrofit
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/yuzhangzhen/article/details/109958977
版权

学而不思则罔，思而不学则殆

【Retrofit】Retrofit原理解析之注解详解篇

Retrofit系列文章

【Retrofit】Retrofit原理解析之使用篇
【Retrofit】Retrofit原理解析之原理篇
【Retrofit】Retrofit原理解析之注解详解篇
【Retrofit】Retrofit原理解析之设计模式总结篇

粗略看一下，Retrofit定义了总共20多个注解。
在这里插入图片描述

注解总结

注解作用域功能说明
@GET方法发送GET请求-
@POST方法发送POST请求默认必须带有Body，为空则存在长度为0的正文
@Path方法参数实现path拼接http://localhost:3434/retrofit/user/{username} + fish2 = http://localhost:3434/retrofit/user/fish2
@Query方法参数query拼接http://localhost:3434/retrofit/query + ? + id=2 —> http://localhost:3434/retrofit/query?id=2
@QueryMap方法参数query拼接一次拼接多个
@QueryName方法参数query拼接一次拼接多个
@Header方法参数添加请求头一次添加一个
@HeaderMap方法参数添加请求头一次添加多个
@Headers方法添加请求头一次添加多个
@FormUrlEncoded方法表示当前是表单编码不能和@Multipart共存
@Field方法参数提交一个表单必须和@FormUrlEncoded一起使用，一次添加一个，可以多个参数使用该注解
@FieldMap方法参数提交多个表单必须和@FormUrlEncoded一起使用，一次添加多个，可以多个参数使用该注解
@Body方法参数添加正文信息不能和@FormUrlEncoded 和 @Multipart共存，该方法注解只能存在一个
@Multipart方法表示当前是多部分编码不能和@FormUrlEncoded 共存
@Part方法参数一次添加一个正文part必须和@Multipart一起使用，方法参数可以存在多个
@PartMap方法参数一次添加多个正文part必须和@Multipart一起使用，方法参数可以存在多个

注解使用范例

服务端代码：https://github.com/aJanefish/ZyServer

构建Retrofit

        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl(HttpUrl.get("http://localhost:3434/"))
                .addConverterFactory(Utils.FACTORY)
                .build();

构建Converter.Factory

//Utils 
public class Utils {
    static final Converter.Factory FACTORY =
            new Converter.Factory() {
                @Override
                public @Nullable
                Converter<ResponseBody, ?> responseBodyConverter(Type type, Annotation[] annotations, Retrofit retrofit) {
                    if (type == Blog.class) return new DataAdapter();
                    return null;
                }

                @Override
                public Converter<?, RequestBody> requestBodyConverter(Type type, Annotation[] parameterAnnotations, Annotation[] methodAnnotations, Retrofit retrofit) {
                    System.out.println("type:" + type + " " + Blog.class);
                    System.out.println("type:" + type + " " + Blog.class);
                    if (type == Blog.class) {
                        return new RequestBodyAdapter();
                    }
                    return null;
                }
            };

    static final class RequestBodyAdapter implements Converter<Blog, RequestBody> {
        @Override
        public RequestBody convert(Blog blog) throws IOException {
            StackTraceElement[] stackTrace = Thread.currentThread().getStackTrace();
            for (StackTraceElement stackTraceElement : stackTrace) {
                System.out.println(stackTraceElement);
            }
            return RequestBody.create(null, blog.toString());
        }
    }


    static final class DataAdapter implements Converter<ResponseBody, Blog> {
        @Override
        public Blog convert(ResponseBody responseBody) throws IOException {
            String body = responseBody.string();
            // FIXME: 2020/11/16 数据处理
            return new Blog(body);
        }
    }
}

@GET

@Documented
@Target(METHOD)
@Retention(RUNTIME)
public @interface GET {
  /**
   * A relative or absolute path, or full URL of the endpoint. This value is optional if the first
   * parameter of the method is annotated with {@link Url @Url}.
   *
   * <p>See {@linkplain retrofit2.Retrofit.Builder#baseUrl(HttpUrl) base URL} for details of how
   * this is resolved against a base URL to create the full endpoint URL.
   */
  String value() default "";
}

public interface BlogService {
    @GET("retrofit/all.do")
    Call<Blog> getAll();
 }   
    Call<Blog> call = blogService.getAll();

服务端信息：

GET http://localhost:3434/retrofit/all.do?null HTTP/1.1
Accept-Encoding: gzip
Connection: keep-alive
Host: localhost:3434
User-Agent: okhttp/3.14.9

客户端信息：

Blog{body='{"code":200,"msg":"OK","des":"all.do","data":[{"id":1,"date":"2020-11-15 10:39:13","author":"fish1","title":"retrofit1","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test1"},{"id":2,"date":"2020-11-15 10:39:13","author":"fish2","title":"retrofit2","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test2"},{"id":3,"date":"2020-11-15 10:39:13","author":"fish3","title":"retrofit3","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test3"},{"id":4,"date":"2020-11-15 10:39:13","author":"fish4","title":"retrofit4","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test4"},{"id":5,"date":"2020-11-15 10:39:13","author":"fish5","title":"retrofit5","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test5"},{"id":6,"date":"2020-11-15 10:39:13","author":"fish6","title":"retrofit6","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test6"},{"id":7,"date":"2020-11-15 10:39:13","author":"fish7","title":"retrofit7","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test7"},{"id":8,"date":"2020-11-15 10:39:13","author":"fish8","title":"retrofit8","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test8"},{"id":9,"date":"2020-11-15 10:39:13","author":"fish9","title":"retrofit9","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test9"},{"id":10,"date":"2020-11-15 10:39:13","author":"fish10","title":"retrofit10","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test10"}]}'}

@POST

@Documented
@Target(METHOD)
@Retention(RUNTIME)
public @interface POST {
  /**
   * A relative or absolute path, or full URL of the endpoint. This value is optional if the first
   * parameter of the method is annotated with {@link Url @Url}.
   *
   * <p>See {@linkplain retrofit2.Retrofit.Builder#baseUrl(HttpUrl) base URL} for details of how
   * this is resolved against a base URL to create the full endpoint URL.
   */
  String value() default "";
}

    @POST("retrofit/all.do")
    Call<Blog> postAll();
    
    Call<Blog> call = blogService.postAll();

服务端信息：

POST http://localhost:3434/retrofit/all.do?null HTTP/1.1
Accept-Encoding: gzip
Connection: keep-alive
Content-Length: 0
Host: localhost:3434
User-Agent: okhttp/3.14.9

注意Content-Length: 0 ， 这说明存在正文，只是正文长度为0；这是因为POST默认是有Body的，但是在这个例子中，正文为空，所以框架还是添加了一个长度为0的body.

  Request.Builder get() {
    ...
    RequestBody body = this.body;
    if (body == null) {
      // Try to pull from one of the builders.
      if (formBuilder != null) {
        body = formBuilder.build();
      } else if (multipartBuilder != null) {
        body = multipartBuilder.build();
      } else if (hasBody) {
        // Body is absent, make an empty body.
        body = RequestBody.create(null, new byte[0]);
      }
    }
    ...
    return requestBuilder.url(url).headers(headersBuilder.build()).method(method, body);
  }

客户端信息：

Blog{body='{"code":200,"msg":"OK","des":"all.do","data":[{"id":1,"date":"2020-11-15 10:39:13","author":"fish1","title":"retrofit1","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test1"},{"id":2,"date":"2020-11-15 10:39:13","author":"fish2","title":"retrofit2","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test2"},{"id":3,"date":"2020-11-15 10:39:13","author":"fish3","title":"retrofit3","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test3"},{"id":4,"date":"2020-11-15 10:39:13","author":"fish4","title":"retrofit4","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test4"},{"id":5,"date":"2020-11-15 10:39:13","author":"fish5","title":"retrofit5","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test5"},{"id":6,"date":"2020-11-15 10:39:13","author":"fish6","title":"retrofit6","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test6"},{"id":7,"date":"2020-11-15 10:39:13","author":"fish7","title":"retrofit7","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test7"},{"id":8,"date":"2020-11-15 10:39:13","author":"fish8","title":"retrofit8","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test8"},{"id":9,"date":"2020-11-15 10:39:13","author":"fish9","title":"retrofit9","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test9"},{"id":10,"date":"2020-11-15 10:39:13","author":"fish10","title":"retrofit10","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test10"}]}'}

@Path

@Documented
@Retention(RUNTIME)
@Target(PARAMETER)
public @interface Path {
  String value();

  /**
   * Specifies whether the argument value to the annotated method parameter is already URL encoded.
   */
  boolean encoded() default false;
}

    @GET("retrofit/user/{username}")
    Call<Blog> getByName(@Path("username") String username);
    
    Call<Blog> call = blogService.getByName("fish1");
    Call<Blog> call = blogService.getByName("fish2");

http://localhost:3434/retrofit/user/{username} + fish2 = http://localhost:3434/retrofit/user/fish2

服务端信息：

GET http://localhost:3434/retrofit/user/fish1?null HTTP/1.1
Accept-Encoding: gzip
Connection: keep-alive
Host: localhost:3434
User-Agent: okhttp/3.14.9

GET http://localhost:3434/retrofit/user/fish2?null HTTP/1.1
Accept-Encoding: gzip
Connection: keep-alive
Host: localhost:3434
User-Agent: okhttp/3.14.9

客户端信息：

Blog{body='{"code":200,"msg":"OK","des":"path fish1","data":[{"id":1,"date":"2020-11-15 10:39:13","author":"fish1","title":"retrofit1","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test1"}]}'}
Blog{body='{"code":200,"msg":"OK","des":"path fish2","data":[{"id":2,"date":"2020-11-15 10:39:13","author":"fish2","title":"retrofit2","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test2"}]}'}

@Query

@Documented
@Target(PARAMETER)
@Retention(RUNTIME)
public @interface Query {
  /** The query parameter name. */
  String value();

  /**
   * Specifies whether the parameter {@linkplain #value() name} and value are already URL encoded.
   */
  boolean encoded() default false;
}

    @GET("retrofit/query")
    Call<Blog> query(@Query("id") String id);
    
    Call<Blog> call = blogService.query("2");
    Call<Blog> call = blogService.query("2");
  1. http://localhost:3434/retrofit/query + ? + id=2 —> http://localhost:3434/retrofit/query?id=2
  2. http://localhost:3434/retrofit/query + ? + id=4 —> http://localhost:3434/retrofit/query?id=4

服务端信息：

GET http://localhost:3434/retrofit/query?id=2 HTTP/1.1
Accept-Encoding: gzip
Connection: keep-alive
Host: localhost:3434
User-Agent: okhttp/3.14.9


GET http://localhost:3434/retrofit/query?id=4 HTTP/1.1
Accept-Encoding: gzip
Connection: keep-alive
Host: localhost:3434
User-Agent: okhttp/3.14.9

客户端信息：

Blog{body='{"code":200,"msg":"OK","des":"path fish2","data":{"id":2,"date":"2020-11-15 10:39:13","author":"fish2","title":"retrofit2","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test2"}}'}
Blog{body='{"code":200,"msg":"OK","des":"path fish2","data":{"id":4,"date":"2020-11-15 10:39:13","author":"fish4","title":"retrofit4","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test4"}}'}

@QueryMap

@Documented
@Target(PARAMETER)
@Retention(RUNTIME)
public @interface QueryMap {
  /** Specifies whether parameter names and values are already URL encoded. */
  boolean encoded() default false;
}

    @GET("retrofit/query")
    Call<Blog> queryMap(@QueryMap Map<String, String> map);

            HashMap<String, String> map = new HashMap<>();
            map.put("id", "2");
            map.put("name", "zy");
            map.put("age", "28");
            Call<Blog> call = blogService.queryMap(map);

服务端信息：

GET http://localhost:3434/retrofit/query?name=zy&id=2&age=28 HTTP/1.1
Accept-Encoding: gzip
Connection: keep-alive
Host: localhost:3434
User-Agent: okhttp/3.14.9

客户端信息：

Blog{body='{"code":200,"msg":"OK","des":"path fish2","data":{"id":2,"date":"2020-11-15 10:39:13","author":"fish2","title":"retrofit2","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test2"}}'}

@QueryName

@Documented
@Target(PARAMETER)
@Retention(RUNTIME)
public @interface QueryName {
  /** Specifies whether the parameter is already URL encoded. */
  boolean encoded() default false;
}

    @GET("retrofit/query")
    Call<Blog> queryName(@QueryName List<String> query);

    @GET("retrofit/query")
    Call<Blog> queryName(@QueryName String... query);
    
            List<String> list = new ArrayList<>();
            list.add("id=2");
            list.add("name=zy");
            list.add("age=28");
            list.add("type=list");
            Call<Blog> call1 = blogService.queryName(list);
            Call<Blog> call2 = blogService.queryName("id=2", "name=zy", "age=28", "type=strings");

服务端信息：

GET http://localhost:3434/retrofit/query?id%3D2&name%3Dzy&age%3D28&type%3Dlist HTTP/1.1
Accept-Encoding: gzip
Connection: keep-alive
Host: localhost:3434
User-Agent: okhttp/3.14.9

GET http://localhost:3434/retrofit/query?id%3D2&name%3Dzy&age%3D28&type%3Dstrings HTTP/1.1
Accept-Encoding: gzip
Connection: keep-alive
Host: localhost:3434
User-Agent: okhttp/3.14.9

客户端信息：

Blog{body='{"code":200,"msg":"OK","des":"path fish2"}'}
Blog{body='{"code":200,"msg":"OK","des":"path fish2"}'}

@Header

@Documented
@Retention(RUNTIME)
@Target(PARAMETER)
public @interface Header {
  String value();
}

    @GET("retrofit/query?id=4")
    Call<Blog> header(@Header("NAME-TAG") String zy, @Header("AGE-TAG") String age, @Header("Accept-Language") String lang);

    Call<Blog> call = blogService.header("zy", "28", "zh-CN");

服务端信息：

GET http://localhost:3434/retrofit/query?id=4 HTTP/1.1
AGE-TAG: 28
Accept-Encoding: gzip
Accept-Language: zh-CN
Connection: keep-alive
Host: localhost:3434
NAME-TAG: zy
User-Agent: okhttp/3.14.9

客户端信息：

Blog{body='{"code":200,"msg":"OK","des":"path fish2","data":{"id":4,"date":"2020-11-15 10:39:13","author":"fish4","title":"retrofit4","address":"https://gitee.com/zhangyuwxf/retrofit.git","content":"http test4"}}'}

@HeaderMap

@Documented
@Target(PARAMETER)
@Retention(RUNTIME)
public @interface HeaderMap {}

    @GET("retrofit/query?id=4")
    Call<Blog> headerMap(@HeaderMap Map<String, String> map);
    
            HashMap<String,String> map = new HashMap<>();
            map.put("Accept","ext/plain");
            map.put("Accept-Charset","utf-8");
            map.put("NAME-TAG","zy");
            Call<Blog> call = blogService.headerMap(map);

服务端信息：

GET http://localhost:3434/retrofit/query?id=4 HTTP/1.1
Accept: ext/plain
Accept-Charset: utf-8
Accept-Encoding: gzip
Connection: keep-alive
Host: localhost:3434
NAME-TAG: zy
User-Agent: okhttp/3.14.9

@Headers

@Documented
@Target(METHOD)
@Retention(RUNTIME)
public @interface Headers {
  String[] value();
}

    @GET("retrofit/query?id=4")
    @Headers({"X-Foo: Bar", "X-Ping: Pong", "NAME: zy"})
    Call<Blog> headers();
    
    Call<Blog> call = blogService.headers();

服务端信息：

GET http://localhost:3434/retrofit/query?id=4 HTTP/1.1
Accept-Encoding: gzip
Connection: keep-alive
Host: localhost:3434
NAME: zy
User-Agent: okhttp/3.14.9
X-Foo: Bar
X-Ping: Pong

@FormUrlEncoded + @Field

@Documented
@Target(METHOD)
@Retention(RUNTIME)
public @interface FormUrlEncoded {}

@Documented
@Target(PARAMETER)
@Retention(RUNTIME)
public @interface Field {
  String value();

  /** Specifies whether the {@linkplain #value() name} and value are already URL encoded. */
  boolean encoded() default false;
}

    @POST("retrofit/login")
    @FormUrlEncoded
    Call<Blog> login(@Field("username") String username, @Field("password") String password, @Field("tag") String tag);

    Call<Blog> call = blogService.login("zhangyu", "123456", "tag+" + System.currentTimeMillis());

服务端信息：

POST http://localhost:3434/retrofit/login?null HTTP/1.1
Accept-Encoding: gzip
Connection: keep-alive
Content-Length: 56
Content-Type: application/x-www-form-urlencoded
Host: localhost:3434
User-Agent: okhttp/3.14.9

username=zhangyu&password=123456&tag=tag%2B1606047792882

@FormUrlEncoded + @FieldMap

@Documented
@Target(PARAMETER)
@Retention(RUNTIME)
public @interface FieldMap {
  /** Specifies whether the names and values are already URL encoded. */
  boolean encoded() default false;
}


    @POST("retrofit/login")
    @FormUrlEncoded
    Call<Blog> fieldMap(@FieldMap Map<String, String> map);
    
            HashMap<String, String> map = new HashMap<>();
            map.put("id", "2");
            map.put("name", "zy");
            map.put("age", "28");
            Call<Blog> call = blogService.fieldMap(map);

服务端信息：

POST http://localhost:3434/retrofit/login?null HTTP/1.1
Accept-Encoding: gzip
Connection: keep-alive
Content-Length: 19
Content-Type: application/x-www-form-urlencoded
Host: localhost:3434
User-Agent: okhttp/3.14.9

name=zy&id=2&age=28

@Body

@Documented
@Target(PARAMETER)
@Retention(RUNTIME)
public @interface Body {}

    @POST("retrofit/add")
    Call<Blog> addBlog(@Body Blog blog);
    
    Call<Blog> call = blogService.addBlog(new Blog("I am clint Blog!"));

服务端信息：

POST http://localhost:3434/retrofit/add?null HTTP/1.1
Accept-Encoding: gzip
Connection: keep-alive
Content-Length: 29
Host: localhost:3434
User-Agent: okhttp/3.14.9

Blog{body='I am clint Blog!'}

@Multipart + @Part

@Documented
@Target(PARAMETER)
@Retention(RUNTIME)
public @interface Part {
  /**
   * The name of the part. Required for all parameter types except {@link
   * okhttp3.MultipartBody.Part}.
   */
  String value() default "";
  /** The {@code Content-Transfer-Encoding} of this part. */
  String encoding() default "binary";
}

    @Multipart
    @POST("retrofit/register")
    Call<Blog> registerUser(@Part MultipartBody.Part part, @Part("username") RequestBody username, @Part("password") RequestBody password);
 
            File file = new File("samples/build.gradle");
            RequestBody photoRequestBody = RequestBody.create(MediaType.parse("text/plain"), file);
            MultipartBody.Part photo = MultipartBody.Part.createFormData("fileName", "build.gradle", photoRequestBody);

            Call<Blog> call = blogService.registerUser(photo, RequestBody.create(null, "abc"), RequestBody.create(null, "123"));

服务端信息：

POST http://localhost:3434/retrofit/register?null HTTP/1.1
Accept-Encoding: gzip
Connection: keep-alive
Content-Length: 1002
Content-Type: multipart/form-data; boundary=f39f975d-5f5f-4d74-83e6-f7f8947ce749
Host: localhost:3434
User-Agent: okhttp/3.14.9

--f39f975d-5f5f-4d74-83e6-f7f8947ce749
Content-Disposition: form-data; name="fileName"; filename="build.gradle"
Content-Type: text/plain
Content-Length: 495

apply plugin: 'java-library'

dependencies {
  implementation project(':retrofit')
  implementation project(':retrofit-mock')
  implementation project(':retrofit-converters:moshi')
  implementation project(':retrofit-converters:gson')
  implementation project(':retrofit-converters:simplexml')
  implementation project(':retrofit-adapters:rxjava')
  implementation deps.mockwebserver
  implementation deps.guava
  implementation deps.jsoup
  compileOnly deps.findBugsAnnotations
}

--f39f975d-5f5f-4d74-83e6-f7f8947ce749
Content-Disposition: form-data; name="username"
Content-Transfer-Encoding: binary
Content-Length: 3

abc
--f39f975d-5f5f-4d74-83e6-f7f8947ce749
Content-Disposition: form-data; name="password"
Content-Transfer-Encoding: binary
Content-Length: 3

123
--f39f975d-5f5f-4d74-83e6-f7f8947ce749--

----------------------------------------------

@Multipart + @PartMap

@Documented
@Target(PARAMETER)
@Retention(RUNTIME)
public @interface PartMap {
  /** The {@code Content-Transfer-Encoding} of the parts. */
  String encoding() default "binary";
}

    @Multipart
    @POST("retrofit/register")
    Call<Blog> registerUser(@PartMap Map<String, RequestBody> params);


            RequestBody requestBody1 = RequestBody.create(MediaType.parse("text/plain"), new File("samples/build.gradle"));
            RequestBody requestBody2 = RequestBody.create(MediaType.parse("text/plain"), new File("samples/src/main/java/com/example/test/PartMapTest.java"));
            
            HashMap<String, RequestBody> hashMap = new HashMap<>();
            hashMap.put("part1", requestBody1);
            hashMap.put("part2", requestBody2);
            hashMap.put("part3", RequestBody.create(null, "zy"));
            Call<Blog> call = blogService.registerUser(hashMap);

服务端信息：

POST http://localhost:3434/retrofit/register?null HTTP/1.1
Accept-Encoding: gzip
Connection: keep-alive
Content-Length: 2616
Content-Type: multipart/form-data; boundary=95335199-4456-48d3-b076-eadfdfe4a9c5
Host: localhost:3434
User-Agent: okhttp/3.14.9

--95335199-4456-48d3-b076-eadfdfe4a9c5
Content-Disposition: form-data; name="part1"
Content-Transfer-Encoding: binary
Content-Type: text/plain
Content-Length: 495

apply plugin: 'java-library'

dependencies {
  implementation project(':retrofit')
  implementation project(':retrofit-mock')
  implementation project(':retrofit-converters:moshi')
  implementation project(':retrofit-converters:gson')
  implementation project(':retrofit-converters:simplexml')
  implementation project(':retrofit-adapters:rxjava')
  implementation deps.mockwebserver
  implementation deps.guava
  implementation deps.jsoup
  compileOnly deps.findBugsAnnotations
}

--95335199-4456-48d3-b076-eadfdfe4a9c5
Content-Disposition: form-data; name="part2"
Content-Transfer-Encoding: binary
Content-Type: text/plain
Content-Length: 1588

package com.example.test;

import okhttp3.*;
import retrofit2.Call;
import retrofit2.Converter;
import retrofit2.Response;
import retrofit2.Retrofit;
import retrofit2.http.*;

import javax.annotation.Nullable;
import java.io.File;
import java.io.IOException;
import java.lang.annotation.Annotation;
import java.lang.reflect.Type;
import java.util.HashMap;
import java.util.Map;

public class PartMapTest {


    public static void main(String[] args) {

        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl(HttpUrl.get("http://localhost:3434/"))
                .addConverterFactory(Utils.FACTORY)
                .build();

        BlogService blogService = retrofit.create(BlogService.class);
        try {

            RequestBody requestBody1 = RequestBody.create(MediaType.parse("text/plain"), new File("samples/build.gradle"));
            RequestBody requestBody2 = RequestBody.create(MediaType.parse("text/plain"), new File("samples/src/main/java/com/example/test/PartMapTest.java"));

            HashMap<String, RequestBody> hashMap = new HashMap<>();
            hashMap.put("part1", requestBody1);
            hashMap.put("part2", requestBody2);
            hashMap.put("part3", RequestBody.create(null, "zy"));
            Call<Blog> call = blogService.registerUser(hashMap);

            Response<Blog> response = call.execute();
            Blog blog = response.body();
            System.out.println(blog);
        } catch (IOException e) {
            //e.printStackTrace();
        }


    }


}

--95335199-4456-48d3-b076-eadfdfe4a9c5
Content-Disposition: form-data; name="part3"
Content-Transfer-Encoding: binary
Content-Length: 2

zy
--95335199-4456-48d3-b076-eadfdfe4a9c5--
珍心
关注
  • 1
    点赞
  • 踩
  • 4
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
retrofit应用详解与源码解析--注解详解
门心叼龙的专栏
07-29 664
本文出自门心叼龙的博客，属于原创类容，转载请注明出处。 文章目录方法注解参数注解其他注解01.用户登录：单个查询参数设置【@GET+@Query】02.用户注册：请求体JSON对象设置【@POST+@Body】03.用户登录：多个查询参数设置【@GET+@QueryMap】04.用户登录：单个表单参数设置【@POST+@FormURLEncoded+@Field】05.用户登录：多个表单参数设置【@POST+@FormURLEncoded+@FieldMap】06.查询用户：动态的URL变参设置【@GE.
Retrofit常见注解全解析
09-06 754
​导语Android开发圈中这三者Retrofit+RxJava+MVP结合使用的频率已经相当高了，很多圈内大神也已经总结了很多有关于整合这三者的博客，已经很多了，今天写这篇文章主要就不再介绍了。不过很多人并不了解Retrofit的全部注解使用，今天的重点就是要介绍日常常用的Retrofit的注解。1、什么是Retrofit?Retrofit 是一个Square开发的安卓客户端请求库。其中内部封装了
Retrofit各个注解的含义及作用
热门推荐
qiang_xi的专栏
12-31 3万+
写在前面本篇文章基于retrofit-2.1进行分析.1. 各个注解的含义及使用1.1 Body注解: 作用于方法的参数 使用该注解定义的参数不可为null 当你发送一个post或put请求,但是又不想作为请求参数或表单的方式发送请求时,使用该注解定义的参数可以直接传入一个实体类,retrofit会通过convert把该实体序列化并将序列化后的结果直接作为请求体发送出去. 示例: //实体
Retrofit原理和常用注解
最新发布
m0_46268254的博客
06-24 1603
Retrofit 面试
Retrofit中的注解
Rssqzqyp的博客
11-30 878
参数method：使用http注解时必须要指定method，method如果是POST就会执行http方法执行post请求，method如果指定GET就会执行http方法执行get请求。@path注解作用于参数部分，意思是{id}里面是id会被@path中的id替换掉替换成参数path。可以看到请求的url是http://www.httpbin.org/post,使用的是post请求。@url注解作用于参数中，作用是指定完整的http地址，不像之前的注解还要自己进行拼接。@Header是用来设置请求头的。
Retrofit常见注解 最详细解析
冯旭的博客
03-20 2615
Android开发圈中这三者Retrofit+RxJava+MVP结合使用的频率已经相当高了，很多圈内大神也已经总结了很多有关于整合这三者的博客，已经很多了，今天写这篇文章主要就不再介绍了。不过很多人并不了解Retrofit的全部注解使用，今天的重点就是要介绍日常常用的Retrofit的注解。 1、什么是Retrofit? Retrofit 是一个Square开发的安卓客户端请求库。其中内部封...
Retrofit 注解最全使用讲解
Code Issuer的博客
11-29 913
method annotation 方法注解@GET @POST @Multipart @FormUrlEncoded @Headers (@PUT/@DELETE/@PATCH/@HEAD 不经常使用所以省略） @Get ① 不可以搭配 @FormUrlEncoded 和 @Multipart ②可以搭配@Headers @POST ① @FormUrlEncoded (普通表单上传) / @P
Retrofit-原理全解析
qq_21349039的博客
07-05 2468
Retrofit是一个RESTful的Http网络请求框架的封装，网络请求部分本质是由OKHttp完成的而我们学习Retrofit除了对Http请求有进一步的了解之外，我们还能通过学习Retrofit 源码感受到面向对象特性运用的极致与合理运用设计模式带来的代码优雅。本篇内容我是面向已经会用Retrofit的开发者写的，不会再重复介绍Retrofit用法，如果还不会使用Retrofit我建议先去看看官方文档后再来学习本文章，那么事不宜迟，我们开始吧！本文将会从源码角度，讲述Retrofit从初始化，到最后请
Retrofit详解
11-10
本文将深入解析Retrofit的核心概念、工作原理以及如何在实际项目中进行集成和使用。 一、Retrofit核心概念 1. **接口定义**：在Retrofit中，我们首先定义一个服务接口，这个接口包含了所有可能的HTTP操作方法（GET...
Kotlin + Retrofit + RxJava简单封装使用详解
08-27
Kotlin + Retrofit + RxJava简单封装使用详解 本文主要介绍了使用Kotlin、Retrofit和RxJava实现简单的网络请求封装，包括Retrofit的配置、OkHttp的使用、错误处理机制等。 Retrofit的配置 Retrofit是Square公司...
Android进阶之路 - Retrofit注解全析
Android、前端、小程序、后端
03-25 1590
我还记得2017年的时候就已经有同事慢慢开始使用Retrofit网络框架了，在2018年的时候也是同事封装好我直接使用的，索性2020年的时候自己写新项目，借着这个机会巩固封装了一波，只是时隔几个月才来记录，起初久久无法落笔，因为想写的有点多，最终决定分为几个部分进行记录 ~.........
Retrofit 常用注解及其解释
qq_45490395的博客
09-14 609
1.需要掌握的注解字段 Get Post Url Query QueryMap Field FieldMap Path Body Part MulltiPart Header Headers FormUrlEncode retrofit的简单实现： 依赖： implementation ‘com.squareup.retrofit2:retrofit:2.5.0’ implementation ‘com.squareup.retrofit2:converter-gson:2.1.0’ 1 2 权限： Re
Retrofit原理分析
xiao_nian的博客
02-21 1万+
一、Retrofit简介 Retrofit是现下Android端开发非常流行的一款网络请求框架，它通过动态代理的方式将Java接口翻译成网络请求，通过OkHttp发送请求，并且其具备强大的可扩展性，支持各种数据格式的转换以及RxJava。说到这里，我们来分析一下网络请求框架的本质，网络请求框架是一套提供给开发者使用的用于网络请求的API接口，我们知道，Android网络请求一般是基于Http协议...
Retrofit 原理篇
augfun的博客
04-01 4335
1、Retrofit 实现原理 Retrofit 通过 java 接口以及注解来描述网络请求，并用动态代理的方式生成网络请求的 request，然后通过 client 调用相应的网络框架（默认 okhttp）去发起网络请求，并将返回的 response 通过 converterFactorty 转换成相应的数据 model，最后通过 calladapter 转换成其他数据方式（如 rxjava Observable） 通过 Retrofit. create( ciass)方法创建出 Service in
Retrofit原理解析（一）
故不积跬步无以至千里
08-30 2278
Retrofit是一个restful的HTTP网络请求框架的封装；那为什么起名叫Retrofit呢？Retrofit翻译为中文，意为改造、翻新之意，Retrofit网络请求的本质是交给内部的OkHttp来完成的，自身只负责网络请求接口的封装，这样一想，名字起的真是十级👍；我们先简单看下RetrofitAPP应用端通过Retrofit请求网络，实际上是使用Retrofit接口层封装请求参数，如Header、Url等信息，之后交给OkHttp完成后续的请求；当服务端返回请求数据后，OkHttp。......
Retrofit中的注解原理项目实战
bugyinyin的博客
12-05 872
今天我们来聊聊这个最近很火的网络请求库retrofit，在此基础上会延伸出一些列的知识点。现在关于retrofit的文章很多，我之所以写这篇文章的原因在于：8月份负责假设新客户端底层的过程中首次尝试使用该库，并取得非常不错的效果，不到20天的时间内实现新产品的快速开发。 另外因为个人的原因，在写完基础框架及发布两个基础版本之后，我也选择的离职。现在，留给自己10天的时间，用来对2016年做个简短的总结，也希望能帮助各位。首先简单的说说会总结哪方面的，觉得感兴趣的同学可以关注下： 网络请求及优化，以retr
Android中Retrofit常见注解全解析
tanghongchang123的博客
04-12 1022
1、什么是Retrofit?Retrofit 是一个Square开发的安卓客户端请求库。其中内部封装了okhttp库。官方的介绍是使用非常简短 Retrofit使用注解,能够极大的简化网络请求数据的代码。Retrofit常用注解包括：@Query，@QueryMap，@Field，@FieldMap，@FormUrlEncoded，@Path，@Url2、@Query，@QueryMap@Quer...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值