摘要：最近有一个需求，为客户提供一些Restful API 接口，QA使用postman进行测试，但是postman的测试接口与java调用的相似但并不相同，于是想自己写一个程序去测试Restful API接口，由于使用的是HTTPS，所以还要考虑到对于HTTPS的处理。由于我也是首次使用Java调用restful接口，所以还要研究一番，自然也是查阅了一些资料。

分析：这个问题与模块之间的调用不同，比如我有两个模块front end 和back end，front end提供前台展示，back end提供数据支持。之前使用过Hession去把back end提供的服务注册成远程服务，在front end端可以通过这种远程服务直接调到back end的接口。但这对于一个公司自己的一个项目耦合性比较高的情况下使用，没有问题。但是如果给客户注册这种远程服务，似乎不太好，耦合性太高。所以就考虑用一下方式进行处理。

一、HttpClient

HttpClient大家也许比较熟悉但又比较陌生，熟悉是知道他可以远程调用比如请求一个URL，然后在response里获取到返回状态和返回信息，但是今天讲的稍微复杂一点，因为今天的主题是HTTPS，这个牵涉到证书或用户认证的问题。

确定使用HttpClient之后，查询相关资料，发现HttpClient的新版本与老版本不同，随然兼容老版本，但已经不提倡老版本是使用方式，很多都已经标记为过时的方法或类。今天就分别使用老版本4.2和最新版本4.5.3来写代码。

老版本4.2

需要认证

在准备证书阶段选择的是使用证书认证

package com.darren.test.https.v42;

import java.io.File;

import java.io.FileInputStream;

import java.security.KeyStore;

import org.apache.http.conn.ssl.SSLSocketFactory;

public class HTTPSCertifiedClient extends HTTPSClient {

    public HTTPSCertifiedClient() {

    }

    @Override

    public void prepareCertificate() throws Exception {

        // 获得密匙库

        KeyStore trustStore = KeyStore.getInstance(KeyStore.getDefaultType());

        FileInputStream instream = new FileInputStream(

                new File("C:/Users/zhda6001/Downloads/software/xxx.keystore"));

        // FileInputStream instream = new FileInputStream(new File("C:/Users/zhda6001/Downloads/xxx.keystore"));

        // 密匙库的密码

        trustStore.load(instream, "password".toCharArray());

        // 注册密匙库

        this.socketFactory = new SSLSocketFactory(trustStore);

        // 不校验域名

        socketFactory.setHostnameVerifier(SSLSocketFactory.ALLOW_ALL_HOSTNAME_VERIFIER);

    }

}

跳过认证

在准备证书阶段选择的是跳过认证

package com.darren.test.https.v42;

import java.security.cert.CertificateException;

import java.security.cert.X509Certificate;

import javax.net.ssl.SSLContext;

import javax.net.ssl.TrustManager;

import javax.net.ssl.X509TrustManager;

import org.apache.http.conn.ssl.SSLSocketFactory;

public class HTTPSTrustClient extends HTTPSClient {

    public HTTPSTrustClient() {

    }

    @Override

    public void prepareCertificate() throws Exception {

        // 跳过证书验证

        SSLContext ctx = SSLContext.getInstance("TLS");

        X509TrustManager tm = new X509TrustManager() {

            @Override

            public void checkClientTrusted(X509Certificate[] chain, String authType) throws CertificateException {

            }

            @Override

            public void checkServerTrusted(X509Certificate[] chain, String authType) throws CertificateException {

            }

            @Override

            public X509Certificate[] getAcceptedIssuers() {

                return null;

            }

        };

        // 设置成已信任的证书

        ctx.init(null, new TrustManager[] { tm }, null);

        // 穿件SSL socket 工厂，并且设置不检查host名称

        this.socketFactory = new SSLSocketFactory(ctx, SSLSocketFactory.ALLOW_ALL_HOSTNAME_VERIFIER);

    }

}

总结

现在发现这两个类都继承了同一个类HTTPSClient，并且HTTPSClient继承了DefaultHttpClient类，可以发现，这里使用了模板方法模式。

