com.sun.enterprise.deployment
Class ServiceReferenceDescriptor

java.lang.Object
  java.util.Observable
      com.sun.enterprise.deployment.DynamicAttributesDescriptor
          com.sun.enterprise.deployment.Descriptor
              com.sun.enterprise.deployment.EnvironmentProperty
                  com.sun.enterprise.deployment.ServiceReferenceDescriptor

All Implemented Interfaces:

InjectionCapable, ApplicationParameter, HandlerChainContainer, ContextParameter, EnvironmentEntry, InitializationParameter, NameValuePair, WebDescriptor, java.io.Serializable

public class ServiceReferenceDescriptor
extends EnvironmentProperty
implements HandlerChainContainer

Information about a J2EE web service client.

Author:

Kenneth Saks

See Also:

Serialized Form

Field Summary

Fields inherited from class com.sun.enterprise.deployment.EnvironmentProperty

lookupName

Fields inherited from class com.sun.enterprise.deployment.Descriptor

DESCRIPTION_CHANGED, DESCRIPTOR_CHANGED, docType, LARGE_ICON_CHANGED, NAME_CHANGED, SMALL_ICON_CHANGED

Constructor Summary

ServiceReferenceDescriptor()

ServiceReferenceDescriptor(ServiceReferenceDescriptor other)

ServiceReferenceDescriptor(java.lang.String name, java.lang.String description, java.lang.String service)

Method Summary

void	addCallProperty(NameValuePairDescriptor property) Add call property, using property name as a key.
ServiceRefPortInfo	addContainerManagedPort(java.lang.String serviceEndpointInterface)
void	addHandler(WebServiceHandler handler) Append handler to end of handler chain for this endpoint.
void	addHandlerChain(WebServiceHandlerChain handler) HandlerChain related setters, getters, adders, finders
void	addPortInfo(ServiceRefPortInfo portInfo)
void	addRuntimePortInfo(ServiceRefPortInfo runtimePortInfo) Special handling of case where runtime port info is added.
boolean	equals(java.lang.Object object) Returns true if the argument is an environment property of the same name, false else.
Addressing	getAddressing()
BundleDescriptor	getBundleDescriptor()
java.util.Set	getCallProperties() Runtime information.
NameValuePairDescriptor	getCallPropertyByName(java.lang.String name)
java.util.LinkedList	getHandlerChain()
java.util.LinkedList	getHandlers() Get ordered list of WebServiceHandler handlers for this endpoint.
java.lang.String	getInjectionTargetType()
java.lang.String	getMappedName()
java.io.File	getMappingFile()
java.lang.String	getMappingFileUri()
int	getMtomThreshold()
java.util.Map<java.lang.Class<? extends java.lang.annotation.Annotation>,java.lang.annotation.Annotation>	getOtherAnnotations()
ServiceRefPortInfo	getPortInfo(java.lang.String serviceEndpointInterface) Lookup port info by service endpoint interface.
ServiceRefPortInfo	getPortInfoByPort(javax.xml.namespace.QName wsdlPort) Lookup port info by wsdl port.
ServiceRefPortInfo	getPortInfoBySEI(java.lang.String serviceEndpointInterface) Lookup port info by service endpoint interface.
java.util.Set	getPortsInfo()
RespectBinding	getRespectBinding()
java.lang.String	getServiceImplClassName()
java.lang.String	getServiceInterface()
java.lang.String	getServiceLocalPart()
javax.xml.namespace.QName	getServiceName()
java.lang.String	getServiceNameNamespacePrefix()
java.lang.String	getServiceNamespaceUri()
java.lang.String	getWsdlFileUri()
java.net.URL	getWsdlFileUrl()
java.net.URL	getWsdlOverride()
boolean	hasClientManagedPorts()
boolean	hasContainerManagedPorts()
boolean	hasGeneratedServiceInterface()
boolean	hasGenericServiceInterface()
boolean	hasHandlerChain()
boolean	hasHandlers()
boolean	hasMappingFile()
boolean	hasMtomEnabled()
boolean	hasServiceImplClassName()
boolean	hasServiceName()
boolean	hasWsdlFile()
boolean	hasWsdlOverride()
boolean	isAddressingEnabled()
boolean	isAddressingRequired()
boolean	isMtomEnabled()
boolean	isRespectBindingEnabled()
void	removeCallProperty(NameValuePairDescriptor property) Remove call property, using property name as a key.
void	removeHandler(WebServiceHandler handler)
void	removeHandlerByName(java.lang.String handlerName)
void	removeHandlerChain(WebServiceHandlerChain handler)
void	removePortInfo(ServiceRefPortInfo portInfo)
void	setAddressing(Addressing addressing)
void	setBundleDescriptor(BundleDescriptor bundle)
void	setInjectionTargetType(java.lang.String type)
void	setMappedName(java.lang.String value)
void	setMappingFile(java.io.File file) Derived, non-peristent location of mapping file.
void	setMappingFileUri(java.lang.String uri)
void	setMtomEnabled(boolean mtomEnabled)
void	setMtomThreshold(int mtomThreshold)
void	setOtherAnnotations(java.util.Map<java.lang.Class<? extends java.lang.annotation.Annotation>,java.lang.annotation.Annotation> otherAnnotations)
void	setRespectBinding(RespectBinding respectBinding)
void	setServiceImplClassName(java.lang.String className)
void	setServiceInterface(java.lang.String service)
void	setServiceLocalPart(java.lang.String localpart)
void	setServiceName(javax.xml.namespace.QName serviceName)
void	setServiceName(javax.xml.namespace.QName serviceName, java.lang.String prefix)
void	setServiceNameNamespacePrefix(java.lang.String prefix)
void	setServiceNamespaceUri(java.lang.String uri)
void	setWsdlFileUri(java.lang.String uri)
void	setWsdlFileUrl(java.net.URL url) Derived, non-peristent location of wsdl file.
void	setWsdlOverride(java.net.URL override)

