Module com.sun.xml.ws.rt
Package com.sun.xml.ws.api.message.saaj

Class SAAJFactory

  • public class SAAJFactory
extends Object
    Factory SPI for SAAJ implementations
    Since:
    2.2.6

    • Constructor Detail

      • SAAJFactory

        public SAAJFactory()

    • Method Detail

      • getMessageFactory

        public static javax.xml.soap.MessageFactory getMessageFactory​(String protocol)
                                                       throws javax.xml.soap.SOAPException
        Creates a new MessageFactory object that is an instance of the specified implementation. May be a dynamic message factory, a SOAP 1.1 message factory, or a SOAP 1.2 message factory. A dynamic message factory creates messages based on the MIME headers specified as arguments to the createMessage method. This method uses the SAAJMetaFactory to locate the implementation class and create the MessageFactory instance.
        Parameters:
        protocol - a string constant representing the class of the specified message factory implementation. May be either DYNAMIC_SOAP_PROTOCOL, DEFAULT_SOAP_PROTOCOL (which is the same as) SOAP_1_1_PROTOCOL, or SOAP_1_2_PROTOCOL.
        Returns:
        a new instance of a MessageFactory
        Throws:
        javax.xml.soap.SOAPException - if there was an error in creating the specified implementation of MessageFactory.
        See Also:
        SAAJMetaFactory

      • getSOAPFactory

        public static javax.xml.soap.SOAPFactory getSOAPFactory​(String protocol)
                                                 throws javax.xml.soap.SOAPException
        Creates a new SOAPFactory object that is an instance of the specified implementation, this method uses the SAAJMetaFactory to locate the implementation class and create the SOAPFactory instance.
        Parameters:
        protocol - a string constant representing the protocol of the specified SOAP factory implementation. May be either DYNAMIC_SOAP_PROTOCOL, DEFAULT_SOAP_PROTOCOL (which is the same as) SOAP_1_1_PROTOCOL, or SOAP_1_2_PROTOCOL.
        Returns:
        a new instance of a SOAPFactory
        Throws:
        javax.xml.soap.SOAPException - if there was an error creating the specified SOAPFactory
        See Also:
        SAAJMetaFactory

      • create

        public static Message create​(javax.xml.soap.SOAPMessage saaj)
        Creates Message from SOAPMessage
        Parameters:
        saaj - SOAPMessage
        Returns:
        created Message

      • createMessageFactory

        public javax.xml.soap.MessageFactory createMessageFactory​(String protocol)
                                                   throws javax.xml.soap.SOAPException
        Creates a new MessageFactory object that is an instance of the specified implementation. May be a dynamic message factory, a SOAP 1.1 message factory, or a SOAP 1.2 message factory. A dynamic message factory creates messages based on the MIME headers specified as arguments to the createMessage method. This method uses the SAAJMetaFactory to locate the implementation class and create the MessageFactory instance.
        Parameters:
        protocol - a string constant representing the class of the specified message factory implementation. May be either DYNAMIC_SOAP_PROTOCOL, DEFAULT_SOAP_PROTOCOL (which is the same as) SOAP_1_1_PROTOCOL, or SOAP_1_2_PROTOCOL.
        Returns:
        a new instance of a MessageFactory
        Throws:
        javax.xml.soap.SOAPException - if there was an error in creating the specified implementation of MessageFactory.
        See Also:
        SAAJMetaFactory

      • createSOAPFactory

        public javax.xml.soap.SOAPFactory createSOAPFactory​(String protocol)
                                             throws javax.xml.soap.SOAPException
        Creates a new SOAPFactory object that is an instance of the specified implementation, this method uses the SAAJMetaFactory to locate the implementation class and create the SOAPFactory instance.
        Parameters:
        protocol - a string constant representing the protocol of the specified SOAP factory implementation. May be either DYNAMIC_SOAP_PROTOCOL, DEFAULT_SOAP_PROTOCOL (which is the same as) SOAP_1_1_PROTOCOL, or SOAP_1_2_PROTOCOL.
        Returns:
        a new instance of a SOAPFactory
        Throws:
        javax.xml.soap.SOAPException - if there was an error creating the specified SOAPFactory
        See Also:
        SAAJMetaFactory

      • createMessage

        public Message createMessage​(javax.xml.soap.SOAPMessage saaj)
        Creates Message from SOAPMessage
        Parameters:
        saaj - SOAPMessage
        Returns:
        created Message

      • readAsSOAPMessage

        public javax.xml.soap.SOAPMessage readAsSOAPMessage​(SOAPVersion soapVersion,
                                                    Message message,
                                                    Packet packet)
                                             throws javax.xml.soap.SOAPException
        Reads Message as SOAPMessage. After this call message is consumed. The implementation in this class simply calls readAsSOAPMessage(SOAPVersion, Message), and ignores the other parameters Subclasses can override and choose to base SOAPMessage creation on Packet properties if needed
        Parameters:
        soapVersion - SOAP version
        message - Message
        Returns:
        Created SOAPMessage
        Throws:
        javax.xml.soap.SOAPException - if SAAJ processing fails