OpenTop C++ class: HttpsURLConnection

Overview

Namespace

Class

Glossary

Index

OpenTop Portal

OpenTop 1.5

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

Cross-Platform C++

SUMMARY: CONSTRUCTOR | METHOD

DETAIL: CONSTRUCTOR | METHOD

ot::ssl
class HttpsURLConnection (abstract)

#include "ot/ssl/HttpsURLConnection.h"

A specialized URLConnection class that represents a connection with a resource specified by a HTTPS URL.

HTTPS involves the use of HTTP over a secure SSL/TLS connection and is described in detail in RFC 2818.

A HttpURLConnection instance can make only one HTTP request (although this one request may involve several message exchanges if HTTP redirection or authorization is involved). When an application makes multiple HTTP requests to the same server, the underlying OpenTop framework classes will attempt to maximize network efficiency by making use of persistent HTTP connections. Note, however, that not all HTTP servers support persistent connections and only idempotent requests will be considered for transmission over an existing persistent connection..

Managing persistent connections

TCP/IP connections employed by HttpURLConnection are created and managed by the global instance of the web::HttpClientConnectionManager class. Changes to the properties of this global object will affect all users of HttpURLConnection..

Enabling SSL

Before an application can make HTTPS requests, the SSL implementation will need to be initialized. See the documentation for ssl::SSLContext for information about configuring OpenTop for secure communications using SSL.

Constructor/Destructor Summary
`HttpsURLConnection(const URL& url)`

Method Summary
`static RefPtr< HostnameVerifier >`	`GetDefaultHostnameVerifier()`
`static RefPtr< SSLSocketFactory >`	`GetDefaultSSLSocketFactory()`
`virtual RefPtr< HostnameVerifier >`	`getHostnameVerifier() const=0`
`virtual RefPtr< SSLSocketFactory >`	`getSSLSocketFactory() const=0`
`static void`	`SetDefaultHostnameVerifier(HostnameVerifier* pVerifier)`
`static void`	`SetDefaultSSLSocketFactory(SSLSocketFactory* pFactory)`
`virtual void`	`setHostnameVerifier(HostnameVerifier* pVerifier)=0`
`virtual void`	`setSSLSocketFactory(SSLSocketFactory* pFactory)=0`

Methods inherited from class ot::net::HttpURLConnection

GetDefaultFollowRedirects(), getErrorStream(), getFollowRedirects(), getRequestMethod(), getResponseCode(), getResponseMessage(), SetDefaultFollowRedirects(bool), setFollowRedirects(bool), setRequestMethod(const String&)

Methods inherited from class ot::ManagedObject

addRef(), getRefCount(), onFinalRelease(), operator=(const ManagedObject&), release()

Methods inherited from class ot::net::URLConnection

connect(), getConnectTimeout(), getContentEncoding(), getContentLength(), getContentType(), getDate(), GetDefaultConnectTimeout(), GetDefaultTimeout(), GetDefaultUseCaches(), getDoInput(), getDoOutput(), getHeaderField(const String&), getHeaderField(size_t), getHeaderFieldCount(), getHeaderFieldDate(const String&), getHeaderFieldKey(size_t), getHeaderFieldLong(const String&, long), getInputStream(), getLastModified(), getOutputStream(), getRequestProperty(const String&), getTimeout(), getURL(), getUseCaches(), isConnected(), resetHeaderFields(), setConnected(bool), setConnectTimeout(size_t), SetDefaultConnectTimeout(size_t), SetDefaultTimeout(size_t), SetDefaultUseCaches(bool), setDoInput(bool), setDoOutput(bool), setRequestProperty(const String&, const String&), setTimeout(size_t), setURL(const URL&), setUseCaches(bool)

Constructor/Destructor Detail

HttpsURLConnection

 HttpsURLConnection(const URL& url)

Method Detail

GetDefaultHostnameVerifier

static RefPtr< HostnameVerifier > GetDefaultHostnameVerifier()

GetDefaultSSLSocketFactory

static RefPtr< SSLSocketFactory > GetDefaultSSLSocketFactory()

getHostnameVerifier

virtual RefPtr< HostnameVerifier > getHostnameVerifier() const=0

getSSLSocketFactory

virtual RefPtr< SSLSocketFactory > getSSLSocketFactory() const=0

SetDefaultHostnameVerifier

static void SetDefaultHostnameVerifier(HostnameVerifier* pVerifier)

SetDefaultSSLSocketFactory

static void SetDefaultSSLSocketFactory(SSLSocketFactory* pFactory)

setHostnameVerifier

virtual void setHostnameVerifier(HostnameVerifier* pVerifier)=0

setSSLSocketFactory

virtual void setSSLSocketFactory(SSLSocketFactory* pFactory)=0