org.apache.axis.deployment.wsdd

Class WSDDDeployment

Implemented Interfaces:
EngineConfiguration, Serializable, WSDDEngineConfiguration, WSDDTypeMappingContainer

public class WSDDDeployment
extends WSDDElement
implements WSDDTypeMappingContainer, WSDDEngineConfiguration

WSDD deployment element
Authors:
James Snell
Glen Daniels (gdaniels@apache.org)

Field Summary

protected static Log
log

Fields inherited from class org.apache.axis.deployment.wsdd.WSDDConstants

ARRAY_DESERIALIZER_FACTORY, ARRAY_SERIALIZER_FACTORY, ATTR_ATTACHMENT_FORMAT, ATTR_CLASS, ATTR_CLASSNAME, ATTR_DESERIALIZER, ATTR_ENCSTYLE, ATTR_INHEADER, ATTR_INNER_NAME, ATTR_INNER_TYPE, ATTR_ITEMQNAME, ATTR_ITEMTYPE, ATTR_LANG_SPEC_TYPE, ATTR_LOCKED, ATTR_MEP, ATTR_MODE, ATTR_NAME, ATTR_OUTHEADER, ATTR_PIVOT, ATTR_PROVIDER, ATTR_QNAME, ATTR_RETHEADER, ATTR_RETITEMQNAME, ATTR_RETITEMTYPE, ATTR_RETQNAME, ATTR_RETTYPE, ATTR_SERIALIZER, ATTR_SOAP12ACTION, ATTR_SOAPACTION, ATTR_SOAPACTORNAME, ATTR_STREAMING, ATTR_STYLE, ATTR_TYPE, ATTR_USE, ATTR_VALUE, BEAN_DESERIALIZER_FACTORY, BEAN_SERIALIZER_FACTORY, ELEM_WSDD_ARRAYMAPPING, ELEM_WSDD_BEANMAPPING, ELEM_WSDD_CHAIN, ELEM_WSDD_DEPLOY, ELEM_WSDD_DOC, ELEM_WSDD_ELEMENTMAPPING, ELEM_WSDD_ENDPOINTURL, ELEM_WSDD_FAULT, ELEM_WSDD_FAULTFLOW, ELEM_WSDD_GLOBAL, ELEM_WSDD_HANDLER, ELEM_WSDD_JAXRPC_CHAIN, ELEM_WSDD_JAXRPC_HANDLERINFO, ELEM_WSDD_JAXRPC_HEADER, ELEM_WSDD_JAXRPC_ROLE, ELEM_WSDD_NAMESPACE, ELEM_WSDD_OPERATION, ELEM_WSDD_PARAM, ELEM_WSDD_REQFLOW, ELEM_WSDD_RESPFLOW, ELEM_WSDD_ROLE, ELEM_WSDD_SERVICE, ELEM_WSDD_TRANSPORT, ELEM_WSDD_TYPEMAPPING, ELEM_WSDD_UNDEPLOY, ELEM_WSDD_WSDLFILE, NS_PREFIX_WSDD, NS_PREFIX_WSDD_JAVA, PROVIDER_BSF, PROVIDER_COM, PROVIDER_CORBA, PROVIDER_EJB, PROVIDER_HANDLER, PROVIDER_MSG, PROVIDER_RMI, PROVIDER_RPC, QNAME_ARRAYMAPPING, QNAME_BEANMAPPING, QNAME_BSF_PROVIDER, QNAME_CHAIN, QNAME_COM_PROVIDER, QNAME_CORBA_PROVIDER, QNAME_DEPLOY, QNAME_DOC, QNAME_EJB_PROVIDER, QNAME_ELEMENTMAPPING, QNAME_ENDPOINTURL, QNAME_FAULT, QNAME_FAULTFLOW, QNAME_GLOBAL, QNAME_HANDLER, QNAME_HANDLER_PROVIDER, QNAME_JAVAMSG_PROVIDER, QNAME_JAVARPC_PROVIDER, QNAME_JAXRPC_HANDLERINFO, QNAME_JAXRPC_HANDLERINFOCHAIN, QNAME_JAXRPC_HEADER, QNAME_JAXRPC_ROLE, QNAME_NAMESPACE, QNAME_OPERATION, QNAME_PARAM, QNAME_REQFLOW, QNAME_RESPFLOW, QNAME_RMI_PROVIDER, QNAME_SERVICE, QNAME_TRANSPORT, QNAME_TYPEMAPPING, QNAME_UNDEPLOY, QNAME_WSDLFILE, URI_WSDD, URI_WSDD_HANDLER, URI_WSDD_JAVA, URI_WSDD_WSDD_BSF, URI_WSDD_WSDD_COM

Fields inherited from interface org.apache.axis.EngineConfiguration

PROPERTY_NAME

Constructor Summary

WSDDDeployment()
Default constructor
WSDDDeployment(Element e)
Create an element in WSDD that wraps an extant DOM element

Method Summary

