com.sun.xml.ws.api.server
Interface TransportBackChannel

All Known Implementing Classes:
HttpAdapter.Oneway

public interface TransportBackChannel

Represents a transport back-channel.

When the JAX-WS runtime finds out that the request Packet being processed is known not to produce a response, it invokes the close() method to indicate that the transport does not need to keep the channel for the response message open.

This allows the transport to close down the communication channel sooner than wainting for WSEndpoint.PipeHead.process(com.sun.xml.ws.api.message.Packet, com.sun.xml.ws.api.server.WebServiceContextDelegate, com.sun.xml.ws.api.server.TransportBackChannel) method to return, thereby improving the overall throughput of the system.


Method Summary
 void close()
          See the class javadoc for the discussion.
 

Method Detail

close

void close()
See the class javadoc for the discussion.

JAX-WS is not guaranteed to call this method for all operations that do not have a response. This is merely a hint.

When the implementation of this method fails to close the connection successfuly, it should record the error, and return normally. Do not throw any exception.