Binder (Java Platform SE 8 )

java.lang.Object
- javax.xml.bind.Binder<XmlNode>

```
public abstract class Binder<XmlNode>
extends Object
```
使XML Infoset节点之间的同步和JAXB代表同一个XML文档对象。
这个类的一个实例保持InfoSet保存视图的XML节点和XML文档的JAXB表示之间的关联。两视图之间导航的方法和getJAXBNode(Object)提供getXMLNode(Object)。

可以修改或信息集保存视图或文档的JAXB表示而其他视图保持不变。粘合剂能够同步改良观到其他视图中使用合适的粘结剂的更新方法的变化，updateXML(Object, Object)或updateJAXB(Object)。

一个典型的使用场景如下：
- 加载XML文档转换成XML Infoset表示
- unmarshal(Object) XML Infoset观JAXB观。（注意节约资源，只能分解子树XML信息集观JAXB的观点。）
- 应用程序访问和更新XML文档的API视图。
- updateXML(Object) JAXB视图同步回XML Infoset视图的修改。更新操作保留尽可能多的原始XML Infoset（即评论，PI，…）
粘合剂的实例是使用工厂方法创建JAXBContext.createBinder()或JAXBContext.createBinder(Class)。

模板参数，XmlNode，是XML信息集保存表示根接口/类。粘合剂的实现需要最小支持org.w3c.dom.Node.class一XmlNode价值。粘合剂实现可以支持替代XML Infoset保存表示。
从以下版本开始：

JAXB 2

构造方法摘要

构造方法

Constructor and Description

Binder()

构造方法
Constructor and Description
`Binder()`

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`abstract ValidationEventHandler`	`getEventHandler()` 如果一个没有被设置，返回当前事件处理程序或默认事件处理程序。
`abstract Object`	`getJAXBNode(XmlNode xmlNode)` 获取与给定的XML元素相关联的JAXB对象。
`abstract Object`	`getProperty(String name)` 在 `Binder`底层实现获得特定的属性。
`abstract Schema`	`getSchema()` 最后 `Schema`对象（包括零）的 `setSchema(Schema)`方法。
`abstract XmlNode`	`getXMLNode(Object jaxbObject)` 获取与给定的JAXB对象关联的XML元素。
`abstract void`	`marshal(Object jaxbObject, XmlNode xmlNode)` 元帅JAXB对象树的一个新的XML文档。
`abstract void`	`setEventHandler(ValidationEventHandler handler)` 允许应用程序登记一 `ValidationEventHandler`。
`abstract void`	`setProperty(String name, Object value)` 在 `Binder`底层实现设置特定的属性。
`abstract void`	`setSchema(Schema schema)` 指定是否元帅、分解和更新方法对XML内容的验证。
`abstract Object`	`unmarshal(XmlNode xmlNode)` 数据的XML Infoset以便JAXB对象树。
`abstract <T> JAXBElement<T>`	`unmarshal(XmlNode xmlNode, 类<T> declaredType)` 数据的XML根元素来提供 `declaredType` JAXB对象树。
`abstract Object`	`updateJAXB(XmlNode xmlNode)` 以一个XML节点和更新相关的JAXB对象及其后裔。
`abstract XmlNode`	`updateXML(Object jaxbObject)` 采用JAXB对象和更新相关的XML节点及其子孙。
`abstract XmlNode`	`updateXML(Object jaxbObject, XmlNode xmlNode)` 在JAXB对象树的变化是在其相关的XML解析树的更新。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Binder
```
public Binder()
```
- 方法详细信息
  - unmarshal
```
public abstract Object unmarshal(XmlNode xmlNode)
                          throws JAXBException
```
    数据的XML Infoset以便JAXB对象树。
    这种方法类似于Unmarshaller.unmarshal(Node)以维护XML节点和生产的JAXB对象之间的关联的加入，使未来的更新操作，updateXML(Object, Object)或updateJAXB(Object)。
    
    当getSchema()非空，xmlNode及其后代进行了验证该操作中。
    
    该方法将UnmarshalException当粘合剂的JAXBContext没有该XML元素的名称或类型的映射，可以通过@xsi:type，xmlNode JAXB映射的一类。方法unmarshal(Object, Class)使应用程序指定的JAXB映射类，xmlNode应映射到。
    
    参数
    
    xmlNode -文档/元来分解XML数据。
    
    结果
    
    新创建的JAXB对象树的根对象。
    
    异常
    
    JAXBException -如果任何意外的错误发生而解散
    
    UnmarshalException -如果 ValidationEventHandler返回false其 handleEvent法或 Binder无法执行XML java绑定。
    
    IllegalArgumentException如果节点参数为空
  - unmarshal
