Oracle Fusion Middleware
Oracle WebLogic Server API Reference
11g Release 1 (10.3.6)

Part Number E13941-06

weblogic.jws.jaxws.client.async
Class AsyncClientTransportFeature

java.lang.Object
  extended by javax.xml.ws.WebServiceFeature
      extended by weblogic.jws.jaxws.WLSWebServiceFeature
          extended by weblogic.jws.jaxws.client.async.AsyncClientTransportFeature
All Implemented Interfaces:
com.sun.xml.ws.api.client.ServiceCreationInterceptor, com.sun.xml.ws.binding.ImpliesWebServiceFeature

public class AsyncClientTransportFeature
extends WLSWebServiceFeature
implements com.sun.xml.ws.binding.ImpliesWebServiceFeature, com.sun.xml.ws.api.client.ServiceCreationInterceptor

Designates a client that accesses the service through WS-Addressing and asynchronous transport. Use of this feature will by default publish a response endpoint to receive inbound response messages and correlate request and response exchanges. Clients may create multiple ports or Dispatch instances from the same Service instance that share the same response endpoint by specifying the same AsyncClientTransportFeature instance; however, at most one of the port instances may specify AsyncClientHandlerFeature.

Since:
2.1.5

Nested Class Summary
static interface AsyncClientTransportFeature.AsyncEndpointListener
           
static interface AsyncClientTransportFeature.AsyncResponseEndpointRegistry
           
 
Field Summary
static String ID
          Constant value identifying the AsyncClientTransportFeature
 
Fields inherited from class javax.xml.ws.WebServiceFeature
enabled
 
Constructor Summary
AsyncClientTransportFeature()
          Create an AsyncClientTransportFeature.
AsyncClientTransportFeature(Object context)
          Create an AsyncClientTransportFeature that will select an asynchronous response endpoint address within the scope of a pre-existing context.
AsyncClientTransportFeature(Object context, boolean useAsyncWithSyncInvoke)
          Create an AsyncClientTransportFeature that will select an asynchronous response endpoint address within the scope of a pre-existing context.
AsyncClientTransportFeature(String address)
          Create an AsyncClientTransportFeature that will publish an asynchronous response endpoint at the given address.
AsyncClientTransportFeature(String address, boolean doPublish)
          Create an AsyncClientTransportFeature.
AsyncClientTransportFeature(String address, boolean doPublish, boolean useAsyncWithSyncInvoke)
          Create an AsyncClientTransportFeature.
AsyncClientTransportFeature(javax.xml.ws.wsaddressing.W3CEndpointReference replyTo)
          Create an AsyncClientTransportFeature that will publish an asynchronous response endpoint at the address specified by the given endpoint reference.
AsyncClientTransportFeature(javax.xml.ws.wsaddressing.W3CEndpointReference replyTo, boolean doPublish)
          Create an AsyncClientTransportFeature.
AsyncClientTransportFeature(javax.xml.ws.wsaddressing.W3CEndpointReference replyTo, boolean doPublish, boolean useAsyncWithSyncInvoke)
          Create an AsyncClientTransportFeature.
AsyncClientTransportFeature(javax.xml.ws.wsaddressing.W3CEndpointReference replyTo, javax.xml.ws.wsaddressing.W3CEndpointReference faultTo)
          Create an AsyncClientTransportFeature that will publish an asynchronous response endpoint at the address specified by the given replyTo endpoint reference.
AsyncClientTransportFeature(javax.xml.ws.wsaddressing.W3CEndpointReference replyTo, javax.xml.ws.wsaddressing.W3CEndpointReference faultTo, boolean doPublish)
          Create an AsyncClientTransportFeature.
AsyncClientTransportFeature(javax.xml.ws.wsaddressing.W3CEndpointReference replyTo, javax.xml.ws.wsaddressing.W3CEndpointReference faultTo, boolean doPublish, boolean useAsyncWithSyncInvoke)
          Create an AsyncClientTransportFeature.
 
Method Summary
 void addAsyncEndpointListener(AsyncClientTransportFeature.AsyncEndpointListener listener)
           
 void dispose()
           
 boolean equals(Object other)
           
 String getClientIdComponent()
           
 Endpoint getEndpoint()
           