protected void
addHandler(WSDDHandler handler)
protected void
addService(WSDDService service)
protected void
addTransport(WSDDTransport transport)
void
configureEngine(AxisEngine engine)
Configure this AxisEngine using whatever data source we have.
void
deployHandler(WSDDHandler handler)
Put a WSDDHandler into this deployment, replacing any other WSDDHandler which might already be present with the same QName.
void
deployService(WSDDService service)
Put a WSDDService into this deployment, replacing any other WSDDService which might already be present with the same QName.
void
deployToRegistry(WSDDDeployment target)
void
deployTransport(WSDDTransport transport)
Put a WSDDTransport into this deployment, replacing any other WSDDTransport which might already be present with the same QName.
void
deployTypeMapping(WSDDTypeMapping typeMapping)
Iterator
getDeployedServices()
Get an enumeration of the services deployed to this engine
WSDDDeployment
getDeployment()
Get the WSDDDeployment for this engine configuration.
protected QName
getElementName()
Return the element name of a particular subclass.
AxisEngine
getEngine()
WSDDGlobalConfiguration
getGlobalConfiguration()
Get our global configuration
Hashtable
getGlobalOptions()
Returns the global configuration options.
Handler
getGlobalRequest()
Returns a global request handler.
Handler
getGlobalResponse()
Returns a global response handler.
Handler
getHandler(QName name)
Return an instance of the named handler.
WSDDHandler[]
getHandlers()
List
getRoles()
Get a list of roles that this engine plays globally.
SOAPService
getService(QName name)
Retrieve an instance of the named service.
SOAPService
getServiceByNamespaceURI(String namespace)
Get a service which has been mapped to a particular namespace.
WSDDService[]
getServices()
Return an array of the services in this deployment
Handler
getTransport(QName name)
Retrieve an instance of the named transport.
WSDDTransport[]
getTransports()
TypeMapping
getTypeMapping(String encodingStyle)
TypeMappingRegistry
getTypeMappingRegistry()
Retrieve the TypeMappingRegistry for this engine.
WSDDTypeMapping[]
getTypeMappings()
WSDDHandler
getWSDDHandler(QName qname)
WSDDService
getWSDDService(QName qname)
Return the WSDD description for a given named service
WSDDTransport
getWSDDTransport(QName qname)
void
registerNamespaceForService(String namespace, WSDDService service)
Register a particular namepsace which maps to a given WSDDService.
void
removeNamespaceMapping(String namespace)
Remove a namespace -> WSDDService mapping.
void
setGlobalConfiguration(WSDDGlobalConfiguration globalConfig)
void
undeployHandler(QName qname)
Remove a named handler
void
undeployService(QName qname)
Remove a named service
void
undeployTransport(QName qname)
Remove a named transport
void
writeEngineConfig(AxisEngine engine)
Read the configuration from an engine, and store it somehow.
void
writeToContext(SerializationContext context)
Write this element out to a SerializationContext

Methods inherited from class org.apache.axis.deployment.wsdd.WSDDElement

getChildElement, getChildElements, getElementName, writeToContext

Field Details

log

protected static Log log

Constructor Details

WSDDDeployment

public WSDDDeployment()
Default constructor

WSDDDeployment

public WSDDDeployment(Element e)
            throws WSDDException
Create an element in WSDD that wraps an extant DOM element
Parameters:
e - the element to create the deployment from
Throws:
WSDDException - when problems occur deploying a service or type mapping.

Method Details

addHandler

protected void addHandler(WSDDHandler handler)

addService

protected void addService(WSDDService service)

addTransport

protected void addTransport(WSDDTransport transport)

configureEngine

public void configureEngine(AxisEngine engine)
            throws ConfigurationException
Configure this AxisEngine using whatever data source we have.
Specified by:
configureEngine in interface EngineConfiguration
Parameters:
engine - the AxisEngine we'll deploy state to
Throws:
ConfigurationException - if there was a problem

deployHandler

public void deployHandler(WSDDHandler handler)
Put a WSDDHandler into this deployment, replacing any other WSDDHandler which might already be present with the same QName.
Parameters:
handler - a WSDDHandler to insert in this deployment

deployService

public void deployService(WSDDService service)
Put a WSDDService into this deployment, replacing any other WSDDService which might already be present with the same QName.
Parameters:
service - a WSDDHandler to insert in this deployment

deployToRegistry

public void deployToRegistry(WSDDDeployment target)
            throws ConfigurationException

deployTransport

public void deployTransport(WSDDTransport transport)
Put a WSDDTransport into this deployment, replacing any other WSDDTransport which might already be present with the same QName.
Parameters:
transport - a WSDDTransport to insert in this deployment

deployTypeMapping

public void deployTypeMapping(WSDDTypeMapping typeMapping)
            throws WSDDException
Specified by:
deployTypeMapping in interface WSDDTypeMappingContainer

getDeployedServices

public Iterator getDeployedServices()
            throws ConfigurationException
Get an enumeration of the services deployed to this engine
Specified by:
getDeployedServices in interface EngineConfiguration

getDeployment

