<dependency>
    <groupId>com.github.vizaizai</groupId>
    <artifactId>easy-http</artifactId>
    <version>4.1.8</version>
</dependency>

public interface BookHttpService {
    @Get("/books/{id}")
    ApiResult<Book> getBookById(@Var("id") String id);
}

BookHttpService bookHttpService = EasyHttp.builder()
                .url("127.0.0.1:8888")
                .build(BookHttpService.class);
ApiResult<Book> bookRet = bookHttpService.getBookById("166895");
System.out.println(bookRet.getData().getName());

@Get("/books/{id}")
ApiResult<Book> getBookById(@Var("id") String id);
@Get("/books?author={author}")
ApiResult<Book> getBookById(@Var("author") String author);

@Get("/books")
ApiResult<List<Book>> listBooksByAuthor1(@Param("author") String author);

// Установлен параметр -parameters
@Get("/books")
ApiResult<List<Book>> listBooksByAuthor2(@Param String author);

@Get("/books")
ApiResult<List<Book>> listBooksByAuthor(@Param Map<String, String> params);

@Get("/books")
ApiResult<List<Book>> listBooksByAuthor(Map<String, String> params);

@Get("/books")
ApiResult<List<Book>> listBooksByIds(@Param("ids") List<String> ids);

@Post("/addBookUseForm")
String test5(@Param Book book); // Тело запроса x-www-form-urlencoded

@POST(value="/addBookUseForm", bodyType = RequestBodyType.NONE) // Указывает отсутствие тела запроса, параметры добавляются к URL
String test5_1(@Param Book book); // Склейка URL, например /addBookUseForm?name=easyhttp&author=lcw

@Post("/books")
void addBook(@Body Book book);

@Post("/addBookUseJSON")
String test6(@Body Book1 book1);

@Post("/addBookUseJSON")
String test6_1(@Body Map<String,Object> book);

@Post("/addBookUseJSON")
String test6_2(@Body String content);


@Post("/addBookUseFormData")
String test8(@Body FormData formData);
// Использование form-data
FormData formData = new FormData();
formData.addText("author","吴承恩");
formData.addText("name","西游记");
formData.addText("lang","chinese");
formData.addFile("files", new File("C:\\Users\\dell\\Desktop\\logo.png"));
formData.addFile("files", new File("C:\\Users\\dell\\Desktop\\Dingtalk_20210317145859.jpg"));
formData.addFile("files", new File("C:\\Users\\dell\\Desktop\\jsd_pro_back.rar"));
paramService.test8(formData);

@Post("/upload/e-book/{id}")
String test9(@Var String id, @Body BodyContent bodyContent);
// Двоичный файл
paramService.test9("123", FileContent.of(new File("C:\\Users\\dell\\Desktop\\jsd_pro_back.rar")));

public class CustomEncoder implements Encoder {
    /**
     * Преобразует объект в Body (если тип параметра является базовым типом, то он напрямую преобразуется в строку). Используется для кодирования объекта с аннотацией @Body (по умолчанию используется кодирование jackson).
     * @param object Объект для кодирования
     * @param bodyType Тип объекта запроса
     * @return Body
     */
    @Override
    public Body encode(Object object, Type bodyType) {
        return null;
    }
}

BookHttpService bookHttpService = EasyHttp.builder()
                                            .url("127.0.0.1:8888")
                                            .encoder(new CustomEncoder())
                                            .build(BookHttpService.class);

public class CustomDecoder implements Decoder {
    /**
     * Расшифровывает ответ (декодирование по умолчанию реализовано с помощью jackson).
     * @param response Ответ
     * @param type Тип возвращаемого значения
     * @return Object
     */
    @Override
    public Object decode(HttpResponse response, Type type) {
        return null;
    }
}

BookHttpService bookHttpService = EasyHttp.builder()
                                        .url("127.0.0.1:8888")
                                        .encoder(new CustomEncoder())
                                        .decoder(new CustomDecoder())
                                        .build(BookHttpService.class);

public class ResultInterceptor implements HttpInterceptor {
    @Override
    public boolean preHandle(HttpRequest request) {
        return true;
    }

    @Override
    public void postHandle(HttpRequest request, HttpResponse response) {
         if (!response.isOk()) {
            throw new EasyHttpException("Запрос ошибочен~");
        }
        if (response.getBody() == null) {
           return;
        }

        try {
            JavaType javaType = mapper.getTypeFactory().constructParametricType(ApiResult.class,
                    mapper.getTypeFactory().constructType(response.getReturnType()));
            ApiResult<Object> bizRet = mapper.readValue(response.getBody().asInputStream(), javaType);

            // 200 — успешное выполнение операции
            if (bizRet.getCode() == 200) {
                if (bizRet.getData() != null) {
                    // Данные используются как возвращаемое значение
                    response.setReturnObject(bizRet.getData());
                    return;
                }
            }
            response.setReturnObject(null);
        }catch (Exception e) {
            throw new EasyHttpException(e);
        }
    }

    @Override
    public int order() {
        return 4;
    }
    @Override
    public List<ExcludePath> excludes() {
        return Arrays.asList(ExcludePath.instance("/books/**", HttpMethod.DELETE, HttpMethod.POST));
    }
}

        BookHttpService bookHttpService = EasyHttp.builder()
                                                    .url("127.0.0.1:8888")
                                                    .encoder(new CustomEncoder())
                                                    .decoder(new CustomDecoder())
                                                    .withInterceptor(new ResultInterceptor())
                                                    .withInterceptor(new TimeInterceptor())
                                                    .build(BookHttpService.class);

EasyHttp.builder()
        .url("127.0.0.1:8888")
        .client(ApacheHttpClient.getInstance())
        .build(BookHttpService.class);

// Интерфейс метода
@Get("/books")
CompletableFuture<ApiResult<List<Book>>> foo();

// Выполнение асинхронного запроса
CompletableFuture<ApiResult<List<Book>>> foo = bookHttpService.foo();
foo.thenAccept(e->System.out.println(e.getData()))
   .thenRun(()->System.out.println("Асинхронный запрос выполнен"));
System.out.println("Асинхронно");
foo.join();

EasyHttp.builder()
        .url("127.0.0.1:8888")
        .client(DefaultURLClient.getInstance())
        .retryable(3,1000,new DefaultRule())
        .build(BookHttpService.class);