Methods inherited from class com.sun.enterprise.deployment.EnvironmentProperty

addInjectionTarget, getComponentEnvName, getInjectionTargets, getInjectResourceType, getLookupName, getResolvedValue, getResolvedValueObject, getType, getValue, getValueObject, getValueType, hasAValue, hashCode, hasInjectionTargetFromXml, hasLookupName, isConflictResourceGroup, isInjectable, isSetValueCalled, print, printInjectableResourceInfo, setInjectResourceType, setLookupName, setType, setValue

Methods inherited from class com.sun.enterprise.deployment.Descriptor

addDeploymentExtension, addPrefixMapping, createUniqueFilenameAmongst, createUniqueNameAmongst, createUniqueNameAmongstNamedDescriptors, fillDocType, getDeploymentExtensions, getDescription, getDisplayName, getDocType, getLargeIconUri, getLocalizedDescription, getLocalizedDescriptions, getLocalizedDisplayName, getLocalizedDisplayNames, getLocalizedLargeIconUri, getLocalizedLargeIconUris, getLocalizedSmallIconUri, getLocalizedSmallIconUris, getName, getPrefixMapping, getSmallIconUri, isBoundsChecking, setBoundsChecking, setDescription, setDisplayName, setLargeIconUri, setLocalizedDescription, setLocalizedDisplayName, setLocalizedLargeIconUri, setLocalizedSmallIconUri, setName, setSmallIconUri, visit

Methods inherited from class com.sun.enterprise.deployment.DynamicAttributesDescriptor

addExtraAttribute, getExtraAttribute, getExtraAttributes, removeExtraAttribute, toString

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.sun.enterprise.deployment.web.WebDescriptor

getDescription, getLargeIconUri, getName, getSmallIconUri, setDescription, setLargeIconUri, setName, setSmallIconUri

Methods inherited from interface com.sun.enterprise.deployment.web.NameValuePair

getDescription, getName, setDescription, setName

Constructor Detail

ServiceReferenceDescriptor

public ServiceReferenceDescriptor(ServiceReferenceDescriptor other)

ServiceReferenceDescriptor

public ServiceReferenceDescriptor(java.lang.String name,
                                  java.lang.String description,
                                  java.lang.String service)

ServiceReferenceDescriptor

public ServiceReferenceDescriptor()

Method Detail

getOtherAnnotations

public java.util.Map<java.lang.Class<? extends java.lang.annotation.Annotation>,java.lang.annotation.Annotation> getOtherAnnotations()

setOtherAnnotations

public void setOtherAnnotations(java.util.Map<java.lang.Class<? extends java.lang.annotation.Annotation>,java.lang.annotation.Annotation> otherAnnotations)

isRespectBindingEnabled

public boolean isRespectBindingEnabled()

getAddressing

public Addressing getAddressing()

getRespectBinding

public RespectBinding getRespectBinding()

setRespectBinding

public void setRespectBinding(RespectBinding respectBinding)

hasMtomEnabled

public boolean hasMtomEnabled()

isMtomEnabled

public boolean isMtomEnabled()

setMtomEnabled

public void setMtomEnabled(boolean mtomEnabled)

isAddressingEnabled

public boolean isAddressingEnabled()

setAddressing

public void setAddressing(Addressing addressing)

isAddressingRequired

public boolean isAddressingRequired()

getMtomThreshold

public int getMtomThreshold()

setMtomThreshold

public void setMtomThreshold(int mtomThreshold)

getMappedName

public java.lang.String getMappedName()

Overrides:

getMappedName in class EnvironmentProperty

setMappedName

public void setMappedName(java.lang.String value)

Overrides:

setMappedName in class EnvironmentProperty

setBundleDescriptor

public void setBundleDescriptor(BundleDescriptor bundle)

getBundleDescriptor

public BundleDescriptor getBundleDescriptor()

hasGenericServiceInterface

public boolean hasGenericServiceInterface()

hasGeneratedServiceInterface

public boolean hasGeneratedServiceInterface()

setServiceInterface

public void setServiceInterface(java.lang.String service)

getServiceInterface

public java.lang.String getServiceInterface()

hasWsdlFile

public boolean hasWsdlFile()

setWsdlFileUrl

