org.apache.axis2.jaxws.description.impl
Class ServiceDescriptionImpl

java.lang.Object
  org.apache.axis2.jaxws.description.impl.ServiceDescriptionImpl

All Implemented Interfaces:

ServiceDescription, ServiceDescriptionJava, ServiceDescriptionWSDL

public class ServiceDescriptionImpl
extends Object
implements ServiceDescription, ServiceDescriptionWSDL, ServiceDescriptionJava

See Also:

../ServiceDescription

Method Summary

Responses	getAddressingResponses(Object serviceDelegateKey, Class seiClass) Answer the type of Addressing responses required by the service-requester.
HandlerChain	getAnnoHandlerChainAnnotation(Object sparseCompositeKey)
ConfigurationContext	getAxisConfigContext()
Map<String,Object>	getBindingProperties(Object serviceDelegateKey, String key) This method is responsible for querying the metadata for properties associated with a given BindingProvider instance.
JAXWSCatalogManager	getCatalogManager()
HashMap<String,DescriptionBuilderComposite>	getDBCMap()
DescriptionBuilderComposite	getDescriptionBuilderComposite()
DescriptionBuilderComposite	getDescriptionBuilderComposite(QName serviceQName, Integer portCompositeIndex) This method provides a means for accessing a DescriptionBuilderComposite instance.
Collection<EndpointDescriptionImpl>	getDynamicEndpointDescriptions_AsCollection(Object serviceDelegateKey)
EndpointDescription[]	getEndpointDescription(Class seiClass) Return the EndpointDescriptions corresponding to the SEI class.
EndpointDescription	getEndpointDescription(QName portQName)
EndpointDescription	getEndpointDescription(QName portQName, Object serviceDelegateKey)
Collection<EndpointDescription>	getEndpointDescriptions_AsCollection()
EndpointDescription[]	getEndpointDescriptions()
WSDLWrapper	getGeneratedWsdlWrapper()
HandlerChainsType	getHandlerChain() Return the handler chain configuration information as a HandlerChainsType object.
HandlerChainsType	getHandlerChain(Object sparseCompositeKey) Return the handler chain configuration information as a HandlerChainsType object.
int	getMTOMThreshold(Object serviceDelegate, Class seiClass) Return the MTOM Threshold as set by the Client via a sparse composite (such as a client deployment descriptor).
List<QName>	getPorts(Object serviceDelegateKey) Returns a list of the ports for this serivce.
QName	getPreferredPort(Object key)
ResolvedHandlersDescription	getResolvedHandlersDescription(PortInfo portInfo) Answer information for resolved handlers for the given port.
protected String	getServiceClassName() Return the name of the client-side service class if it exists.
ServiceClient	getServiceClient(QName portQName, Object serviceDelegateKey)
QName	getServiceQName()
ServiceRuntimeDescription	getServiceRuntimeDesc(String name)
javax.wsdl.Definition	getWSDLDefinition()
javax.wsdl.Definition	getWSDLGeneratedDefinition() Returns the WSDL definiton as created by calling the WSDL generator.
String	getWSDLLocation()
Map	getWSDLPorts()
List<javax.wsdl.Port>	getWSDLPortsUsingPortType(QName portTypeQN) Return a collection of WSDL ports under this service which use the portType QName.
List<javax.wsdl.Port>	getWSDLPortsUsingSOAPAddress(List<javax.wsdl.Port> wsdlPorts) Return a subset of the collection of WSDL ports which specify a SOAP 1.1 or 1.2 address.
javax.wsdl.Service	getWSDLService()
WSDLWrapper	getWSDLWrapper()
boolean	isAddressingConfigured(Object serviceDelegateKey, Class seiClass) Answer whether Addressing was explicitly configured via metadata (such as a deployment descriptor) on the service-requester.
boolean	isAddressingEnabled(Object serviceDelegateKey, Class seiClass) Answer whether Addressing is enabled on the service-requester.
boolean	isAddressingRequired(Object serviceDelegateKey, Class seiClass) Answer whether Addressing is required on the service-requester.
boolean	isMTOMEnabled(Object key) Answer if MTOM is enabled for the service represented by this Service Description.
boolean	isMTOMEnabled(Object key, Class seiClass) Answer if MTOM is enabled for the service represented by this Service Description and the service-endpoint-interface indicated.
boolean	isRespectBindingEnabled(Object serviceDelegateKey, Class seiClass) Return whether RespectBinding is enabled as set by the Client via a sparse composite (such as a client deployment descriptor).
boolean	isServerSide()
boolean	isWSDLSpecified()
void	releaseResources(Object delegate) Check into releasing resources related to this ServiceDescription.
void	setResolvedHandlersDescription(PortInfo portInfo, ResolvedHandlersDescription resolvedHandlersInfo) Cache information for handlers which have been resolved for this port.
void	setServiceRuntimeDesc(ServiceRuntimeDescription srd)
String	toString() Return a string representing this Description object and all the objects it contains.

