com.sun.xml.ws.message
Class AbstractMessageImpl

java.lang.Object
  com.sun.xml.ws.api.message.Message
      com.sun.xml.ws.message.AbstractMessageImpl

Direct Known Subclasses:

DOMMessage, EmptyMessageImpl, JAXBDispatchMessage, JAXBMessage, PayloadStreamReaderMessage, StreamMessage, XMLMessage.UnknownContent, XMLMessage.XMLMultiPart

public abstract class AbstractMessageImpl
extends Message

Partial Message implementation.

This class implements some of the Message methods. The idea is that those implementations may be non-optimal but it may save effort in implementing Message and reduce the code size.

Message classes that are used more commonly should examine carefully which method can be implemented faster, and override them accordingly.

Field Summary

protected TagInfoset	bodyTag
protected static java.util.List<TagInfoset>	DEFAULT_TAGS
protected static org.xml.sax.helpers.AttributesImpl	EMPTY_ATTS
protected TagInfoset	envelopeTag
protected TagInfoset	headerTag
protected static org.xml.sax.helpers.LocatorImpl	NULL_LOCATOR
protected SOAPVersion	soapVersion SOAP version of this message.

Fields inherited from class com.sun.xml.ws.api.message.Message

attachmentSet

Constructor Summary

protected	AbstractMessageImpl(AbstractMessageImpl that) Copy constructor.
protected	AbstractMessageImpl(SOAPVersion soapVersion)

Method Summary

SOAPVersion	getSOAPVersion()
javax.xml.soap.SOAPMessage	readAsSOAPMessage() Default implementation that uses writeTo(ContentHandler, ErrorHandler)
javax.xml.soap.SOAPMessage	readAsSOAPMessage(Packet packet, boolean inbound) Creates the equivalent SOAPMessage from this message.
javax.xml.transform.Source	readEnvelopeAsSource() Consumes this message including the envelope.
<T> T	readPayloadAsJAXB(com.sun.xml.bind.api.Bridge<T> bridge) Deprecated.
<T> T	readPayloadAsJAXB(javax.xml.bind.Unmarshaller unmarshaller) Reads the payload as a JAXB object by using the given unmarshaller.
<T> T	readPayloadAsJAXB(XMLBridge<T> bridge) Reads the payload as a Data-Bond object This consumes the message.
Message	toSAAJ(Packet p, java.lang.Boolean inbound)
protected abstract void	writePayloadTo(org.xml.sax.ContentHandler contentHandler, org.xml.sax.ErrorHandler errorHandler, boolean fragment) Writes the payload to SAX events.
void	writeTo(org.xml.sax.ContentHandler contentHandler, org.xml.sax.ErrorHandler errorHandler) Writes the whole envelope as SAX events.
void	writeTo(javax.xml.stream.XMLStreamWriter w) Default implementation that relies on Message.writePayloadTo(XMLStreamWriter)
void	writeToBodyStart(javax.xml.stream.XMLStreamWriter w)

Methods inherited from class com.sun.xml.ws.api.message.Message

addSOAPMimeHeaders, assertOneWay, consume, copy, copyFrom, generateMessageID, getAttachments, getFirstDetailEntryName, getHeaders, getID, getID, getMethod, getOperation, getOperation, getPayloadLocalPart, getPayloadNamespaceURI, getTransportHeaders, getTransportHeaders, hasAttachments, hasHeaders, hasPayload, isFault, isOneWay, readPayload, readPayloadAsSource, setMessageMedadata, writePayloadTo

Methods inherited from class java.lang.Object

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

Field Detail

soapVersion

protected final SOAPVersion soapVersion

SOAP version of this message. Used to implement some of the methods, but nothing more than that.

So if you aren't using those methods that use this field, this can be null.

envelopeTag

@NotNull
protected TagInfoset envelopeTag

headerTag

@NotNull
protected TagInfoset headerTag

bodyTag

@NotNull
protected TagInfoset bodyTag

EMPTY_ATTS

protected static final org.xml.sax.helpers.AttributesImpl EMPTY_ATTS

NULL_LOCATOR

protected static final org.xml.sax.helpers.LocatorImpl NULL_LOCATOR

DEFAULT_TAGS

protected static final java.util.List<TagInfoset> DEFAULT_TAGS

Constructor Detail

AbstractMessageImpl

protected AbstractMessageImpl(SOAPVersion soapVersion)

AbstractMessageImpl

protected AbstractMessageImpl(AbstractMessageImpl that)

