com.sun.enterprise.deployment
Class WebServiceEndpoint

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

All Implemented Interfaces:

HandlerChainContainer, java.io.Serializable

public class WebServiceEndpoint
extends Descriptor
implements HandlerChainContainer

Represents a single port-component in a webservice in webservices.xml

See Also:

Serialized Form

Field Summary

static java.lang.String	CLIENT_CERT
static java.lang.String	PUBLISHING_SUBCONTEXT
static java.lang.String	SOAP11_MTOM_TOKEN
static java.lang.String	SOAP11_TOKEN
static java.lang.String	SOAP12_MTOM_TOKEN
static java.lang.String	SOAP12_TOKEN
static java.lang.String	TRANSPORT_CONFIDENTIAL
static java.lang.String	TRANSPORT_INTEGRAL
static java.lang.String	TRANSPORT_NONE
static java.lang.String	XML_TOKEN

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

DESCRIPTION_CHANGED, DESCRIPTOR_CHANGED, docType, LARGE_ICON_CHANGED, NAME_CHANGED, SMALL_ICON_CHANGED

Constructor Summary

WebServiceEndpoint()

WebServiceEndpoint(WebServiceEndpoint other)

Method Summary

void	addHandler(WebServiceHandler handler) Append handler to end of handler chain for this endpoint.
void	addHandlerChain(WebServiceHandlerChain handlerChain) Append handlerchain to end of handlerchain for this endpoint.
void	addProperty(NameValuePairDescriptor newProp)
java.net.URL	composeEndpointAddress(java.net.URL root) Given the root portion of a URL representing the :: of the webserver, return the endpoint address used to make web service invocations on this endpoint.
java.net.URL	composeEndpointAddress(java.net.URL root, java.lang.String contextRoot)
java.net.URL	composeFinalWsdlUrl(java.net.URL root) Generate a URL pointing to the initial wsdl document for this endpoint's web service.
Addressing	getAddressing()
java.lang.String	getAuthMethod()
BundleDescriptor	getBundleDescriptor()
java.lang.String	getDebugging()
EjbDescriptor	getEjbComponentImpl()
java.lang.String	getEjbLink()
java.lang.String	getEndpointAddressPath()
java.lang.String	getEndpointAddressUri()
java.lang.String	getEndpointName()
java.util.LinkedList<WebServiceHandlerChain>	getHandlerChain() Get ordered list of WebServiceHandler handler chains for this endpoint.
java.util.LinkedList	getHandlers() Get ordered list of WebServiceHandler handler for this endpoint.
java.lang.String	getHttpResponseBufferSize()
java.lang.String	getLinkName()
MessageSecurityBindingDescriptor	getMessageSecurityBinding()
java.lang.String	getMtomEnabled()
java.lang.String	getMtomThreshold()
java.util.Iterator	getProperties()
java.lang.String	getProtocolBinding()
java.lang.String	getPublishingUri() This is the logical equivalent to endpoint address uri, but for url publishing.
java.lang.String	getRealm()
ReliabilityConfig	getReliabilityConfig()
RespectBinding	getRespectBinding()
java.lang.String	getServiceEndpointInterface()
javax.xml.namespace.QName	getServiceName()
java.lang.String	getServletImplClass()
java.lang.String	getSoapAddressPrefix()
java.lang.String	getStreamAttachments()
java.lang.String	getTieClassName()
java.lang.String	getTransportGuarantee()
java.lang.String	getValidateRequest()
WebComponentDescriptor	getWebComponentImpl()
java.lang.String	getWebComponentLink()
WebService	getWebService()
java.lang.String	getWsdlContentPath(java.lang.String requestUri)
java.lang.String	getWsdlExposed()
javax.xml.namespace.QName	getWsdlPort()
java.lang.String	getWsdlPortNamespacePrefix()
javax.xml.namespace.QName	getWsdlService()
java.lang.String	getWsdlServiceNamespacePrefix()
boolean	hasAuthMethod()
boolean	hasBasicAuth()
boolean	hasClientCertAuth()
boolean	hasEndpointAddressUri()
boolean	hasHandlerChain()
boolean	hasHandlers()
boolean	hasSecurePipeline()
boolean	hasServiceName()
boolean	hasServletImplClass()
boolean	hasTieClassName()
boolean	hasTransportGuarantee()
boolean	hasUserSpecifiedProtocolBinding()
boolean	hasWsdlPort()
boolean	hasWsdlPortNamespacePrefix()
boolean	hasWsdlServiceNamespacePrefix()
boolean	implementedByEjbComponent()
boolean	implementedByEjbComponent(EjbDescriptor ejb)
boolean	implementedByWebComponent()
boolean	implementedByWebComponent(WebComponentDescriptor webComp)
boolean	isSecure()
boolean	matchesEjbPublishRequest(java.lang.String requestUriRaw, java.lang.String query) Checks an ejb request uri to see if it represents a legal request for the wsdl content associated with this endpoint's web service.
void	print(java.lang.StringBuffer toStringBuffer) A String representation of this object.
void	removeHandler(WebServiceHandler handler)
void	removeHandlerByName(java.lang.String handlerName)
void	removeHandlerChain(WebServiceHandlerChain handlerChain)
boolean	resolveComponentLink() Convert the contents of the ejb-link or servlet-link element to an object representing the implementation component.
void	saveServletImplClass() Store current contents of servlet impl class in a runtime descriptor element.
void	setAddressing(Addressing addressing)
void	setAuthMethod(java.lang.String authType)
void	setDebugging(java.lang.String debuggingEnabled)
void	setEjbComponentImpl(EjbDescriptor ejbComponent)
void	setEjbLink(java.lang.String link)
void	setEndpointAddressUri(java.lang.String uri)
void	setEndpointName(java.lang.String name)
void	setHttpResponseBufferSize(java.lang.String httpResponseBufferSize)
void	setMessageSecurityBinding(MessageSecurityBindingDescriptor messageSecBindingDesc)
void	setMtomEnabled(java.lang.String value)
void	setMtomThreshold(java.lang.String mtomThreshold)
void	setProtocolBinding(java.lang.String value)
void	setRealm(java.lang.String realm)
void	setReliabilityConfig(ReliabilityConfig reliabilityConfig)
void	setRespectBinding(RespectBinding respectBinding)
void	setSecurePipeline()
void	setServiceEndpointInterface(java.lang.String endpointInterface)
void	setServiceLocalPart(java.lang.String localpart)
void	setServiceNamespaceUri(java.lang.String uri)
void	setServletImplClass(java.lang.String implClass)
void	setStreamAttachments(java.lang.String streamAttachments)
void	setTieClassName(java.lang.String tieClass)
void	setTransportGuarantee(java.lang.String guarantee)
void	setValidateRequest(java.lang.String validateRequests)
void	setWebComponentImpl(WebComponentDescriptor webComponent)
void	setWebComponentLink(java.lang.String link)
void	setWebService(WebService service)
void	setWsdlExposed(java.lang.String wsdlExposed)
void	setWsdlPort(javax.xml.namespace.QName port)
void	setWsdlPort(javax.xml.namespace.QName port, java.lang.String prefix)
void	setWsdlService(javax.xml.namespace.QName service)
void	setWsdlService(javax.xml.namespace.QName svc, java.lang.String prefix)

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, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

