javax.xml.bind

Class JAXB

java.lang.Object

javax.xml.bind.JAXB

public final class JAXB
extends Object

类定义的方便方法，使用简单的API。

在该类中定义的方法是方便的方法，把几个基本的操作在JAXBContext，Unmarshaller，和Marshaller。他们的设计是首选的方法来开发新的JAXB。他们有以下特点：

1. 一般来说，性能不一定是最优的。可以预期的是，谁需要写性能关键代码的人会使用JAXB API直接休息。
2. 这是发生在处理错误包装成DataBindingException（已JAXBException为cause。可以预期的是，人喜欢检查异常会使用JAXB API直接休息。

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

1. 在输入XML上没有进行模式验证。处理将继续尝试，即使在XML中有错误，尽可能多。只能作为最后的手段，这种方法失败，DataBindingException。

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

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

这个类的所有方法都需要所有参数的非空参数。的unmarshal方法或者不能有异常或返回一个非空值。

从以下版本开始：

二点一

方法摘要

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) 读取一个java对象树从给定的XML输入。
static <T> T	unmarshal(InputStream xml, 类<T> type) 读取一个java对象树从给定的XML输入。
static <T> T	unmarshal(Reader xml, 类<T> type) 读取一个java对象树从给定的XML输入。
static <T> T	unmarshal(Source xml, 类<T> type) 读取一个java对象树从给定的XML输入。
static <T> T	unmarshal(String xml, 类<T> type) 读取一个java对象树从给定的XML输入。
static <T> T	unmarshal(URI xml, 类<T> type) 读取一个java对象树从给定的XML输入。
static <T> T	unmarshal(URL xml, 类<T> type) 读取一个java对象树从给定的XML输入。

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)

读取一个java对象树从给定的XML输入。

参数

xml读取整个文件为XML。

unmarshal

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

读取一个java对象树从给定的XML输入。

参数

xml -资源指向的URL是通读全文。

unmarshal

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

读取一个java对象树从给定的XML输入。

参数

xml的URI是 turned into URL和随后的处理 URL。

unmarshal

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

读取一个java对象树从给定的XML输入。

参数

xml -字符串解释为一种绝对的 URI。如果不是 a valid absolute URI，然后解释为 File

unmarshal

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

读取一个java对象树从给定的XML输入。

参数

xml -整个流读取一个XML Infoset。在一个成功的完成后，该流将被关闭该方法。

unmarshal

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

读取一个java对象树从给定的XML输入。

参数

xml的字符流读取一个XML Infoset。在XML中的编码声明将被忽略。在一个成功的完成后，该流将被关闭该方法。

unmarshal

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

读取一个java对象树从给定的XML输入。

参数

xml - XML信息集， Source代表读。

marshal

public static void marshal(Object jaxbObject,
                           File xml)

写了一个java对象树的XML并将其存储到指定的位置。

参数

jaxbObject的java对象被打包成XML。如果这个对象是一个 JAXBElement，它将提供根标签名称和身体。如果这个对象的类定义 XmlRootElement，将被用作根标签名称和给定的对象将提供机构。否则，根标记的名字是 infered从 the short class name。此参数不能为空。

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

异常

DataBindingException -如果操作失败，如由于I/O错误，unbindable类。

marshal

public static void marshal(Object jaxbObject,
                           URL xml)

写了一个java对象树的XML并将其存储到指定的位置。

参数

jaxbObject的java对象被打包成XML。如果这个对象是一个 JAXBElement，它将提供根标签名称和身体。如果这个对象有 XmlRootElement在类的定义，将被用作根标签名称和给定的对象将提供机构。否则，根标记的名字是 infered从 the short class name。此参数不能为空。

xml - XML将 sent的资源指向的URL。注意：不是所有的 URLs支持这样的操作，和精确的语义取决于 URL实现。如果 HTTP URLs，这将执行HTTP POST。

异常

DataBindingException -如果操作失败，如由于I/O错误，unbindable类。

marshal

public static void marshal(Object jaxbObject,
                           URI xml)

写了一个java对象树的XML并将其存储到指定的位置。

参数

jaxbObject的java对象被打包成XML。如果这个对象是一个 JAXBElement，它将提供根标签名称和身体。如果这个对象有 XmlRootElement在类的定义，将被用作根标签名称和给定的对象将提供机构。否则，根标记的名字是 infered从 the short class name。此参数不能为空。

xml的URI是 turned into URL和随后的处理 URL。上面看到的。

异常

DataBindingException -如果操作失败，如由于I/O错误，unbindable类。

marshal

public static void marshal(Object jaxbObject,
                           String xml)

写了一个java对象树的XML并将其存储到指定的位置。

参数

jaxbObject的java对象被打包成XML。如果这个对象是一个 JAXBElement，它将提供根标签名称和身体。如果这个对象有 XmlRootElement在类的定义，将被用作根标签名称和给定的对象将提供机构。否则，根标记的名字是 infered从 the short class name。此参数不能为空。

xml -字符串解释为一种绝对的 URI。如果不是 a valid absolute URI，然后解释为 File

异常

DataBindingException -如果操作失败，如由于I/O错误，unbindable类。

marshal

public static void marshal(Object jaxbObject,
                           OutputStream xml)

写了一个java对象树的XML并将其存储到指定的位置。

参数

jaxbObject的java对象被打包成XML。如果这个对象是一个 JAXBElement，它将提供根标签名称和身体。如果这个对象有 XmlRootElement在类的定义，将被用作根标签名称和给定的对象将提供机构。否则，根标记的名字是 infered从 the short class name。此参数不能为空。

xml - XML将被送到了 OutputStream。在一个成功的完成后，该流将被关闭该方法。

异常

DataBindingException -如果操作失败，如由于I/O错误，unbindable类。

marshal

public static void marshal(Object jaxbObject,
                           Writer xml)

写了一个java对象树的XML并将其存储到指定的位置。

参数

jaxbObject的java对象被打包成XML。如果这个对象是一个 JAXBElement，它将提供根标签名称和身体。如果这个对象有 XmlRootElement在类的定义，将被用作根标签名称和给定的对象将提供机构。否则，根标记的名字是 infered从 the short class name。此参数不能为空。

xml - XML将作为字符流到了 Writer发送。一旦成功完成，流将通过这种方法封闭。

异常

DataBindingException -如果操作失败，如由于I/O错误，unbindable类。

marshal

public static void marshal(Object jaxbObject,
                           Result xml)

写了一个java对象树的XML并将其存储到指定的位置。

参数

jaxbObject的java对象被打包成XML。如果这个对象是一个 JAXBElement，它将提供根标签名称和身体。如果这个对象的类定义 XmlRootElement，将被用作根标签名称和给定的对象将提供机构。否则，根标记的名字是 infered从 the short class name。此参数不能为空。

xml - XML将被发送到 Result对象。

异常

DataBindingException -如果操作失败，如由于I/O错误，unbindable类。