JavaTM 2 Platform
Standard Ed. 6

javax.xml.stream
類別 XMLEventFactory

java.lang.Object
  繼承者 javax.xml.stream.XMLEventFactory

public abstract class XMLEventFactory
extends Object

此介面定義一個創建 XMLEvent 實例的實用工具類別。

從以下版本開始:
1.6
另請參見:
StartElement, EndElement, ProcessingInstruction, Comment, Characters, StartDocument, EndDocument, DTD

建構子摘要
protected XMLEventFactory()
           
 
方法摘要
abstract  Attribute createAttribute(QName name, String value)
          創建一個新 Attribute。
abstract  Attribute createAttribute(String localName, String value)
          創建一個新 Attribute。
abstract  Attribute createAttribute(String prefix, String namespaceURI, String localName, String value)
          創建一個新 Attribute。
abstract  Characters createCData(String content)
          創建一個 CData 標記設置為 true 的 Character 事件。
abstract  Characters createCharacters(String content)
          創建一個 Character 事件,此方法不檢查內容是否全部為空白。
abstract  Comment createComment(String text)
          創建一個註釋。
abstract  DTD createDTD(String dtd)
          創建一個文檔型別定義事件。
abstract  EndDocument createEndDocument()
          創建一個 EndDocument 事件的新實例。
abstract  EndElement createEndElement(QName name, Iterator namespaces)
          創建一個新 EndElement。
abstract  EndElement createEndElement(String prefix, String namespaceUri, String localName)
          創建一個新 EndElement。
abstract  EndElement createEndElement(String prefix, String namespaceUri, String localName, Iterator namespaces)
          創建一個新 EndElement。
abstract  EntityReference createEntityReference(String name, EntityDeclaration declaration)
          創建一個 EntityReference 事件的新實例。
abstract  Characters createIgnorableSpace(String content)
          創建一個可忽略的空間。
abstract  Namespace createNamespace(String namespaceURI)
          創建一個新的預設 Namespace。
abstract  Namespace createNamespace(String prefix, String namespaceUri)
          創建一個新的 Namespace。
abstract  ProcessingInstruction createProcessingInstruction(String target, String data)
          創建一個處理指令。
abstract  Characters createSpace(String content)
          創建一個 isSpace 標記設置為 true 的 Character 事件。
abstract  StartDocument createStartDocument()
          創建一個 StartDocument 事件的新實例。
abstract  StartDocument createStartDocument(String encoding)
          創建一個 StartDocument 事件的新實例。
abstract  StartDocument createStartDocument(String encoding, String version)
          創建一個 StartDocument 事件的新實例。
abstract  StartDocument createStartDocument(String encoding, String version, boolean standalone)
          創建一個 StartDocument 事件的新實例。
abstract  StartElement createStartElement(QName name, Iterator attributes, Iterator namespaces)
          創建一個新 StartElement。
abstract  StartElement createStartElement(String prefix, String namespaceUri, String localName)
          創建一個新 StartElement。
abstract  StartElement createStartElement(String prefix, String namespaceUri, String localName, Iterator attributes, Iterator namespaces)
          創建一個新 StartElement。
abstract  StartElement createStartElement(String prefix, String namespaceUri, String localName, Iterator attributes, Iterator namespaces, NamespaceContext context)
          創建一個新 StartElement。
static XMLEventFactory newInstance()
          創建一個新的處理器實例。
static XMLEventFactory newInstance(String factoryId, ClassLoader classLoader)
          創建一個新的處理器實例。
abstract  void setLocation(Location location)
          此方法允許對此處理器創建的每個事件設置 Location。
 
從類別 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

建構子詳細資訊

XMLEventFactory

protected XMLEventFactory()
方法詳細資訊

newInstance

public static XMLEventFactory newInstance()
                                   throws FactoryConfigurationError
創建一個新的處理器實例。

拋出:
FactoryConfigurationError - 如果無法載入此處理器的實例

newInstance

public static XMLEventFactory newInstance(String factoryId,
                                          ClassLoader classLoader)
                                   throws FactoryConfigurationError
創建一個新的處理器實例。

參數:
factoryId - 要尋找的處理器的名稱,與屬性名稱相同
classLoader - 要使用的類別載入器
返回:
處理器實作
拋出:
FactoryConfigurationError - 如果此處理器的實例無法載入

setLocation

