com.sun.xml.ws.transport.http
Class DeploymentDescriptorParser<A>

java.lang.Object
  com.sun.xml.ws.transport.http.DeploymentDescriptorParser<A>

public class DeploymentDescriptorParser<A>
extends java.lang.Object

Parses sun-jaxws.xml into WSEndpoint.

Since sun-jaxws.xml captures more information than what WSEndpoint represents (in particular URL pattern and name), this class takes a parameterization 'A' so that the user of this parser can choose to create another type that wraps WSEndpoint.

HttpAdapter and its derived type is used for this often, but it can be anything.

Nested Class Summary

static interface

DeploymentDescriptorParser.AdapterFactory<A> Creates a new "Adapter".

Field Summary

static java.lang.String	ATTR_BINDING
static java.lang.String	ATTR_DATABINDING
static java.lang.String	ATTR_ENABLE_MTOM
static java.lang.String	ATTR_FILE
static java.lang.String	ATTR_IMPLEMENTATION
static java.lang.String	ATTR_MTOM_THRESHOLD_VALUE
static java.lang.String	ATTR_NAME
static java.lang.String	ATTR_PORT
static java.lang.String	ATTR_RESOURCE
static java.lang.String	ATTR_SERVICE
static java.lang.String	ATTR_URL_PATTERN
static java.lang.String	ATTR_VERSION
static java.lang.String	ATTR_WSDL
static java.util.List<java.lang.String>	ATTRVALUE_SUPPORTED_VERSIONS
static java.lang.String	JAXWS_WSDL_DD_DIR
static java.lang.String	NS_RUNTIME
static javax.xml.namespace.QName	QNAME_ENDPOINT
static javax.xml.namespace.QName	QNAME_ENDPOINTS
static javax.xml.namespace.QName	QNAME_EXT_METADA

Constructor Summary

DeploymentDescriptorParser(java.lang.ClassLoader cl, ResourceLoader loader, Container container, DeploymentDescriptorParser.AdapterFactory<A> adapterFactory)

Method Summary

protected com.oracle.webservices.api.databinding.ExternalMetadataFeature	configureExternalMetadataReader(javax.xml.stream.XMLStreamReader reader)
protected static void	fail(java.lang.String key, javax.xml.stream.XMLStreamReader reader)
protected static void	failWithFullName(java.lang.String key, javax.xml.stream.XMLStreamReader reader)
protected static void	failWithLocalName(java.lang.String key, javax.xml.stream.XMLStreamReader reader)
protected static void	failWithLocalName(java.lang.String key, javax.xml.stream.XMLStreamReader reader, java.lang.String arg)
protected java.lang.String	getAttribute(Attributes attrs, java.lang.String name)
static java.lang.String	getBindingIdForToken(java.lang.String lexical) JSR-109 defines short-form tokens for standard binding Ids.
protected java.lang.String	getMandatoryAttribute(javax.xml.stream.XMLStreamReader reader, Attributes attrs, java.lang.String name)
protected java.lang.String	getMandatoryNonEmptyAttribute(javax.xml.stream.XMLStreamReader reader, Attributes attributes, java.lang.String name)
protected java.lang.String	getNonEmptyAttribute(javax.xml.stream.XMLStreamReader reader, Attributes attrs, java.lang.String name)
protected javax.xml.namespace.QName	getQNameAttribute(Attributes attrs, java.lang.String name)
protected java.lang.Class	loadClass(java.lang.String name)
java.util.List<A>	parse(java.io.File f) Parses the sun-jaxws.xml file and configures a set of HttpAdapters.
java.util.List<A>	parse(java.lang.String systemId, java.io.InputStream is) Parses the sun-jaxws.xml file and configures a set of HttpAdapters.
protected boolean	setHandlersAndRoles(WSBinding binding, javax.xml.stream.XMLStreamReader reader, javax.xml.namespace.QName serviceName, javax.xml.namespace.QName portName) Parses the handler and role information and sets it on the WSBinding.

Methods inherited from class java.lang.Object

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

Field Detail

NS_RUNTIME

public static final java.lang.String NS_RUNTIME

See Also:

Constant Field Values

JAXWS_WSDL_DD_DIR

public static final java.lang.String JAXWS_WSDL_DD_DIR

See Also:

Constant Field Values

QNAME_ENDPOINTS

public static final javax.xml.namespace.QName QNAME_ENDPOINTS

QNAME_ENDPOINT

public static final javax.xml.namespace.QName QNAME_ENDPOINT

QNAME_EXT_METADA

public static final javax.xml.namespace.QName QNAME_EXT_METADA

ATTR_FILE

public static final java.lang.String ATTR_FILE

See Also:

Constant Field Values

ATTR_RESOURCE

public static final java.lang.String ATTR_RESOURCE

See Also:

Constant Field Values

ATTR_VERSION

