Package 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 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.

Author:

WS Development Team, Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	DeploymentDescriptorParser.AdapterFactory<A>	Creates a new "Adapter".

Field Summary

Fields

Modifier and Type	Field	Description
static String	ATTR_BINDING
static String	ATTR_DATABINDING
static String	ATTR_ENABLE_MTOM
static String	ATTR_FILE
static String	ATTR_IMPLEMENTATION
static String	ATTR_MTOM_THRESHOLD_VALUE
static String	ATTR_NAME
static String	ATTR_PORT
static String	ATTR_RESOURCE
static String	ATTR_SERVICE
static String	ATTR_URL_PATTERN
static String	ATTR_VERSION
static String	ATTR_WSDL
static List<String>	ATTRVALUE_SUPPORTED_VERSIONS
static String	JAXWS_WSDL_DD_DIR
static String	NS_RUNTIME
static QName	QNAME_ENDPOINT
static QName	QNAME_ENDPOINTS
static QName	QNAME_EXT_METADA

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
protected ExternalMetadataFeature	configureExternalMetadataReader(XMLStreamReader reader)
protected static void	fail(String key, XMLStreamReader reader)
protected static void	failWithFullName(String key, XMLStreamReader reader)
protected static void	failWithLocalName(String key, XMLStreamReader reader)
protected static void	failWithLocalName(String key, XMLStreamReader reader, String arg)
protected String	getAttribute(Attributes attrs, String name)
static String	getBindingIdForToken(String lexical)	JSR-109 defines short-form tokens for standard binding Ids.
protected String	getMandatoryAttribute(XMLStreamReader reader, Attributes attrs, String name)
protected String	getMandatoryNonEmptyAttribute(XMLStreamReader reader, Attributes attributes, String name)
protected String	getNonEmptyAttribute(XMLStreamReader reader, Attributes attrs, String name)
protected QName	getQNameAttribute(Attributes attrs, String name)
protected Class	loadClass(String name)
List<A>	parse(File f)	Parses the sun-jaxws.xml file and configures a set of HttpAdapters.
List<A>	parse(String systemId, InputStream is)	Parses the sun-jaxws.xml file and configures a set of HttpAdapters.
protected boolean	setHandlersAndRoles(WSBinding binding, XMLStreamReader reader, QName serviceName, 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 String NS_RUNTIME

See Also:

Constant Field Values

JAXWS_WSDL_DD_DIR

public static final String JAXWS_WSDL_DD_DIR

See Also:

Constant Field Values

QNAME_ENDPOINTS

public static final QName QNAME_ENDPOINTS

QNAME_ENDPOINT

public static final QName QNAME_ENDPOINT

QNAME_EXT_METADA

public static final QName QNAME_EXT_METADA

ATTR_FILE

public static final String ATTR_FILE

See Also:

Constant Field Values

ATTR_RESOURCE

public static final String ATTR_RESOURCE

See Also:

Constant Field Values

ATTR_VERSION

public static final String ATTR_VERSION

See Also:

Constant Field Values

ATTR_NAME

public static final String ATTR_NAME

See Also:

Constant Field Values

ATTR_IMPLEMENTATION

public static final String ATTR_IMPLEMENTATION

See Also:

Constant Field Values

ATTR_WSDL

public static final String ATTR_WSDL

See Also:

Constant Field Values

ATTR_SERVICE

public static final String ATTR_SERVICE

See Also:

Constant Field Values

ATTR_PORT

public static final String ATTR_PORT

See Also:

Constant Field Values

ATTR_URL_PATTERN

public static final String ATTR_URL_PATTERN

See Also:

Constant Field Values

ATTR_ENABLE_MTOM

public static final String ATTR_ENABLE_MTOM

See Also:

Constant Field Values

ATTR_MTOM_THRESHOLD_VALUE

public static final String ATTR_MTOM_THRESHOLD_VALUE

See Also:

Constant Field Values

ATTR_BINDING

public static final String ATTR_BINDING

See Also:

Constant Field Values

ATTR_DATABINDING

public static final String ATTR_DATABINDING

See Also:

Constant Field Values

ATTRVALUE_SUPPORTED_VERSIONS

public static final List<String> ATTRVALUE_SUPPORTED_VERSIONS

Constructor Detail

DeploymentDescriptorParser

public DeploymentDescriptorParser(ClassLoader cl,
                                  ResourceLoader loader,
                                  Container container,
                                  DeploymentDescriptorParser.AdapterFactory<A> adapterFactory)
                           throws 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:

MalformedURLException

Method Detail

parse

@NotNull
public List<A> parse(String systemId,
                     InputStream is)

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

parse

@NotNull
public List<A> parse(File f)
              throws IOException

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

Throws:

IOException

getBindingIdForToken

@NotNull
public static String getBindingIdForToken(@NotNull
                                          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 String getAttribute(Attributes attrs,
                              String name)

getQNameAttribute

protected QName getQNameAttribute(Attributes attrs,
                                  String name)

getNonEmptyAttribute

protected String getNonEmptyAttribute(XMLStreamReader reader,
                                      Attributes attrs,
                                      String name)

getMandatoryAttribute

protected String getMandatoryAttribute(XMLStreamReader reader,
                                       Attributes attrs,
                                       String name)

getMandatoryNonEmptyAttribute

protected String getMandatoryNonEmptyAttribute(XMLStreamReader reader,
                                               Attributes attributes,
                                               String name)

setHandlersAndRoles

protected boolean setHandlersAndRoles(WSBinding binding,
                                      XMLStreamReader reader,
                                      QName serviceName,
                                      QName portName)

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

Returns:

true if <handler-chains> element present in DD false otherwise.

configureExternalMetadataReader

protected ExternalMetadataFeature configureExternalMetadataReader(XMLStreamReader reader)

fail

protected static void fail(String key,
                           XMLStreamReader reader)

failWithFullName

protected static void failWithFullName(String key,
                                       XMLStreamReader reader)

failWithLocalName

protected static void failWithLocalName(String key,
                                        XMLStreamReader reader)

failWithLocalName

protected static void failWithLocalName(String key,
                                        XMLStreamReader reader,
                                        String arg)

loadClass

protected Class loadClass(String name)