com.webobjects.appserver
Class WOWebServiceRegistrar

java.lang.Object
  com.webobjects.appserver.WOWebServiceRegistrar

public class WOWebServiceRegistrar
extends Object

Registers WebServices with WebObjects application.

Since:

5.2

Method Summary

static void	registerD2WebServiceWithOperations(String webServiceName, String[] operations) Used by Direct To WebServices to register operations
static void	registerFactoriesForClassWithQName(javax.xml.rpc.encoding.SerializerFactory aSerializerFactory, javax.xml.rpc.encoding.DeserializerFactory aDeserializerFactory, Class aClass, QName aQName) Register aSerializerFactory for serializing objects of class aClass and aDeserializerFactory for deserializing DOM elements with QName aQName.
static void	registerWebService(Class webServiceClass, boolean isRPC) Expose all methods declared on webServiceClass as operations on a web service whose name is the non-qualified class name of webServiceClass.
static void	registerWebService(String webServiceName, Class webServiceClass, boolean isRPC) Expose all methods declared on webServiceClass as operations on a web service whose name is webServiceName.
static void	registerWebService(String webServiceName, Class webServiceClass, String[] allowedMethods, boolean isRPC) Expose methods listed in allowedMethods declared on webServiceClass as operations on a web service whose name is webServiceName.
static void	registerXSLTForServiceAndOperation(URL aURL, String serviceName, String operationName) Register an XSLT transformation for serviceName and operationName.
static void	setSecurityDelegate(Object aDelegate) Register aDelegate as the security delegate for Axis.
static void	unregisterWebService(Class webServiceClass) Deregister the web service registered for webServiceClass.
static void	unregisterWebService(String webServiceName) Deregister the web service registered with the name webServiceName.

Methods inherited from class java.lang.Object

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

Method Detail

registerWebService

public static void registerWebService(Class webServiceClass,
                                      boolean isRPC)

Expose all methods declared on webServiceClass as operations on a web service whose name is the non-qualified class name of webServiceClass.

Parameters:

webServiceClass - Class to be exposed as a web service

isRPC - boolean true if the service is RPC based false if document

Throws:

IllegalArgumentException - if webServiceClass is null, or if isRPC is false the number of declared methods on webServiceClass is not 1

registerWebService

public static void registerWebService(String webServiceName,
                                      Class webServiceClass,
                                      boolean isRPC)

Expose all methods declared on webServiceClass as operations on a web service whose name is webServiceName.

Parameters:

webServiceName - the name under which the class should be exposed

webServiceClass - Class to be exposed as a web service

isRPC - boolean true if the service is RPC based false if document

Throws:

IllegalArgumentException - if webServiceName or webServiceClass are null, or if isRPC is false and the number of declared methods on webServiceClass is not 1

registerWebService

public static void registerWebService(String webServiceName,
                                      Class webServiceClass,
                                      String[] allowedMethods,
                                      boolean isRPC)

Expose methods listed in allowedMethods declared on webServiceClass as operations on a web service whose name is webServiceName.

Parameters:

webServiceName - the name under which the class should be exposed

webServiceClass - Class to be exposed as a web service

allowedMethods - array of Strings containing the names of methods to be exposed

isRPC - boolean true if the service is RPC based false if document

Throws:

IllegalArgumentException - if webServiceName or webServiceClass are null, or if isRPC is false and either allowedMethods is null or allowedMethods.length != 1

registerD2WebServiceWithOperations

public static void registerD2WebServiceWithOperations(String webServiceName,
                                                      String[] operations)

Used by Direct To WebServices to register operations

Parameters:

webServiceName - name of webservices

operations - String array of operations to be registered

Since:

5.2

unregisterWebService

public static void unregisterWebService(Class webServiceClass)

Deregister the web service registered for webServiceClass. This method assumes that webServiceClass will be exposed under it's classname.

Parameters:

webServiceClass - the Class to be deregistered

Throws:

IllegalArgumentException - if webServiceClass is null

unregisterWebService

public static void unregisterWebService(String webServiceName)

Deregister the web service registered with the name webServiceName.

Parameters:

webServiceName - the name of the service to be deregistered

Throws:

IllegalArgumentException - if webServiceName is null

registerFactoriesForClassWithQName

public static void registerFactoriesForClassWithQName(javax.xml.rpc.encoding.SerializerFactory aSerializerFactory,
                                                      javax.xml.rpc.encoding.DeserializerFactory aDeserializerFactory,
                                                      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

registerXSLTForServiceAndOperation

public static void registerXSLTForServiceAndOperation(URL aURL,
                                                      String serviceName,
                                                      String operationName)

Register an XSLT transformation for serviceName and operationName. All parameters must be non-null. The contents of the URL will be read at registration.

Parameters:

aURL - URL for a resource containing an XSLT

serviceName - the name of the service for which this transformation should be registered

operationName - the name of the operation for which this transformation should be registered

setSecurityDelegate

public static void setSecurityDelegate(Object aDelegate)

Register aDelegate as the security delegate for Axis.

Parameters:

aDelegate - any object implementing some subset of the WOSecurityDelegate interface

See Also:

WOSecurityDelegate