<T extends EndpointReference>
T
getEndpointReference(Class<T> clazz, Element... referenceParameters)
          Generates endpoint reference for response endpoint
 String getID()
          Returns feature ID
 int getSslPort()
          Get the port used for SSL or -1 if unset.
 int hashCode()
           
 void implyFeatures(Map<Class<? extends WebServiceFeature>,WebServiceFeature> list)
           
 boolean isEndpointPublished()
           
 boolean isEndpointShared()
          Determine if the endpoint returned by getEndpoint() is actually a 'shared' endpoint (that was registered/associated with a client identity).
 boolean isUseAsyncWithSyncInvoke()
           
 void postCreateDispatch(com.sun.xml.ws.developer.WSBindingProvider bp)
          A callback to notify that a Dispatch object is created.
 void postCreateProxy(com.sun.xml.ws.developer.WSBindingProvider bp, Class<?> serviceEndpointInterface)
          A callback to notify the event of creation of proxy object for SEI endpoint.
 void preRegisterForSharedEndpoint(weblogic.jws.jaxws.client.ClientIdentityFeature clientIdFeature)
           
 void removeAsyncEndpointListener(AsyncClientTransportFeature.AsyncEndpointListener listener)
           
static void setAsyncResponseEndpointRegistry(AsyncClientTransportFeature.AsyncResponseEndpointRegistry registry)
           
 void setSslPort(int sslPort)
          Set the port used for SSL or -1 to disable SSL use on this feature.
 void setUseAsyncWithSyncInvoke(boolean useAsyncWithSyncInvoke)
           
 String toString()
           
 
Methods inherited from class weblogic.jws.jaxws.WLSWebServiceFeature
featuresAreEqual, isKnownTubelineImpactingFeature, isTubelineImpact, setTubelineImpact
 
Methods inherited from class javax.xml.ws.WebServiceFeature
isEnabled
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

ID

public static final String ID
Constant value identifying the AsyncClientTransportFeature

See Also:
Constant Field Values
Constructor Detail

AsyncClientTransportFeature

public AsyncClientTransportFeature()
Create an AsyncClientTransportFeature. Client proxies created using this feature will publish and use an asynchronous response endpoint with an auto-selected address.


AsyncClientTransportFeature

public AsyncClientTransportFeature(Object context)
Create an AsyncClientTransportFeature that will select an asynchronous response endpoint address within the scope of a pre-existing context. The context parameter may be an instance of javax.servlet.ServletContext. Other context types are implementation dependent.

Parameters:
context - Existing context that will scope response endpoint
See Also:
ServletContext

AsyncClientTransportFeature

public AsyncClientTransportFeature(Object context,
                                   boolean useAsyncWithSyncInvoke)
Create an AsyncClientTransportFeature that will select an asynchronous response endpoint address within the scope of a pre-existing context. The context parameter may be an instance of javax.servlet.ServletContext. Other context types are implementation dependent.

Parameters:
context - Existing context that will scope response endpoint
useAsyncWithSyncInvoke - Determines if async transport will be used with sync invocation
See Also:
ServletContext

AsyncClientTransportFeature

public AsyncClientTransportFeature(String address)
Create an AsyncClientTransportFeature that will publish an asynchronous response endpoint at the given address.
NOTE:This constructor should be used for off-server clients only. Any clients running inside a WLS cluster should use one of the "context based" constructors instead (allowing the client container to calculate the proper address based on the context associated with the container).

Parameters:
address - Asynchronous response endpoint address

AsyncClientTransportFeature

public AsyncClientTransportFeature(javax.xml.ws.wsaddressing.W3CEndpointReference replyTo)
Create an AsyncClientTransportFeature that will publish an asynchronous response endpoint at the address specified by the given endpoint reference. This endpoint reference will be used for outgoing ReplyTo headers.
NOTE:This constructor should be used for off-server clients only. Any clients running inside a WLS cluster should use one of the "context based" constructors instead (allowing the client container to calculate the proper address based on the context associated with the container).

Parameters:
replyTo - Asynchronous response endpoint reference

AsyncClientTransportFeature

public AsyncClientTransportFeature(javax.xml.ws.wsaddressing.W3CEndpointReference replyTo,
                                   javax.xml.ws.wsaddressing.W3CEndpointReference faultTo)
Create an AsyncClientTransportFeature that will publish an asynchronous response endpoint at the address specified by the given replyTo endpoint reference. The replyTo and faultTo endpoint references will be used for outgoing ReplyTo and FaultTo headers, respectively.
NOTE:This constructor should be used for off-server clients only. Any clients running inside a WLS cluster should use one of the "context based" constructors instead (allowing the client container to calculate the proper address based on the context associated with the container).