public abstract void setLocation(Location location)
此方法允許對此處理器創建的每個事件設置 Location。這些值被複製到此處理器創建的事件中。若要重置位置資訊,可將 location 設置為 null。

參數:
location - 要對每個創建的事件設置的位置

createAttribute

public abstract Attribute createAttribute(String prefix,
                                          String namespaceURI,
                                          String localName,
                                          String value)
創建一個新 Attribute。

參數:
prefix - 此屬性的前綴,不可以為 null
namespaceURI - 被設置為此值的屬性值,不可以為 null
localName - 屬性 XML 名稱的本地名稱,localName 不可以為 null
value - 要設置的屬性值,不可以為 null
返回:
帶有指定值的 Attribute

createAttribute

public abstract Attribute createAttribute(String localName,
                                          String value)
創建一個新 Attribute。

參數:
localName - 屬性 XML 名稱的本地名稱,localName 不可以為 null
value - 要設置的屬性值,不可以為 null
返回:
帶有指定值的 Attribute

createAttribute

public abstract Attribute createAttribute(QName name,
                                          String value)
創建一個新 Attribute。

參數:
name - 屬性的限定名,不可以為 null
value - 要設置的屬性值,不可以為 unll
返回:
帶有指定值的 Attribute

createNamespace

public abstract Namespace createNamespace(String namespaceURI)
創建一個新的預設 Namespace。

參數:
namespaceURI - 預設名稱空間 URI
返回:
帶有指定值的 Namespace

createNamespace

public abstract Namespace createNamespace(String prefix,
                                          String namespaceUri)
創建一個新的 Namespace。

參數:
prefix - 此名稱空間的前綴,不可以為 null
namespaceUri - 被設置為此值的屬性值,不可以為 null
返回:
帶有指定值的 Namespace

createStartElement

public abstract StartElement createStartElement(QName name,
                                                Iterator attributes,
                                                Iterator namespaces)
創建一個新 StartElement。通過傳入一個迭代 Namespace 介面集合的 Iterator,可以將名稱空間添加到此 StartElement。通過傳入一個迭代 Attribute 介面集合的 Iterator,可以將屬性添加到此 StartElement。

參數:
name - 屬性的限定名,不可以為 null
attributes - 要添加到新 StartElement 的可選無序物件集合,這些物件均實作 Attribute,該參數可以為 null
namespaces - 要添加到新 StartElement 的可選無序物件集合,這些物件均實作 Namespace,該參數可以為 null
返回:
請求的 StartElement 的實例

createStartElement

public abstract StartElement createStartElement(String prefix,
                                                String namespaceUri,
                                                String localName)
創建一個新 StartElement。此方法預設 NamespaceContext 為空 NamespaceContext。查詢此事件的名稱空間或屬性將導致返回空的迭代器。

參數:
namespaceUri - 新 StartElement QName 的 URI
localName - 新 StartElement QName 的本地名稱
prefix - 新 StartElement QName 的前綴
返回:
請求的 StartElement 的實例

createStartElement

public abstract StartElement createStartElement(String prefix,
                                                String namespaceUri,
                                                String localName,
                                                Iterator attributes,
                                                Iterator namespaces)
創建一個新 StartElement。通過傳入一個迭代 Namespace 介面集合的 Iterator,可以將名稱空間添加到此 StartElement。通過傳入一個迭代 Attribute 介面集合的 Iterator,可以將屬性添加到此 StartElement。

參數:
namespaceUri - 新 StartElement QName 的 URI
localName - 新 StartElement QName 的本地名稱
prefix - 新 StartElement QName 的前綴
attributes - 要添加到新 StartElement 的無序物件集合,這些物件均實作 Attribute
namespaces - 要添加到新 StartElement 的無序物件集合,這些物件均實作 Namespace
返回:
請求的 StartElement 的實例

createStartElement

public abstract StartElement createStartElement(String prefix,
                                                String namespaceUri,
                                                String localName,
                                                Iterator attributes,
                                                Iterator namespaces,
                                                NamespaceContext context)
創建一個新 StartElement。通過傳入一個迭代 Namespace 介面集合的 Iterator,可以將名稱空間添加到此 StartElement。通過傳入一個迭代 Attribute 介面集合的 Iterator,可以將屬性添加到此 StartElement。