Methods inherited from class java.lang.Object

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

Method Detail

getEndpointDescriptions

public EndpointDescription[] getEndpointDescriptions()

Specified by:

getEndpointDescriptions in interface ServiceDescription

getDynamicEndpointDescriptions_AsCollection

public Collection<EndpointDescriptionImpl> getDynamicEndpointDescriptions_AsCollection(Object serviceDelegateKey)

getEndpointDescriptions_AsCollection

public Collection<EndpointDescription> getEndpointDescriptions_AsCollection()

Specified by:

getEndpointDescriptions_AsCollection in interface ServiceDescription

getEndpointDescription

public EndpointDescription getEndpointDescription(QName portQName)

Specified by:

getEndpointDescription in interface ServiceDescription

getEndpointDescription

public EndpointDescription getEndpointDescription(QName portQName,
                                                  Object serviceDelegateKey)

Specified by:

getEndpointDescription in interface ServiceDescription

getDescriptionBuilderComposite

public DescriptionBuilderComposite getDescriptionBuilderComposite()

getDescriptionBuilderComposite

public DescriptionBuilderComposite getDescriptionBuilderComposite(QName serviceQName,
                                                                  Integer portCompositeIndex)

This method provides a means for accessing a DescriptionBuilderComposite instance. If the integer value passed in is an index in the list of PortComposite objects, then the indiciated PortComposite will be returned. Otherwise, the instance DBC will be returned.

getEndpointDescription

public EndpointDescription[] getEndpointDescription(Class seiClass)

Description copied from interface: ServiceDescription

Return the EndpointDescriptions corresponding to the SEI class. Note that Dispatch endpoints will never be returned because they do not have an associated SEI.

Specified by:

getEndpointDescription in interface ServiceDescription

Returns:

getWSDLWrapper

public WSDLWrapper getWSDLWrapper()

Specified by:

getWSDLWrapper in interface ServiceDescriptionWSDL

getWSDLLocation

public String getWSDLLocation()

Specified by:

getWSDLLocation in interface ServiceDescriptionWSDL

getGeneratedWsdlWrapper

public WSDLWrapper getGeneratedWsdlWrapper()

Specified by:

getGeneratedWsdlWrapper in interface ServiceDescriptionWSDL

getAxisConfigContext

public ConfigurationContext getAxisConfigContext()

Specified by:

getAxisConfigContext in interface ServiceDescription

getServiceClient

public ServiceClient getServiceClient(QName portQName,
                                      Object serviceDelegateKey)

Specified by:

getServiceClient in interface ServiceDescription

getServiceQName

public QName getServiceQName()

Specified by:

getServiceQName in interface ServiceDescription

getCatalogManager

public JAXWSCatalogManager getCatalogManager()

Specified by:

getCatalogManager in interface ServiceDescription

isMTOMEnabled

public boolean isMTOMEnabled(Object key)