package com.darren.test.https.v42;

import org.apache.http.conn.ClientConnectionManager;

import org.apache.http.conn.scheme.Scheme;

import org.apache.http.conn.scheme.SchemeRegistry;

import org.apache.http.conn.ssl.SSLSocketFactory;

import org.apache.http.impl.client.DefaultHttpClient;

public abstract class HTTPSClient extends DefaultHttpClient {

    protected SSLSocketFactory socketFactory;

    /**

     * 初始化HTTPSClient

     *

     * @return 返回当前实例

     * @throws Exception

     */

    public HTTPSClient init() throws Exception {

        this.prepareCertificate();

        this.regist();

        return this;

    }

    /**

     * 准备证书验证

     *

     * @throws Exception

     */

    public abstract void prepareCertificate() throws Exception;

    /**

     * 注册协议和端口, 此方法也可以被子类重写

     */

    protected void regist() {

        ClientConnectionManager ccm = this.getConnectionManager();

        SchemeRegistry sr = ccm.getSchemeRegistry();

        sr.register(new Scheme("https", 443, socketFactory));

    }

}

下边是工具类

package com.darren.test.https.v42;

import java.util.ArrayList;

import java.util.List;

import java.util.Map;

import java.util.Set;

import org.apache.http.HttpEntity;

import org.apache.http.HttpResponse;

import org.apache.http.NameValuePair;

import org.apache.http.client.entity.UrlEncodedFormEntity;

import org.apache.http.client.methods.HttpGet;

import org.apache.http.client.methods.HttpPost;

import org.apache.http.client.methods.HttpRequestBase;

import org.apache.http.message.BasicNameValuePair;

import org.apache.http.util.EntityUtils;

public class HTTPSClientUtil {

    private static final String DEFAULT_CHARSET = "UTF-8";

    public static String doPost(HTTPSClient httpsClient, String url, Map<String, String> paramHeader,

            Map<String, String> paramBody) throws Exception {

        return doPost(httpsClient, url, paramHeader, paramBody, DEFAULT_CHARSET);

    }

    public static String doPost(HTTPSClient httpsClient, String url, Map<String, String> paramHeader,

            Map<String, String> paramBody, String charset) throws Exception {

        String result = null;

        HttpPost httpPost = new HttpPost(url);

        setHeader(httpPost, paramHeader);

        setBody(httpPost, paramBody, charset);

        HttpResponse response = httpsClient.execute(httpPost);

        if (response != null) {

            HttpEntity resEntity = response.getEntity();

            if (resEntity != null) {

                result = EntityUtils.toString(resEntity, charset);

            }

        }

        return result;

    }

    public static String doGet(HTTPSClient httpsClient, String url, Map<String, String> paramHeader,

            Map<String, String> paramBody) throws Exception {

        return doGet(httpsClient, url, paramHeader, paramBody, DEFAULT_CHARSET);

    }

    public static String doGet(HTTPSClient httpsClient, String url, Map<String, String> paramHeader,

            Map<String, String> paramBody, String charset) throws Exception {

        String result = null;

        HttpGet httpGet = new HttpGet(url);

        setHeader(httpGet, paramHeader);

        HttpResponse response = httpsClient.execute(httpGet);

        if (response != null) {

            HttpEntity resEntity = response.getEntity();

            if (resEntity != null) {

                result = EntityUtils.toString(resEntity, charset);

            }

        }

        return result;

    }

    private static void setHeader(HttpRequestBase request, Map<String, String> paramHeader) {

        // 设置Header

        if (paramHeader != null) {

            Set<String> keySet = paramHeader.keySet();

            for (String key : keySet) {

                request.addHeader(key, paramHeader.get(key));

            }

        }

    }

