com.sun.xml.ws.transport.http

Class TG_DeploymentDescriptorParser<A>

java.lang.Object

com.sun.xml.ws.transport.http.TG_DeploymentDescriptorParser<A>

public class TG_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 and Description
static interface	TG_DeploymentDescriptorParser.AdapterFactory<A> Creates a new "Adapter".

Field Summary

Fields

Modifier and Type	Field and Description
static String	ATTR_BINDING
static String	ATTR_ENABLE_MTOM
static String	ATTR_IMPLEMENTATION
static String	ATTR_MTOM_THRESHOLD_VALUE
static String	ATTR_NAME
static String	ATTR_PORT
static String	ATTR_SERVICE
static String	ATTR_URL_PATTERN
static String	ATTR_VERSION
static String	ATTR_WSDL
static String	ATTRVALUE_VERSION_1_0
static String	JAXWS_WSDL_DD_DIR
static String	NS_RUNTIME
static QName	QNAME_ENDPOINT
static QName	QNAME_ENDPOINTS

Constructor Summary

Constructors

Constructor and Description
TG_DeploymentDescriptorParser(ClassLoader cl, com.sun.xml.ws.transport.http.ResourceLoader loader, com.sun.xml.ws.api.server.Container container, TG_DeploymentDescriptorParser.AdapterFactory<A> adapterFactory)

Method Summary

Methods

Modifier and Type	Method and Description
static <T> com.sun.xml.ws.api.server.WSEndpoint<T>	create(Class<T> implType, boolean processHandlerAnnotation, com.sun.xml.ws.api.server.Invoker invoker, QName serviceName, QName portName, com.sun.xml.ws.api.server.Container container, com.sun.xml.ws.api.WSBinding binding, com.sun.xml.ws.api.server.SDDocumentSource primaryWsdl, Collection<? extends com.sun.xml.ws.api.server.SDDocumentSource> metadata, EntityResolver resolver, boolean isTransportSynchronous)
protected static void	ensureNoContent(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(com.sun.xml.ws.streaming.Attributes attrs, String name)
static String	getBindingIdForToken(String lexical) JSR-109 defines short-form tokens for standard binding Ids.
Map<String,com.sun.xml.ws.api.server.SDDocumentSource>	getDocs()
protected String	getMandatoryAttribute(XMLStreamReader reader, com.sun.xml.ws.streaming.Attributes attrs, String name)
protected String	getMandatoryNonEmptyAttribute(XMLStreamReader reader, com.sun.xml.ws.streaming.Attributes attributes, String name)
protected String	getNonEmptyAttribute(XMLStreamReader reader, com.sun.xml.ws.streaming.Attributes attrs, String name)
protected QName	getQNameAttribute(com.sun.xml.ws.streaming.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(com.sun.xml.ws.api.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

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

ATTRVALUE_VERSION_1_0

public static final String ATTRVALUE_VERSION_1_0

See Also:

Constant Field Values

Constructor Detail

TG_DeploymentDescriptorParser

public TG_DeploymentDescriptorParser(ClassLoader cl,
                             com.sun.xml.ws.transport.http.ResourceLoader loader,
                             com.sun.xml.ws.api.server.Container container,
                             TG_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

getDocs

public Map<String,com.sun.xml.ws.api.server.SDDocumentSource> getDocs()

create

public static <T> com.sun.xml.ws.api.server.WSEndpoint<T> create(@NotNull
                                                 Class<T> implType,
                                                 boolean processHandlerAnnotation,
                                                 @Nullable
                                                 com.sun.xml.ws.api.server.Invoker invoker,
                                                 @Nullable
                                                 QName serviceName,
                                                 @Nullable
                                                 QName portName,
                                                 @Nullable
                                                 com.sun.xml.ws.api.server.Container container,
                                                 @Nullable
                                                 com.sun.xml.ws.api.WSBinding binding,
                                                 @Nullable
                                                 com.sun.xml.ws.api.server.SDDocumentSource primaryWsdl,
                                                 @Nullable
                                                 Collection<? extends com.sun.xml.ws.api.server.SDDocumentSource> metadata,
                                                 @Nullable
                                                 EntityResolver resolver,
                                                 boolean isTransportSynchronous)

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(com.sun.xml.ws.streaming.Attributes attrs,
                  String name)

getQNameAttribute

protected QName getQNameAttribute(com.sun.xml.ws.streaming.Attributes attrs,
                      String name)

getNonEmptyAttribute

protected String getNonEmptyAttribute(XMLStreamReader reader,
                          com.sun.xml.ws.streaming.Attributes attrs,
                          String name)

getMandatoryAttribute

protected String getMandatoryAttribute(XMLStreamReader reader,
                           com.sun.xml.ws.streaming.Attributes attrs,
                           String name)

getMandatoryNonEmptyAttribute

protected String getMandatoryNonEmptyAttribute(XMLStreamReader reader,
                                   com.sun.xml.ws.streaming.Attributes attributes,
                                   String name)

setHandlersAndRoles

protected boolean setHandlersAndRoles(com.sun.xml.ws.api.WSBinding binding,
                          XMLStreamReader reader,
                          QName serviceName,
                          QName portName)

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

Returns:

true if element present in DD false otherwise.

ensureNoContent

protected static void ensureNoContent(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)