TRANSPORT_NONE

public static final java.lang.String TRANSPORT_NONE

See Also:

Constant Field Values

TRANSPORT_INTEGRAL

public static final java.lang.String TRANSPORT_INTEGRAL

See Also:

Constant Field Values

TRANSPORT_CONFIDENTIAL

public static final java.lang.String TRANSPORT_CONFIDENTIAL

See Also:

Constant Field Values

CLIENT_CERT

public static final java.lang.String CLIENT_CERT

See Also:

Constant Field Values

SOAP11_TOKEN

public static final java.lang.String SOAP11_TOKEN

See Also:

Constant Field Values

SOAP12_TOKEN

public static final java.lang.String SOAP12_TOKEN

See Also:

Constant Field Values

SOAP11_MTOM_TOKEN

public static final java.lang.String SOAP11_MTOM_TOKEN

See Also:

Constant Field Values

SOAP12_MTOM_TOKEN

public static final java.lang.String SOAP12_MTOM_TOKEN

See Also:

Constant Field Values

XML_TOKEN

public static final java.lang.String XML_TOKEN

See Also:

Constant Field Values

PUBLISHING_SUBCONTEXT

public static final java.lang.String PUBLISHING_SUBCONTEXT

See Also:

Constant Field Values

Constructor Detail

WebServiceEndpoint

public WebServiceEndpoint(WebServiceEndpoint other)

WebServiceEndpoint

public WebServiceEndpoint()

Method Detail

getWsdlExposed

public java.lang.String getWsdlExposed()

setWsdlExposed

public void setWsdlExposed(java.lang.String wsdlExposed)

getValidateRequest

public java.lang.String getValidateRequest()

setValidateRequest

public void setValidateRequest(java.lang.String validateRequests)

getStreamAttachments

public java.lang.String getStreamAttachments()

setStreamAttachments

public void setStreamAttachments(java.lang.String streamAttachments)

