|
WMA - JSR120 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--javax.microedition.io.Connector
This class is factory for creating new Connection objects.
The creation of connections is performed dynamically by looking up a protocol implementation class whose name is formed from the platform name (read from a system property) and the protocol name of the requested connection (extracted from the parameter string supplied by the application programmer). The parameter string that describes the target should conform to the URL format as described in RFC 2396. This takes the general form:
{scheme}:[{target}][{parms}]
where:
scheme
is the name of a protocol such as
HTTP.target
is normally some kind of network
address.parms
are formed as a series of equates
of the form ;x=y. For example: ;type=a.An optional second parameter may be specified to the open function. This is a mode flag that indicates to the protocol handler the intentions of the calling code. The options here specify if the connection is going to be read (READ), written (WRITE), or both (READ_WRITE). The validity of these flag settings is protocol dependent. For example, a connection for a printer would not allow read access, and would throw an IllegalArgumentException. If the mode parameter is not specified, READ_WRITE is used by default.
An optional third parameter is a boolean flag that indicates if the calling code can handle timeout exceptions. If this flag is set, the protocol implementation may throw an InterruptedIOException when it detects a timeout condition. This flag is only a hint to the protocol handler, and it does not guarantee that such exceptions will actually be thrown. If this parameter is not set, no timeout exceptions will be thrown.
Because connections are frequently opened just to gain access
to a specific input or output stream, convenience
functions are provided for this purpose.
See also: DatagramConnection
for information relating to datagram addressing
Field Summary | |
static int |
READ
Access mode READ. |
static int |
READ_WRITE
Access mode READ_WRITE. |
static int |
WRITE
Access mode WRITE. |
Method Summary | |
static Connection |
open(java.lang.String name)
Creates and opens a Connection. |
static Connection |
open(java.lang.String name,
int mode)
Creates and opens a Connection. |
static Connection |
open(java.lang.String name,
int mode,
boolean timeouts)
Creates and opens a Connection. |
static java.io.DataInputStream |
openDataInputStream(java.lang.String name)
Creates and opens a connection input stream. |
static java.io.DataOutputStream |
openDataOutputStream(java.lang.String name)
Creates and opens a connection output stream. |
static java.io.InputStream |
openInputStream(java.lang.String name)
Creates and opens a connection input stream. |
static java.io.OutputStream |
openOutputStream(java.lang.String name)
Creates and opens a connection output stream. |
Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final int READ
public static final int WRITE
public static final int READ_WRITE
Method Detail |
public static Connection open(java.lang.String name) throws java.io.IOException
name
- the URL for the connectionjava.lang.IllegalArgumentException
- if a parameter is invalidConnectionNotFoundException
- if the requested connection
cannot be made, or the protocol type does not existjava.io.IOException
- if some other kind of I/O error occursjava.lang.SecurityException
- if a requested protocol handler is not
permittedpublic static Connection open(java.lang.String name, int mode) throws java.io.IOException
name
- the URL for the connectionmode
- the access modejava.lang.IllegalArgumentException
- if a parameter is invalidConnectionNotFoundException
- if the requested connection
cannot be made, or the protocol type does not existjava.io.IOException
- if some other kind of I/O error occursjava.lang.SecurityException
- if a requested protocol handler is not
permittedpublic static Connection open(java.lang.String name, int mode, boolean timeouts) throws java.io.IOException
name
- the URL for the connectionmode
- the access modetimeouts
- a flag to indicate that the caller
wants timeout exceptionsjava.lang.IllegalArgumentException
- if a parameter is invalidConnectionNotFoundException
- if the requested connection
cannot be made, or the protocol type does not existjava.io.IOException
- if some other kind of I/O error occursjava.lang.SecurityException
- if a requested protocol handler is not
permittedpublic static java.io.DataInputStream openDataInputStream(java.lang.String name) throws java.io.IOException
name
- the URL for the connectionjava.lang.IllegalArgumentException
- if a parameter is invalidConnectionNotFoundException
- if the connection cannot
be foundjava.io.IOException
- if some other kind of I/O error occursjava.lang.SecurityException
- if access to the requested
stream is not permittedpublic static java.io.DataOutputStream openDataOutputStream(java.lang.String name) throws java.io.IOException
name
- the URL for the connectionjava.lang.IllegalArgumentException
- if a parameter is invalidConnectionNotFoundException
- if the connection cannot
be foundjava.io.IOException
- if some other kind of I/O error occursjava.lang.SecurityException
- if access to the requested
stream is not permittedpublic static java.io.InputStream openInputStream(java.lang.String name) throws java.io.IOException
name
- the URL for the connectionjava.lang.IllegalArgumentException
- if a parameter is invalidConnectionNotFoundException
- if the connection cannot
be foundjava.io.IOException
- if some other kind of I/O error occursjava.lang.SecurityException
- if access to the requested
stream is not permittedpublic static java.io.OutputStream openOutputStream(java.lang.String name) throws java.io.IOException
name
- the URL for the connectionjava.lang.IllegalArgumentException
- if a parameter is invalidConnectionNotFoundException
- if the connection cannot
be foundjava.io.IOException
- if some other kind of I/O error occursjava.lang.SecurityException
- if access to the requested
stream is not permitted
|
WMA - JSR120 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |