com.sun.xml.ws.api.message.saaj
Class SAAJFactory

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

public class SAAJFactory
extends Object

Factory SPI for SAAJ implementations

Since:
2.2.6

Constructor Summary
SAAJFactory()
           
 
Method Summary
protected static void addAttachmentsToSOAPMessage(SOAPMessage msg, Message message)
           
static Message create(SOAPMessage saaj)
          Creates Message from SOAPMessage
 Message createMessage(SOAPMessage saaj)
          Creates Message from SOAPMessage
 MessageFactory createMessageFactory(String protocol)
          Creates a new MessageFactory object that is an instance of the specified implementation.
 SOAPFactory createSOAPFactory(String protocol)
          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.
static MessageFactory getMessageFactory(String protocol)
          Creates a new MessageFactory object that is an instance of the specified implementation.
static SOAPFactory getSOAPFactory(String protocol)
          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.
static SAAJMessage read(Packet packet)
          Reads the message within the Packet to a SAAJMessage.
static SOAPMessage read(SOAPVersion soapVersion, Message message)
          Reads Message as SOAPMessage.
static SOAPMessage read(SOAPVersion soapVersion, Message message, Packet packet)
          Reads Message as SOAPMessage.
 SAAJMessage readAsSAAJ(Packet packet)
          Reads the message within the Packet to a SAAJMessage.
 SOAPMessage readAsSOAPMessage(SOAPVersion soapVersion, Message message)
          Reads Message as SOAPMessage.
 SOAPMessage readAsSOAPMessage(SOAPVersion soapVersion, Message message, Packet packet)
          Reads Message as SOAPMessage.
 SOAPMessage readAsSOAPMessageSax2Dom(SOAPVersion soapVersion, Message message)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SAAJFactory

public SAAJFactory()
Method Detail

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:
SAAJMetaFactory

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:
SAAJMetaFactory

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:
SAAJMetaFactory

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:
SAAJMetaFactory

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


Copyright © 2005-2015 Oracle Corporation. All Rights Reserved.