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

最新推荐文章于 2025-06-20 00:21:46 发布
原创 最新推荐文章于 2025-06-20 00:21:46 发布 · 1.2k 阅读 · 4 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
收录于
Retrofit

当前文章被收录于：

Retrofit
3 篇文章 0 人学习
订阅专栏 查看详情

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

【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--
标签
#java #Retrofit
Android进阶之路 - Retrofit注解全析
Android、前端、小程序、后端
03-25 1970
我还记得2017年的时候就已经有同事慢慢开始使用Retrofit网络框架了，在2018年的时候也是同事封装好我直接使用的，索性2020年的时候自己写新项目，借着这个机会巩固封装了一波，只是时隔几个月才来记录，起初久久无法落笔，因为想写的有点多，最终决定分为几个部分进行记录 ~.........
retrofit应用详解与源码解析--注解详解
门心叼龙的专栏
07-29 1045
本文出自门心叼龙的博客，属于原创类容，转载请注明出处。 文章目录方法注解参数注解其他注解01.用户登录：单个查询参数设置【@GET+@Query】02.用户注册：请求体JSON对象设置【@POST+@Body】03.用户登录：多个查询参数设置【@GET+@QueryMap】04.用户登录：单个表单参数设置【@POST+@FormURLEncoded+@Field】05.用户登录：多个表单参数设置【@POST+@FormURLEncoded+@FieldMap】06.查询用户：动态的URL变参设置【@GE.
Retrofit常见注解 最详细解析
冯旭的博客
03-20 2849
Android开发圈中这三者Retrofit+RxJava+MVP结合使用的频率已经相当高了，很多圈内大神也已经总结了很多有关于整合这三者的博客，已经很多了，今天写这篇文章主要就不再介绍了。不过很多人并不了解Retrofit的全部注解使用，今天的重点就是要介绍日常常用的Retrofit的注解。 1、什么是Retrofit? Retrofit 是一个Square开发的安卓客户端请求库。其中内部封...
Retrofit中的注解
Rssqzqyp的博客
11-30 1355
参数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各个注解的含义及作用
qiang_xi的专栏
12-31 3万+
写在前面本篇文章基于retrofit-2.1进行分析.1. 各个注解的含义及使用1.1 Body注解: 作用于方法的参数 使用该注解定义的参数不可为null 当你发送一个post或put请求,但是又不想作为请求参数或表单的方式发送请求时,使用该注解定义的参数可以直接传入一个实体类,retrofit会通过convert把该实体序列化并将序列化后的结果直接作为请求体发送出去. 示例: //实体
Retrofit详解
热门推荐
qq_30621333的博客
04-07 3万+
一：Retrofit是什么？ 准确来说，Retrofit 是一个 RESTful 的 HTTP 网络请求框架的封装。 原因：网络请求的工作本质上是 OkHttp 完成，而 Retrofit 仅负责 网络请求接口的封装 我们先来看看下面这个图： 上图说明了如下几点： 1. App应用程序通过 Retrofit 请求网络，实际上是使用 Retrofit 接口层封装请求参数、Header、Url 等信息，之 后由 OkHttp 完成后续的请求操作。 2. 在服务端返回数据之后，OkHttp 将原始的结果交给
Retrofit原理和常用注解
m0_46268254的博客
06-24 2045
Retrofit 面试
【Retrofit】Retrofit原理解析之原理篇
珍心
11-22 720
学而不思则罔，思而不学则殆 【Retrofit】Retrofit原理解析之原理篇引言整体流程 系列文章 【Retrofit】Retrofit原理解析之使用篇 【Retrofit】Retrofit原理解析之原理篇 引言 在上一篇文章中，分享讲了Retrofit框架的常见使用范例，本篇分享来说一下Retrofit的的原理 整体流程 整体流程 新建Retrofit实例，通过构建者模式设置一些参数工厂（用来数据封装+数据解析） 调用Retrofit.create(),方法拿到自定义服务的实例 调用服务的具体
展开说说Android之Retrofit详解_源码解析
最新发布
Hidanchaofan的博客
06-20 1022
本文主要从六个方面分析了Retrofit源码实现：首先介绍了Retrofit的核心类和接口，包括Retrofit类、ServiceMethod类等；接着解析了@GET、@POST等注解的作用；然后通过OkHttpCall类揭示了Retrofit封装OkHttp的实现；解释了Retrofit异步请求能在主线程返回的原理；梳理了请求的完整流程；最后总结了Retrofit的优缺点。文章详细呈现了Retrofit从注解解析到最终请求实现的完整机制，特别是通过动态代理和线程切换的实现细节
Android网络编程（十）Retrofit2后篇[注解]
Android进阶三部曲 - 刘望舒
11-02 6392
在上一篇中我们了解了Retrofit的最基本的GET方式访问网络的写法以及请求参数的简单介绍。这一篇我们来详细的了解Retrofit的请求参数。
Retrofit2的使用及注解分析
ezconn的博客
10-26 4959
Retrofit简介 Retrofit是Square公司出品的网络请求封装库，注意是封装框架，不是网络请求框架；Retrofit底层网络请求是通过OKHttp实现的，Retrofit只是在此基础上做了很好的封装，使其更好用，更方便，更强大，而且能很多开源库（比如：GSON,Rxjava）配合使用；把网络请求通过注解封装成一个接口； 官网地址 https://github.com/square...
Retrofit 注解参数详解
赵彦军
10-28 1869
文章目录GET@Path@Query@QueryMapPOST@Bodyform表单1：@FormUrlEncodedform表单2：FormBody@Multipart上传文件 对Retrofit已经使用了一点时间了，是时候归纳一下各种网络请求的service了。 下面分为GET、POST、DELETE还有PUT的请求，说明@Path、@Query、@QueryMap、@Body、@Field的用法。 添加依赖 implementation 'com.squareup.retrofit2:retrofit
Retrofit 中的注解以及如何自定义接口方法注解
wangjiang
07-10 4744
前言 Retrofit 是一个网络请求框架，它在Android领域已经被使用很长一段时间了。我们知道它的特点就是用注解来描述 HTTP 请求： 支持 URL 参数替换和查询参数 将对象转换为请求主体（例如，JSON、协议缓冲区） 多部分请求正文和文件上传 这些注解主要用来标识接口方法和接口方法参数，并预示着一个请求将会被如何处理。 ...
Retrofit中的注解原理项目实战
bugyinyin的博客
12-05 1283
今天我们来聊聊这个最近很火的网络请求库retrofit，在此基础上会延伸出一些列的知识点。现在关于retrofit的文章很多，我之所以写这篇文章的原因在于：8月份负责假设新客户端底层的过程中首次尝试使用该库，并取得非常不错的效果，不到20天的时间内实现新产品的快速开发。 另外因为个人的原因，在写完基础框架及发布两个基础版本之后，我也选择的离职。现在，留给自己10天的时间，用来对2016年做个简短的总结，也希望能帮助各位。首先简单的说说会总结哪方面的，觉得感兴趣的同学可以关注下： 网络请求及优化，以retr
Retrofit常见注解全解析
09-06 1052
​导语Android开发圈中这三者Retrofit+RxJava+MVP结合使用的频率已经相当高了，很多圈内大神也已经总结了很多有关于整合这三者的博客，已经很多了，今天写这篇文章主要就不再介绍了。不过很多人并不了解Retrofit的全部注解使用，今天的重点就是要介绍日常常用的Retrofit的注解。1、什么是Retrofit?Retrofit 是一个Square开发的安卓客户端请求库。其中内部封装了
Android Retrofit 框架注解定义与解析模块深度剖析(一)
Android开发领域创作者
03-11 1300
定义服务接口：开发者使用注解定义一个接口，该接口包含了各种 HTTP 请求方法。创建 Retrofit 实例：通过构建 Retrofit 实例，配置请求的基础 URL、转换器工厂、调用适配器工厂等。创建服务代理对象：使用 Retrofit 实例创建服务接口的代理对象。发起请求：调用服务代理对象的方法发起 HTTP 请求，并处理响应结果。@GETRetrofit 的注解定义与解析模块是其核心功能之一，通过使用注解，开发者可以以一种简洁、声明式的方式定义 HTTP 请求。
【Retrofit】Retrofit原理解析之设计模式总结篇
珍心
11-22 449
学而不思则罔，思而不学则殆 【Retrofit】Retrofit原理解析之设计模式总结篇
Retrofit的使用及原理详解
java521666的博客
08-04 1367
retrofit—>建造者—>create(动态代理)—>getPersonInfo接口（注解解析+URL拼接）到invoke方法中—>call.enqueue(丢给okHttp，realCall—>AsyncCall内部类，切到子线程)—> ExecutorCallAdapterFactory中返回数据的enqueue()方法（切回主线程callbackExecutor.execute()）...
Retrofit 原理解析
男儿不展风云志，空有天生八尺躯
06-28 831
* Retrofit adapts a Java interface to HTTP calls by using annotations on the declared methods to * define how requests are made. Create instances using {@linkplain Builder * the builder} and pass your interface to {@link #create} to generate an implemen.
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值