Copy constructor.

Method Detail

getSOAPVersion

public SOAPVersion getSOAPVersion()

Overrides:

getSOAPVersion in class Message

readEnvelopeAsSource

public javax.xml.transform.Source readEnvelopeAsSource()

Description copied from class: Message

Consumes this message including the envelope. returns it as a Source object.

Specified by:

readEnvelopeAsSource in class Message

readPayloadAsJAXB

public <T> T readPayloadAsJAXB(javax.xml.bind.Unmarshaller unmarshaller)
                    throws javax.xml.bind.JAXBException

Description copied from class: Message

Reads the payload as a JAXB object by using the given unmarshaller. This consumes the message.

Specified by:

readPayloadAsJAXB in class Message

Throws:

javax.xml.bind.JAXBException - If JAXB reports an error during the processing.

readPayloadAsJAXB

public <T> T readPayloadAsJAXB(com.sun.xml.bind.api.Bridge<T> bridge)
                    throws javax.xml.bind.JAXBException

Deprecated.

Description copied from class: Message

Reads the payload as a JAXB object according to the given Bridge. This consumes the message.

Specified by:

readPayloadAsJAXB in class Message

Returns:

null if there's no payload.

Throws:

javax.xml.bind.JAXBException - If JAXB reports an error during the processing.

readPayloadAsJAXB

public <T> T readPayloadAsJAXB(XMLBridge<T> bridge)
                    throws javax.xml.bind.JAXBException

Description copied from class: Message

Reads the payload as a Data-Bond object This consumes the message.

Specified by:

readPayloadAsJAXB in class Message

Returns:

null if there's no payload.

Throws:

javax.xml.bind.JAXBException - If JAXB reports an error during the processing.

writeToBodyStart

public void writeToBodyStart(javax.xml.stream.XMLStreamWriter w)
                      throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

writeTo

public void writeTo(javax.xml.stream.XMLStreamWriter w)
             throws javax.xml.stream.XMLStreamException

Default implementation that relies on Message.writePayloadTo(XMLStreamWriter)

Specified by:

writeTo in class Message

Throws:

javax.xml.stream.XMLStreamException - If the XMLStreamWriter reports an error, or some other errors happen during the processing.

writeTo

public void writeTo(org.xml.sax.ContentHandler contentHandler,
                    org.xml.sax.ErrorHandler errorHandler)
             throws org.xml.sax.SAXException

Writes the whole envelope as SAX events.

Specified by:

writeTo in class Message

Parameters:

contentHandler - must not be nulll.

errorHandler - must not be null. any error encountered during the SAX event production must be first reported to this error handler. Fatal errors can be then thrown as SAXParseException. SAXExceptions thrown from ErrorHandler should propagate directly through this method.

Throws:

org.xml.sax.SAXException

writePayloadTo

protected abstract void writePayloadTo(org.xml.sax.ContentHandler contentHandler,
                                       org.xml.sax.ErrorHandler errorHandler,
                                       boolean fragment)
                                throws org.xml.sax.SAXException

Writes the payload to SAX events.

Parameters:

fragment - if true, this method will fire SAX events without start/endDocument events, suitable for embedding this into a bigger SAX event sequence. if false, this method generaets a completely SAX event sequence on its own.

Throws:

org.xml.sax.SAXException

toSAAJ

public Message toSAAJ(Packet p,
                      java.lang.Boolean inbound)
               throws javax.xml.soap.SOAPException

Throws:

javax.xml.soap.SOAPException

readAsSOAPMessage

public javax.xml.soap.SOAPMessage readAsSOAPMessage()
                                             throws javax.xml.soap.SOAPException

Default implementation that uses writeTo(ContentHandler, ErrorHandler)

Specified by:

readAsSOAPMessage in class Message

Throws:

javax.xml.soap.SOAPException - if there's any error while creating a SOAPMessage.

readAsSOAPMessage

public javax.xml.soap.SOAPMessage readAsSOAPMessage(Packet packet,
                                                    boolean inbound)
                                             throws javax.xml.soap.SOAPException

Description copied from class: Message

Creates the equivalent SOAPMessage from this message. It also uses transport specific headers from Packet during the SOAPMessage construction so that SOAPMessage.getMimeHeaders() gives meaningful transport headers. This consumes the message.

Overrides:

readAsSOAPMessage in class Message

Throws:

javax.xml.soap.SOAPException - if there's any error while creating a SOAPMessage.