public interface HttpsConnection extends HttpConnection
https
when passed to
Connector.open
will return a
HttpsConnection
.
RFC 2818
defines the scheme.
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.
The HTTPS connection supports the same ConnectionOption
parameters
as defined by HttpConnection
.
This connection inherits the connection options from HttpConnection
.
Additional ConnectionOption
s, which allow the selection of certificates,
protocols and cipher suites are defined in SecureConnection
;
these are also applicable to HttpsConnection
.
The mode
parameter of Connector.open
is not used.
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(); } }
CertificateException
CONNECT, DELETE, GET, 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, OPTIONS, POST, PUT, TRACE
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.
|
getAccessPoint, getDate, getExpiration, getFile, getHeaderField, getHeaderField, getHeaderFieldDate, getHeaderFieldInt, getHeaderFieldKey, getHost, getLastModified, getProtocol, getQuery, getRef, getRequestMethod, getRequestProperty, getResponseCode, getResponseMessage, getURL, setRequestMethod, setRequestProperty
getEncoding, getLength, getType
openDataInputStream, openInputStream
openDataOutputStream, openOutputStream
close
int getPort()
HttpsConnection
.getPort
in interface HttpConnection
HttpsConnection
.
The default HTTPS port number (443) is returned if there was
no port number in the string passed to Connector.open
.SecurityInfo getSecurityInfo() throws java.io.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.java.io.IOException
- if an arbitrary connection failure occursCopyright (c) 2014, Oracle and/or its affiliates. All Rights Reserved. Use of this specification is subject to license terms.