Parameters:
replyTo - Asynchronous response endpoint reference
faultTo - FaultTo endpoint reference

AsyncClientTransportFeature

public AsyncClientTransportFeature(String address,
                                   boolean doPublish)
Create an AsyncClientTransportFeature. If doPublish is true then an asynchronous response endpoint will be published at the given address. Otherwise, no endpoint will be published, but WSA headers will be added to outbound, non-oneway request messages.
NOTE:This constructor should be used for off-server clients only. Any clients running inside a WLS cluster should use one of the "context based" constructors instead (allowing the client container to calculate the proper address based on the context associated with the container).

Parameters:
address - Asynchronous response endpoint address
doPublish - Determines if response endpoint will be auto-published

AsyncClientTransportFeature

public AsyncClientTransportFeature(javax.xml.ws.wsaddressing.W3CEndpointReference replyTo,
                                   boolean doPublish)
Create an AsyncClientTransportFeature. If doPublish is true then an asynchronous response endpoint will be published at the address specified by the replyTo endpoint reference. Otherwise, no endpoint will be published, but WSA headers will be added to outbound, non-oneway request messages.
NOTE:This constructor should be used for off-server clients only. Any clients running inside a WLS cluster should use one of the "context based" constructors instead (allowing the client container to calculate the proper address based on the context associated with the container).

Parameters:
replyTo - Asynchronous response endpoint reference
doPublish - Determines if response endpoint will be auto-published

AsyncClientTransportFeature

public AsyncClientTransportFeature(javax.xml.ws.wsaddressing.W3CEndpointReference replyTo,
                                   javax.xml.ws.wsaddressing.W3CEndpointReference faultTo,
                                   boolean doPublish)
Create an AsyncClientTransportFeature. If doPublish is true then an asynchronous response endpoint will be published at the address specified by the replyTo endpoint reference. Otherwise, no endpoint will be published, but WSA headers will be added to outbound, non-oneway request messages. The replyTo and faultTo endpoint references will be used for outgoing ReplyTo and FaultTo headers, respectively.
NOTE:This constructor should be used for off-server clients only. Any clients running inside a WLS cluster should use one of the "context based" constructors instead (allowing the client container to calculate the proper address based on the context associated with the container).

Parameters:
replyTo - Asynchronous response endpoint reference
faultTo - FaultTo endpoint reference
doPublish - Determines if response endpoint will be auto-published

AsyncClientTransportFeature

public AsyncClientTransportFeature(String address,
                                   boolean doPublish,
                                   boolean useAsyncWithSyncInvoke)
Create an AsyncClientTransportFeature. If doPublish is true then an asynchronous response endpoint will be published at the given address. Otherwise, no endpoint will be published, but WSA headers will be added to outbound, non-oneway request messages.
NOTE:This constructor should be used for off-server clients only. Any clients running inside a WLS cluster should use one of the "context based" constructors instead (allowing the client container to calculate the proper address based on the context associated with the container).

Parameters:
address - Asynchronous response endpoint address
doPublish - Determines if feature deploys response endpoint or if client application is responsible
useAsyncWithSyncInvoke - Determines if async transport will be used with sync invocation

AsyncClientTransportFeature

public AsyncClientTransportFeature(javax.xml.ws.wsaddressing.W3CEndpointReference replyTo,
                                   boolean doPublish,
                                   boolean useAsyncWithSyncInvoke)
Create an AsyncClientTransportFeature. If doPublish is true then an asynchronous response endpoint will be published at the address specified by the replyTo endpoint reference. Otherwise, no endpoint will be published, but WSA headers will be added to outbound, non-oneway request messages.
NOTE:This constructor should be used for off-server clients only. Any clients running inside a WLS cluster should use one of the "context based" constructors instead (allowing the client container to calculate the proper address based on the context associated with the container).

Parameters:
replyTo - Asynchronous response endpoint reference
doPublish - Determines if response endpoint will be auto-published
useAsyncWithSyncInvoke - Determines if async transport will be used with sync invocation

AsyncClientTransportFeature

public AsyncClientTransportFeature(javax.xml.ws.wsaddressing.W3CEndpointReference replyTo,
                                   javax.xml.ws.wsaddressing.W3CEndpointReference faultTo,
                                   boolean doPublish,
                                   boolean useAsyncWithSyncInvoke)
