构造方法详细信息

• MessageFactory

  public MessageFactory()

方法详细信息

• newInstance

  public static MessageFactory newInstance()
                                    throws SOAPException

  创建一个新的MessageFactory对象，该对象是默认实现（SOAP 1.1）的实例。此方法使用以下有序查找过程来确定要加载的MessageFactory实现类：

  • 使用javax.xml.soap.MessageFactory系统属性。
  • 使用JRE目录中的属性文件“lib / jaxm.properties”。 此配置文件采用标准的java.util.Properties格式，并包含实现类的完全限定名称，其中键为上面定义的系统属性。
  • 使用服务API（如JAR规范中所述）（如果可用）确定类名。 Services API将在运行时可用的jar中的文件META-INF / services / javax.xml.soap.MessageFactory中查找一个类名。
  • 使用SAAJMetaFactory实例来定位MessageFactory实现类。

  结果

  一个新的一个 MessageFactory实例

  异常

  SOAPException - 如果创建MessageFactory的默认实现时 MessageFactory 。

  另请参见：

  SAAJMetaFactory

• newInstance

  public static MessageFactory newInstance(String protocol)
                                    throws SOAPException

  创建一个新的MessageFactory对象，该对象是指定实现的实例。 可能是一个动态消息工厂，一个SOAP 1.1消息工厂或一个SOAP 1.2消息工厂。 动态消息工厂基于指定为createMessage方法的createMessage的MIME标头创建消息。 此方法使用SAAJMetaFactory来定位实现类并创建MessageFactory实例。

  参数

  protocol - 表示指定消息工厂实现类的字符串常量。 可以是DYNAMIC_SOAP_PROTOCOL ， DEFAULT_SOAP_PROTOCOL （其是相同的） SOAP_1_1_PROTOCOL ，或SOAP_1_2_PROTOCOL 。

  结果

  一个新的一个 MessageFactory

  异常

  SOAPException -如果在创建指定执行的错误 MessageFactory 。

  从以下版本开始：

  SAAJ 1.3

  另请参见：

  SAAJMetaFactory

• createMessage

  public abstract SOAPMessage createMessage()
                                     throws SOAPException

  创建一个新SOAPMessage与默认对象SOAPPart ， SOAPEnvelope ， SOAPBody和SOAPHeader对象。 个人资料信息工厂可以选择预先SOAPMessage对象的个人资料头文件。

  可以将内容添加到此消息的SOAPPart对象中，并且当仅包含SOAP部分的消息就足够时，消息可以“按原样”发送。 否则， SOAPMessage对象需要创建一个或多个AttachmentPart对象并将其添加到其自身。 任何不是XML格式的内容必须在AttachmentPart对象中。

  结果

  一个新的 SOAPMessage对象

  异常

  SOAPException - 如果发生SOAP错误

  UnsupportedOperationException - 如果这个 MessageFactory实例的协议是 DYNAMIC_SOAP_PROTOCOL

• createMessage

  public abstract SOAPMessage createMessage(MimeHeaders headers,
                                            InputStream in)
                                     throws IOException,
                                            SOAPException

  将给定的 InputStream对象的内容内化为一个新的 SOAPMessage对象，并返回 SOAPMessage对象。

  参数

  in - 包含消息数据的 InputStream对象

  headers - 以传输独立方式传送给消息的传输特定头文件用于创建消息

  结果

  一个新的 SOAPMessage对象包含来自给定的 InputStream对象的数据

  异常

  IOException - 如果从输入流读取数据有问题

  SOAPException - 如果消息无效，可能会抛出

  IllegalArgumentException - 如果MessageFactory需要一个或多个MIME标头存在于headers参数中，并且它们丢失。 MessageFactory实现为SOAP_1_1_PROTOCOL或SOAP_1_2_PROTOCOL不得抛出IllegalArgumentException这个原因。