|
|||||||||
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES |
See:
Description
Interface Summary | |
---|---|
Connection | This is the most basic type of generic connection. |
ContentConnection | This interface defines the stream connection over which content is passed. |
Datagram | This class defines an abstract interface for datagram packets. |
DatagramConnection | This interface defines the capabilities that a datagram connection must have. |
HttpConnection | This interface defines the necessary methods and constants for an HTTP connection. |
HttpsConnection | This interface defines the necessary methods and constants to establish a secure network connection. |
InputConnection | This interface defines the capabilities that an input stream connection must have. |
OutputConnection | This interface defines the capabilities that an output stream connection must have. |
SecureConnection | This interface defines the secure socket stream connection. |
SecurityInfo | This interface defines methods to access information about a secure network connection. |
ServerSocketConnection | This interface defines the server socket stream connection. |
SocketConnection | This interface defines the socket stream connection. |
StreamConnection | This interface defines the capabilities that a stream connection must have. |
StreamConnectionNotifier | This interface defines the capabilities that a connection notifier must have. |
UDPDatagramConnection | This interface defines a datagram connection which knows it's local end point address. |
Class Summary | |
---|---|
Connector | This class is factory for creating new Connection objects. |
Exception Summary | |
---|---|
ConnectionNotFoundException | This class is used to signal that a connection target cannot be found, or the protocol type is not supported. |
Provides the classes and interfaces for the Generic Connection Framework.
See Runtime Environment Specification for the Java Card Platform, Connected Edition, chapters 1 and 6 for details.
The Generic Connection Framework provides a simplified mechanism for applications to use various
types of I/O protocols in resource-constrained environments; I/O is
performed by means of Connections obtained through the Connector
factory class; Connections are dynamically created based on URIs of
the form: {scheme}:[{target}][{params}]
Please see the
Connector class for more information.
The following connection protocols must be supported on the Java Card platform, Connected Edition:
TCP/IP Client Socket.
TCP/IP Server Socket.
HTTP Client Connection.
SSL/TLS Client Socket.
SSL/TLS Server Socket.
File Connection.
Support of the following connection protocol is optional on the Java Card platform, Connected Edition:
Datagram Socket.
The Generic Connection Framework must behave as defined below for the following protocols:
TCP/IP Client Socket. URIs of the form
"socket://{host}:{port}
" must return an
object with behavior that follows the
javax.microedition.io.SocketConnection interface
specification.
TCP/IP Server Socket. URIs of the form "socket:// | socket://:{port}" must return an object with behavior that follows the javax.microedition.io.ServerSocketConnection interface specification.
HTTP Client Connection. URIs of the form
"http://{host}:{port}{path}
" must
return an object with behavior that follows the
javax.microedition.io.HttpConnection interface
specification.
SSL/TLS Client Socket. URIs of the form "ssl://{host}:{port}
"
must return an object with behavior that follows the
javax.microedition.io.SecureConnection interface
specification.
SSL/TLS Server Socket. URIs of the form "ssl:// | ssl://:{port}" must return an object with behavior that follows the javacardx.io.ServerSecureConnection interface specification.
HTTPS Client Connection. URIs of the form
"https://{host}:{port}{path}
" must
return an object with behavior that follows the
javax.microedition.io.HttpsConnection interface
specification.
File Connection. URIs of the form "file://{path}" (File URLs as defined by RFC 1738 - http://www.w3.org/Addressing/rfc1738.txt) must return an object which implements either javax.microedition.io.InputConnection (for "read" mode), javax.microedition.io.OutputConnection (for "write" mode) or javax.microedition.io.StreamConnection (for "read/write" mode).
Datagram Socket. URIs of the form "datagram://[{host}]:{port}" must return an object with behavior that follows the javax.microedition.io.UDPDatagramConnection interface specification which extends the javax.microedition.io.DatagramConnection interface.
javax.microedition.io.Connector
is governed by certain
javacardx.io.ConnectorPermission
checks, as described below:
Protocol | URI Form | Permission Check |
TCP/IP Client Socket | socket://{host}:{port} |
ConnectorPermission("socket://{host}:{port}", "connect") |
TCP/IP Server Socket | socket://:{port} |
ConnectorPermission("socket://:{port}", "listen") |
HTTP 1.1 | http://{host}[:{port}][{path}] |
ConnectorPermission("http://{host}[:{port}][{path}]", "connect") |
HTTPS | https://{host}[:{port}][{path}] |
ConnectorPermission("https://{host}:{port}[{path}]", "connect") |
Secure Client Socket | ssl://{host}:{port} |
ConnectorPermission("ssl://{host}:{port}", "connect") |
Secure Server Socket | ssl://:{port} |
ConnectorPermission("ssl://:{port}", "listen") |
File I/O | file://{path} (reading)file://{path} (writing) |
ConnectorPermission("file://{path}", "read") ConnectorPermission("file://{path}", "write") |
Datagram Socket | datagram://{host}:{port} datagram://:{port} |
ConnectorPermission("datagram://{host}:{port}", "connect") ConnectorPermission("datagram://:{port}", "listen") |
javax.microedition.io.InputConnection.openDataInputStream()
, javax.microedition.io.InputConnection.openInputStream()
,
javax.microedition.io.OutputConnection.openDataOutputStream()
and javax.microedition.io.OutputConnection.openOutputStream()
result in the same permission checks
as the ones described above for the methods of javax.microedition.io.Connector
.
Connector.open()
and a call to InputConnection.openInputStream()
(for example) on
the returned Connection
object may result in a SecurityException
to be thrown if the permission
is no longer granted.
The methods javax.microedition.io.StreamConnectionNotifier.acceptAndOpen()
and javax.microedition.io.DatagramConnection.receive()
result in permission checks, as described below:
Protocol | URI Form of the client connection being accepted | Permission Check |
TCP/IP Server Socket ( StreamConnectionNotifier.acceptAndOpen() method) |
socket://{host}:{port} |
ConnectorPermission("socket://{host}:{port}", "accept") |
Secure Server Socket ( StreamConnectionNotifier.acceptAndOpen() method) |
ssl://{host}:{port} |
ConnectorPermission("ssl://{host}:{port}", "accept") |
Datagram Socket ( DatagramConnection.receive() method) |
datagram://{host}:{port} |
ConnectorPermission("datagram://{host}:{port}", "accept") |
javacardx.io
|
|||||||||
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES |