org.apache.axis.configuration
Class SimpleProvider

java.lang.Object
  |
  +--org.apache.axis.configuration.SimpleProvider

All Implemented Interfaces:

EngineConfiguration

Direct Known Subclasses:

BasicClientConfig, BasicServerConfig

public class SimpleProvider

extends java.lang.Object

implements EngineConfiguration

A SimpleProvider is an EngineConfiguration which contains a simple HashMap-based registry of Handlers, Transports, and Services. This is for when you want to programatically deploy components which you create. SimpleProvider may also optionally contain a reference to a "default" EngineConfiguration, which will be scanned for components not found in the internal registry. This is handy when you want to start with a base configuration (like the default WSDD) and then quickly add stuff without changing the WSDD document.

Author:

Glen Daniels (gdaniels@macromedia.com)

Field Summary

Fields inherited from interface org.apache.axis.EngineConfiguration

PROPERTY_NAME

Constructor Summary

SimpleProvider()
Default constructor.

SimpleProvider(EngineConfiguration defaultConfiguration)
Constructor which takes an EngineConfiguration which will be used as the default.

Method Summary

void	configureEngine(AxisEngine engine) Configure an AxisEngine.
void	deployService(QName qname, SOAPService service)
void	deployService(java.lang.String name, SOAPService service)
void	deployTransport(QName qname, Handler transport)
void	deployTransport(java.lang.String name, Handler transport)
java.util.Iterator	getDeployedServices() Get an enumeration of the services deployed to this engine
java.util.Hashtable	getGlobalOptions() Returns the global configuration options.
Handler	getGlobalRequest() Returns a global request handler.
Handler	getGlobalResponse() Returns a global response handler.
Handler	getHandler(QName qname) retrieve an instance of the named handler
SOAPService	getService(QName qname) retrieve an instance of the named service
SOAPService	getServiceByNamespaceURI(java.lang.String namespace) Get a service which has been mapped to a particular namespace
Handler	getTransport(QName qname) retrieve an instance of the named transport
TypeMapping	getTypeMapping(java.lang.String encodingStyle)
TypeMappingRegistry	getTypeMappingRegistry() Get our TypeMappingRegistry.
void	writeEngineConfig(AxisEngine engine) We don't write ourselves out, so this is a noop.

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleProvider

public SimpleProvider()

Default constructor.

SimpleProvider

public SimpleProvider(EngineConfiguration defaultConfiguration)

Constructor which takes an EngineConfiguration which will be used as the default.

Method Detail

configureEngine

public void configureEngine(AxisEngine engine)
                     throws ConfigurationException

Configure an AxisEngine. Right now just calls the default configuration if there is one, since we don't do anything special.

Specified by:

configureEngine in interface EngineConfiguration

Parameters:

engine - the AxisEngine we'll deploy state to

Throws:

ConfigurationException - if there was a problem

writeEngineConfig

public void writeEngineConfig(AxisEngine engine)
                       throws ConfigurationException

We don't write ourselves out, so this is a noop.

Specified by:

writeEngineConfig in interface EngineConfiguration

Parameters:

engine - the AxisEngine from which to read state.

Throws:

ConfigurationException - if there was a problem

getGlobalOptions

public java.util.Hashtable getGlobalOptions()
                                     throws ConfigurationException

Returns the global configuration options.

Specified by:

getGlobalOptions in interface EngineConfiguration

ConfigurationException

getGlobalResponse

public Handler getGlobalResponse()
                          throws ConfigurationException

Returns a global response handler.

Specified by:

getGlobalResponse in interface EngineConfiguration

ConfigurationException

getGlobalRequest

public Handler getGlobalRequest()
                         throws ConfigurationException

Returns a global request handler.

Specified by:

getGlobalRequest in interface EngineConfiguration

ConfigurationException

getTypeMappingRegistry

public TypeMappingRegistry getTypeMappingRegistry()
                                           throws ConfigurationException

Get our TypeMappingRegistry. Returns our specific one if we have one, otherwise the one from our defaultConfiguration. If we don't have one and also don't have a defaultConfiguration, we create one.

Specified by:

getTypeMappingRegistry in interface EngineConfiguration

ConfigurationException

getTypeMapping

public TypeMapping getTypeMapping(java.lang.String encodingStyle)
                           throws ConfigurationException

ConfigurationException

getTransport

public Handler getTransport(QName qname)
                     throws ConfigurationException

Description copied from interface: EngineConfiguration

retrieve an instance of the named transport

Specified by:

getTransport in interface EngineConfiguration

Parameters:

qname - XXX

Returns:

XXX

Throws:

ConfigurationException - XXX

getService

public SOAPService getService(QName qname)
                       throws ConfigurationException

Description copied from interface: EngineConfiguration

retrieve an instance of the named service

Specified by:

getService in interface EngineConfiguration

Parameters:

qname - XXX

Returns:

XXX

Throws:

ConfigurationException - XXX

getServiceByNamespaceURI

public SOAPService getServiceByNamespaceURI(java.lang.String namespace)
                                     throws ConfigurationException

Get a service which has been mapped to a particular namespace

Specified by:

getServiceByNamespaceURI in interface EngineConfiguration

Parameters:

namespace - a namespace URI

Returns:

an instance of the appropriate Service, or null

ConfigurationException

getHandler

public Handler getHandler(QName qname)
                   throws ConfigurationException

Description copied from interface: EngineConfiguration

retrieve an instance of the named handler

Specified by:

getHandler in interface EngineConfiguration

Parameters:

qname - XXX

Returns:

XXX

Throws:

ConfigurationException - XXX

deployService

public void deployService(QName qname,
                          SOAPService service)

deployService

public void deployService(java.lang.String name,
                          SOAPService service)

deployTransport

public void deployTransport(QName qname,
                            Handler transport)

deployTransport

public void deployTransport(java.lang.String name,
                            Handler transport)

getDeployedServices

public java.util.Iterator getDeployedServices()
                                       throws ConfigurationException

Get an enumeration of the services deployed to this engine

Specified by:

getDeployedServices in interface EngineConfiguration

Returns:

something to iterate with

ConfigurationException

See Also:

ServiceDesc