com.webobjects.webservices.client
Class WOWebService

java.lang.Object
  com.webobjects.webservices.client.WOWebService

public class WOWebService
extends Object

A WOWebService represents a single SOAP HTTP service as defined in a WSDL document. It can be used to introspect the operations implemented on the Web service, or to create a call which can be used to invoke a given operation. A WOWebService is capable of maintaing session state through multiple invocations of operations on the Web service.

See Also:

Service, Call

Nested Class Summary

static class

WOWebService.SessionInfo SessionInfo stores all data required to connect to an existing Web service sessions.

Constructor Summary

WOWebService(QName aQName, URL aURL)
Create and initialize a new instance of WOWebService.

Method Summary

org.apache.axis.client.Service	axisService() Returns the underlying Axis service used to make Web service invocations.
org.apache.axis.client.Call	createCallForOperation(String opName) Creates an returns an Axis call object for the operation opName.
org.apache.axis.EngineConfiguration	engineConfiguration() Return the EngineConfiguration used by the underlying Axis service.
boolean	isOperationDocumentStyle(String operationName) Returns true if the operation name is document style, false otherwise.
boolean	isOperationRPCStyle(String operationName) Returns true if the operation name is RPC style, false otherwise.
String	name() Returns the local part of the QName of the service.
WOClientOperation	operationNamed(String operationName) Return the operation named name.
NSDictionary	operationsDictionary() Return an NSDictionary containing name to WOClientOperation mappings for all operations published in this service.
QName	qName() Returns the QName of the service.
void	registerFactoriesForClassWithQName(org.apache.axis.encoding.SerializerFactory sFactory, org.apache.axis.encoding.DeserializerFactory dFactory, Class aClass, QName aQName) Register aSerializerFactory for serializing objects of class aClass and aDeserializerFactory for deserializing DOM elements with QName aQName.
WOWebService.SessionInfo	sessionInfo() Return an opaque SessionInfo object which can be used to transfer session information between instances of WOWebService.
void	setEngineConfiguration(org.apache.axis.EngineConfiguration aConfig) Set the EngineConfiguration to used by the underlying Axis service.
void	setSecurityDelegate(Object aDelegate)
void	setSessionInfo(WOWebService.SessionInfo aSessionInfo) Set the session information for the service to the values contained in aSessionInfo.
String	toString()
Class	typeForQName(QName aQname) Return the class to which DOM elements with name aQName will be deserialized.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

WOWebService

public WOWebService(QName aQName,
                    URL aURL)

Create and initialize a new instance of WOWebService.

Parameters:

aQName - the QName of the service

aURL - the URL at which the WSDL for this service can be found

Method Detail

qName

public QName qName()

Returns the QName of the service.

Returns:

the QName of the service

name

public String name()

Returns the local part of the QName of the service.

Returns:

the name of the service

operationsDictionary

public NSDictionary operationsDictionary()

Return an NSDictionary containing name to WOClientOperation mappings for all operations published in this service.

Returns:

an NSDictionary of WOClientOperation instances

operationNamed

public WOClientOperation operationNamed(String operationName)

Return the operation named name.

Parameters:

name - the name of the operation being requested

Returns:

an instance of WOClientOperation or null

isOperationRPCStyle

public boolean isOperationRPCStyle(String operationName)

Returns true if the operation name is RPC style, false otherwise.

Parameters:

name - the name of the operation being checked

Returns:

true if name is a SOAP RPC style operation

isOperationDocumentStyle

public boolean isOperationDocumentStyle(String operationName)

Returns true if the operation name is document style, false otherwise.

Parameters:

name - the name of the operation being checked

Returns:

true if name is a document style operation

registerFactoriesForClassWithQName

public void registerFactoriesForClassWithQName(org.apache.axis.encoding.SerializerFactory sFactory,
                                               org.apache.axis.encoding.DeserializerFactory dFactory,
                                               Class aClass,
                                               QName aQName)

Register aSerializerFactory for serializing objects of class aClass and aDeserializerFactory for deserializing DOM elements with QName aQName. Objects serialized by aSerializerFactory will have a QName of aQName. If a aSerializerFactory is null, only aDeserializerFactory will be registered, and vice versa.

Parameters:

aSerializerFactory - factory for creating serializers for Class aClass

aDeserializerFactory - factory for creating deserializers for elements with QName aQName

aClass - Class which aSerializerFactory should be used to serialize

aQName - QName defining elements that aDeserializerFactory should be used to deserialize

typeForQName

public Class typeForQName(QName aQname)

Return the class to which DOM elements with name aQName will be deserialized. Will return null if there is no deserializer registered for aQName

Parameters:

aQName - a QName

Returns:

the class to which aQName will deserialize, or null

axisService

public org.apache.axis.client.Service axisService()

Returns the underlying Axis service used to make Web service invocations.

Returns:

the underlying Axis service

See Also:

Service

createCallForOperation

public org.apache.axis.client.Call createCallForOperation(String opName)
                                                   throws javax.xml.rpc.ServiceException

Creates an returns an Axis call object for the operation opName.

Parameters:

opName - String name of operation to be invoked

Returns:

Axis call object that can be used to invoke the operation

Throws:

javax.xml.rpc.ServiceException

See Also:

Call

setSecurityDelegate

public void setSecurityDelegate(Object aDelegate)

engineConfiguration

public org.apache.axis.EngineConfiguration engineConfiguration()

Return the EngineConfiguration used by the underlying Axis service.

Returns:

the org.apache.axis.EngineConfiguration for the receiver

setEngineConfiguration

public void setEngineConfiguration(org.apache.axis.EngineConfiguration aConfig)

Set the EngineConfiguration to used by the underlying Axis service. If the service has already been created, the existing instance will be freed.

Note: If you reset the service's engine configuration, all existing session information for the service will be lost.

Parameters:

aConfig - an org.apache.axis.EngineConfiguration

toString

public String toString()

Overrides:

toString in class Object

sessionInfo

public WOWebService.SessionInfo sessionInfo()

Return an opaque SessionInfo object which can be used to transfer session information between instances of WOWebService. If there is no session information, will return an empty SessionInfo.

Returns:

a SessionInfo object

setSessionInfo

public void setSessionInfo(WOWebService.SessionInfo aSessionInfo)

Set the session information for the service to the values contained in aSessionInfo.

Note: If after setting session information, you reset the service's engine configuration, all session information will be lost.

Parameters:

aSessionInfo - object containing session information

See Also:

WOWebService.SessionInfo