org.apache.axis.description

Class JavaServiceDesc

java.lang.Object

org.apache.axis.description.JavaServiceDesc

All Implemented Interfaces:

java.io.Serializable, org.apache.axis.description.ServiceDesc

public class JavaServiceDesc
extends java.lang.Object
implements org.apache.axis.description.ServiceDesc

A ServiceDesc is an abstract description of a service. ServiceDescs contain OperationDescs, which are descriptions of operations. The information about a service's operations comes from one of two places: 1) deployment, or 2) introspection.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.apache.commons.logging.Log	log

Constructor Summary

Constructors

Constructor and Description
JavaServiceDesc() Default constructor

Method Summary

Modifier and Type	Method and Description
void	addOperationDesc(org.apache.axis.description.OperationDesc operation)
java.util.List	getAllowedMethods()
java.lang.String	getDefaultNamespace()
java.util.List	getDisallowedMethods()
java.lang.String	getDocumentation() get the documentation for the service
java.lang.String	getEndpointURL()
java.lang.Class	getImplClass()
java.lang.String	getName() the name of the service
org.apache.axis.description.OperationDesc	getOperationByElementQName(javax.xml.namespace.QName qname) Map an XML QName to an operation.
org.apache.axis.description.OperationDesc	getOperationByName(java.lang.String methodName) Return an operation matching the given method name.
java.util.ArrayList	getOperations() get all the operations as a list of OperationDescs.
org.apache.axis.description.OperationDesc[]	getOperationsByName(java.lang.String methodName) get all overloaded operations by name
org.apache.axis.description.OperationDesc[]	getOperationsByQName(javax.xml.namespace.QName qname) Return all operations which match this QName (i.e.
java.lang.Object	getProperty(java.lang.String name)
java.util.ArrayList	getStopClasses()
org.apache.axis.constants.Style	getStyle() What kind of service is this?
org.apache.axis.encoding.TypeMapping	getTypeMapping()
org.apache.axis.encoding.TypeMappingRegistry	getTypeMappingRegistry()
org.apache.axis.constants.Use	getUse() What kind of use is this?
java.lang.String	getWSDLFile() the wsdl file of the service.
boolean	isInitialized()
boolean	isWrapped() Determine whether or not this is a "wrapped" invocation, i.e.
void	loadServiceDescByIntrospection() Fill in a service description by introspecting the implementation class.
void	loadServiceDescByIntrospection(java.lang.Class implClass) Fill in a service description by introspecting the implementation class.
void	loadServiceDescByIntrospection(java.lang.Class cls, org.apache.axis.encoding.TypeMapping tm) Fill in a service description by introspecting the implementation class.
void	removeOperationDesc(org.apache.axis.description.OperationDesc operation)
void	setAllowedMethods(java.util.List allowedMethods)
void	setDefaultNamespace(java.lang.String namespace)
void	setDisallowedMethods(java.util.List disallowedMethods)
void	setDocumentation(java.lang.String documentation) set the documentation for the service
void	setEndpointURL(java.lang.String endpointURL)
void	setImplClass(java.lang.Class implClass) set the implementation class
void	setName(java.lang.String name) the name of the service
void	setNamespaceMappings(java.util.List namespaces)
void	setProperty(java.lang.String name, java.lang.Object value)
void	setStopClasses(java.util.ArrayList stopClasses)
void	setStyle(org.apache.axis.constants.Style style)
void	setTypeMapping(org.apache.axis.encoding.TypeMapping tm)
void	setTypeMappingRegistry(org.apache.axis.encoding.TypeMappingRegistry tmr)
void	setUse(org.apache.axis.constants.Use use)
void	setWSDLFile(java.lang.String wsdlFileName) set the wsdl file of the service; this causes the named file to be returned on a ?wsdl, probe, not introspection generated wsdl.

Methods inherited from class java.lang.Object

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

Field Detail

log

protected static org.apache.commons.logging.Log log

Constructor Detail

JavaServiceDesc

public JavaServiceDesc()

Default constructor

Method Detail

getStyle

public org.apache.axis.constants.Style getStyle()

What kind of service is this?

Specified by:

getStyle in interface org.apache.axis.description.ServiceDesc

Returns:

setStyle

public void setStyle(org.apache.axis.constants.Style style)

Specified by:

setStyle in interface org.apache.axis.description.ServiceDesc

getUse

public org.apache.axis.constants.Use getUse()

What kind of use is this?

Specified by:

getUse in interface org.apache.axis.description.ServiceDesc

Returns:

setUse

public void setUse(org.apache.axis.constants.Use use)

Specified by:

setUse in interface org.apache.axis.description.ServiceDesc

isWrapped

public boolean isWrapped()

Determine whether or not this is a "wrapped" invocation, i.e. whether the outermost XML element of the "main" body element represents a method call, with the immediate children of that element representing arguments to the method.

Specified by:

isWrapped in interface org.apache.axis.description.ServiceDesc

Returns:

true if this is wrapped (i.e. RPC or WRAPPED style), false otherwise

getWSDLFile

public java.lang.String getWSDLFile()

the wsdl file of the service. When null, it means that the wsdl should be autogenerated

Specified by:

getWSDLFile in interface org.apache.axis.description.ServiceDesc

Returns:

filename or null

setWSDLFile

public void setWSDLFile(java.lang.String wsdlFileName)

set the wsdl file of the service; this causes the named file to be returned on a ?wsdl, probe, not introspection generated wsdl.

Specified by:

setWSDLFile in interface org.apache.axis.description.ServiceDesc

Parameters:

wsdlFileName - filename or null to re-enable introspection

getAllowedMethods

public java.util.List getAllowedMethods()

Specified by:

getAllowedMethods in interface org.apache.axis.description.ServiceDesc

setAllowedMethods

public void setAllowedMethods(java.util.List allowedMethods)

Specified by:

setAllowedMethods in interface org.apache.axis.description.ServiceDesc

getImplClass

public java.lang.Class getImplClass()

setImplClass

public void setImplClass(java.lang.Class implClass)

set the implementation class

Warning: You cannot call getInitializedServiceDesc() after setting this as it uses this to indicate its work has already been done.

Parameters:

implClass -

Throws:

java.lang.IllegalArgumentException - if the implementation class is already set

getTypeMapping

public org.apache.axis.encoding.TypeMapping getTypeMapping()

Specified by:

getTypeMapping in interface org.apache.axis.description.ServiceDesc

setTypeMapping

public void setTypeMapping(org.apache.axis.encoding.TypeMapping tm)

Specified by:

setTypeMapping in interface org.apache.axis.description.ServiceDesc

getName

public java.lang.String getName()

the name of the service

Specified by:

getName in interface org.apache.axis.description.ServiceDesc

setName

public void setName(java.lang.String name)

the name of the service

Specified by:

setName in interface org.apache.axis.description.ServiceDesc

Parameters:

name -

getDocumentation

public java.lang.String getDocumentation()

get the documentation for the service

Specified by:

getDocumentation in interface org.apache.axis.description.ServiceDesc

setDocumentation

public void setDocumentation(java.lang.String documentation)

set the documentation for the service

Specified by:

setDocumentation in interface org.apache.axis.description.ServiceDesc

getStopClasses

public java.util.ArrayList getStopClasses()

setStopClasses

public void setStopClasses(java.util.ArrayList stopClasses)

getDisallowedMethods

public java.util.List getDisallowedMethods()

Specified by:

getDisallowedMethods in interface org.apache.axis.description.ServiceDesc

setDisallowedMethods

public void setDisallowedMethods(java.util.List disallowedMethods)

Specified by:

setDisallowedMethods in interface org.apache.axis.description.ServiceDesc

removeOperationDesc

public void removeOperationDesc(org.apache.axis.description.OperationDesc operation)

Specified by:

removeOperationDesc in interface org.apache.axis.description.ServiceDesc

addOperationDesc

public void addOperationDesc(org.apache.axis.description.OperationDesc operation)

Specified by:

addOperationDesc in interface org.apache.axis.description.ServiceDesc

getOperations

public java.util.ArrayList getOperations()

get all the operations as a list of OperationDescs. this method triggers an evaluation of the valid operations by introspection, so use sparingly

Specified by:

getOperations in interface org.apache.axis.description.ServiceDesc

Returns:

reference to the operations array. This is not a copy

getOperationsByName

public org.apache.axis.description.OperationDesc[] getOperationsByName(java.lang.String methodName)

get all overloaded operations by name

Specified by:

getOperationsByName in interface org.apache.axis.description.ServiceDesc

Parameters:

methodName -

Returns:

null for no match, or an array of OperationDesc objects

getOperationByName

public org.apache.axis.description.OperationDesc getOperationByName(java.lang.String methodName)

Return an operation matching the given method name. Note that if we have multiple overloads for this method, we will return the first one.

Specified by:

getOperationByName in interface org.apache.axis.description.ServiceDesc

Returns:

null for no match

getOperationByElementQName

public org.apache.axis.description.OperationDesc getOperationByElementQName(javax.xml.namespace.QName qname)

Map an XML QName to an operation. Returns the first one it finds in the case of mulitple matches.

Specified by:

getOperationByElementQName in interface org.apache.axis.description.ServiceDesc

Returns:

null for no match

getOperationsByQName

public org.apache.axis.description.OperationDesc[] getOperationsByQName(javax.xml.namespace.QName qname)

Return all operations which match this QName (i.e. get all the overloads)

Specified by:

getOperationsByQName in interface org.apache.axis.description.ServiceDesc

Returns:

null for no match

loadServiceDescByIntrospection

public void loadServiceDescByIntrospection()

Fill in a service description by introspecting the implementation class.

loadServiceDescByIntrospection

public void loadServiceDescByIntrospection(java.lang.Class implClass)

Fill in a service description by introspecting the implementation class.

loadServiceDescByIntrospection

public void loadServiceDescByIntrospection(java.lang.Class cls,
                                           org.apache.axis.encoding.TypeMapping tm)

Fill in a service description by introspecting the implementation class. This version takes the implementation class and the in-scope TypeMapping.

setNamespaceMappings

public void setNamespaceMappings(java.util.List namespaces)

Specified by:

setNamespaceMappings in interface org.apache.axis.description.ServiceDesc

getDefaultNamespace

public java.lang.String getDefaultNamespace()

Specified by:

getDefaultNamespace in interface org.apache.axis.description.ServiceDesc

setDefaultNamespace

public void setDefaultNamespace(java.lang.String namespace)

Specified by:

setDefaultNamespace in interface org.apache.axis.description.ServiceDesc

setProperty

public void setProperty(java.lang.String name,
                        java.lang.Object value)

Specified by:

setProperty in interface org.apache.axis.description.ServiceDesc

getProperty

public java.lang.Object getProperty(java.lang.String name)

Specified by:

getProperty in interface org.apache.axis.description.ServiceDesc

getEndpointURL

public java.lang.String getEndpointURL()

Specified by:

getEndpointURL in interface org.apache.axis.description.ServiceDesc

setEndpointURL

public void setEndpointURL(java.lang.String endpointURL)

Specified by:

setEndpointURL in interface org.apache.axis.description.ServiceDesc

getTypeMappingRegistry

public org.apache.axis.encoding.TypeMappingRegistry getTypeMappingRegistry()

Specified by:

getTypeMappingRegistry in interface org.apache.axis.description.ServiceDesc

setTypeMappingRegistry

public void setTypeMappingRegistry(org.apache.axis.encoding.TypeMappingRegistry tmr)

Specified by:

setTypeMappingRegistry in interface org.apache.axis.description.ServiceDesc

isInitialized

public boolean isInitialized()

Specified by:

isInitialized in interface org.apache.axis.description.ServiceDesc