    private static void setBody(HttpPost httpPost, Map<String, String> paramBody, String charset) throws Exception {

        // 设置参数

        if (paramBody != null) {

            List<NameValuePair> list = new ArrayList<NameValuePair>();

            Set<String> keySet = paramBody.keySet();

            for (String key : keySet) {

                list.add(new BasicNameValuePair(key, paramBody.get(key)));

            }

            if (list.size() > 0) {

                UrlEncodedFormEntity entity = new UrlEncodedFormEntity(list, charset);

                httpPost.setEntity(entity);

            }

        }

    }

}

然后是测试类：

package com.darren.test.https.v42;

import java.util.HashMap;

import java.util.Map;

public class HTTPSClientTest {

    public static void main(String[] args) throws Exception {

        HTTPSClient httpsClient = null;

        httpsClient = new HTTPSTrustClient().init();

        //httpsClient = new HTTPSCertifiedClient().init();

        String url = "https://1.2.6.2:8011/xxx/api/getToken";

        //String url = "https://1.2.6.2:8011/xxx/api/getHealth";

        Map<String, String> paramHeader = new HashMap<>();

        //paramHeader.put("Content-Type", "application/json");

        paramHeader.put("Accept", "application/xml");

        Map<String, String> paramBody = new HashMap<>();

        paramBody.put("client_id", "ankur.tandon.ap@xxx.com");

        paramBody.put("client_secret", "P@ssword_1");

        String result = HTTPSClientUtil.doPost(httpsClient, url, paramHeader, paramBody);

        //String result = HTTPSClientUtil.doGet(httpsClient, url, null, null);

        System.out.println(result);

    }

}

返回信息：

<?xml version="1.0" encoding="utf-8"?>

<token>jkf8RL0sw+Skkflj8RbKI5hP1bEQK8PrCuTZPpBINqMYKRMxY1kWCjmCfT191Zpp88VV1aGHW8oYNWjEYS0axpLuGAX89ejCoWNbikCc1UvfyesXHLktcJqyUFiVjevhrEQxJPHncLQYWP+Xse5oD9X8vKFKk7InNTMRzQK7YBTZ/e3U7gswM/5cvAHFl6o9rEq9cWPXavZNohyvnXsohSzDo+BXAtXxa1xpEDLy/8h/UaP4n4dlZDJJ3B8t1Xh+CRRIoMOPxf7c5wKhHtOkEOeXW+xoPQKKSx5CKWwJpPuGIIFWF/PaqWg+JUOsVT7QGdPv8PMWJ9DwEwjTdxguDg==</token>

新版本4.5.3

需要认证

package com.darren.test.https.v45;

import java.io.File;

import java.io.FileInputStream;

import java.security.KeyStore;

import javax.net.ssl.SSLContext;

import org.apache.http.conn.ssl.SSLConnectionSocketFactory;

import org.apache.http.conn.ssl.TrustSelfSignedStrategy;

import org.apache.http.ssl.SSLContexts;

public class HTTPSCertifiedClient extends HTTPSClient {

    public HTTPSCertifiedClient() {

    }

    @Override

    public void prepareCertificate() throws Exception {

        // 获得密匙库

        KeyStore trustStore = KeyStore.getInstance(KeyStore.getDefaultType());

        FileInputStream instream = new FileInputStream(

                new File("C:/Users/zhda6001/Downloads/software/xxx.keystore"));

        // FileInputStream instream = new FileInputStream(new File("C:/Users/zhda6001/Downloads/xxx.keystore"));

        try {

            // 密匙库的密码

            trustStore.load(instream, "password".toCharArray());

        } finally {

            instream.close();

        }

        SSLContext sslcontext = SSLContexts.custom().loadTrustMaterial(trustStore, TrustSelfSignedStrategy.INSTANCE)

                .build();

        this.connectionSocketFactory = new SSLConnectionSocketFactory(sslcontext);

    }

}

跳过认证

package com.darren.test.https.v45;

import java.security.cert.CertificateException;

import java.security.cert.X509Certificate;

import javax.net.ssl.SSLContext;

import javax.net.ssl.TrustManager;

import javax.net.ssl.X509TrustManager;

import org.apache.http.conn.ssl.SSLConnectionSocketFactory;

