使用spring的RestTemplate發(fā)送HTTP請求

在一個(gè)spring-boot項(xiàng)目中窗轩,需要請求第三方API苹丸,使用JDK原生的URLConnection過于繁瑣检痰,功能強(qiáng)大的Apache.HttpClient又需要額外引入县爬,導(dǎo)致微服務(wù)程序變大蔑担。搜索發(fā)現(xiàn)spring原生的RestTemplate已經(jīng)內(nèi)置到了spring-boot-starter-web笋庄,可以開箱即用滑负,所以實(shí)現(xiàn)了一個(gè)基于RestTemplate的工具類充包,如下

WebHelper

import org.apache.commons.lang.IllegalClassException;
import org.apache.http.impl.client.HttpClients;
import org.springframework.http.*;
import org.springframework.http.client.SimpleClientHttpRequestFactory;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.http.converter.StringHttpMessageConverter;
import org.springframework.lang.NonNull;
import org.springframework.lang.Nullable;
import org.springframework.web.client.RestTemplate;

import javax.net.ssl.HttpsURLConnection;
import javax.net.ssl.SSLContext;
import javax.net.ssl.TrustManager;
import javax.net.ssl.X509TrustManager;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
import java.net.HttpURLConnection;
import java.nio.charset.StandardCharsets;
import java.security.cert.X509Certificate;
import java.util.List;
import java.util.Map;

/**
 * @author frank
 * @date 2020-07-31 15:34
 */
public class WebHelper {

    private static final String[] IP_HEADER_CANDIDATES = {
            "X-Forwarded-For",
            "Proxy-Client-IP",
            "WL-Proxy-Client-IP",
            "HTTP_X_FORWARDED_FOR",
            "HTTP_X_FORWARDED",
            "HTTP_X_CLUSTER_CLIENT_IP",
            "HTTP_CLIENT_IP",
            "HTTP_FORWARDED_FOR",
            "HTTP_FORWARDED",
            "HTTP_VIA",
            "REMOTE_ADDR"
    };

    /**
     * 獲取客戶端 IP 地址
     *
     * @param request 請求實(shí)例
     * @return 客戶端 IP
     */
    public static @Nullable
    String getClientIpAddress(HttpServletRequest request) {
        for (String header : IP_HEADER_CANDIDATES) {
            String ip = request.getHeader(header);
            if (ip != null && ip.length() != 0 && !"unknown".equalsIgnoreCase(ip)) {
                return ip;
            }
        }
        return request.getRemoteAddr();
    }

    /**
     * 發(fā)送 HTTPS.GET 請求
     *
     * @param url     請求地址
     * @param params  請求參數(shù)
     * @param headers 請求頭
     * @return 響應(yīng)實(shí)體挑格,可能需要對響應(yīng)結(jié)果的狀態(tài)碼進(jìn)行處理斤蔓,所以直接返回響應(yīng)實(shí)體
     */
    public static ResponseEntity<String> sendGet(String url, Map<String, String> params, Map<String, String> headers) {
        return sendRequest(url, params, null, headers, HttpMethod.GET, Boolean.TRUE);
    }

    /**
     * 發(fā)送 HTTPS.POST 請求
     *
     * @param url     請求地址
     * @param body    請求體
     * @param headers 請求頭
     * @return 響應(yīng)實(shí)體令花,可能需要對響應(yīng)結(jié)果的狀態(tài)碼進(jìn)行處理锦担,所以直接返回響應(yīng)實(shí)體
     */
    public static ResponseEntity<String> sendPost(String url, String body, Map<String, String> headers) {
        HttpClients.createDefault();
        return sendRequest(url, null, body, headers, HttpMethod.POST, Boolean.TRUE);
    }

    /**
     * 使用 springboot 內(nèi)置的 RestTemplate 發(fā)送 http 請求
     *
     * @param url     請求地址
     * @param params  請求參數(shù)
     * @param body    請求體
     * @param headers 請求頭
     * @param method  請求方法
     * @param useSSL  是否使用安全套接字
     * @return 響應(yīng)實(shí)體俭识,可能需要對響應(yīng)結(jié)果的狀態(tài)碼進(jìn)行處理,所以直接返回響應(yīng)實(shí)體
     */
    public static ResponseEntity<String> sendRequest(String url, Map<String, String> params, String body,
                                                     Map<String, String> headers, HttpMethod method, boolean useSSL) {
        RestTemplate rt = useSSL
                ? new RestTemplate(new HttpsClientRequestFactory())
                : new RestTemplate();

        // 字符編碼設(shè)為 UTF-8
        List<HttpMessageConverter<?>> converters = rt.getMessageConverters();
        converters.set(1, new StringHttpMessageConverter(StandardCharsets.UTF_8));
        rt.setMessageConverters(converters);

        HttpHeaders httpHeaders = new HttpHeaders();
        if (!MapHelper.isEmpty(headers)) {
            httpHeaders.setAll(headers);
        }

        HttpEntity<String> httpEntity = new HttpEntity<>(body, httpHeaders);
        if (!MapHelper.isEmpty(params)) {
            url = StringHelper.append(url, "?", MapHelper.toUrl(params, "UTF-8"));
        }

        return rt.exchange(url, method, httpEntity, String.class);
    }