setWebService

public void setWebService(WebService service)

getMtomThreshold

public java.lang.String getMtomThreshold()

setMtomThreshold

public void setMtomThreshold(java.lang.String mtomThreshold)

getWebService

public WebService getWebService()

getAddressing

public Addressing getAddressing()

setAddressing

public void setAddressing(Addressing addressing)

getRespectBinding

public RespectBinding getRespectBinding()

setRespectBinding

public void setRespectBinding(RespectBinding respectBinding)

setSecurePipeline

public void setSecurePipeline()

hasSecurePipeline

public boolean hasSecurePipeline()

setEndpointName

public void setEndpointName(java.lang.String name)

getEndpointName

public java.lang.String getEndpointName()

setServiceEndpointInterface

public void setServiceEndpointInterface(java.lang.String endpointInterface)

getServiceEndpointInterface

public java.lang.String getServiceEndpointInterface()

setProtocolBinding

public void setProtocolBinding(java.lang.String value)

getProtocolBinding

public java.lang.String getProtocolBinding()

hasUserSpecifiedProtocolBinding

public boolean hasUserSpecifiedProtocolBinding()

setMtomEnabled

public void setMtomEnabled(java.lang.String value)

getMtomEnabled

public java.lang.String getMtomEnabled()

setWsdlService

public void setWsdlService(javax.xml.namespace.QName svc,
                           java.lang.String prefix)

setWsdlService

public void setWsdlService(javax.xml.namespace.QName service)

getWsdlServiceNamespacePrefix

public java.lang.String getWsdlServiceNamespacePrefix()

hasWsdlServiceNamespacePrefix

public boolean hasWsdlServiceNamespacePrefix()

getWsdlService

public javax.xml.namespace.QName getWsdlService()

setWsdlPort

public void setWsdlPort(javax.xml.namespace.QName port,
                        java.lang.String prefix)

setWsdlPort

public void setWsdlPort(javax.xml.namespace.QName port)

getWsdlPortNamespacePrefix

public java.lang.String getWsdlPortNamespacePrefix()

hasWsdlPortNamespacePrefix

public boolean hasWsdlPortNamespacePrefix()

hasWsdlPort

public boolean hasWsdlPort()

getWsdlPort

public javax.xml.namespace.QName getWsdlPort()

setMessageSecurityBinding

public void setMessageSecurityBinding(MessageSecurityBindingDescriptor messageSecBindingDesc)

getMessageSecurityBinding

public MessageSecurityBindingDescriptor getMessageSecurityBinding()

getReliabilityConfig

public ReliabilityConfig getReliabilityConfig()

setReliabilityConfig

public void setReliabilityConfig(ReliabilityConfig reliabilityConfig)

getHttpResponseBufferSize

public java.lang.String getHttpResponseBufferSize()

setHttpResponseBufferSize

public void setHttpResponseBufferSize(java.lang.String httpResponseBufferSize)

resolveComponentLink

public boolean resolveComponentLink()

Convert the contents of the ejb-link or servlet-link element to an object representing the implementation component.

getBundleDescriptor

public BundleDescriptor getBundleDescriptor()

implementedByEjbComponent

public boolean implementedByEjbComponent()

Returns:

true if this endpoint is implemented by any ejb

implementedByEjbComponent

public boolean implementedByEjbComponent(EjbDescriptor ejb)

Returns:

true if this endpoint is implemented by a specific ejb

implementedByWebComponent

public boolean implementedByWebComponent()

Returns:

true if this endpoint is implemented by any web component

implementedByWebComponent

public boolean implementedByWebComponent(WebComponentDescriptor webComp)

Returns:

true if this endpoint is implemented by a specific web component

getLinkName

public java.lang.String getLinkName()

setEjbLink

public void setEjbLink(java.lang.String link)

getEjbLink

public java.lang.String getEjbLink()

setEjbComponentImpl

public void setEjbComponentImpl(EjbDescriptor ejbComponent)

getEjbComponentImpl

public EjbDescriptor getEjbComponentImpl()

setWebComponentLink

public void setWebComponentLink(java.lang.String link)

getWebComponentLink

public java.lang.String getWebComponentLink()

setWebComponentImpl

public void setWebComponentImpl(WebComponentDescriptor webComponent)

getWebComponentImpl

public WebComponentDescriptor getWebComponentImpl()

hasHandlers

public boolean hasHandlers()

Returns:

true if this endpoint has at least one handler in its handler chain.

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)

getHandlers

public java.util.LinkedList getHandlers()

Get ordered list of WebServiceHandler handler for this endpoint.

getHandlerChain

