|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Defines a transport-neutral interface to established client-side
connections for secure remote calls. In the case of TCP, a connection is
usually a wrapper around an instance of (or an instance of a subclass of)
java.net.Socket
.
Method Summary | |
void |
close()
Closes the connection. |
java.io.InputStream |
getInputStream()
Returns an input stream for the connection. |
java.io.OutputStream |
getOutputStream()
Returns an output stream for the connection. |
javax.security.auth.Subject |
getServerSubject()
Returns the authenticated identity of the server as a read-only instance, or null if the server has not been authenticated. |
void |
writeCallData(SecureCallContext context,
java.io.ObjectOutputStream stream)
Writes to the specified stream any per-call data required by the connection for a remote call with the specified context. |
Method Detail |
public java.io.InputStream getInputStream() throws java.io.IOException
java.io.IOException
- if an I/O exception occurspublic java.io.OutputStream getOutputStream() throws java.io.IOException
java.io.IOException
- if an I/O exception occurspublic javax.security.auth.Subject getServerSubject()
null
if the server has not been authenticated.null
if the server has not been authenticatedpublic void writeCallData(SecureCallContext context, java.io.ObjectOutputStream stream) throws java.io.IOException
There can be multiple remote calls taking place concurrently over this
connection, and the specified stream may be buffering and multiplexing
the data from different calls into this connection's underlying output
stream. As such, this method can only write data to the specified
stream, and cannot read any data from the connection's underlying input
stream. If this connection's underlying protocol conflicts with these
requirements, then the connection should implement
SecureReusableClientConnection
and perform any necessary data transfer in the
switchConstraints
method of that interface instead.
context
- the remote call contextstream
- the output streamjava.io.IOException
- if an I/O exception occursNullPointerException
- if any parameter is null
java.lang.IllegalArgumentException
- if the specified context was not
created by an endpoint equal to the endpoint used to open this
connectionpublic void close() throws java.io.IOException
java.io.IOException
- if an I/O exception occurs
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |