This interface wraps the Socket and/or SSLSocket to provide clients an input set of APIs without exposing the underlying Socket/SSLSocket.
The APIs, readIntoBuffer and read are identical to Socket and SSLSocket, thus this interface can directly pass through to the underlying connection.
Note: Transport exception may or may not contains SSL information. This depends on whether or not the underlying connection is secure or not.
C++ Example:
HttpURLConnection_var hc = HttpURLConnection::_narrow(...);
..... set properties .....
SocketInputStream_var sis = hc->getInputStream();
buffer = sis->read(...);
Java Example:
Reads data from the peer.
XDT::Binary read ( in long minlength, in long maxLength ) raises (NetComponents::TransportException, CtsSecurity::TransportException, CtsSecurity::SSLException);
Reads data from the peer into the supplied buffer.
void readIntoBuffer ( inout long length, in XDT::Binary bufferRef ) raises (NetComponents::TransportException, CtsSecurity::TransportException, CtsSecurity::SSLException);
Note: This method may only be called from a C++ component.
The implementation of this method expects that the bufferRef contains a a reference to the buffer. In essense you are passing a pointer. You can not do this in Java.