public java.util.LinkedList<WebServiceHandlerChain> getHandlerChain()

Get ordered list of WebServiceHandler handler chains for this endpoint.

Specified by:

getHandlerChain in interface HandlerChainContainer

hasHandlerChain

public boolean hasHandlerChain()

Specified by:

hasHandlerChain in interface HandlerChainContainer

Returns:

true if this endpoint has at least one handler chain

addHandlerChain

public void addHandlerChain(WebServiceHandlerChain handlerChain)

Append handlerchain to end of handlerchain for this endpoint.

Specified by:

addHandlerChain in interface HandlerChainContainer

removeHandlerChain

public void removeHandlerChain(WebServiceHandlerChain handlerChain)

hasEndpointAddressUri

public boolean hasEndpointAddressUri()

setEndpointAddressUri

public void setEndpointAddressUri(java.lang.String uri)

getEndpointAddressUri

public java.lang.String getEndpointAddressUri()

isSecure

public boolean isSecure()

composeEndpointAddress

public java.net.URL composeEndpointAddress(java.net.URL root)
                                    throws java.net.MalformedURLException

Given the root portion of a URL representing the :: of the webserver, return the endpoint address used to make web service invocations on this endpoint.

Throws:

java.net.MalformedURLException

composeEndpointAddress

public java.net.URL composeEndpointAddress(java.net.URL root,
                                           java.lang.String contextRoot)
                                    throws java.net.MalformedURLException

Throws:

java.net.MalformedURLException

getEndpointAddressPath

public java.lang.String getEndpointAddressPath()

composeFinalWsdlUrl

public java.net.URL composeFinalWsdlUrl(java.net.URL root)
                                 throws java.net.MalformedURLException

Generate a URL pointing to the initial wsdl document for this endpoint's web service.

Throws:

java.net.MalformedURLException

getPublishingUri

public java.lang.String getPublishingUri()

This is the logical equivalent to endpoint address uri, but for url publishing. Like endpoint address uri, it does not include the context root for servlet endpoints.

Returns:

publishing uri without a leading or trailing slash.

matchesEjbPublishRequest

public boolean matchesEjbPublishRequest(java.lang.String requestUriRaw,
                                        java.lang.String query)

Checks an ejb request uri to see if it represents a legal request for the wsdl content associated with this endpoint's web service. Equivalent matching for servlets is performed automatically by the web server. Should only be called for HTTP(S) GET.

getWsdlContentPath

public java.lang.String getWsdlContentPath(java.lang.String requestUri)

Returns:

the portion of a request uri that represents the location of wsdl content within a module or null if this request is invalid. Returned value does not have leading slash.

setAuthMethod

public void setAuthMethod(java.lang.String authType)

getAuthMethod

public java.lang.String getAuthMethod()

hasAuthMethod

public boolean hasAuthMethod()

hasBasicAuth

public boolean hasBasicAuth()

hasClientCertAuth

public boolean hasClientCertAuth()

setRealm

public void setRealm(java.lang.String realm)

getRealm

public java.lang.String getRealm()

setTransportGuarantee

public void setTransportGuarantee(java.lang.String guarantee)

getTransportGuarantee

public java.lang.String getTransportGuarantee()

hasTransportGuarantee

public boolean hasTransportGuarantee()

setServiceNamespaceUri

public void setServiceNamespaceUri(java.lang.String uri)

setServiceLocalPart

public void setServiceLocalPart(java.lang.String localpart)

hasServiceName

public boolean hasServiceName()

getServiceName

public javax.xml.namespace.QName getServiceName()

Returns:

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

saveServletImplClass

public void saveServletImplClass()

Store current contents of servlet impl class in a runtime descriptor element. The standard deployment descriptor element will be replaced at deployment time with a container-provided servlet impl, so we need to make a copy of this value in the runtime information.

hasServletImplClass

public boolean hasServletImplClass()

setServletImplClass

public void setServletImplClass(java.lang.String implClass)

getServletImplClass

public java.lang.String getServletImplClass()

hasTieClassName

public boolean hasTieClassName()

setTieClassName

public void setTieClassName(java.lang.String tieClass)

getTieClassName

public java.lang.String getTieClassName()

getDebugging

public java.lang.String getDebugging()

setDebugging

public void setDebugging(java.lang.String debuggingEnabled)

addProperty

public void addProperty(NameValuePairDescriptor newProp)

getProperties

public java.util.Iterator getProperties()

getSoapAddressPrefix

public java.lang.String getSoapAddressPrefix()

print

public void print(java.lang.StringBuffer toStringBuffer)

Description copied from class: Descriptor

A String representation of this object.

Overrides:

print in class Descriptor