javax.xml.bind

Class JAXB

java.lang.Object

javax.xml.bind.JAXB

public final class JAXB
extends Object

定义方便方法的类用于常见，简单的使用JAXB。

在这一类中定义的方法是，在把几个基本操作方便的方法JAXBContext ， Unmarshaller和Marshaller 。 它们被设计为JAXB新开发者的首选方法。 它们具有以下特征：

1. 一般来说，性能并不一定是最佳的。 预计需要编写性能关键代码的人将直接使用其余的JAXB API。
2. 在处理过程中发生的错误包含在DataBindingException （其中JAXBException为cause） ，预计喜欢被检查异常的人将直接使用其余的JAXB API。

此外， unmarshal方法具有以下特点：

1. 不对输入XML执行模式验证。 即使XML中存在错误，处理也将尽可能的继续进行。 只有作为最后的手段，这种方法失败了DataBindingException 。

同样， marshal方法具有以下特点：

1. 即使Java对象树不符合有效性要求，处理也将继续进行。 只有作为最后的手段，这种方法失败了DataBindingException 。

该类上的所有方法都需要对所有参数的非空参数。 unmarshal方法会失败或异常返回非空值。

从以下版本开始：

2.1

方法摘要

Modifier and Type	Method and Description
static void	marshal(Object jaxbObject, File xml) 将Java对象树写入XML并将其存储到指定的位置。
static void	marshal(Object jaxbObject, OutputStream xml) 将Java对象树写入XML并将其存储到指定的位置。
static void	marshal(Object jaxbObject, Result xml) 将Java对象树写入XML并将其存储到指定的位置。
static void	marshal(Object jaxbObject, String xml) 将Java对象树写入XML并将其存储到指定的位置。
static void	marshal(Object jaxbObject, URI xml) 将Java对象树写入XML并将其存储到指定的位置。
static void	marshal(Object jaxbObject, URL xml) 将Java对象树写入XML并将其存储到指定的位置。
static void	marshal(Object jaxbObject, Writer xml) 将Java对象树写入XML并将其存储到指定的位置。
static <T> T	unmarshal(File xml, 类<T> type) 从给定的XML输入中读取Java对象树。
static <T> T	unmarshal(InputStream xml, 类<T> type) 从给定的XML输入中读取Java对象树。
static <T> T	unmarshal(Reader xml, 类<T> type) 从给定的XML输入中读取Java对象树。
static <T> T	unmarshal(Source xml, 类<T> type) 从给定的XML输入中读取Java对象树。
static <T> T	unmarshal(String xml, 类<T> type) 从给定的XML输入中读取Java对象树。
static <T> T	unmarshal(URI xml, 类<T> type) 从给定的XML输入中读取Java对象树。
static <T> T	unmarshal(URL xml, 类<T> type) 从给定的XML输入中读取Java对象树。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细信息

unmarshal

public static <T> T unmarshal(File xml,
                              类<T> type)

从给定的XML输入中读取Java对象树。

参数

xml - 将整个文件作为XML读取。

unmarshal

public static <T> T unmarshal(URL xml,
                              类<T> type)

从给定的XML输入中读取Java对象树。

参数

xml - URL所指向的资源全部被读取。

unmarshal

public static <T> T unmarshal(URI xml,
                              类<T> type)

从给定的XML输入中读取Java对象树。

参数

xml - 该URI为 turned into URL ，随后处理 URL 。

unmarshal

public static <T> T unmarshal(String xml,
                              类<T> type)

从给定的XML输入中读取Java对象树。

参数

xml - 该字符串首先解释为绝对值URI 。 如果不是a valid absolute URI ，那么它被解释为File

unmarshal

public static <T> T unmarshal(InputStream xml,
                              类<T> type)

从给定的XML输入中读取Java对象树。

参数

xml - 将整个流作为XML信息集读取。 成功完成后，该流将通过此方法关闭。

unmarshal

public static <T> T unmarshal(Reader xml,
                              类<T> type)

从给定的XML输入中读取Java对象树。

参数

xml - 字符流作为XML信息集读取。 XML中的编码声明将被忽略。 成功完成后，该流将通过此方法关闭。

unmarshal

public static <T> T unmarshal(Source xml,
                              类<T> type)

从给定的XML输入中读取Java对象树。

参数

xml -该XML信息Source代表被读取。

marshal

public static void marshal(Object jaxbObject,
                           File xml)