public static final java.lang.String ATTR_VERSION

See Also:

Constant Field Values

ATTR_NAME

public static final java.lang.String ATTR_NAME

See Also:

Constant Field Values

ATTR_IMPLEMENTATION

public static final java.lang.String ATTR_IMPLEMENTATION

See Also:

Constant Field Values

ATTR_WSDL

public static final java.lang.String ATTR_WSDL

See Also:

Constant Field Values

ATTR_SERVICE

public static final java.lang.String ATTR_SERVICE

See Also:

Constant Field Values

ATTR_PORT

public static final java.lang.String ATTR_PORT

See Also:

Constant Field Values

ATTR_URL_PATTERN

public static final java.lang.String ATTR_URL_PATTERN

See Also:

Constant Field Values

ATTR_ENABLE_MTOM

public static final java.lang.String ATTR_ENABLE_MTOM

See Also:

Constant Field Values

ATTR_MTOM_THRESHOLD_VALUE

public static final java.lang.String ATTR_MTOM_THRESHOLD_VALUE

See Also:

Constant Field Values

ATTR_BINDING

public static final java.lang.String ATTR_BINDING

See Also:

Constant Field Values

ATTR_DATABINDING

public static final java.lang.String ATTR_DATABINDING

See Also:

Constant Field Values

ATTRVALUE_SUPPORTED_VERSIONS

public static final java.util.List<java.lang.String> ATTRVALUE_SUPPORTED_VERSIONS

Constructor Detail

DeploymentDescriptorParser

public DeploymentDescriptorParser(java.lang.ClassLoader cl,
                                  ResourceLoader loader,
                                  Container container,
                                  DeploymentDescriptorParser.AdapterFactory<A> adapterFactory)
                           throws java.net.MalformedURLException

Parameters:

cl - Used to load service implementations.

loader - Used to locate resources, in particular WSDL.

container - Optional Container that WSEndpoints receive.

adapterFactory - Creates HttpAdapter (or its derived class.)

Throws:

java.net.MalformedURLException

Method Detail

parse

@NotNull
public java.util.List<A> parse(java.lang.String systemId,
                                       java.io.InputStream is)

Parses the sun-jaxws.xml file and configures a set of HttpAdapters.

parse

@NotNull
public java.util.List<A> parse(java.io.File f)
                        throws java.io.IOException

Parses the sun-jaxws.xml file and configures a set of HttpAdapters.

Throws:

java.io.IOException

getBindingIdForToken

@NotNull
public static java.lang.String getBindingIdForToken(@NotNull
                                                            java.lang.String lexical)

JSR-109 defines short-form tokens for standard binding Ids. These are used only in DD. So stand alone deployment descirptor should also honor these tokens. This method converts the tokens to API's standard binding ids

Parameters:

lexical - binding attribute value from DD. Always not null

Returns:

returns corresponding API's binding ID or the same lexical

getAttribute

protected java.lang.String getAttribute(Attributes attrs,
                                        java.lang.String name)

getQNameAttribute

protected javax.xml.namespace.QName getQNameAttribute(Attributes attrs,
                                                      java.lang.String name)

getNonEmptyAttribute

protected java.lang.String getNonEmptyAttribute(javax.xml.stream.XMLStreamReader reader,
                                                Attributes attrs,
                                                java.lang.String name)

getMandatoryAttribute

protected java.lang.String getMandatoryAttribute(javax.xml.stream.XMLStreamReader reader,
                                                 Attributes attrs,
                                                 java.lang.String name)

getMandatoryNonEmptyAttribute

protected java.lang.String getMandatoryNonEmptyAttribute(javax.xml.stream.XMLStreamReader reader,
                                                         Attributes attributes,
                                                         java.lang.String name)

setHandlersAndRoles

protected boolean setHandlersAndRoles(WSBinding binding,
                                      javax.xml.stream.XMLStreamReader reader,
                                      javax.xml.namespace.QName serviceName,
                                      javax.xml.namespace.QName portName)

Parses the handler and role information and sets it on the WSBinding.

Returns:

true if element present in DD false otherwise.

configureExternalMetadataReader

protected com.oracle.webservices.api.databinding.ExternalMetadataFeature configureExternalMetadataReader(javax.xml.stream.XMLStreamReader reader)

fail

protected static void fail(java.lang.String key,
                           javax.xml.stream.XMLStreamReader reader)

failWithFullName

protected static void failWithFullName(java.lang.String key,
                                       javax.xml.stream.XMLStreamReader reader)

failWithLocalName

protected static void failWithLocalName(java.lang.String key,
                                        javax.xml.stream.XMLStreamReader reader)

failWithLocalName

protected static void failWithLocalName(java.lang.String key,
                                        javax.xml.stream.XMLStreamReader reader,
                                        java.lang.String arg)

loadClass

protected java.lang.Class loadClass(java.lang.String name)