概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法

javax.xml.soap
類別 SOAPFactory

java.lang.Object
  繼承者 javax.xml.soap.SOAPFactory

public abstract class SOAPFactory
extends Object

SOAPFactory 是用來創建存在於 SOAP XML 階層樹中的各種物件的處理器。SOAPFactory 可以用於創建最終成為 SOAP 部分的 XML 片段。這些片段可以作為 SOAPHeaderElement、SOAPBodyElement、SOAPEnvelope 或其他 SOAPElement 物件的子級插入。SOAPFactory 還具有創建 javax.xml.soap.Detail 物件以及 java.xml.soap.Name 物件的方法。

建構子摘要
SOAPFactory()
           
 
方法摘要
abstract  Detail createDetail()
          創建充當 DetailEntry 物件容器的新 Detail 物件。
 SOAPElement createElement(Element domElement)
          根據現有的 DOM Element 創建 SOAPElement 物件。
abstract  SOAPElement createElement(Name name)
          創建使用給定 Name 物件初始化的 SOAPElement 物件。
 SOAPElement createElement(QName qname)
          創建使用給定 QName 物件初始化的 SOAPElement 物件。
abstract  SOAPElement createElement(String localName)
          創建使用給定本地名稱初始化的 SOAPElement 物件。
abstract  SOAPElement createElement(String localName, String prefix, String uri)
          使用本地名稱、前綴和 URI 創建新的 SOAPElement 物件。
abstract  SOAPFault createFault()
          創建一個新的預設 SOAPFault 物件
abstract  SOAPFault createFault(String reasonText, QName faultCode)
          創建使用給定 reasonText 和 faultCode 初始化的新 SOAPFault 物件
abstract  Name createName(String localName)
          創建使用給定本地名稱初始化的新 Name 物件。
abstract  Name createName(String localName, String prefix, String uri)
          創建使用給定本地名稱、名稱空間前綴和名稱空間 URI 初始化的新 Name 物件。
static SOAPFactory newInstance()
          創建新的 SOAPFactory 物件，該物件是預設實作 (SOAP 1.1) 的實例。
static SOAPFactory newInstance(String protocol)
          創建新的 SOAPFactory 物件，該物件是指定實作的實例，此方法使用 SAAJMetaFactory 來定位實作類別並創建 SOAPFactory 實例。
 
從類別 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

建構子詳細資訊

SOAPFactory

public SOAPFactory()
方法詳細資訊

createElement

public SOAPElement createElement(Element domElement)
                          throws SOAPException
根據現有的 DOM Element 創建 SOAPElement 物件。如果作為參數傳入的 DOM Element 已經是一個 SOAPElement，那麼此方法必須不作任何修改地返回該參數。否則，會創建新的 SOAPElement 並進行此 domElement 參數的深層複製。返回值的具體型別將取決於 domElement 參數的名稱。如果以 domElement 為根的階層樹的任何部分違背了 SOAP 規則，則會拋出 SOAPException。

參數：
domElement - 要複製的 Element。
返回：
一個新的 SOAPElement，它是 domElement 的副本。
拋出：
SOAPException - 如果在創建 SOAPElement 物件時存在錯誤
從以下版本開始：
SAAJ 1.3

createElement

public abstract SOAPElement createElement(Name name)
                                   throws SOAPException
創建使用給定 Name 物件初始化的 SOAPElement 物件。返回值的具體型別將取決於提供給新 SOAPElement 的名稱。例如，一個帶有名稱 "{http://www.w3.org/2003/05/soap-envelope}Envelope" 的新 SOAPElement 會導致創建支持 SOAP 1.2 行為的 SOAPEnvelope。

參數：
name - 帶有新元素 XML 名稱的 Name 物件
返回：
創建的新 SOAPElement 物件
拋出：
SOAPException - 如果在創建 SOAPElement 物件時出現錯誤
另請參見：
createElement(javax.xml.namespace.QName)

createElement

public SOAPElement createElement(QName qname)
                          throws SOAPException
創建使用給定 QName 物件初始化的 SOAPElement 物件。返回值的具體型別將取決於提供給新 SOAPElement 的名稱。例如，一個帶有名稱 "{http://www.w3.org/2003/05/soap-envelope}Envelope" 的新 SOAPElement 會導致創建支持 SOAP 1.2 行為的 SOAPEnvelope。

參數：
qname - 帶有新元素 XML 名稱的 QName 物件
返回：
創建的新 SOAPElement 物件
拋出：
SOAPException - 如果在創建 SOAPElement 物件時出現錯誤
從以下版本開始：
SAAJ 1.3
另請參見：
createElement(Name)