public void setWsdlFileUrl(java.net.URL url)

Derived, non-peristent location of wsdl file. Only used at deployment/runtime.

getWsdlFileUrl

public java.net.URL getWsdlFileUrl()

setWsdlFileUri

public void setWsdlFileUri(java.lang.String uri)

getWsdlFileUri

public java.lang.String getWsdlFileUri()

hasMappingFile

public boolean hasMappingFile()

setMappingFile

public void setMappingFile(java.io.File file)

Derived, non-peristent location of mapping file. Only used at deployment/runtime.

getMappingFile

public java.io.File getMappingFile()

setMappingFileUri

public void setMappingFileUri(java.lang.String uri)

getMappingFileUri

public java.lang.String getMappingFileUri()

setServiceName

public void setServiceName(javax.xml.namespace.QName serviceName)

setServiceName

public void setServiceName(javax.xml.namespace.QName serviceName,
                           java.lang.String prefix)

setServiceNamespaceUri

public void setServiceNamespaceUri(java.lang.String uri)

getServiceNamespaceUri

public java.lang.String getServiceNamespaceUri()

setServiceLocalPart

public void setServiceLocalPart(java.lang.String localpart)

getServiceLocalPart

public java.lang.String getServiceLocalPart()

setServiceNameNamespacePrefix

public void setServiceNameNamespacePrefix(java.lang.String prefix)

getServiceNameNamespacePrefix

public java.lang.String getServiceNameNamespacePrefix()

hasServiceName

public boolean hasServiceName()

getServiceName

public javax.xml.namespace.QName getServiceName()

Returns:

service QName or null if either part of qname is not set

getPortsInfo

public java.util.Set getPortsInfo()

addPortInfo

public void addPortInfo(ServiceRefPortInfo portInfo)

removePortInfo

public void removePortInfo(ServiceRefPortInfo portInfo)

addRuntimePortInfo

public void addRuntimePortInfo(ServiceRefPortInfo runtimePortInfo)

Special handling of case where runtime port info is added. Ensures that port info is not duplicated when multiple runtime info instances are parsed using same standard descriptor.

addContainerManagedPort

public ServiceRefPortInfo addContainerManagedPort(java.lang.String serviceEndpointInterface)

hasContainerManagedPorts

public boolean hasContainerManagedPorts()

hasClientManagedPorts

public boolean hasClientManagedPorts()

getPortInfo

public ServiceRefPortInfo getPortInfo(java.lang.String serviceEndpointInterface)

Lookup port info by service endpoint interface.

getPortInfoBySEI

public ServiceRefPortInfo getPortInfoBySEI(java.lang.String serviceEndpointInterface)

Lookup port info by service endpoint interface.

getPortInfoByPort

public ServiceRefPortInfo getPortInfoByPort(javax.xml.namespace.QName wsdlPort)

Lookup port info by wsdl port.

addHandler

public void addHandler(WebServiceHandler handler)

Append handler to end of handler chain for this endpoint.

removeHandler

public void removeHandler(WebServiceHandler handler)

removeHandlerByName

public void removeHandlerByName(java.lang.String handlerName)

hasHandlers

public boolean hasHandlers()

getHandlers

public java.util.LinkedList getHandlers()

Get ordered list of WebServiceHandler handlers for this endpoint.

addHandlerChain

public void addHandlerChain(WebServiceHandlerChain handler)

HandlerChain related setters, getters, adders, finders

Specified by:

addHandlerChain in interface HandlerChainContainer

removeHandlerChain

public void removeHandlerChain(WebServiceHandlerChain handler)

hasHandlerChain

public boolean hasHandlerChain()

Specified by:

hasHandlerChain in interface HandlerChainContainer

getHandlerChain

public java.util.LinkedList getHandlerChain()

Specified by:

getHandlerChain in interface HandlerChainContainer

getCallProperties

public java.util.Set getCallProperties()

Runtime information.

getCallPropertyByName

public NameValuePairDescriptor getCallPropertyByName(java.lang.String name)

addCallProperty

public void addCallProperty(NameValuePairDescriptor property)

Add call property, using property name as a key. This will replace the property value of any existing stub property with the same name.

removeCallProperty

public void removeCallProperty(NameValuePairDescriptor property)

Remove call property, using property name as a key. This will remove the property value of an existing stub property with the matching name.

hasServiceImplClassName

public boolean hasServiceImplClassName()

setServiceImplClassName

public void setServiceImplClassName(java.lang.String className)

getServiceImplClassName

public java.lang.String getServiceImplClassName()

hasWsdlOverride

public boolean hasWsdlOverride()

setWsdlOverride

public void setWsdlOverride(java.net.URL override)

getWsdlOverride

public java.net.URL getWsdlOverride()

setInjectionTargetType

public void setInjectionTargetType(java.lang.String type)

getInjectionTargetType

public java.lang.String getInjectionTargetType()

equals

public boolean equals(java.lang.Object object)

Description copied from class: EnvironmentProperty

Returns true if the argument is an environment property of the same name, false else.

Overrides:

equals in class EnvironmentProperty