public class HTTPSTrustClient extends HTTPSClient {

    public HTTPSTrustClient() {

    }

    @Override

    public void prepareCertificate() throws Exception {

        // 跳过证书验证

        SSLContext ctx = SSLContext.getInstance("TLS");

        X509TrustManager tm = new X509TrustManager() {

            @Override

            public void checkClientTrusted(X509Certificate[] chain, String authType) throws CertificateException {

            }

            @Override

            public void checkServerTrusted(X509Certificate[] chain, String authType) throws CertificateException {

            }

            @Override

            public X509Certificate[] getAcceptedIssuers() {

                return null;

            }

        };

        // 设置成已信任的证书

        ctx.init(null, new TrustManager[] { tm }, null);

        this.connectionSocketFactory = new SSLConnectionSocketFactory(ctx);

    }

}

总结

package com.darren.test.https.v45;

import org.apache.http.config.Registry;

import org.apache.http.config.RegistryBuilder;

import org.apache.http.conn.socket.ConnectionSocketFactory;

import org.apache.http.conn.socket.PlainConnectionSocketFactory;

import org.apache.http.impl.client.CloseableHttpClient;

import org.apache.http.impl.client.HttpClientBuilder;

import org.apache.http.impl.client.HttpClients;

import org.apache.http.impl.conn.PoolingHttpClientConnectionManager;

public abstract class HTTPSClient extends HttpClientBuilder {

    private CloseableHttpClient client;

    protected ConnectionSocketFactory connectionSocketFactory;

    /**

     * 初始化HTTPSClient

     *

     * @return 返回当前实例

     * @throws Exception

     */

    public CloseableHttpClient init() throws Exception {

        this.prepareCertificate();

        this.regist();

        return this.client;

    }

    /**

     * 准备证书验证

     *

     * @throws Exception

     */

    public abstract void prepareCertificate() throws Exception;

    /**

     * 注册协议和端口, 此方法也可以被子类重写

     */

    protected void regist() {

        // 设置协议http和https对应的处理socket链接工厂的对象

        Registry<ConnectionSocketFactory> socketFactoryRegistry = RegistryBuilder.<ConnectionSocketFactory>create()

                .register("http", PlainConnectionSocketFactory.INSTANCE)

                .register("https", this.connectionSocketFactory)

                .build();

        PoolingHttpClientConnectionManager connManager = new PoolingHttpClientConnectionManager(socketFactoryRegistry);

        HttpClients.custom().setConnectionManager(connManager);

        // 创建自定义的httpclient对象

        this.client = HttpClients.custom().setConnectionManager(connManager).build();

        // CloseableHttpClient client = HttpClients.createDefault();

    }

}

工具类：

package com.darren.test.https.v45;

import java.util.ArrayList;

import java.util.List;

import java.util.Map;

import java.util.Set;

import org.apache.http.HttpEntity;

import org.apache.http.HttpResponse;

import org.apache.http.NameValuePair;

import org.apache.http.client.HttpClient;

import org.apache.http.client.entity.UrlEncodedFormEntity;

import org.apache.http.client.methods.HttpGet;

import org.apache.http.client.methods.HttpPost;

import org.apache.http.client.methods.HttpRequestBase;

import org.apache.http.message.BasicNameValuePair;

import org.apache.http.util.EntityUtils;

public class HTTPSClientUtil {

    private static final String DEFAULT_CHARSET = "UTF-8";

    public static String doPost(HttpClient httpClient, String url, Map<String, String> paramHeader,

            Map<String, String> paramBody) throws Exception {

        return doPost(httpClient, url, paramHeader, paramBody, DEFAULT_CHARSET);

    }

    public static String doPost(HttpClient httpClient, String url, Map<String, String> paramHeader,

            Map<String, String> paramBody, String charset) throws Exception {

        String result = null;

        HttpPost httpPost = new HttpPost(url);

        setHeader(httpPost, paramHeader);

        setBody(httpPost, paramBody, charset);

        HttpResponse response = httpClient.execute(httpPost);

        if (response != null) {

            HttpEntity resEntity = response.getEntity();

            if (resEntity != null) {

                result = EntityUtils.toString(resEntity, charset);

            }

        }

        return result;

    }