将Java对象树写入XML并将其存储到指定的位置。

参数

jaxbObject - 要编组为XML的Java对象。 如果这个对象是一个JAXBElement ，它将提供根标记名称和正文。 如果此对象在其类定义上具有XmlRootElement，则将用作根标记名称，给定对象将提供正文。 否则，根标记名称为infered，从the short class name 。 此参数不能为空。

xml - XML将被写入此文件。 如果它已经存在，它将被覆盖。

异常

DataBindingException - 如果操作失败，例如由于I / O错误，不可分类。

marshal

public static void marshal(Object jaxbObject,
                           URL xml)

将Java对象树写入XML并将其存储到指定的位置。

参数

jaxbObject - 要编组为XML的Java对象。 如果这个对象是一个JAXBElement ，它将提供根标记名称和正文。 如果此对象在其类定义上具有XmlRootElement，则将用作根标记名称，给定对象将提供正文。 否则，根标签名称为infered，从the short class name 。 此参数不能为空。

xml - 该URL指向的资源将为sent 。 请注意，并不是所有的URL都支持这样的操作，精确的语义取决于URL实现。 在HTTP URLs的情况下，这将执行HTTP POST。

异常

DataBindingException - 如果操作失败，例如由于I / O错误，不可分类。

marshal

public static void marshal(Object jaxbObject,
                           URI xml)

将Java对象树写入XML并将其存储到指定的位置。

参数

jaxbObject - 要编组为XML的Java对象。 如果这个对象是一个JAXBElement ，它将提供根标记名称和正文。 如果此对象在其类定义上具有XmlRootElement，则将用作根标记名称，给定对象将提供正文。 否则，根标记名称为infered，从the short class name 。 此参数不能为空。

xml - URI是turned into URL ，然后遵循URL的处理。 往上看。

异常

DataBindingException - 如果操作失败，例如由于I / O错误，不可分类。

marshal

public static void marshal(Object jaxbObject,
                           String xml)

将Java对象树写入XML并将其存储到指定的位置。

参数

jaxbObject - 要编组为XML的Java对象。 如果这个对象是一个JAXBElement ，它将提供根标签名称和正文。 如果此对象在其类定义上具有XmlRootElement，则将用作根标记名称，给定对象将提供正文。 否则，根标记名称为infered，来自the short class name 。 此参数不能为空。

xml - 该字符串首先解释为绝对值URI 。 如果不是a valid absolute URI ，那么它被解释为File

异常

DataBindingException - 如果操作失败，例如由于I / O错误，不可分类。

marshal

public static void marshal(Object jaxbObject,
                           OutputStream xml)

将Java对象树写入XML并将其存储到指定的位置。

参数

jaxbObject - 要编组为XML的Java对象。 如果这个对象是一个JAXBElement ，它将提供根标记名称和正文。 如果此对象在其类定义上具有XmlRootElement，则将用作根标记名称，给定对象将提供正文。 否则，根标记名称为infered，从the short class name 。 此参数不能为空。

xml - XML将发送给给定的OutputStream 。 成功完成后，该流将通过此方法关闭。

异常

DataBindingException - 如果操作失败，例如由于I / O错误，不可绑定的类。

marshal

public static void marshal(Object jaxbObject,
                           Writer xml)

将Java对象树写入XML并将其存储到指定的位置。

参数

jaxbObject - 要编组为XML的Java对象。 如果这个对象是一个JAXBElement ，它将提供根标记名称和正文。 如果此对象在其类定义上具有XmlRootElement，则将用作根标记名称，给定对象将提供正文。 否则，根标记名称为infered，从the short class name 。 此参数不能为空。

xml - XML将作为字符流发送给给定的Writer 。 成功完成后，该流将通过此方法关闭。

异常

DataBindingException - 如果操作失败，例如由于I / O错误，不可分类。

marshal

public static void marshal(Object jaxbObject,
                           Result xml)

将Java对象树写入XML并将其存储到指定的位置。

参数

jaxbObject - 要编组为XML的Java对象。 如果这个对象是一个JAXBElement ，它将提供根标记名称和正文。 如果此对象在其类定义上具有XmlRootElement，则将用作根标记名称，给定对象将提供正文。 否则，根标记名称为infered，从the short class name 。 此参数不能为空。

xml - XML将发送到Result对象。

异常

DataBindingException - 如果操作失败，例如由于I / O错误，不可分类。