javax.xml.stream.util
介面 XMLEventAllocator

public interface XMLEventAllocator

此介面定義了一個類別，該類別允許使用者註冊給定 XMLStreamReader 的情況下分派事件的方式。實作不需要使用 XMLEventFactory 實作，但推薦這樣做。可以使用屬性 "javax.xml.stream.allocator" 在 XMLInputFactory 上設置 XMLEventAllocator。

從以下版本開始：

1.6

另請參見：

XMLInputFactory, XMLEventFactory

方法摘要

XMLEvent	allocate(XMLStreamReader reader) 此方法在給定 XMLStreamReader 當前狀態的情況下分派事件。
void	allocate(XMLStreamReader reader, XMLEventConsumer consumer) 此方法在給定 XMLStreamReader 當前狀態的情況下分派一個事件或一個事件組，並將該事件或事件組添加給傳入的使用者。
XMLEventAllocator	newInstance() 此方法創建一個 XMLEventAllocator 實例。

方法詳細資訊

newInstance

XMLEventAllocator newInstance()

此方法創建一個 XMLEventAllocator 實例。它允許 XMLInputFactory 為每個 reader 分派一個新實例。

allocate

XMLEvent allocate(XMLStreamReader reader)
                  throws XMLStreamException

此方法在給定 XMLStreamReader 當前狀態的情況下分派事件。如果此 XMLEventAllocator 在 reader 狀態和事件之間不存在一對一的映射關係，則此方法將返回 null。此方法不能修改 XMLStreamReader 的狀態。

參數：

reader - 作為分派根據的 XMLStreamReader

返回：

對應於當前 reader 狀態的事件

拋出：

XMLStreamException

allocate

void allocate(XMLStreamReader reader,
              XMLEventConsumer consumer)
              throws XMLStreamException

此方法在給定 XMLStreamReader 當前狀態的情況下分派一個事件或一個事件組，並將該事件或事件組添加給傳入的使用者。此方法可將 reader 狀態展開或聯繫到事件狀態中。此方法可修改 XMLStreamReader 的狀態。

參數：

reader - 作為分派根據的 XMLStreamReader

consumer - 要添加事件的 XMLEventConsumer。

拋出：

XMLStreamException