Description copied from interface: ServiceDescription

Answer if MTOM is enabled for the service represented by this Service Description. This is currently only supported on the service-requester side; it is not supported on the service-provider side. If the key is non-null, it is used to look up an sparse metadata that may have been specified when the Service Description was created.

Specified by:

isMTOMEnabled in interface ServiceDescription

Parameters:

key - If non-null, used to look up any sparse metadata that may have been specified when the service was created.

Returns:

TRUE if mtom was enabled either in the sparse metadata or in the composite; FALSE othewise.

isMTOMEnabled

public boolean isMTOMEnabled(Object key,
                             Class seiClass)

Description copied from interface: ServiceDescription

Answer if MTOM is enabled for the service represented by this Service Description and the service-endpoint-interface indicated. This is currently only supported on the service-requester side; it is not supported on the service-provider side. If the key is non-null, it is used to look up an sparse metadata that may have been specified when the Service Description was created. If the seiClass is non-null it is used to further scope the enablement of MTOM to a specific SEI.

Specified by:

isMTOMEnabled in interface ServiceDescription

Parameters:

key - If non-null, used to look up any sparse metadata that may have been specified when the service was created.

seiClass - Represents client service-endpoint-interface class.

Returns:

TRUE if mtom was enabled either in the sparse metadata or in the composite; FALSE othewise.

getBindingProperties

public Map<String,Object> getBindingProperties(Object serviceDelegateKey,
                                               String key)

Description copied from interface: ServiceDescription

This method is responsible for querying the metadata for properties associated with a given BindingProvider instance. This is only applicable for the requestor-side, and the properties are scoped at the port level.

Specified by:

getBindingProperties in interface ServiceDescription

Parameters:

serviceDelegateKey - This should always be non-null when called via ServiceDelegate and is used to help retrieve dynamic ports per client

key - This should always be non-null and is used to retrieve properties for a given client-side port

Returns:

getPreferredPort

public QName getPreferredPort(Object key)

Specified by:

getPreferredPort in interface ServiceDescription

isServerSide

public boolean isServerSide()

Specified by:

isServerSide in interface ServiceDescription

getDBCMap

public HashMap<String,DescriptionBuilderComposite> getDBCMap()

isWSDLSpecified

public boolean isWSDLSpecified()

Specified by:

isWSDLSpecified in interface ServiceDescriptionWSDL

getHandlerChain

public HandlerChainsType getHandlerChain()

Description copied from interface: ServiceDescription

Return the handler chain configuration information as a HandlerChainsType object. This is the same as calling getHandlerChain(null).

Specified by:

getHandlerChain in interface ServiceDescription

See Also:

ServiceDescription.getHandlerChain(Object)

getHandlerChain

public HandlerChainsType getHandlerChain(Object sparseCompositeKey)

Description copied from interface: ServiceDescription

Return the handler chain configuration information as a HandlerChainsType object. If the key is non-null then it is used to look for handler chain configuration information in the sparse metadata. The order in which the configuration information is resolved is: 1) Look in sparse composite if the key is not null 2) Look in the composite 3) Look for a HandlerChain annotation and read in the file it specifies

Specified by:

getHandlerChain in interface ServiceDescription

Parameters:

sparseCompositeKey - May be null. If non-null, used to look for service-delegate specific sparse composite information.

Returns:

A HandlerChainsType object or null

getAnnoHandlerChainAnnotation

public HandlerChain getAnnoHandlerChainAnnotation(Object sparseCompositeKey)

getWSDLDefinition

public javax.wsdl.Definition getWSDLDefinition()

Specified by:

getWSDLDefinition in interface ServiceDescriptionWSDL

getWSDLGeneratedDefinition

public javax.wsdl.Definition getWSDLGeneratedDefinition()

Returns the WSDL definiton as created by calling the WSDL generator. This will be null unless the WSDL definition provided by the metadata is incomplete

getWSDLService

public javax.wsdl.Service getWSDLService()

