public interface Call
extends com.ibm.websphere.webservices.rpc.IBMCall
com.ibm.wsspi.webservices.Call
interface extends support
for the dynamic invocation of a service endpoint. The
com.ibm.wsspi.webservices.Service
interface acts as a factory
for the creation of Call
instances specifically tailored for WSIF.
Once a Call
instance is created, various setter
and getter methods may be used to configure this Call
instance.
Modifier and Type | Method and Description |
---|---|
void |
addAttachmentPart(java.lang.Object attachment)
Deprecated.
This method is not an appropriate application-level API. It
will eventually disappear in favor of an as-yet-undefined SPI.
|
void |
addFault(javax.xml.namespace.QName faultCode,
java.lang.Class cls,
javax.xml.namespace.QName msgQName,
javax.xml.namespace.QName xmlType,
javax.xml.namespace.QName partQName)
Add a fault for this operation
|
void |
addHeader(com.ibm.ws.webservices.engine.xmlsoap.SOAPHeaderElement header)
Add a header which should be inserted into each outgoing message
we generate.
|
void |
clearHeaders()
Clear the list of headers which we insert into each message
|
java.util.List |
invoke(com.ibm.ws.webservices.engine.xmlsoap.SOAPBodyElement[] inputParams)
Deprecated.
There is no long term commitment to support this method
|
com.ibm.ws.webservices.engine.xmlsoap.SOAPEnvelope |
invoke(com.ibm.ws.webservices.engine.xmlsoap.SOAPEnvelope env)
Invoke the service with a custom SOAPEnvelope.
|
void |
invokeOneWay(com.ibm.ws.webservices.engine.xmlsoap.SOAPBodyElement[] params)
Deprecated.
There is no long term commitment to support this method
|
void |
registerTypeMapping(java.lang.Class javaType,
javax.xml.namespace.QName xmlType,
com.ibm.ws.webservices.engine.encoding.SerializerFactory sf,
com.ibm.ws.webservices.engine.encoding.DeserializerFactory df)
Register type mapping information for serialization/deserialization
|
void |
setEncodingStyle(java.lang.String namespaceURI)
Sets the encoding style to the URL passed in.
|
void |
setMaintainSession(boolean yesno)
Determine whether we'd like to track sessions or not.
|
void |
setOperationStyle(java.lang.String operationStyle)
Set the operation style: "document", "rpc", "wrapped", or "message".
|
void |
setOperationUse(java.lang.String operationUse)
Set the operation use: "literal", "encoded".
|
void |
setPortName(javax.xml.namespace.QName portName)
Sets the port name of this Call object.
|
addAttachmentParameter, addParameter, addParameter, setAttachmentReturnType
addParameter, addParameter, getOperationName, getOutputParams, getOutputValues, getParameterTypeByName, getPortTypeName, getProperty, getPropertyNames, getReturnType, getTargetEndpointAddress, invoke, invoke, invokeOneWay, isParameterAndReturnSpecRequired, removeAllParameters, removeProperty, setOperationName, setPortTypeName, setProperty, setReturnType, setReturnType, setTargetEndpointAddress
com.ibm.ws.webservices.engine.xmlsoap.SOAPEnvelope invoke(com.ibm.ws.webservices.engine.xmlsoap.SOAPEnvelope env) throws java.rmi.RemoteException
env
- a SOAPEnvelope to send.WebServicesFault
java.rmi.RemoteException
java.util.List invoke(com.ibm.ws.webservices.engine.xmlsoap.SOAPBodyElement[] inputParams) throws java.rmi.RemoteException
inputParams
- SOAPBodyElement[]--Parameters for this invocation. This
includes only the input paramsnull
java.rmi.RemoteException
- if there is any error in the remote
method invocation or if the Call
object is not configured properly.SOAPFaultException
- Indicates a SOAP faultJAXRPCException
- Call
object
inputParams
do not match the required parameter
set (as specified through the addParameter
invocations or in the corresponding WSDL)
void invokeOneWay(com.ibm.ws.webservices.engine.xmlsoap.SOAPBodyElement[] params)
JAXRPCException
during the processing of the one-way
remote call. Requested by WSIF/WSGWparams
- SOAPBodyElement[]--Parameters for this invocation. This
includes only the input params.JAXRPCException
- if there is an error in the
configuration of the Call
object (example: a
non-void return type has been incorrectly specified for the
one-way call) or if there is any error during the
invocation of the one-way remote callvoid addAttachmentPart(java.lang.Object attachment)
java.lang.RuntimeException
- if there is no support for attachments.void addHeader(com.ibm.ws.webservices.engine.xmlsoap.SOAPHeaderElement header)
header
- a SOAPHeaderElement to be inserted into messagesvoid setOperationStyle(java.lang.String operationStyle)
operationStyle
- string designating stylevoid setOperationUse(java.lang.String operationUse)
operationUse
- string designating usecom.ibm.wsspi.webservices.Constants.OPERATION_USE_LITERAL
,
com.ibm.wsspi.webservices.Constants.OPERATION_USE_ENCODED
void clearHeaders()
void setPortName(javax.xml.namespace.QName portName)
portName
- Fully qualified name of the portvoid setMaintainSession(boolean yesno)
yesno
- true if session state is desired, false if not.void setEncodingStyle(java.lang.String namespaceURI)
namespaceURI
- URI of the encoding to use.void registerTypeMapping(java.lang.Class javaType, javax.xml.namespace.QName xmlType, com.ibm.ws.webservices.engine.encoding.SerializerFactory sf, com.ibm.ws.webservices.engine.encoding.DeserializerFactory df)
javaType
- is the Java class of the data type.xmlType
- the xsi:type QName of the associated XML type.sf
- the serializer factory (or the Class object of the factory).df
- the deserializer factory (or the Class object of the factory).void addFault(javax.xml.namespace.QName faultCode, java.lang.Class cls, javax.xml.namespace.QName msgQName, javax.xml.namespace.QName xmlType, javax.xml.namespace.QName partQName)
faultCode
- QName used in SOAPFault fault code (same as messageQName if simple fault)cls
- Class of matching ExceptionmsgQName
- QName of WSDL MessagexmlType
- QName of complex type of PartpartQName
- QName of Part