com.webmethods.caf.wsclient.proxy
Interface IWSClientProxy

All Superinterfaces:
InvocationHandler
All Known Implementing Classes:
WSClientDynamicProxy

public interface IWSClientProxy
extends InvocationHandler

This is the web service proxy stub which is invoked by clients and returned by the IWSProxyFactory.getProxy(java.lang.Class, java.lang.String, java.lang.String)


Method Summary
 void addFailedAuthCallback(IFailedAuthCallback callbackObj)
          Register a IFailedAuthCallback listener to be invoked when an authentication failure occurs when invoking a web service
 void flushCache()
          Flush the cache web service results cache associated with this proxy
 AuthCredentials getAuthCredentials()
          Get the AuthCredentials used by this proxy to authenticate web service request.
 int getClientSocketReadTimeout()
          Get the socket timeout.
 String getEndPointURL()
          Get the endpoint that this web service proxy will invoke
 List getFailedAuthListeners()
          Get the list of all registered IFailedAuthCallback listeners
 String getHostURL()
          Get the host partion of the IWSClientProxy.getEndPointURL() }
 IWSProxyFactory getProxyFactory()
          The factory that instantiated this proxy
 boolean getReuseSession()
          Whether to attempt to recycle an existing IWSClientSession when invoking a web service
 boolean getUseCache()
          Whether invocations will check with the CacheManager
 Class getWebServiceClass()
          Get the portType class that this IWSClientProxy instance is proxying
 String getWsdlURL()
          The WSDL url for this proxy
 void removeFailedAuthCallback(IFailedAuthCallback callbackObj)
          Remove a specific IFailedAuthCallback object from the list of listeners
 void setReuseSession(boolean reuseSession)
          Specify whether to attempt to recycle an existing IWSClientSession when invoking a web service
 void setUseCache(boolean useCache)
          Set option for the cache manager to cache web service results
 
Methods inherited from interface java.lang.reflect.InvocationHandler
invoke
 

Method Detail

getProxyFactory

IWSProxyFactory getProxyFactory()
The factory that instantiated this proxy

Returns:
the IWSProxyFactory that created this proxy instance

getEndPointURL

String getEndPointURL()
Get the endpoint that this web service proxy will invoke

Returns:
the endpoint URL as string

getHostURL

String getHostURL()
Get the host partion of the IWSClientProxy.getEndPointURL() }

Returns:
the host name as string

getWsdlURL

String getWsdlURL()
The WSDL url for this proxy

Returns:
the WSDL URL as a string

getUseCache

boolean getUseCache()
Whether invocations will check with the CacheManager

Returns:
true if the cache manager is configured to use caching

setUseCache

void setUseCache(boolean useCache)
Set option for the cache manager to cache web service results

Parameters:
useCache - true to enable caching, false to disable caching

getReuseSession

boolean getReuseSession()
Whether to attempt to recycle an existing IWSClientSession when invoking a web service

Returns:
boolean true if session reuse is enabled, false if session reuse is disabled

setReuseSession

void setReuseSession(boolean reuseSession)
Specify whether to attempt to recycle an existing IWSClientSession when invoking a web service

Parameters:
reuseSession - true to enable session reuse, false to create a new session on each service invocation

getAuthCredentials

AuthCredentials getAuthCredentials()
Get the AuthCredentials used by this proxy to authenticate web service request. Specifying null credentials will use global credentials set on the @WSClient instance.

Returns:
the AuthCredentials for this proxy

getWebServiceClass

Class getWebServiceClass()
Get the portType class that this IWSClientProxy instance is proxying

Returns:
the portType as Class

getClientSocketReadTimeout

int getClientSocketReadTimeout()
Get the socket timeout. This is the number of milliseconds the web service request will wait before it gives up waiting for a response from the web service provider.

Returns:
the socket timeout value in milliseconds

addFailedAuthCallback

void addFailedAuthCallback(IFailedAuthCallback callbackObj)
Register a IFailedAuthCallback listener to be invoked when an authentication failure occurs when invoking a web service

Parameters:
callbackObj - - the IFailedAuthCallback object instance

removeFailedAuthCallback

void removeFailedAuthCallback(IFailedAuthCallback callbackObj)
Remove a specific IFailedAuthCallback object from the list of listeners

Parameters:
callbackObj - - the IFailedAuthCallback object instance to remove

getFailedAuthListeners

List getFailedAuthListeners()
Get the list of all registered IFailedAuthCallback listeners

Returns:
a List of IFailedAuthCallback instances

flushCache

void flushCache()
Flush the cache web service results cache associated with this proxy