javax.xml.soap

Class MessageFactory

java.lang.Object

javax.xml.soap.MessageFactory

public abstract class MessageFactory
extends Object

一个用于创建对象的工厂 SOAPMessage。

一种用于客户端可以使用的方法newInstance创建一个MessageFactory对象，如下面的代码所示。

messagefactory MF = messagefactory。newinstance()；messagefactory mf12 = messagefactory。newInstance（soapconstants。soap_1_2_protocol）；

所有的MessageFactory物体，不论它们是如何产生的，会产生有以下元素默认情况下，SOAPMessage对象：

• 一个SOAPPart对象
• 一个SOAPEnvelope对象
• 一个SOAPBody对象
• 一个SOAPHeader对象

在某些情况下，专业messagefactory对象可以获得生产信息预先设置在 SOAPHeader对象附加条目和 SOAPBody对象。一个新的 SOAPMessage对象的内容取决于这两种 MessageFactory方法用于创建它。

• createMessage()
  这是客户端的方法通常用来创建一个请求消息。
• createMessage(MimeHeaders, java.io.InputStream) --信息内容从InputStream对象和标题从MimeHeaders对象
  此方法可用于内部的服务实现创建一个消息，这是一个请求的响应。

构造方法摘要

构造方法

Constructor and Description
MessageFactory()

方法摘要

Modifier and Type	Method and Description
abstract SOAPMessage	createMessage() 创建一个新的默认 SOAPPart， SOAPMessage对象 SOAPEnvelope， SOAPBody，和 SOAPHeader对象。
abstract SOAPMessage	createMessage(MimeHeaders headers, InputStream in) 内化的 InputStream对象到一个新的 SOAPMessage对象的内容并返回 SOAPMessage对象。
static MessageFactory	newInstance() 创建一个新的 MessageFactory对象是默认实现的实例（肥皂1.1），这种方法使用以下命令查找程序来确定messagefactory实现类负荷：用javax.xml.soap.messagefactory系统性能。
static MessageFactory	newInstance(String protocol) 创建一个新的 MessageFactory对象是指定实现的一个实例。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MessageFactory

public MessageFactory()

方法详细信息

newInstance

public static MessageFactory newInstance()
                                  throws SOAPException

创建一个新的 MessageFactory对象是默认实现的实例（肥皂1.1），这种方法使用以下命令查找程序来确定messagefactory实现类负荷：

• 使用javax.xml.soap.messagefactory系统性能。
• 使用属性文件的“库/ JAXM。属性”在JRE目录。这个配置文件是java.util.properties格式标准，包含实现类的完全限定名的关键是上面定义的系统性能。
• 使用服务的API（如罐中详细说明），如果有，确定类名。服务API将在文件META-INF /服务/ javax.xml.soap.messagefactory提供运行时罐类名。
• 使用saajmetafactory实例定位messagefactory实现类。

结果

一个 MessageFactory新实例

异常

SOAPException -如果在创建的 MessageFactory默认的实现有一个错误。

另请参见：

SAAJMetaFactory

newInstance

public static MessageFactory newInstance(String protocol)
                                  throws SOAPException

创建一个新的 MessageFactory对象是指定实现的一个实例。可能是一个动态消息工厂，一个肥皂1.1消息工厂，或一个肥皂1.2消息工厂。动态消息工厂创建基于MIME标头指定为在 createMessage方法的参数信息。这种方法使用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

创建一个新的默认 SOAPPart， SOAPMessage对象 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 -运输特定的头文件传递到消息的创作在运输无关的消息

结果

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

异常

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

SOAPException可能如果消息无效投入

IllegalArgumentException -如果 MessageFactory需要一个或多个MIME标头在 headers参数是现在和他们失踪。 MessageFactory实现 SOAP_1_1_PROTOCOL或 SOAP_1_2_PROTOCOL不能把这个原因 IllegalArgumentException。