java.lang.Object javax.xml.bind.annotation.W3CDomHandler
public class W3CDomHandler
W3C DOM(org.w3c.dom
包)的 DomHandler
实现。
构造方法摘要 | |
---|---|
W3CDomHandler() 默认的构造方法。 |
|
W3CDomHandler(DocumentBuilder builder) 允许应用程序指定使用哪一个 DOM 实现的构造方法。 |
方法摘要 | |
---|---|
DOMResult |
createUnmarshaller(ValidationEventHandler errorHandler) 当 JAXB 提供者需要将文档的一部分解组为信息集表示形式时,首先要调用此方法创建一个 Result 对象。 |
DocumentBuilder |
getBuilder() |
Element |
getElement(DOMResult r) 将部分发送到 Result 后,JAXB 提供者将调用此方法来获取已解组元素表示形式。 |
Source |
marshal(Element element, ValidationEventHandler errorHandler) 在 JAXB 提供者需要将元素编组为 XML 时调用此方法。 |
void |
setBuilder(DocumentBuilder builder) |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
构造方法详细信息 |
---|
public W3CDomHandler()
public W3CDomHandler(DocumentBuilder builder)
builder
- 不得为 null。JAXB 使用此
DocumentBuilder
创建新的元素。
方法详细信息 |
---|
public DocumentBuilder getBuilder()
public void setBuilder(DocumentBuilder builder)
public DOMResult createUnmarshaller(ValidationEventHandler errorHandler)
DomHandler
复制的描述
Result
对象。
然后 JAXB 提供者将 XML 的一部分发送到给定的结果中。这一部分 XML 总是可以形成整个 XML 文档(该文档以某个元素为根)的子树。
DomHandler<Element,DOMResult>
中的
createUnmarshaller
errorHandler
- 如果在调用此方法和调用
DomHandler.getElement(Result)
之间发生任何错误,则必须向此处理程序报告。 调用者必须提供一个非 null 错误处理程序。 从此方法创建的
Result
对象可以保存对此错误处理程序的引用。
public Element getElement(DOMResult r)
DomHandler
复制的描述
Result
后,JAXB 提供者将调用此方法来获取已解组元素表示形式。
多次调用此方法可能返回不同的对象。在将整个子树填充到 Result
对象时,才可以调用此方法。
DomHandler<Element,DOMResult>
中的
getElement
r
- 由
DomHandler.createUnmarshaller(ValidationEventHandler)
创建的
Result
对象。
public Source marshal(Element element, ValidationEventHandler errorHandler)
DomHandler
复制的描述
如果为非 null,则返回的 Source
必须包含以一个元素为根的整个文档,该文档随后将被编制成一个将由 JAXB 提供者编组的更大文档。
DomHandler<Element,DOMResult>
中的
marshal
errorHandler
- 接收将元素转换成
Source
的过程中发生的任何错误。 调用者必须提供一个非 null 错误处理程序。