|
JSR 216 (Maintenance Release) | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This interface defines the capabilities that a stream connection must have.
In a typical implementation of this interface (for instance
in MIDP 2.0), all StreamConnections
have one
underlying InputStream
and one OutputStream
.
Opening a DataInputStream
counts as opening an
InputStream
and opening a DataOutputStream
counts as opening an OutputStream
. Trying to open
another InputStream
or OutputStream
causes an IOException
. Trying to open the
InputStream
or OutputStream
after
they have been closed causes an IOException
.
NOTE of clarification for implementations supporting multiple streams:
Each openXXXStream
(where XXX can be
either Input or Output) call returns
a unique new stream, not a copy of a single stream. When an opened
stream is closed, a StreamConnection
implementation may
choose to close the connection and close all other opened streams derived
from that connection. When this choice of implementation happens, further
access to the connection and streams will throw an IOException
.
When this choice of implementation is not chosen, where one opened
stream is closed, all other opened streams must remain open and any
other openXXXStream
call is valid and must return a new
unique XXXStream
.
The methods of StreamConnection
are not
synchronized. The only stream method that can be called safely
in another thread is close
.
Methods inherited from interface javax.microedition.io.InputConnection |
openDataInputStream, openInputStream |
Methods inherited from interface javax.microedition.io.Connection |
close |
Methods inherited from interface javax.microedition.io.OutputConnection |
openDataOutputStream, openOutputStream |
|
JSR 216 (Maintenance Release) | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |