top.jfunc.http.smart.SmartHttpTemplate Maven / Gradle / Ivy

Go to download
package top.jfunc.http.smart;

import top.jfunc.http.base.ContentCallback;
import top.jfunc.http.component.ContentCallbackCreator;
import top.jfunc.http.request.FormRequest;
import top.jfunc.http.request.HttpRequest;
import top.jfunc.http.request.StringBodyRequest;
import top.jfunc.http.request.UploadRequest;
import top.jfunc.http.response.ClientHttpResponse;
import top.jfunc.http.response.ClientHttpResponseConverter;

import java.io.IOException;

/**
 * @author xiongshiyan at 2019/4/2 , contact me with email [email protected] or phone 15208384257
 */
public interface SmartHttpTemplate {
    /**
     * 封装http请求的一般步骤
     * @param httpRequest 请求参数 {@link HttpRequest}代表一个http请求所有的参数，
     *                    可能是其子类{@link StringBodyRequest}、{@link UploadRequest}、{@link FormRequest}等
     * @param contentCallback 封装对BODY的处理，例如JSON或者文件上传。maybe null if doesn't have body
     * @see ContentCallbackCreator
     * @param clientHttpResponseConverter 对响应{@link ClientHttpResponse}进行进一步处理得到自己想要的
     * @throws IOException IOException
     * @return  转换过后的结果
     */
     R template(HttpRequest httpRequest,
                   ContentCallback contentCallback,
                   ClientHttpResponseConverter clientHttpResponseConverter) throws IOException;
}