    public static String doGet(HttpClient httpClient, String url, Map<String, String> paramHeader,

            Map<String, String> paramBody) throws Exception {

        return doGet(httpClient, url, paramHeader, paramBody, DEFAULT_CHARSET);

    }

    public static String doGet(HttpClient httpClient, String url, Map<String, String> paramHeader,

            Map<String, String> paramBody, String charset) throws Exception {

        String result = null;

        HttpGet httpGet = new HttpGet(url);

        setHeader(httpGet, paramHeader);

        HttpResponse response = httpClient.execute(httpGet);

        if (response != null) {

            HttpEntity resEntity = response.getEntity();

            if (resEntity != null) {

                result = EntityUtils.toString(resEntity, charset);

            }

        }

        return result;

    }

    private static void setHeader(HttpRequestBase request, Map<String, String> paramHeader) {

        // 设置Header

        if (paramHeader != null) {

            Set<String> keySet = paramHeader.keySet();

            for (String key : keySet) {

                request.addHeader(key, paramHeader.get(key));

            }

        }

    }

    private static void setBody(HttpPost httpPost, Map<String, String> paramBody, String charset) throws Exception {

        // 设置参数

        if (paramBody != null) {

            List<NameValuePair> list = new ArrayList<NameValuePair>();

            Set<String> keySet = paramBody.keySet();

            for (String key : keySet) {

                list.add(new BasicNameValuePair(key, paramBody.get(key)));

            }

            if (list.size() > 0) {

                UrlEncodedFormEntity entity = new UrlEncodedFormEntity(list, charset);

                httpPost.setEntity(entity);

            }

        }

    }

}

测试类：

package com.darren.test.https.v45;

import java.util.HashMap;

import java.util.Map;

import org.apache.http.client.HttpClient;

public class HTTPSClientTest {

    public static void main(String[] args) throws Exception {

        HttpClient httpClient = null;

        //httpClient = new HTTPSTrustClient().init();

        httpClient = new HTTPSCertifiedClient().init();

        String url = "https://1.2.6.2:8011/xxx/api/getToken";

        //String url = "https://1.2.6.2:8011/xxx/api/getHealth";

        Map<String, String> paramHeader = new HashMap<>();

        paramHeader.put("Accept", "application/xml");

        Map<String, String> paramBody = new HashMap<>();

        paramBody.put("client_id", "ankur.tandon.ap@xxx.com");

        paramBody.put("client_secret", "P@ssword_1");

        String result = HTTPSClientUtil.doPost(httpClient, url, paramHeader, paramBody);

        //String result = HTTPSClientUtil.doGet(httpsClient, url, null, null);

        System.out.println(result);

    }

}

结果：

二、HttpURLConnection

三、Spring的RestTemplate

其它方式以后补充

参考：

JAVA利用HttpClient进行POST请求（HTTPS）

CloseableHttpClient加载证书来访问https网站

Java 调用Restful API接口的几种方式--HTTPS的更多相关文章