Specified by:

getWSDLService in interface ServiceDescriptionWSDL

getWSDLPorts

public Map getWSDLPorts()

Specified by:

getWSDLPorts in interface ServiceDescriptionWSDL

getPorts

public List<QName> getPorts(Object serviceDelegateKey)

Description copied from interface: ServiceDescription

Returns a list of the ports for this serivce. The ports returned are the - Ports declared ports for this Service. They can be delcared in the WSDL or via annotations. - Dynamic ports added to the service

Specified by:

getPorts in interface ServiceDescription

Parameters:

serviceDelegateKey - This should always be non-null when called via ServiceDelegate and is used to help retrieve dynamic ports per client

Returns:

getWSDLPortsUsingPortType

public List<javax.wsdl.Port> getWSDLPortsUsingPortType(QName portTypeQN)

Description copied from interface: ServiceDescriptionWSDL

Return a collection of WSDL ports under this service which use the portType QName.

Specified by:

getWSDLPortsUsingPortType in interface ServiceDescriptionWSDL

Returns:

getWSDLPortsUsingSOAPAddress

public List<javax.wsdl.Port> getWSDLPortsUsingSOAPAddress(List<javax.wsdl.Port> wsdlPorts)

Description copied from interface: ServiceDescriptionWSDL

Return a subset of the collection of WSDL ports which specify a SOAP 1.1 or 1.2 address.

Specified by:

getWSDLPortsUsingSOAPAddress in interface ServiceDescriptionWSDL

Returns:

getServiceRuntimeDesc

public ServiceRuntimeDescription getServiceRuntimeDesc(String name)

Specified by:

getServiceRuntimeDesc in interface ServiceDescription

setServiceRuntimeDesc

public void setServiceRuntimeDesc(ServiceRuntimeDescription srd)

Specified by:

setServiceRuntimeDesc in interface ServiceDescription

getServiceClassName

protected String getServiceClassName()

Return the name of the client-side service class if it exists.

toString

public String toString()

Return a string representing this Description object and all the objects it contains.

Overrides:

toString in class Object

setResolvedHandlersDescription

public void setResolvedHandlersDescription(PortInfo portInfo,
                                           ResolvedHandlersDescription resolvedHandlersInfo)

Description copied from interface: ServiceDescription

Cache information for handlers which have been resolved for this port. This information is set when the handler resolver initially resolves the handlers based on the handler configuration information. It is cached on the service description for performance so that subsequent queries by other handler resolvers for the same port do not have to re-resolve the information from the handler configuration information.

Specified by:

setResolvedHandlersDescription in interface ServiceDescription

Parameters:

portInfo - Port for which the handler information should be cached

resolvedHandlersInfo - An object containing information for the resolved handlers

getResolvedHandlersDescription

public ResolvedHandlersDescription getResolvedHandlersDescription(PortInfo portInfo)

Description copied from interface: ServiceDescription

Answer information for resolved handlers for the given port. This information is set when the handler resolver initially resolves the handlers based on the handler configuration information. It is cached on the service description for performance so that subsequent queries by other handler resolvers for the same port do not have to re-resolve the information from the handler configuration information.

Specified by:

getResolvedHandlersDescription in interface ServiceDescription

Parameters:

portInfo - Port for which the handler information is desired

Returns:

An object containing information for the resolved handlers, or null if no information is found in the cache.

releaseResources

public void releaseResources(Object delegate)

Description copied from interface: ServiceDescription

Check into releasing resources related to this ServiceDescription. Those resources include this ServiceDescription instance, the EndpointDescription instances it owns and their associated AxisService and related objects. NOTE: This should only be called on ServiceDescrpition instances that are owned by client ServiceDelegate instances; it SHOULD NOT be called on server-side ServiceDescriptions since those are built during server start and their life-cycle is the life-cycle of the server.

Specified by:

releaseResources in interface ServiceDescription

Parameters:

delegate - The ServiceDelegate instance that owns this ServiceDescription.

