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

Class SAAJFactory

java.lang.Object
com.sun.xml.ws.api.message.saaj.SAAJFactory
public class SAAJFactory extends Object
Factory SPI for SAAJ implementations
Since:
2.2.6

  • Constructor Details

    • SAAJFactory

      public SAAJFactory()
      Default constructor.

  • Method Details

    • getMessageFactory

      public static MessageFactory getMessageFactory(String protocol) throws 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:
      SOAPException - if there was an error in creating the specified implementation of MessageFactory.
      See Also:

    • getSOAPFactory

      public static SOAPFactory getSOAPFactory(String protocol) throws 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:
      SOAPException - if there was an error creating the specified SOAPFactory
      See Also:

    • create

      public static Message create(SOAPMessage saaj)
      Creates Message from SOAPMessage
      Parameters:
      saaj - SOAPMessage
      Returns:
      created Message

    • read

      public static SOAPMessage read(SOAPVersion soapVersion, Message message) throws SOAPException
      Reads Message as SOAPMessage. After this call message is consumed.
      Parameters:
      soapVersion - SOAP version
      message - Message
      Returns:
      Created SOAPMessage
      Throws:
      SOAPException - if SAAJ processing fails

    • read

      public static SOAPMessage read(SOAPVersion soapVersion, Message message, Packet packet) throws SOAPException
      Reads Message as SOAPMessage. After this call message is consumed.
      Parameters:
      soapVersion - SOAP version
      message - Message
      packet - The packet that owns the Message
      Returns:
      Created SOAPMessage
      Throws:
      SOAPException - if SAAJ processing fails

    • read

      public static SAAJMessage read(Packet packet) throws SOAPException
      Reads the message within the Packet to a SAAJMessage. After this call message is consumed.
      Parameters:
      packet - Packet
      Returns:
      Created SAAJPMessage
      Throws:
      SOAPException - if SAAJ processing fails

    • readAsSAAJ

      public SAAJMessage readAsSAAJ(Packet packet) throws SOAPException
      Reads the message within the Packet to a SAAJMessage. After this call message is consumed.
      Parameters:
      packet - Packet
      Returns:
      Created SAAJPMessage
      Throws:
      SOAPException - if SAAJ processing fails

    • createMessageFactory

      public MessageFactory createMessageFactory(String protocol) throws 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:
      SOAPException - if there was an error in creating the specified implementation of MessageFactory.
      See Also:

    • createSOAPFactory

      public SOAPFactory createSOAPFactory(String protocol) throws 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:
      SOAPException - if there was an error creating the specified SOAPFactory
      See Also:

    • createMessage

      public Message createMessage(SOAPMessage saaj)
      Creates Message from SOAPMessage
      Parameters:
      saaj - SOAPMessage
      Returns:
      created Message

    • readAsSOAPMessage

      public SOAPMessage readAsSOAPMessage(SOAPVersion soapVersion, Message message) throws SOAPException
      Reads Message as SOAPMessage. After this call message is consumed.
      Parameters:
      soapVersion - SOAP version
      message - Message
      Returns:
      Created SOAPMessage
      Throws:
      SOAPException - if SAAJ processing fails

    • readAsSOAPMessageSax2Dom

      public SOAPMessage readAsSOAPMessageSax2Dom(SOAPVersion soapVersion, Message message) throws SOAPException
      Throws:
      SOAPException

    • addAttachmentsToSOAPMessage

      protected static void addAttachmentsToSOAPMessage(SOAPMessage msg, Message message)

    • readAsSOAPMessage

      public SOAPMessage readAsSOAPMessage(SOAPVersion soapVersion, Message message, Packet packet) throws 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:
      SOAPException - if SAAJ processing fails