參數:
namespaceUri - 新 StartElement QName 的 URI
localName - 新 StartElement QName 的本地名稱
prefix - 新 StartElemente QName 的前綴
attributes - 要添加到新 StartElement 的無序物件集合,這些物件均實作 Attribute,可以為 null
namespaces - 要添加到新 StartElement 的無序物件集合,這些物件均實作 Namespace,可以為 null
context - 此元素的名稱空間上下文
返回:
請求的 StartElement 的實例

createEndElement

public abstract EndElement createEndElement(QName name,
                                            Iterator namespaces)
創建一個新 EndElement。

參數:
name - EndElement 的限定名
namespaces - 超出範圍的無序物件集合,這些物件均實作 Namespace,該參數可以為 null
返回:
請求的 EndElement 的實例

createEndElement

public abstract EndElement createEndElement(String prefix,
                                            String namespaceUri,
                                            String localName)
創建一個新 EndElement。

參數:
namespaceUri - 新 StartElement QName 的 URI
localName - 新 StartElement QName 的本地名稱
prefix - 新 StartElement QName 的前綴
返回:
請求的 EndElement 的實例

createEndElement

public abstract EndElement createEndElement(String prefix,
                                            String namespaceUri,
                                            String localName,
                                            Iterator namespaces)
創建一個新 EndElement。

參數:
namespaceUri - 新 StartElement QName 的 URI
localName - 新 StartElement QName 的本地名稱
prefix - 新 StartElement QName 的前綴
namespaces - 超出範圍的無序物件集合,這些物件均實作 Namespace,該參數可以為 null
返回:
請求的 EndElement 的實例

createCharacters

public abstract Characters createCharacters(String content)
創建一個 Character 事件,此方法不檢查內容是否全部為空白。使用 #createSpace(String) 創建一個空間事件。

參數:
content - 要創建的字元串
返回:
一個 Character 事件

createCData

public abstract Characters createCData(String content)
創建一個 CData 標記設置為 true 的 Character 事件。

參數:
content - 要創建的字元串
返回:
一個 Character 事件

createSpace

public abstract Characters createSpace(String content)
創建一個 isSpace 標記設置為 true 的 Character 事件。

參數:
content - 要創建的空間的內容
返回:
一個 Character 事件

createIgnorableSpace

public abstract Characters createIgnorableSpace(String content)
創建一個可忽略的空間。

參數:
content - 要創建的空間
返回:
一個 Character 事件

createStartDocument

public abstract StartDocument createStartDocument()
創建一個 StartDocument 事件的新實例。

返回:
一個 StartDocument 事件

createStartDocument

public abstract StartDocument createStartDocument(String encoding,
                                                  String version,
                                                  boolean standalone)
創建一個 StartDocument 事件的新實例。

參數:
encoding - 編碼樣式
version - XML 的版本
standalone - 獨立的狀態,可以設置為 "true" 或 "false"
返回:
一個 StartDocument 事件

createStartDocument

public abstract StartDocument createStartDocument(String encoding,
                                                  String version)
創建一個 StartDocument 事件的新實例。

參數:
encoding - 編碼樣式
XML - 的版本
返回:
一個 StartDocument 事件

createStartDocument

public abstract StartDocument createStartDocument(String encoding)
創建一個 StartDocument 事件的新實例。

參數:
encoding - 編碼樣式
返回:
一個 StartDocument 事件

createEndDocument

public abstract EndDocument createEndDocument()
創建一個 EndDocument 事件的新實例。

返回:
一個 EndDocument 事件

createEntityReference

public abstract EntityReference createEntityReference(String name,
                                                      EntityDeclaration declaration)
創建一個 EntityReference 事件的新實例。

參數:
name - 參考的名稱
declaration - 事件的宣告
返回:
一個 EntityReference 事件

createComment

public abstract Comment createComment(String text)
創建一個註釋。

參數:
text - Comment 事件的註釋文本

createProcessingInstruction

public abstract ProcessingInstruction createProcessingInstruction(String target,
                                                                  String data)
創建一個處理指令。

參數:
target - 處理指令的目標
data - 處理指令的文本
返回:
一個 ProcessingInstruction 事件

createDTD

public abstract DTD createDTD(String dtd)
創建一個文檔型別定義事件。此字元串包含與 XML 1.0 規範中的 doctypedecl 相比對的整個文檔型別宣告。

參數:
dtd - 文檔型別定義的文本
返回:
一個 DTD 事件

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

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