javax.microedition.io
Interface SecureConnection
- All Superinterfaces:
- Connection, InputConnection, OutputConnection, SocketConnection, StreamConnection
@TransactionType(value=NOT_SUPPORTED)
public interface SecureConnection
- extends SocketConnection
This interface defines the secure socket stream connection. A secure
connection is established using Connector.open
with the scheme
"ssl" and the secure connection is established before open
returns. If the secure connection cannot be established due to errors related
to certificates a CertificateException
is thrown.
A secure socket is accessed using a generic connection string with an
explicit host and port number. The host may be specified as a fully qualified
host name or IPv4 number. E.g., ssl://host.com:79
defines a
target socket on the host.com
system at port 79
.
Note that RFC1900 recommends the use of names rather than IP numbers for best
results in the event of IP number reassignment.
A secure connection MUST be implemented by one or more of the following
specifications:
BNF Format for Connector.open() string
The URI must conform to the BNF syntax specified below. If the URI does not
conform to this syntax, an IllegalArgumentException
is thrown.
<socket_connection_string> |
::= "ssl://"<hostport> |
<hostport> |
::= host ":" port |
<host> |
::= host name or IP address |
<port> |
::= numeric port number |
Examples
The following examples show how a SecureConnection
would be
used to access a sample loopback program.
SecureConnection sc = (SecureConnection) Connector.open("ssl://host.com:79");
SecurityInfo info = sc.getSecurityInfo(); boolean isTLS =
(info.getProtocolName().equals("TLS"));
sc.setSocketOption(SocketConnection.LINGER, 5);
InputStream is = sc.openInputStream(); OutputStream os =
sc.openOutputStream();
os.write("\r\n".getBytes()); int ch = 0; while(ch != -1) { ch = is.read(); }
is.close(); os.close(); sc.close();
- Since:
- MIDP 2.0, Foundation Profile 1.1, Java Card 3.0
getSecurityInfo
SecurityInfo getSecurityInfo()
throws IOException
- Return the security information associated with this connection when it
was opened.
- Returns:
- the security information associated with this open connection.
- Throws:
IOException
- if an arbitrary connection failure occurs
Copyright (c) 2009 Sun Microsystems, Inc. All rights reserved.