```
public abstract <T> JAXBElement<T> unmarshal(XmlNode xmlNode,
                                             类<T> declaredType)
                                      throws JAXBException
```
    数据的XML根元素来提供 declaredType JAXB对象树。
    实现了Unmarshal by Declared Type
    
    这种方法类似于Unmarshaller.unmarshal(Node, Class)以维护XML节点和生产的JAXB对象之间的关联的加入，使未来的更新操作，updateXML(Object, Object)或updateJAXB(Object)。
    
    当getSchema()非空，xmlNode及其后代进行了验证该操作中。
    
    参数
    
    xmlNode -文档/元来分解XML数据。
    
    declaredType JAXB映射类适合举行 node的XML数据。
    
    结果
    
    对 node JAXB Element表示
    
    异常
    
    JAXBException -如果任何意外的错误发生而解散
    
    UnmarshalException -如果 ValidationEventHandler返回false其 handleEvent法或 Binder无法执行XML java绑定。
    
    IllegalArgumentException -如果任何输入参数为空
    
    从以下版本开始：
    
    jaxb2.0
  - marshal
```
public abstract void marshal(Object jaxbObject,
                             XmlNode xmlNode)
                      throws JAXBException
```
    元帅JAXB对象树的一个新的XML文档。
    这种方法类似于Marshaller.marshal(Object, Node)以维护JAXB对象和产生的XML节点之间的关联，使未来的更新等操作updateXML(Object, Object)或updateJAXB(Object)。
    
    当getSchema()非空，验证在这个操作XML内容整理。
    
    参数
    
    jaxbObject -内容被整理。
    
    xmlNode的参数必须是一个节点，接受孩子。
    
    异常
    
    JAXBException -如果在编组发生任何意外的问题。
    
    MarshalException -如果 ValidationEventHandler返回false其 handleEvent法或 Binder无法 jaxbObject元帅（或任何物体可从 jaxbObject）。
    
    IllegalArgumentException -如果任何方法的参数是空的
  - getXMLNode
```
public abstract XmlNode getXMLNode(Object jaxbObject)
```
    获取与给定的JAXB对象关联的XML元素。
    一旦JAXB对象树是用一个XML片段有关，这种方法使在两棵树之间导航。
    
    一个XML元素和JAXB对象之间的关联是通过绑定方法和更新方法。注意，这个协会是部分；不是所有的XML元素有关联的JAXB对象，并不是所有的JAXB对象相关的XML元素。
    
    参数
    
    jaxbObject -实例，可从现有电话绑定或更新方法，返回一个JAXB对象树。
    
    结果
    
    如果指定的JAXB对象不知道这 Binder null，或者如果它是不是一个XML元素相关。
    
    异常
    
    IllegalArgumentException -如果jaxbobject参数为空
  - getJAXBNode
```
public abstract Object getJAXBNode(XmlNode xmlNode)
```
    获取与给定的XML元素相关联的JAXB对象。
    一旦JAXB对象树是用一个XML片段有关，这种方法使在两棵树之间导航。
    
    一个XML元素和JAXB对象之间的关联是通过数据的建立及更新方法，元帅。注意，这个协会是部分；不是所有的XML元素有关联的JAXB对象，并不是所有的JAXB对象相关的XML元素。
    
    结果
    
    如果指定的XML节点是不知道这 Binder null，或者如果它不与JAXB对象关联。
    
    异常
    
    IllegalArgumentException如果节点参数为空
  - updateXML
```
public abstract XmlNode updateXML(Object jaxbObject)
                           throws JAXBException
```
    采用JAXB对象和更新相关的XML节点及其子孙。
    这是一种方便的方法：
```
updatexml（jaxbobject，getxmlnode（jaxbobject））；
```
    异常
    
    JAXBException -如果任何意想不到的问题发生相应的XML内容更新。
    
    IllegalArgumentException -如果jaxbobject参数为空
  - updateXML
