Package com.sun.xml.ws.api.server

Interface TransportBackChannel

All Known Implementing Classes:
TCPAdapter.TCPToolkit
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.

Author:
Kohsuke Kawaguchi, Jitu

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    close()
    See the class javadoc for the discussion.

  • Method Details

    • 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.