createElement

public abstract SOAPElement createElement(String localName)
                                   throws SOAPException
創建使用給定本地名稱初始化的 SOAPElement 物件。

參數：
localName - 給出新元素本地名稱的 String
返回：
創建的新 SOAPElement 物件
拋出：
SOAPException - 如果在創建 SOAPElement 物件時存在錯誤

createElement

public abstract SOAPElement createElement(String localName,
                                          String prefix,
                                          String uri)
                                   throws SOAPException
使用本地名稱、前綴和 URI 創建新的 SOAPElement 物件。返回值的具體型別將取決於提供給新 SOAPElement 的名稱。例如，一個帶有名稱 "{http://www.w3.org/2003/05/soap-envelope}Envelope" 的新 SOAPElement 會導致創建支持 SOAP 1.2 行為的 SOAPEnvelope。

參數：
localName - 給出新元素本地名稱的 String
prefix - 此 SOAPElement 的前綴
uri - 給出新元素所屬名稱空間 URI 的 String
拋出：
SOAPException - 如果在創建 SOAPElement 物件時存在錯誤

createDetail

public abstract Detail createDetail()
                             throws SOAPException
創建充當 DetailEntry 物件容器的新 Detail 物件。

此處理器方法創建 Detail 物件，用於不可能使用 SOAPFault 抽象的情況。

返回：
一個 Detail 物件
拋出：
SOAPException - 如果存在 SOAP 錯誤
UnsupportedOperationException - 如果為 SOAPFactory 指定的協議是 DYNAMIC_SOAP_PROTOCOL

createFault

public abstract SOAPFault createFault(String reasonText,
                                      QName faultCode)
                               throws SOAPException
創建使用給定 reasonText 和 faultCode 初始化的新 SOAPFault 物件

參數：
reasonText - 錯誤的 ReasonText/FaultString
faultCode - 錯誤的 FaultCode
返回：
一個 SOAPFault 物件
拋出：
SOAPException - 如果存在 SOAP 錯誤
從以下版本開始：
SAAJ 1.3

createFault

public abstract SOAPFault createFault()
                               throws SOAPException
創建一個新的預設 SOAPFault 物件

返回：
一個 SOAPFault 物件
拋出：
SOAPException - 如果存在 SOAP 錯誤
從以下版本開始：
SAAJ 1.3

createName

public abstract Name createName(String localName,
                                String prefix,
                                String uri)
                         throws SOAPException
創建使用給定本地名稱、名稱空間前綴和名稱空間 URI 初始化的新 Name 物件。

此處理器方法創建 Name 物件，用於不可能使用 SOAPEnvelope 抽象的情況。

參數：
localName - 給出本地名稱的 String
prefix - 給出名稱空間前綴的 String
uri - 給出名稱空間 URI 的 String
返回：
使用給定本地名稱、名稱空間前綴和名稱空間 URI 初始化的 Name 物件
拋出：
SOAPException - 如果存在 SOAP 錯誤

createName

public abstract Name createName(String localName)
                         throws SOAPException
創建使用給定本地名稱初始化的新 Name 物件。

此處理器方法創建 Name 物件，用於不可能使用 SOAPEnvelope 抽象的情況。

參數：
localName - 給出本地名稱的 String
返回：
使用給定本地名稱初始化的 Name 物件
拋出：
SOAPException - 如果存在 SOAP 錯誤

newInstance

public static SOAPFactory newInstance()
                               throws SOAPException
創建新的 SOAPFactory 物件，該物件是預設實作 (SOAP 1.1) 的實例。 此方法使用以下尋找過程順序來確定要載入的 SOAPFactory 實作類別：

返回：
新的 SOAPFactory 實例
拋出：
SOAPException - 如果在創建預設 SOAPFactory 時出現錯誤
另請參見：
SAAJMetaFactory

newInstance

public static SOAPFactory newInstance(String protocol)
                               throws SOAPException
創建新的 SOAPFactory 物件，該物件是指定實作的實例，此方法使用 SAAJMetaFactory 來定位實作類別並創建 SOAPFactory 實例。

參數：
protocol - 字元串常數，表示指定 SOAP 處理器實作的協議。可以是 DYNAMIC_SOAP_PROTOCOL、DEFAULT_SOAP_PROTOCOL（等同於 SOAP_1_1_PROTOCOL）或 SOAP_1_2_PROTOCOL。
返回：
新的 SOAPFactory 實例
拋出：
SOAPException - 如果在創建指定 SOAPFactory 時出現錯誤
從以下版本開始：
SAAJ 1.3
另請參見：
SAAJMetaFactory
概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法
提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。