Create an AsyncClientTransportFeature. If doPublish is true then an asynchronous response endpoint will be published at the address specified by the replyTo endpoint reference. Otherwise, no endpoint will be published, but WSA headers will be added to outbound, non-oneway request messages. The replyTo and faultTo endpoint references will be used for outgoing ReplyTo and FaultTo headers, respectively.
NOTE:This constructor should be used for off-server clients only. Any clients running inside a WLS cluster should use one of the "context based" constructors instead (allowing the client container to calculate the proper address based on the context associated with the container).

Parameters:
replyTo - Asynchronous response endpoint reference
faultTo - FaultTo endpoint reference
doPublish - Determines if response endpoint will be auto-published
useAsyncWithSyncInvoke - Determines if async transport will be used with sync invocation
Method Detail

setAsyncResponseEndpointRegistry

public static void setAsyncResponseEndpointRegistry(AsyncClientTransportFeature.AsyncResponseEndpointRegistry registry)

postCreateDispatch

public void postCreateDispatch(com.sun.xml.ws.developer.WSBindingProvider bp)
Description copied from interface: com.sun.xml.ws.api.client.ServiceCreationInterceptor
A callback to notify that a Dispatch object is created. The callback could set some properties on the BindingProvider.

Specified by:
postCreateDispatch in interface com.sun.xml.ws.api.client.ServiceCreationInterceptor
Parameters:
bp - BindingProvider of dispatch object

postCreateProxy

public void postCreateProxy(com.sun.xml.ws.developer.WSBindingProvider bp,
                            Class<?> serviceEndpointInterface)
Description copied from interface: com.sun.xml.ws.api.client.ServiceCreationInterceptor
A callback to notify the event of creation of proxy object for SEI endpoint. The callback could set some properties on the BindingProvider.

Specified by:
postCreateProxy in interface com.sun.xml.ws.api.client.ServiceCreationInterceptor
Parameters:
bp - created proxy instance
serviceEndpointInterface - SEI of the endpoint

setSslPort

public void setSslPort(int sslPort)
Set the port used for SSL or -1 to disable SSL use on this feature. NOTE: The SSL port is calculated automatically if this feature is initialized using a context object that supports automatic discovery of SSL configuration (e.g. running in WLS service, EJB or web app container).


getSslPort

public int getSslPort()
Get the port used for SSL or -1 if unset.


preRegisterForSharedEndpoint

public void preRegisterForSharedEndpoint(weblogic.jws.jaxws.client.ClientIdentityFeature clientIdFeature)

dispose

public void dispose()

isEndpointShared

public boolean isEndpointShared()
Determine if the endpoint returned by getEndpoint() is actually a 'shared' endpoint (that was registered/associated with a client identity). If this is the case, this endpoint has the same lifetime as the client identity. If the client identity is disposed, the endpoint will be closed.


getEndpoint

public Endpoint getEndpoint()

getEndpointReference

public <T extends EndpointReference> T getEndpointReference(Class<T> clazz,
                                                            Element... referenceParameters)
Generates endpoint reference for response endpoint

Parameters:
clazz - Endpoint reference type
referenceParameters - Reference parameters
Returns:
Endpoint reference for response endpoint

getID

public String getID()
Returns feature ID

Specified by:
getID in class WebServiceFeature

isUseAsyncWithSyncInvoke

public boolean isUseAsyncWithSyncInvoke()

setUseAsyncWithSyncInvoke

public void setUseAsyncWithSyncInvoke(boolean useAsyncWithSyncInvoke)

implyFeatures

public void implyFeatures(Map<Class<? extends WebServiceFeature>,WebServiceFeature> list)
Specified by:
implyFeatures in interface com.sun.xml.ws.binding.ImpliesWebServiceFeature

isEndpointPublished

public boolean isEndpointPublished()

addAsyncEndpointListener

public void addAsyncEndpointListener(AsyncClientTransportFeature.AsyncEndpointListener listener)

removeAsyncEndpointListener

public void removeAsyncEndpointListener(AsyncClientTransportFeature.AsyncEndpointListener listener)

hashCode

public int hashCode()
Overrides:
hashCode in class Object

equals

public boolean equals(Object other)
Overrides:
equals in class Object

getClientIdComponent

public String getClientIdComponent()
Overrides:
getClientIdComponent in class WLSWebServiceFeature

toString

public String toString()
Overrides:
toString in class Object

Copyright 1996, 2011, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Oracle Fusion Middleware
Oracle WebLogic Server API Reference
11g Release 1 (10.3.6)

Part Number E13941-06