This method is invoked by ServerConnectionManager with the request input stream and the response output stream of the {@link InboundRequest} that it creates for the request when therequest is first received. This method reads information that was sent by {@link Connection#writeRequestData Connection.writeRequestData} and writes information to be readby {@link Connection#readResponseData Connection.readResponseData}. This method can be used, for example, to process per-request information about delegation, client authentication, or client privileges.
If, for security reasons, this method determines that the request must not be processed further (for example, because client authentication failed), this method should close the response output stream and throw a SecurityException after writing any response data.
There may be multiple requests in progress concurrently over this connection, and data read from and written to the specified streams may be buffered and multiplexed with data from other requests on this connection's underlying streams. Therefore, this method should only read data from the request input stream and write data to the response output stream and must not otherwise read from or write to this connection's underlying streams.
@param in the request input stream of the request
@param out the response output stream of the request
@return a handle to identify the request in later invocationson this connection
@throws NullPointerException if in orout is null
@throws IOException if an I/O exception occurs
@throws SecurityException if a security exception occurs
| |
| |