    /**
     * 覆蓋 SimpleClientHttpRequestFactory 的安全套接字層SSL
     */
    public static class HttpsClientRequestFactory extends SimpleClientHttpRequestFactory {
        @Override
        protected void prepareConnection(@NonNull HttpURLConnection connection, @NonNull String httpMethod) throws IOException {

            // to https connection
            if (!(connection instanceof HttpsURLConnection)) {
                throw new IllegalClassException("An instance of HttpsURLConnection is expected");
            }
            HttpsURLConnection httpsConnection = (HttpsURLConnection) connection;

            ExceptionExecutor.withTry(() -> {

                // new empty X509TrustManager
                TrustManager[] trustAllCerts = new TrustManager[]{
                        new X509TrustManager() {
                            @Override
                            public java.security.cert.X509Certificate[] getAcceptedIssuers() {
                                return null;
                            }

                            @Override
                            public void checkClientTrusted(X509Certificate[] certs, String authType) {
                            }

                            @Override
                            public void checkServerTrusted(X509Certificate[] certs, String authType) {
                            }
                        }
                };
                SSLContext sslContext = SSLContext.getInstance("SSL");
                sslContext.init(null, trustAllCerts, new java.security.SecureRandom());

                // set to connection
                httpsConnection.setSSLSocketFactory(sslContext.getSocketFactory());
                httpsConnection.setHostnameVerifier((s, sslSession) -> true);
                return null;
            });

            super.prepareConnection(httpsConnection, httpMethod);
        }
    }

}
MapHelper

import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
import java.util.Map;
import java.util.stream.Collectors;

public class MapHelper {
    /**
     * 根據(jù)指定字符集完成 URL 編碼洞渔,構(gòu)造 URL 參數(shù)字符串
     *
     * @param map     {@code {"name":"frank", "gender":"male"}}
     * @param charset URLEncode 使用的字符集
     * @return name=frank&gender=male
     */
    public static <K, V> String toUrl(Map<K, V> map, String charset) {
        return map.entrySet().stream()
                .map(e -> {
                    K k = e.getKey();
                    String val = "";
                    try {
                        URLEncoder.encode(StringHelper.toStr(e.getValue()), charset);
                    } catch (UnsupportedEncodingException ex) {
                        ex.printStackTrace();
                    }
                    return StringHelper.join("=", k, val);
                })
                .collect(Collectors.joining("&"));
    }
}
StringHelper

import java.util.Arrays;
import java.util.Objects;
import java.util.stream.Collectors;

public class StringHelper {

    private static final String EMPTY = "";

    /**
     * 以字符串形式拼接多個(gè)參數(shù)
     *
     * @param params 如果整個(gè)數(shù)組為空套媚,返回空串;如果其中值為空磁椒,將轉(zhuǎn)為空串
     */
    public static String append(Object... params) {
        return join(EMPTY, params);
    }

    /**
     * 以字符串形式拼接多個(gè)參數(shù)堤瘤,以指定字符串分隔
     *
     * @param separator 分隔參數(shù)的字符串
     * @param params    如果整個(gè)數(shù)組為空,返回空串浆熔;如果其中值為空本辐,將轉(zhuǎn)為空串
     */
    public static String join(String separator, Object... params) {
        if (params == null || params.length == 0) {
            return EMPTY;
        }
        return Arrays.stream(params)
                .map(StringHelper::toStr)
                .collect(Collectors.joining(separator));
    }

    /**
     * Object 轉(zhuǎn) String,如果為 null 時(shí)返回值為空串而不是 "null"
     */
    public static String toStr(Object obj) {
        return Objects.toString(obj, EMPTY);
    }

}

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末医增,一起剝皮案震驚了整個(gè)濱河市慎皱,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌叶骨,老刑警劉巖茫多,帶你破解...
    沈念sama閱讀 217,277評論 6 503
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異忽刽,居然都是意外死亡天揖,警方通過查閱死者的電腦和手機(jī)夺欲,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,689評論 3 393
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來今膊,“玉大人洁闰,你說我怎么就攤上這事⊥蛳福” “怎么了扑眉?”我有些...
    開封第一講書人閱讀 163,624評論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長赖钞。 經(jīng)常有香客問我腰素,道長,這世上最難降的妖魔是什么雪营? 我笑而不...
    開封第一講書人閱讀 58,356評論 1 293
  • 正文 為了忘掉前任弓千,我火速辦了婚禮,結(jié)果婚禮上献起,老公的妹妹穿的比我還像新娘洋访。我一直安慰自己,他們只是感情好谴餐,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,402評論 6 392
  • 文/花漫 我一把揭開白布姻政。 她就那樣靜靜地躺著,像睡著了一般岂嗓。 火紅的嫁衣襯著肌膚如雪汁展。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,292評論 1 301
  • 那天厌殉,我揣著相機(jī)與錄音食绿,去河邊找鬼。 笑死公罕,一個(gè)胖子當(dāng)著我的面吹牛器紧,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播楼眷,決...
    沈念sama閱讀 40,135評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼铲汪,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了摩桶?” 一聲冷哼從身側(cè)響起桥状,我...
    開封第一講書人閱讀 38,992評論 0 275
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎硝清,沒想到半個(gè)月后辅斟,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,429評論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡芦拿,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,636評論 3 334
  • 正文 我和宋清朗相戀三年士飒,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了查邢。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,785評論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡酵幕,死狀恐怖扰藕,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情芳撒,我是刑警寧澤邓深,帶...
    沈念sama閱讀 35,492評論 5 345
  • 正文 年R本政府宣布,位于F島的核電站笔刹,受9級特大地震影響芥备,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜舌菜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,092評論 3 328
  • 文/蒙蒙 一萌壳、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧日月,春花似錦袱瓮、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,723評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至台颠,卻和暖如春褐望,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背串前。 一陣腳步聲響...
    開封第一講書人閱讀 32,858評論 1 269
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留实蔽,地道東北人荡碾。 一個(gè)月前我還...
    沈念sama閱讀 47,891評論 2 370
  • 正文 我出身青樓,卻偏偏與公主長得像局装,于是被迫代替她去往敵國和親坛吁。 傳聞我的和親對象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,713評論 2 354