public interface HttpsConnection extends HttpConnection
https when passed to
Connector.open will return a
HttpsConnection.
RFC 2818
defines the scheme.
A secure connection MUST be implemented by one or more of the following specifications:
HTTPS is the secure version of HTTP (IETF RFC2616), a request-response protocol in which the parameters of the request must be set before the request is sent.
In addition to the normal IOExceptions that may occur during
invocation of the various methods that cause a transition to the Connected
state, CertificateException
(a subtype of IOException) may be thrown to indicate various
failures related to establishing the secure link. The secure link
is necessary in the Connected state so the headers
can be sent securely. The secure link may be established as early as the
invocation of Connector.open() and related
methods for opening input and output streams and failure related to
certificate exceptions may be reported.
Open a HTTPS connection, set its parameters, then read the HTTP response.
Connector.open is used to open the URL
and an HttpsConnection is returned.
The HTTP
headers are read and processed. If the length is available, it is used
to read the data in bulk. From the
HttpsConnection the InputStream is
opened. It is used to read every character until end of file (-1). If
an exception is thrown the connection and stream are closed.
void getViaHttpsConnection(String url)
throws CertificateException, IOException {
HttpsConnection c = null;
InputStream is = null;
try {
c = (HttpsConnection)Connector.open(url);
// Getting the InputStream ensures that the connection
// is opened (if it was not already handled by
// Connector.open()) and the SSL handshake is exchanged,
// and the HTTP response headers are read.
// These are stored until requested.
is = c.openDataInputStream();
if c.getResponseCode() == HttpConnection.HTTP_OK) {
// Get the length and process the data
int len = (int)c.getLength();
if (len > 0) {
byte[] data = new byte[len];
int actual = is.readFully(data);
...
} else {
int ch;
while ((ch = is.read()) != -1) {
...
}
}
} else {
...
}
} finally {
if (is != null)
is.close();
if (c != null)
c.close();
}
}
CertificateExceptionGET, HEAD, HTTP_ACCEPTED, HTTP_BAD_GATEWAY, HTTP_BAD_METHOD, HTTP_BAD_REQUEST, HTTP_CLIENT_TIMEOUT, HTTP_CONFLICT, HTTP_CREATED, HTTP_ENTITY_TOO_LARGE, HTTP_EXPECT_FAILED, HTTP_FORBIDDEN, HTTP_GATEWAY_TIMEOUT, HTTP_GONE, HTTP_INTERNAL_ERROR, HTTP_LENGTH_REQUIRED, HTTP_MOVED_PERM, HTTP_MOVED_TEMP, HTTP_MULT_CHOICE, HTTP_NO_CONTENT, HTTP_NOT_ACCEPTABLE, HTTP_NOT_AUTHORITATIVE, HTTP_NOT_FOUND, HTTP_NOT_IMPLEMENTED, HTTP_NOT_MODIFIED, HTTP_OK, HTTP_PARTIAL, HTTP_PAYMENT_REQUIRED, HTTP_PRECON_FAILED, HTTP_PROXY_AUTH, HTTP_REQ_TOO_LONG, HTTP_RESET, HTTP_SEE_OTHER, HTTP_TEMP_REDIRECT, HTTP_UNAUTHORIZED, HTTP_UNAVAILABLE, HTTP_UNSUPPORTED_RANGE, HTTP_UNSUPPORTED_TYPE, HTTP_USE_PROXY, HTTP_VERSION, POST| Modifier and Type | Method and Description |
|---|---|
int |
getPort()
Returns the network port number of the URL for this
HttpsConnection. |
SecurityInfo |
getSecurityInfo()
Return the security information associated with this
successfully opened connection.
|
getDate, getExpiration, getFile, getHeaderField, getHeaderField, getHeaderFieldDate, getHeaderFieldInt, getHeaderFieldKey, getHost, getLastModified, getProtocol, getQuery, getRef, getRequestMethod, getRequestProperty, getResponseCode, getResponseMessage, getURL, setRequestMethod, setRequestPropertygetEncoding, getLength, getTypeopenDataInputStream, openInputStreamopenDataOutputStream, openOutputStreamcloseSecurityInfo getSecurityInfo() throws IOException
Setup state then
the connection is initiated to establish the secure connection
to the server. The method returns when the connection is
established and the Certificate supplied by the
server has been validated.
The SecurityInfo is only returned if the
connection has been successfully made to the server.IOException - if an arbitrary connection failure occursint getPort()
HttpsConnection.getPort in interface HttpConnectionHttpsConnection.
The default HTTPS port number (443) is returned if there was
no port number in the string passed to Connector.open.