public WSDDDeployment getDeployment()
Get the WSDDDeployment for this engine configuration.
Specified by:
getDeployment in interface WSDDEngineConfiguration
Returns:
the WSDDDeployment

getElementName

protected QName getElementName()
Return the element name of a particular subclass.
Overrides:
getElementName in interface WSDDElement

getEngine

public AxisEngine getEngine()

getGlobalConfiguration

public WSDDGlobalConfiguration getGlobalConfiguration()
Get our global configuration
Returns:
a global configuration object

getGlobalOptions

public Hashtable getGlobalOptions()
            throws ConfigurationException
Returns the global configuration options.
Specified by:
getGlobalOptions in interface EngineConfiguration
Returns:
the global options as a Hashtable
Throws:
ConfigurationException - if the global options could not be returned

getGlobalRequest

public Handler getGlobalRequest()
            throws ConfigurationException
Returns a global request handler.
Specified by:
getGlobalRequest in interface EngineConfiguration
Returns:
the Handler that globally handles requests
Throws:
ConfigurationException - if there was some error fetching the handler

getGlobalResponse

public Handler getGlobalResponse()
            throws ConfigurationException
Returns a global response handler.
Specified by:
getGlobalResponse in interface EngineConfiguration
Returns:
the Handler that globally handles responses
Throws:
ConfigurationException - if there was some error fetching the handler

getHandler

public Handler getHandler(QName name)
            throws ConfigurationException
Return an instance of the named handler.
Specified by:
getHandler in interface EngineConfiguration
Parameters:
name - the name of the handler to get
Returns:
an Axis handler with the specified QName or null of not found

getHandlers

public WSDDHandler[] getHandlers()

getRoles

public List getRoles()
Get a list of roles that this engine plays globally. Services within the engine configuration may also add additional roles.
Specified by:
getRoles in interface EngineConfiguration
Returns:
a List of the roles for this engine

getService

public SOAPService getService(QName name)
            throws ConfigurationException
Retrieve an instance of the named service.
Specified by:
getService in interface EngineConfiguration
Parameters:
name - the QName identifying the Service
Returns:
the Service associated with qname
Throws:
ConfigurationException - if there was an error resolving the qname

getServiceByNamespaceURI

public SOAPService getServiceByNamespaceURI(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
Throws:
ConfigurationException - if there was an error resolving the namespace

getServices

public WSDDService[] getServices()
Return an array of the services in this deployment

getTransport

public Handler getTransport(QName name)
            throws ConfigurationException
Retrieve an instance of the named transport.
Specified by:
getTransport in interface EngineConfiguration
Parameters:
name - the QName of the transport
Returns:
a Handler implementing the transport
Throws:
ConfigurationException - if there was an error resolving the transport

getTransports

public WSDDTransport[] getTransports()

getTypeMapping

public TypeMapping getTypeMapping(String encodingStyle)
            throws ConfigurationException

getTypeMappingRegistry

public TypeMappingRegistry getTypeMappingRegistry()
            throws ConfigurationException
Retrieve the TypeMappingRegistry for this engine.
Specified by:
getTypeMappingRegistry in interface EngineConfiguration
Returns:
the type mapping registry
Throws:
ConfigurationException - if there was an error resolving the registry

getTypeMappings

public WSDDTypeMapping[] getTypeMappings()
Returns:
an array of type mappings in this deployment

getWSDDHandler

public WSDDHandler getWSDDHandler(QName qname)

getWSDDService

public WSDDService getWSDDService(QName qname)
Return the WSDD description for a given named service

getWSDDTransport

public WSDDTransport getWSDDTransport(QName qname)

registerNamespaceForService

public void registerNamespaceForService(String namespace,
                                        WSDDService service)
Register a particular namepsace which maps to a given WSDDService. This will be used for namespace-based dispatching.
Parameters:
namespace - a namespace URI
service - the target WSDDService

removeNamespaceMapping

public void removeNamespaceMapping(String namespace)
Remove a namespace -> WSDDService mapping.
Parameters:
namespace - the namespace URI to unmap

setGlobalConfiguration

public void setGlobalConfiguration(WSDDGlobalConfiguration globalConfig)

undeployHandler

public void undeployHandler(QName qname)
Remove a named handler
Parameters:
qname - the QName of the handler to remove

undeployService

public void undeployService(QName qname)
Remove a named service
Parameters:
qname - the QName of the service to remove

undeployTransport

public void undeployTransport(QName qname)
Remove a named transport
Parameters:
qname - the QName of the transport to remove

writeEngineConfig

public void writeEngineConfig(AxisEngine engine)
            throws ConfigurationException
Read the configuration from an engine, and store it somehow.
Specified by:
writeEngineConfig in interface EngineConfiguration
Parameters:
engine - the AxisEngine from which to read state.
Throws:
ConfigurationException - if there was a problem

writeToContext

public void writeToContext(SerializationContext context)
            throws IOException
Write this element out to a SerializationContext
Overrides:
writeToContext in interface WSDDElement

Copyright © 2005 Apache Web Services Project. All Rights Reserved.