```
public abstract XmlNode updateXML(Object jaxbObject,
                                  XmlNode xmlNode)
                           throws JAXBException
```
    在JAXB对象树的变化是在其相关的XML解析树的更新。
    这种操作可以被认为是一个“到位”的编组。不同的是，这个操作不是创建一个新的XML树，而是在试图尽可能多地保存XML时更新一个现有的树，而不是一个新的XML树。
    
    例如，未知的元素/属性的XML没有必然的JAXB将原封不动（而编组操作将创建一个新的树，不包含任何人。）
    
    作为一个副作用，这个操作更新XML节点和JAXB对象之间的关联。
    
    参数
    
    jaxbObject根可能修改JAXB对象树
    
    xmlNode -更新对象的XML解析树的根
    
    结果
    
    返回更新的XML节点。通常，这是相同的节点就到了XmlNode，但也许一个不同的对象，例如当对象的标签名称已更改。
    
    异常
    
    JAXBException -如果任何意想不到的问题发生相应的XML内容更新。
    
    IllegalArgumentException -如果任何输入参数为空
  - updateJAXB
```
public abstract Object updateJAXB(XmlNode xmlNode)
                           throws JAXBException
```
    以一个XML节点和更新相关的JAXB对象及其后裔。
    此操作可以被认为是一个“到位”组。不同的是，而不是创建一个全新的JAXB树，此操作更新现有的树，利用尽可能多的JAXB对象。
    
    作为一个副作用，这个操作更新XML节点和JAXB对象之间的关联。
    
    结果
    
    返回更新JAXB对象。通常，这是同一个对象，从早期的 marshal(Object,Object)或 updateJAXB(Object)方法调用返回，但它可能是一个不同的对象，例如当XML元素的名称发生了变化。
    
    异常
    
    JAXBException -如果任何意想不到的问题发生的JAXB映射对应的更新内容。
    
    IllegalArgumentException如果节点参数为空
  - setSchema
```
public abstract void setSchema(Schema schema)
```
    指定是否元帅、分解和更新方法对XML内容的验证。
    
    参数
    
    schema -设置为禁用验证。
    
    另请参见：
    
    Unmarshaller.setSchema(Schema)
  - getSchema
```
public abstract Schema getSchema()
```
    最后 Schema对象（包括零）的 setSchema(Schema)方法。
    
    结果
    
    如果不存在验证或空的架构对象
  - setEventHandler
```
public abstract void setEventHandler(ValidationEventHandler handler)
                              throws JAXBException
```
    允许应用程序登记一 ValidationEventHandler。
    的ValidationEventHandler将由JAXB提供者如果任何验证期间遇到错误调用任何粘合剂的分解，元帅和更新方法。
    
    调用此方法与一个空参数将导致粘合剂恢复到默认的默认事件处理程序。
    
    参数
    
    handler -验证事件处理程序
    
    异常
    
    JAXBException如果同时设置事件处理程序时出错
  - getEventHandler
```
public abstract ValidationEventHandler getEventHandler()
                                                throws JAXBException
```
    如果一个没有被设置，返回当前事件处理程序或默认事件处理程序。
    
    结果
    
    目前与ValidationEventHandler或默认的事件处理程序，如果它没有被设置
    
    异常
    
    JAXBException -如果在当前的事件处理程序时出错
  - setProperty
```
public abstract void setProperty(String name,
                                 Object value)
                          throws PropertyException
```
    在 Binder底层实现设置特定的属性。这个方法只能用于设置一个标准定义的编码解码/元帅JAXB属性或粘合剂供应商特定的属性，数据或元帅。试图设置一个未定义的属性将导致propertyexception抛出。看到 Supported Unmarshal Properties和 Supported Marshal Properties。
    
    参数
    
    name -属性的名称是。此值可以使用常量字段或用户提供的字符串中的一个指定。
    
    value -属性要设置的值
    
    异常
    
    PropertyException -当有特定的属性或值的误差处理
    
    IllegalArgumentException如果Name参数为空
  - getProperty
```
public abstract Object getProperty(String name)
                            throws PropertyException
```
    在 Binder底层实现获得特定的属性。这种方法只能得到一个标准的API定义数据/元帅性质或粘合剂供应商特定的属性，数据或元帅。试图获得一个未定义的属性将导致propertyexception抛出。看到 Supported Unmarshal Properties和 Supported Marshal Properties。
    
    参数
    
    name -属性的名称检索
    
    结果
    
    请求属性的值
    
    异常
    
    PropertyException -当有检索给定属性或值的属性名称错误
    
    IllegalArgumentException如果Name参数为空

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class Binder<XmlNode>

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

Binder

方法详细信息

unmarshal

unmarshal

marshal

getXMLNode

getJAXBNode

updateXML

updateXML

updateJAXB

setSchema

getSchema

setEventHandler

getEventHandler

setProperty

getProperty