public class DynamicClient
extends java.lang.Object
See the guide for more details.
This an example of use:
// Get an instance of DynamicClient
DynamicClient dc = new DynamicClient();
// Initialize DynamicClient for MathFunctions webservice by file
dc.initClient(new URI("file:./MathFunctions.wsdl"));
// Example of invocation of an operation (sum) with primitive input/output parameters only
WSData input = new WSData();
input.setParameter("firstElement", 5);
input.setParameter("secondElement", 3);
// Invoke the sum operation
WSData output = dc.invoke("sum", input);
float sum = output.getParameterFloat("sumReturn");
Modifier and Type | Class and Description |
---|---|
static class |
DynamicClient.State
State of DynamicClient.
|
Modifier and Type | Field and Description |
---|---|
static java.text.SimpleDateFormat |
ISO8601_DATE_FORMAT
W3C-ISO8601 date format used in conversion from String to Date
|
Constructor and Description |
---|
DynamicClient()
Create a new DynamicClient
|
Modifier and Type | Method and Description |
---|---|
static void |
disableCertificateChecking()
Disable the checking of security certificate
|
static void |
enableCertificateChecking()
Enable the checking of security certificate
|
java.net.URL |
getDefaultEndpoint()
Get the current default value of wsdl endpoint.
|
java.lang.String |
getDefaultHttpPassword()
Get the current default password for HTTP Basic Authentication
|
java.lang.String |
getDefaultHttpUsername()
Get the current default username for HTTP Basic Authentication
|
java.lang.String |
getDefaultPort()
Get the current default value of wsdl port.
|
java.lang.String |
getDefaultService()
Get the current default value of wsdl service.
|
int |
getDefaultTimeout()
Get the current default value for timeout call.
|
java.lang.String |
getDefaultWSSPassword()
Get the current default password for WS Security specifications - UsernameToken profile
|
java.lang.String |
getDefaultWSSPasswordType()
Get the current default password type for WS Security specifications - UsernameToken profile
|
java.lang.Integer |
getDefaultWSSTimeToLive()
Get defaultWSSTimeToLive value in second for WS Security specifications - Timestamp
|
java.lang.String |
getDefaultWSSUsername()
Get the current default username for WS Security specifications - UsernameToken profile
|
java.lang.String |
getDocumentation()
Return the wsdl documentation associated at
definition tag. |
jade.content.onto.Ontology |
getOntology()
Get the JADE ontology of current wsdl
|
DynamicClientProperties |
getProperties()
Get the current DynamicClient configuration properties
|
java.lang.String |
getReport()
Get the dynamic-client report of discovered wsdl
|
ServiceInfo |
getService(java.lang.String serviceName)
Get informations about the service
|
java.util.Set<java.lang.String> |
getServiceNames()
Get the set of service names present in current wsdl
|
DynamicClient.State |
getState()
Get the current state of DynamicClient
Possible values are:
CREATED: DynamicClient created but not already initialized
INITIALIZED: DynamicClient initialized and ready to use
INIT_FAILED: Some errors occurred during initialization, re-init it
|
void |
initClient(java.net.URI wsdlUri)
Initialize the DynamicClient with the specified wsdl.
|
void |
initClient(java.net.URI wsdlUri,
java.lang.String username,
java.lang.String password)
Initialize the DynamicClient with the specified wsdl.
|
WSData |
invoke(java.lang.String serviceName,
java.lang.String portName,
java.lang.String operation,
java.net.URL endpoint,
int timeout,
SecurityProperties securityProperties,
AddressingProperties addressingProperties,
WSData input)
Invoke a web-service operation.
|
WSData |
invoke(java.lang.String serviceName,
java.lang.String portName,
java.lang.String operation,
java.net.URL endpoint,
int timeout,
SecurityProperties securityProperties,
WSData input)
Invoke a web-service operation.
|
WSData |
invoke(java.lang.String serviceName,
java.lang.String portName,
java.lang.String operation,
java.net.URL endpoint,
int timeout,
WSData input)
Invoke a web-service operation.
|
WSData |
invoke(java.lang.String operation,
WSData input)
Invoke a web-service operation using default call values.
|
java.lang.Boolean |
isDefaultWSSMustUnderstand()
Get mustUnderstand flag for WS Security specifications - UsernameToken profile
|
void |
setDefaultEndpoint(java.net.URL defaultEndpoint)
Set the default url of wsdl endpoint.
|
void |
setDefaultHttpPassword(java.lang.String defaultHttpPassword)
Set the current default password for HTTP Basic Authentication
|
void |
setDefaultHttpUsername(java.lang.String defaultHttpUsername)
Set the current default username for HTTP Basic Authentication
|
void |
setDefaultPort(java.lang.String defaultPortName)
Set the default value of wsdl port.
|
void |
setDefaultService(java.lang.String defaultServiceName)
Set the default name of wsdl service.
|
void |
setDefaultTimeout(int defaultTimeout)
Set the default value for timeout call.
|
void |
setDefaultWSSMustUnderstand(boolean defaultWSSMustUnderstand)
Set mustUnderstand flag for WS Security specifications - UsernameToken profile
|
void |
setDefaultWSSPassword(java.lang.String defaultWSSPassword)
Set the current default password for WS Security specifications - UsernameToken profile
|
void |
setDefaultWSSPasswordType(java.lang.String defaultWSSPasswordType)
Set the current default password type for WS Security specifications - UsernameToken profile
|
void |
setDefaultWSSTimeToLive(int defaultWSSTimeToLive)
Set defaultWSSTimeToLive value in second for WS Security specifications - Timestamp
|
void |
setDefaultWSSUsername(java.lang.String defaultWSSUsername)
Set the current default username for WS Security specifications - UsernameToken profile
|
static void |
setNonProxyHosts(java.lang.String nonProxyHosts)
Set the list of host excluded from proxy.
|
void |
setProperties(DynamicClientProperties properties)
Set the configuration properties of DynamicClient
|
static void |
setProxyAuthentication(java.lang.String proxyUser,
java.lang.String proxyPassword)
Set proxy authentication credentials
|
static void |
setProxyHost(java.lang.String proxyHost)
Set the host of proxy
|
static void |
setProxyPort(java.lang.String proxyPort)
Set the port of proxy
|
static void |
setTrustStore(java.lang.String trustStore)
Set the file of the trust-store
|
static void |
setTrustStorePassword(java.lang.String trustStorePassword)
Set the password of the trust-store
|
public static final java.text.SimpleDateFormat ISO8601_DATE_FORMAT
public DynamicClientProperties getProperties()
DynamicClientProperties
public void setProperties(DynamicClientProperties properties)
properties
- configuration propertiesDynamicClientProperties
public java.net.URL getDefaultEndpoint()
public void setDefaultEndpoint(java.net.URL defaultEndpoint)
defaultEndpoint
- url of default endpointpublic java.lang.String getDefaultService()
public void setDefaultService(java.lang.String defaultServiceName)
defaultServiceName
- name of default servicepublic java.lang.String getDefaultPort()
public void setDefaultPort(java.lang.String defaultPortName)
defaultPortName
- name of default portpublic int getDefaultTimeout()
public void setDefaultTimeout(int defaultTimeout)
defaultTimeout
- value of default timeoutpublic java.lang.String getDefaultHttpUsername()
public void setDefaultHttpUsername(java.lang.String defaultHttpUsername)
defaultHttpUsername
- value of default http usernamepublic java.lang.String getDefaultHttpPassword()
public void setDefaultHttpPassword(java.lang.String defaultHttpPassword)
defaultHttpPassword
- value of default http passwordpublic java.lang.String getDefaultWSSUsername()
public void setDefaultWSSUsername(java.lang.String defaultWSSUsername)
defaultHttpUsername
- value of default wss usernamepublic java.lang.String getDefaultWSSPassword()
public void setDefaultWSSPassword(java.lang.String defaultWSSPassword)
defaultWSSPassword
- value of default wss passwordpublic java.lang.String getDefaultWSSPasswordType()
SecurityProperties
public void setDefaultWSSPasswordType(java.lang.String defaultWSSPasswordType)
defaultWSSPasswordType
- value of default wss passwordSecurityProperties
public java.lang.Boolean isDefaultWSSMustUnderstand()
SecurityProperties
public void setDefaultWSSMustUnderstand(boolean defaultWSSMustUnderstand)
wSSMustUnderstand
- mustUnderstand flagSecurityProperties
public java.lang.Integer getDefaultWSSTimeToLive()
SecurityProperties
public void setDefaultWSSTimeToLive(int defaultWSSTimeToLive)
defaultWSSTimeToLive
- defaultWSSTimeToLive valueSecurityProperties
public static void setTrustStore(java.lang.String trustStore)
trustStore
- trust-store filepublic static void setTrustStorePassword(java.lang.String trustStorePassword)
trustStorePassword
- password of trust-storepublic static void disableCertificateChecking()
public static void enableCertificateChecking()
public static void setProxyHost(java.lang.String proxyHost)
proxyHost
- proxy hostpublic static void setProxyPort(java.lang.String proxyPort)
proxyPort
- proxy portpublic static void setNonProxyHosts(java.lang.String nonProxyHosts)
|
to separate hosts.
Permitted *
as wildcards.nonProxyHosts
- list of hostspublic static void setProxyAuthentication(java.lang.String proxyUser, java.lang.String proxyPassword)
proxyUser
- authentication proxy userproxyPassword
- authentication proxy passwordpublic DynamicClient.State getState()
Possible values are:
public java.lang.String getDocumentation()
definition
tag.
<wsdl:definition name="WsdlName">
<wsdl:documentation>service documentation</wsdl:documentation>
</wsdl:service>
public void initClient(java.net.URI wsdlUri) throws DynamicClientException
wsdlUri
- uri (file or url) of wsdlDynamicClientException
public void initClient(java.net.URI wsdlUri, java.lang.String username, java.lang.String password) throws DynamicClientException
wsdlUri
- uri (file or url) of wsdlusername
- http username authentication to access wsdlpassword
- http password authentication to access wsdlDynamicClientException
public jade.content.onto.Ontology getOntology()
public java.util.Set<java.lang.String> getServiceNames()
public ServiceInfo getService(java.lang.String serviceName)
serviceName
- name of servicepublic WSData invoke(java.lang.String operation, WSData input) throws DynamicClientException, java.rmi.RemoteException
invoke(String serviceName, String portName, String operation, URL endpoint, int timeout, WSData input)
operation
- name of operationinput
- WSData input parameters/headersDynamicClientException
- client exceptionjava.rmi.RemoteException
- server exceptionDynamicClientProperties
,
WSData
public WSData invoke(java.lang.String serviceName, java.lang.String portName, java.lang.String operation, java.net.URL endpoint, int timeout, WSData input) throws DynamicClientException, java.rmi.RemoteException
serviceName
- name of service (null to use the default)portName
- name of port (null to use the default)operation
- name of operationendpoint
- webservice endpoint urltimeout
- call timeout in millisecond (0 no timeout, <0 to use default value)input
- WSData input parameters/headersDynamicClientException
- client exceptionjava.rmi.RemoteException
- server exceptionDynamicClientProperties
,
WSData
public WSData invoke(java.lang.String serviceName, java.lang.String portName, java.lang.String operation, java.net.URL endpoint, int timeout, SecurityProperties securityProperties, WSData input) throws DynamicClientException, java.rmi.RemoteException
serviceName
- name of service (null to use the default)portName
- name of port (null to use the default)operation
- name of operationendpoint
- webservice endpoint urltimeout
- call timeout in millisecond (0 no timeout, <0 to use default value)input
- WSData input parameters/headerssecurityProperties
- security configuration (HTTP, WSS,...)DynamicClientException
- client exceptionjava.rmi.RemoteException
- server exceptionDynamicClientProperties
,
WSData
public WSData invoke(java.lang.String serviceName, java.lang.String portName, java.lang.String operation, java.net.URL endpoint, int timeout, SecurityProperties securityProperties, AddressingProperties addressingProperties, WSData input) throws DynamicClientException, java.rmi.RemoteException
serviceName
- name of service (null to use the default)portName
- name of port (null to use the default)operation
- name of operationendpoint
- webservice endpoint urltimeout
- call timeout in millisecond (0 no timeout, <0 to use default value)input
- WSData input parameters/headerssecurityProperties
- security configuration (HTTP, WSS,...)addressingProperties
- WS-A configurationDynamicClientException
- client exceptionjava.rmi.RemoteException
- server exceptionDynamicClientProperties
,
WSData
public java.lang.String getReport()