getMTOMThreshold

public int getMTOMThreshold(Object serviceDelegate,
                            Class seiClass)

Description copied from interface: ServiceDescription

Return the MTOM Threshold as set by the Client via a sparse composite (such as a client deployment descriptor).

Specified by:

getMTOMThreshold in interface ServiceDescription

Parameters:

serviceDelegate - The instance of the service delegate related to this service

seiClass - The SEI for the port to retrieve the MTOM threshold for

Returns:

the MTOM threshold if set, or 0 if not set.

isRespectBindingEnabled

public boolean isRespectBindingEnabled(Object serviceDelegateKey,
                                       Class seiClass)

Description copied from interface: ServiceDescription

Return whether RespectBinding is enabled as set by the Client via a sparse composite (such as a client deployment descriptor).

Specified by:

isRespectBindingEnabled in interface ServiceDescription

Parameters:

serviceDelegateKey - The instance of the service delegate related to this service

seiClass - The SEI for the port to retrieve the RespectBinding setting for.

Returns:

true if RespectBinding is enabled; false otherwise.

isAddressingConfigured

public boolean isAddressingConfigured(Object serviceDelegateKey,
                                      Class seiClass)

Description copied from interface: ServiceDescription

Answer whether Addressing was explicitly configured via metadata (such as a deployment descriptor) on the service-requester. Note that the related methods will return default values if Addressing was not explicitly configured; otherwise they will return values set based on the metadata configuration.

Specified by:

isAddressingConfigured in interface ServiceDescription

Parameters:

serviceDelegateKey - The instance of the service delegate related to this service

seiClass - The SEI for the port to retrieve the setting for.

Returns:

true if Addressing was explicitly set via metadata, false otherwise.

See Also:

ServiceDescription.isAddressingEnabled(Object, Class), ServiceDescription.isAddressingRequired(Object, Class), ServiceDescription.getAddressingResponses(Object, Class)

isAddressingEnabled

public boolean isAddressingEnabled(Object serviceDelegateKey,
                                   Class seiClass)

Description copied from interface: ServiceDescription

Answer whether Addressing is enabled on the service-requester. Note that if addressing was not configured via metadata, then this method will return a default value, otherwise it will return the value configured via metadata.

Specified by:

isAddressingEnabled in interface ServiceDescription

Parameters:

serviceDelegateKey - The instance of the service delegate related to this service

seiClass - The SEI for the port to retrieve the setting for.

Returns:

true if Addressing is enabled on the service-requester, false (default) otherwise

See Also:

ServiceDescription.isAddressingConfigured(Object, Class)

isAddressingRequired

public boolean isAddressingRequired(Object serviceDelegateKey,
                                    Class seiClass)

Description copied from interface: ServiceDescription

Answer whether Addressing is required on the service-requester. Note that if addressing was not configured via metadata, then this method will return a default value, otherwise it will return the value configured via metadata.

Specified by:

isAddressingRequired in interface ServiceDescription

Parameters:

serviceDelegateKey - The instance of the service delegate related to this service

seiClass - The SEI for the port to retrieve the setting for.

Returns:

true if Addressing is required on the service-requester, false (default) otherwise

See Also:

ServiceDescription.isAddressingConfigured(Object, Class)

getAddressingResponses

public Responses getAddressingResponses(Object serviceDelegateKey,
                                        Class seiClass)

Description copied from interface: ServiceDescription

Answer the type of Addressing responses required by the service-requester. Note that if addressing was not configured via metadata, then this method will return a default value, otherwise it will return the value configured via metadata.

Specified by:

getAddressingResponses in interface ServiceDescription

Parameters:

serviceDelegateKey - The instance of the service delegate related to this service

seiClass - The SEI for the port to retrieve the setting for.

Returns:

AddressingFeature.Responses vale corresponding to the type of responses required by service-requester.

See Also:

ServiceDescription.isAddressingConfigured(Object, Class)