Java Doc for TubelineAssembler.java in  » 6.0-JDK-Modules » jax-ws-runtime » com » sun » xml » ws » api » pipe » Java Source Code / Java DocumentationJava Source Code and Java Documentation

This pluggability layer enables the upper layer to control exactly how the tubeline is composed.

JAX-WS is going to have its own default implementation when used all by itself, but it can be substituted by other implementations.

See TubelineAssemblerFactory for how TubelineAssembler s are located.
See Also:   com.sun.xml.ws.api.pipe.ClientTubeAssemblerContext
author:
   Kohsuke Kawaguchi
author:
   Jitendra Kotamraju

When a JAX-WS client creates a proxy or a javax.xml.ws.Dispatch from a javax.xml.ws.Service , JAX-WS runtime internally uses this method to create a new tubeline as a part of the initilization.
Parameters:
  context - Object that captures various contextual informationthat can be used to determine the tubeline to be assembled.non-null freshly created tubeline.
throws:
  javax.xml.ws.WebServiceException - if there's any configuration error that prevents thetubeline from being constructed.

When a JAX-WS server deploys a new endpoint, it internally uses this method to create a new tubeline as a part of the initialization.

Note that this method is called only once to set up a 'master tubeline', and it gets Tube.copy(TubeCloner) copied from it.
Parameters:
  context - Object that captures various contextual informationthat can be used to determine the tubeline to be assembled.non-null freshly created tubeline.
throws:
  javax.xml.ws.WebServiceException - if there's any configuration error that prevents thetubeline from being constructed.

When a JAX-WS client creates a proxy or a javax.xml.ws.Dispatch from a javax.xml.ws.Service , JAX-WS runtime internally uses this method to create a new tubeline as a part of the initilization.
Parameters:
  context - Object that captures various contextual informationthat can be used to determine the tubeline to be assembled.non-null freshly created tubeline.
throws:
  javax.xml.ws.WebServiceException - if there's any configuration error that prevents thetubeline from being constructed. This exception will bepropagated into the application, so it must havea descriptive error.

When a JAX-WS server deploys a new endpoint, it internally uses this method to create a new tubeline as a part of the initialization.

Note that this method is called only once to set up a 'master tubeline', and it gets Tube.copy(TubeCloner) copied from it.
Parameters:
  context - Object that captures various contextual informationthat can be used to determine the tubeline to be assembled.non-null freshly created tubeline.
throws:
  javax.xml.ws.WebServiceException - if there's any configuration error that prevents thetubeline from being constructed. This exception will bepropagated into the container, so it must havea descriptive error.