Examples of com.sun.xml.ws.api.message.HeaderList

com.sun.xml.ws.api.message.HeaderList
A list of {@link Header}s on a {@link Message}.
This list can be modified to add headers from outside a {@link Message}, this is necessary since intermediate processing layers often need to put additional headers.
Following the SOAP convention, the order among headers are not significant. However, {@link Codec}s are expected to preserve the order of headers in the input message as much as possible.
MustUnderstand Processing

To perform SOAP mustUnderstang processing correctly, we need to keep track of headers that are understood and headers that are not. This is a collaborative process among {@link Pipe}s, thus it's something a {@link Pipe} author needs to keep in mind.
Specifically, when a {@link Pipe} sees a header and processes it(that is, if it did enough computing with the header to claim that the header is understood), then it should mark the corresponding header as "understood". For example, when a pipe that handles JAX-WSA examins the <wsa:To> header, it can claim that it understood the header. But for example, if a pipe that does the signature verification checks <wsa:To> for a signature, that would not be considered as "understood".
There are two ways to mark a header as understood:
1. Use one of the getXXX methods that take a boolean markAsUnderstood parameter. Most often, a {@link Pipe} knows it's going to understand a headeras long as it's present, so this is the easiest and thus the preferred way. For example, if JAX-WSA looks for <wsa:To>, then it can set markAsUnderstand to true, to do the obtaining of a header and marking at the same time.
2. Call {@link #understood(int)}. If under a rare circumstance, a pipe cannot determine whether it can understand it or not when you are fetching a header, then you can use this method afterward to mark it as understood.
Intuitively speaking, at the end of the day, if a header is not understood but {@link Header#isIgnorable(SOAPVersion,java.util.Set)} is false, a bad thingwill happen. The actual implementation of the checking is more complicated, for that see {@link ClientMUTube}/ {@link ServerMUTube}. @see Message#getHeaders()

    }


    @SuppressWarnings("unchecked")
    public SecuredMessage(Message msg, SecurityHeader sh) {
        // FIXME: RJE - Remove cast and then just use MessageHeaders rather than ArrayList
        HeaderList hl = (HeaderList) msg.getHeaders();
        headers = new ArrayList(hl);
        //this.msg = msg;
        this.body = new SOAPBody(msg);
        attachments = msg.getAttachments();
        this.sh = sh;

View Full Code Here

    private final MessageHeaders headers;
    private final AttachmentSet attachmentSet;


    public EmptyMessageImpl(SOAPVersion version) {
        super(version);
        this.headers = new HeaderList(version);
        this.attachmentSet = new AttachmentSetImpl();
    }

View Full Code Here

    }


    public EmptyMessageImpl(MessageHeaders headers, @NotNull AttachmentSet attachmentSet, SOAPVersion version){
        super(version);
        if(headers==null)
            headers = new HeaderList(version);
        this.attachmentSet = attachmentSet;
        this.headers = headers;
    }

View Full Code Here

    /**
     * Copy constructor.
     */
    private EmptyMessageImpl(EmptyMessageImpl that) {
        super(that);
        this.headers = new HeaderList(that.headers);
        this.attachmentSet = that.attachmentSet;
        this.copyFrom(that);
    }

View Full Code Here

        return getHeaders().hasHeaders();
    }


    public MessageHeaders getHeaders() {
        if (headers == null)
            headers = new HeaderList(getSOAPVersion());


        return headers;
    }

View Full Code Here

    }


    public MessageHeaders getHeaders() {
        if ( envelopeReader != null ) readEnvelope(this);
        if (headers == null) {
            headers = new HeaderList(getSOAPVersion());
        }
        return headers;
    }

View Full Code Here

        // Move to next element
        XMLStreamReaderUtil.nextElementContent(reader);
        XMLStreamReaderUtil.verifyReaderState(reader,
                javax.xml.stream.XMLStreamConstants.START_ELEMENT);


        HeaderList headers = null;
        TagInfoset headerTag = null;


        if (reader.getLocalName().equals(SOAP_HEADER)
                && reader.getNamespaceURI().equals(soapVersion.nsUri)) {
            headerTag = new TagInfoset(reader);


            // Collect namespaces on soap:Header
            for(int i=0; i< reader.getNamespaceCount();i++){
                namespaces.put(reader.getNamespacePrefix(i), reader.getNamespaceURI(i));
            }
            // skip <soap:Header>
            XMLStreamReaderUtil.nextElementContent(reader);


            // If SOAP header blocks are present (i.e. not <soap:Header/>)
            if (reader.getEventType() == XMLStreamConstants.START_ELEMENT) {
                headers = new HeaderList(soapVersion);


                try {
                    // Cache SOAP header blocks
                    StreamHeaderDecoder headerDecoder = SOAPVersion.SOAP_11.equals(soapVersion) ? SOAP11StreamHeaderDecoder : SOAP12StreamHeaderDecoder;
                    cacheHeaders(reader, namespaces, headers, headerDecoder);

View Full Code Here

0 1 2 3 4 5

TOP

Related Classes of com.sun.xml.ws.api.message.HeaderList

com.jaxws.json.JSONMessage

com.sun.xml.ws.addressing.WsaServerTube

com.sun.xml.ws.addressing.WsaTubeHelper

com.sun.xml.ws.api.addressing.AddressingVersion

com.sun.xml.ws.api.addressing.WSEndpointReference

com.sun.xml.ws.api.model.wsdl.WSDLBoundOperation

com.sun.xml.ws.api.SOAPVersion

com.sun.xml.ws.client.Stub

com.sun.xml.ws.encoding.StreamSOAPCodec

com.sun.xml.ws.message.AbstractMessageImpl

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.

Examples of com.sun.xml.ws.api.message.HeaderList

MustUnderstand Processing

Related Classes of com.sun.xml.ws.api.message.HeaderList