com.sun.xml.ws.api.message
Class Headers

java.lang.Object
  extended by com.sun.xml.ws.api.message.Headers

public abstract class Headers
extends Object

Factory methods for various Header implementations.

This class provides various methods to create different flavors of Header classes that store data in different formats.

This is a part of the JAX-WS RI internal API so that Pipe implementations can reuse the implementations done inside the JAX-WS without having a strong dependency to the actual class.

If you find some of the useful convenience methods missing from this class, please talk to us.


Method Summary
static Header create(Bridge bridge, Object jaxbObject)
          Creates a Header backed a by a JAXB bean.
static Header create(Element node)
          Creates a new Header backed by an Element.
static Header create(JAXBRIContext context, Object o)
          Creates a Header backed a by a JAXB bean.
static Header create(QName name, String value)
          Creates a new Header that that has a single text value in it (IOW, of the form <foo>text</foo>.)
static Header create(javax.xml.soap.SOAPHeaderElement header)
          Creates a new Header backed by a SAAJ object.
static Header create(SOAPVersion soapVersion, Element node)
          Deprecated. Use create(Element)
static Header create(SOAPVersion soapVersion, Marshaller m, Object o)
          Deprecated. Use create(JAXBRIContext, Object) instead.
static Header create(SOAPVersion soapVersion, Marshaller m, QName tagName, Object o)
          Creates a Header backed a by a JAXB bean, with the given tag name.
static Header create(SOAPVersion soapVersion, javax.xml.stream.XMLStreamReader reader)
          Creates a new Header that reads from XMLStreamReader.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

create

public static Header create(SOAPVersion soapVersion,
                            Marshaller m,
                            Object o)
Deprecated. Use create(JAXBRIContext, Object) instead.


create

public static Header create(JAXBRIContext context,
                            Object o)
Creates a Header backed a by a JAXB bean.


create

public static Header create(SOAPVersion soapVersion,
                            Marshaller m,
                            QName tagName,
                            Object o)
Creates a Header backed a by a JAXB bean, with the given tag name. See create(SOAPVersion, Marshaller, Object) for the meaning of other parameters.

Parameters:
tagName - The name of the newly created header. Must not be null.
o - The JAXB bean that represents the contents of the header. Must not be null.

create

public static Header create(Bridge bridge,
                            Object jaxbObject)
Creates a Header backed a by a JAXB bean.


create

public static Header create(javax.xml.soap.SOAPHeaderElement header)
Creates a new Header backed by a SAAJ object.


create

public static Header create(Element node)
Creates a new Header backed by an Element.


create

public static Header create(SOAPVersion soapVersion,
                            Element node)
Deprecated. Use create(Element)


create

public static Header create(SOAPVersion soapVersion,
                            javax.xml.stream.XMLStreamReader reader)
                     throws javax.xml.stream.XMLStreamException
Creates a new Header that reads from XMLStreamReader.

Note that the header implementation will read the entire data into memory anyway, so this might not be as efficient as you might hope.

Throws:
javax.xml.stream.XMLStreamException

create

public static Header create(QName name,
                            String value)
Creates a new Header that that has a single text value in it (IOW, of the form <foo>text</foo>.)

Parameters:
name - QName of the header element
value - text value of the header