com.opendxl.streaming.client

Class HttpConnection

java.lang.Object

com.opendxl.streaming.client.HttpConnection

All Implemented Interfaces:

java.lang.AutoCloseable

public class HttpConnection
extends java.lang.Object
implements java.lang.AutoCloseable

The HttpConnection class provides an SSL communication layer for Channel requests. Allowed certificates, which are used for HTTPS certificate validation, are given in a file which name is set in the constructor HttpConnection(String, boolean, HttpProxySettings).

Constructor Summary

Constructors

Constructor and Description
HttpConnection(java.lang.String verifyCertBundle, boolean isHttps, HttpProxySettings httpProxySettings)

Method Summary

Modifier and Type	Method and Description
void	close() Closes the request object and its supporting HttpClient.
org.apache.http.client.methods.CloseableHttpResponse	execute(org.apache.http.client.methods.HttpRequestBase httpRequestBase) Execute the HTTP Request
void	resetCookies() Clean up session data which are sent in all requests, e.g.: delete cookies from HttpClientContext CookieStore

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HttpConnection

public HttpConnection(java.lang.String verifyCertBundle,
                      boolean isHttps,
                      HttpProxySettings httpProxySettings)
               throws java.security.cert.CertificateException,
                      java.security.NoSuchAlgorithmException,
                      java.security.KeyStoreException,
                      java.security.KeyManagementException,
                      java.io.IOException

Parameters:

verifyCertBundle - CA Bundle chain certificates. This string shall be either the certificates themselves or a path to a CA bundle file containing those certificates. The CA bundle is used to validate that the certificate of the authentication server being connected to was signed by a valid authority. If set to an empty string, the server certificate will not be validated.

isHttps - set to true if the connection requires SSL, false otherwise

httpProxySettings - contains http proxy url, port, username and password

Throws:

java.security.KeyManagementException - If initialization of SSL context fails

java.security.KeyStoreException - If there is an error creating a key store from the certificates in the trust store file

java.security.cert.CertificateException - If there is an error creating a certificate from the certificates in the trust store file

java.security.NoSuchAlgorithmException - If there is an error creating a certificate factory

java.io.IOException - If there is an error creating a key store from the certificates in the trust store file

Method Detail

execute

public org.apache.http.client.methods.CloseableHttpResponse execute(org.apache.http.client.methods.HttpRequestBase httpRequestBase)
                                                             throws java.io.IOException,
                                                                    org.apache.http.client.ClientProtocolException

Execute the HTTP Request

Parameters:

httpRequestBase - http request to be executed

Returns:

the response to the http request

Throws:

java.io.IOException - in case of a problem or the connection was aborted

org.apache.http.client.ClientProtocolException - in case of an http protocol error

resetCookies

public void resetCookies()

Clean up session data which are sent in all requests, e.g.: delete cookies from HttpClientContext CookieStore

close

public void close()
           throws java.io.IOException

Closes the request object and its supporting HttpClient. This method is added to allow Request to be used in conjunction with Java try-with-resources statement.

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException