< prev index next >
src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/Stubs.java
Print this page
*** 73,106 ****
* <h2>Common Parameters and Their Meanings</h2>
*
* <h3>Pipe next</h3>
* <p>
* Stubs turn a method invocation into a {@link Pipe#process(com.sun.xml.internal.ws.api.message.Packet)} invocation,
! * and this pipe passed in as the <tt>next</tt> parameter will receive a {@link Message}
* from newly created stub. All the methods taking Tube <<next>> parameter are deprecated. JAX-WS Runtime takes care of
! * creating the tubeline when the <tt>next</tt> parameter is not passed. This gives flexibility for the JAX-WS Runtime
* to pass extra information during the tube line creation via {@link ClientTubeAssemblerContext}.
*
* <h3>WSPortInfo portInfo</h3>
* <p> Gives information about the port for which the "stub" being created. Such information includes Port QName,
* target endpoint address, and bindingId etc.
*
* <h3>BindingImpl binding</h3>
* <p>
* Stubs implement {@link BindingProvider}, and its {@link BindingProvider#getBinding()}
! * will return this <tt>binding</tt> object. Stubs often also use this information
* to decide which SOAP version a {@link Message} should be created in.
*
* <h3>{@link WSService} service</h3>
* <p>
* This object represents a {@link Service} that owns the newly created stub.
* For example, asynchronous method invocation will use {@link Service#getExecutor()}.
*
* <h3>{@link WSEndpointReference} epr</h3>
* <p>
* If you want the created {@link Dispatch} to talk to the given EPR, specify the parameter.
! * Otherwise leave it <tt>null</tt>. Note that the addressing needs to be enabled separately
* for this to take effect.
*
* @author Kohsuke Kawaguchi
* @author Kathy Walsh
*/
--- 73,106 ----
* <h2>Common Parameters and Their Meanings</h2>
*
* <h3>Pipe next</h3>
* <p>
* Stubs turn a method invocation into a {@link Pipe#process(com.sun.xml.internal.ws.api.message.Packet)} invocation,
! * and this pipe passed in as the {@code next} parameter will receive a {@link Message}
* from newly created stub. All the methods taking Tube <<next>> parameter are deprecated. JAX-WS Runtime takes care of
! * creating the tubeline when the {@code next} parameter is not passed. This gives flexibility for the JAX-WS Runtime
* to pass extra information during the tube line creation via {@link ClientTubeAssemblerContext}.
*
* <h3>WSPortInfo portInfo</h3>
* <p> Gives information about the port for which the "stub" being created. Such information includes Port QName,
* target endpoint address, and bindingId etc.
*
* <h3>BindingImpl binding</h3>
* <p>
* Stubs implement {@link BindingProvider}, and its {@link BindingProvider#getBinding()}
! * will return this {@code binding} object. Stubs often also use this information
* to decide which SOAP version a {@link Message} should be created in.
*
* <h3>{@link WSService} service</h3>
* <p>
* This object represents a {@link Service} that owns the newly created stub.
* For example, asynchronous method invocation will use {@link Service#getExecutor()}.
*
* <h3>{@link WSEndpointReference} epr</h3>
* <p>
* If you want the created {@link Dispatch} to talk to the given EPR, specify the parameter.
! * Otherwise leave it {@code null}. Note that the addressing needs to be enabled separately
* for this to take effect.
*
* @author Kohsuke Kawaguchi
* @author Kathy Walsh
*/
< prev index next >