java调用CXF WebService接口的两种方式
通过http://localhost:7002/card/services/HelloWorld?wsdl访问到xml如下,说明接口写对了. 2.静态调用 // 创建WebService客户端代理工厂 ...
Python调用API接口的几种方式数据库脚本
Python调用API接口的几种方式 2018-01-08 gaoeb97nd... 转自 one_day_day... 修改微信分享: 相信做过自动化运维的同学都用过API接口来完成某些动作.AP ...
Python调用API接口的几种方式
Python调用API接口的几种方式相信做过自动化运维的同学都用过API接口来完成某些动作.API是一套成熟系统所必需的接口,可以被其他系统或脚本来调用,这也是自动化运维的必修课. 本文主要介绍py ...
Java调用.NET webservice方法的几种方式
最近做项目,涉及到web-service调用,现学了一个星期,现简单的做一个小结.下面实现的是对传喜物流系统(http://vip.cxcod.com/PodApi/GetPodStr.asmx?ws ...
java调用wsdl xfire和cxf两种方式
xfire 如下: String spID = ""; String password = ""; String accessCode = "&quo ...
SpringMVC Restful api接口实现
[前言] 面向资源的 Restful 风格的 api 接口本着简洁,资源,便于扩展,便于理解等等各项优势,在如今的系统服务中越来越受欢迎. .net平台有WebAPi项目是专门用来实现Restful ...
Java调用RestFul接口
使用Java调用RestFul接口,以POST请求为例,以下提供几种方法: 一.通过HttpURLConnection调用 1 public String postRequest(String url ...
Spring Boot入门系列（二十）快速打造Restful API 接口
spring boot入门系列文章已经写到第二十篇,前面我们讲了spring boot的基础入门的内容,也介绍了spring boot 整合mybatis,整合redis.整合Thymeleaf 模板 ...
Spring Boot入门系列（二十一）如何优雅的设计 Restful API 接口版本号，实现 API 版本控制！
前面介绍了Spring Boot 如何快速实现Restful api 接口,并以人员信息为例,设计了一套操作人员信息的接口.不清楚的可以看之前的文章:https://www.cnblogs.com/z ...

随机推荐

#6 Python数据类型及运算
前言前文讲述了Python的输入输出以及变量的相关知识点,本节将探讨Python的数据类型以及数据之间的运算方式! 一.Python数据类型上一节弄清了变量,其实变量所指向的值是有自己独特的数据类 ...
FFmpeg编解码处理2-编解码API详解
本文为作者原创,转载请注明出处:https://www.cnblogs.com/leisure_chn/p/10584925.html FFmpeg编解码处理系列笔记: [0]. FFmpeg时间戳详 ...
PHP报错类型
p: 语法错误定界符; F: 致命错误函数;方法重名;包含(require) W: 警告包含(include); N: 通知变量未声明,函数
windows BLE编程 net winform 连接蓝牙4.0
winform 程序调用Windows.Devices.Bluetoot API 实现windows下BLE蓝牙设备自动连接,收发数据功能.不需要使用win10的UWP开发. 先贴图,回头来完善代码 ...
jQuery基础教程
1.使用$()函数 $()函数其实是创建了一个jQuery对象. 这个函数接受CSS选择符作为参数,充当一个工厂, 返回包含页面中对应元素的jQuery对象. 所有能在样式表中使用的选择符都可以传给这 ...
[PHP] 数据结构-输出链表倒数第k个结点PHP实现
输入一个链表,输出该链表中倒数第k个结点.第一个指针走(k-1)步,到达第k个节点,两个指针同时往后移动,当第一个结点到达末尾的时候,第二个结点所在位置就是倒数第k个节点了 <?php clas ...
第一个SpringBoot程序
第一个SpringBoot程序例子来自慕课网廖师兄的免费课程 2小时学会SpringBoot Spring Boot进阶之Web进阶使用IDEA新建工程,选择Spring Initializr,勾 ...
Java使用for循环输出菱形
/** * This program would print out a diamond * @param row the row of diamond * @version 2018-7-23 * ...
漫画｜你还记得原生的JDBC怎么连接数据库吗？
数据表的设计范式在实际开发中最为常见的设计范式有三个: 第一范式是最基本的范式.如果数据库表中的所有字段值都是不可分解的原子值,就说明该数据库表满足了第一范式: 第二范式需要确保数据库表中的每一列都 ...
element-ui 组件源码分析整理笔记目录
element-ui button组件 radio组件源码分析整理笔记(一) element-ui switch组件源码分析整理笔记(二) element-ui inputNumber.Card .B ...

Java 调用Restful API接口的几种方式--HTTPS

一、HttpClient

老版本4.2

需要认证

跳过认证

总结

新版本4.5.3

需要认证

跳过认证

总结

Java 调用Restful API接口的几种方式--HTTPS的更多相关文章

随机推荐

热门专题