JavaTM Platform
Standard Ed. 6

类 javax.xml.bind.JAXBException
的使用

使用 JAXBException 的软件包
javax.xml.bind 为包含解组、编组和验证功能的客户端应用程序提供运行时绑定框架。 
javax.xml.bind.helpers 仅由 JAXB 提供者用于: 提供某些 javax.xml.bind 接口的部分默认实现。 
javax.xml.bind.util 有用的客户端实用工具类。 
 

javax.xml.bindJAXBException 的使用
 

javax.xml.bindJAXBException 的子类
 class MarshalException
          此异常指示在执行提供者无法恢复的编组操作时发生错误。
 class PropertyException
          此异常指示在获取或设置属性时遇到一个错误。
 class UnmarshalException
          此异常指示在执行阻止 JAXB 提供者完成操作的解组操作时遇到一个错误。
 class ValidationException
          此异常指示在执行验证操作时发生错误。
 

抛出 JAXBExceptionjavax.xml.bind 中的方法
abstract  Marshaller JAXBContext.createMarshaller()
          创建一个可以用来将 java 内容树转换为 XML 数据的 Marshaller 对象。
abstract  Unmarshaller JAXBContext.createUnmarshaller()
          创建一个可以用来将 XML 数据转换为 java 内容树的 Unmarshaller 对象。
abstract  Validator JAXBContext.createValidator()
          已过时。 从 JAXB 2.0 开始
abstract  ValidationEventHandler Binder.getEventHandler()
          当前的事件处理程序;如果没有设置,则返回默认事件处理程序。
 ValidationEventHandler Marshaller.getEventHandler()
          返回当前的事件处理程序,如果没有设置该处理程序,则返回默认的事件处理程序。
 ValidationEventHandler Unmarshaller.getEventHandler()
          返回当前的事件处理程序,如果没有设置事件处理程序,则返回默认的事件处理程序。
 ValidationEventHandler Validator.getEventHandler()
          已过时。 从 JAXB2.0 开始
 Node Marshaller.getNode(Object contentTree)
          获取内容树的 DOM 树视图(可选)。
 Object UnmarshallerHandler.getResult()
          获得解组的结果。
 boolean Unmarshaller.isValidating()
          已过时。 从 JAXB 2.0 开始,请参阅 Unmarshaller.getSchema()
 void Marshaller.marshal(Object jaxbElement, ContentHandler handler)
          将以 jaxbElement 为根的内容树编组到 SAX2 事件中。
 void Marshaller.marshal(Object jaxbElement, Node node)
          将以 jaxbElement 为根的内容树编组到 DOM 树中。
 void Marshaller.marshal(Object jaxbElement, OutputStream os)
          将以 jaxbElement 为根的内容树编组到输出流中。
 void Marshaller.marshal(Object jaxbElement, Result result)
          将以 jaxbElement 为根的内容树编组到指定的 javax.xml.transform.Result 中。
 void Marshaller.marshal(Object jaxbElement, Writer writer)
          将以 jaxbElement 为根的内容树编组到 Writer 中。
 void Marshaller.marshal(Object jaxbElement, XMLEventWriter writer)
          将以 jaxbElement 为根的内容树编组到 XMLEventWriter 中。
abstract  void Binder.marshal(Object jaxbObject, XmlNode xmlNode)
          将 JAXB 对象树编组为新的 XML 文档。
 void Marshaller.marshal(Object jaxbElement, XMLStreamWriter writer)
          将以 jaxbElement 为根的内容树编组到 XMLStreamWriter 中。
static JAXBContext JAXBContext.newInstance(Class... classesToBeBound)
           获得 JAXBContext 类的新实例。
static JAXBContext JAXBContext.newInstance(Class[] classesToBeBound, Map<String,?> properties)
           获得 JAXBContext 类的新实例。
static JAXBContext JAXBContext.newInstance(String contextPath)
           获得 JAXBContext 类的新实例。
static JAXBContext JAXBContext.newInstance(String contextPath, ClassLoader classLoader)
           获得 JAXBContext 类的新实例。
static JAXBContext JAXBContext.newInstance(String contextPath, ClassLoader classLoader, Map<String,?> properties)
           获得 JAXBContext 类的新实例。
abstract  void Binder.setEventHandler(ValidationEventHandler handler)
          允许应用程序注册 ValidationEventHandler
 void Marshaller.setEventHandler(ValidationEventHandler handler)
          允许应用程序注册一个验证事件处理程序。
 void Unmarshaller.setEventHandler(ValidationEventHandler handler)
          允许应用程序注册 ValidationEventHandler
 void Validator.setEventHandler(ValidationEventHandler handler)
          已过时。 从 JAXB2.0 开始
 void Unmarshaller.setValidating(boolean validating)
          已过时。 从 JAXB2.0 开始,请参阅 Unmarshaller.setSchema(javax.xml.validation.Schema)
 Object Unmarshaller.unmarshal(File f)
          从指定的文件解组 XML 数据并返回得到的内容树。
 Object Unmarshaller.unmarshal(InputSource source)
          从指定的 SAX InputSource 解组 XML 数据并返回得到的内容树。
 Object Unmarshaller.unmarshal(InputStream is)
          从指定的 InputStream 解组 XML 数据并返回得到的内容树。
 Object Unmarshaller.unmarshal(Node node)
          从指定的 DOM 树解组全局 XML 数据并返回得到的内容树。
<T> JAXBElement<T>
Unmarshaller.unmarshal(Node node, Class<T> declaredType)
          通过 JAXB 映射的 declaredType 解组 XML 数据并返回得到的内容树。
 Object Unmarshaller.unmarshal(Reader reader)
          从指定的 Reader 解组 XML 数据并返回得到的内容树。
 Object Unmarshaller.unmarshal(Source source)
          从指定的 XML Source 解组 XML 数据并返回得到的内容树。
<T> JAXBElement<T>
Unmarshaller.unmarshal(Source source, Class<T> declaredType)
          从 declaredType 指定的 XML Source 解组 XML 数据并返回得到的内容树。
 Object Unmarshaller.unmarshal(URL url)
          从指定的 URL 解组 XML 数据并返回得到的内容树。
 Object Unmarshaller.unmarshal(XMLEventReader reader)
          从指定的 pull 解析器解组 XML 数据并返回得到的内容树。
<T> JAXBElement<T>
Unmarshaller.unmarshal(XMLEventReader reader, Class<T> declaredType)
          将根元素解组到 JAXB 映射的 declaredType 并返回得到的内容树。
abstract  Object Binder.unmarshal(XmlNode xmlNode)
          将 XML 信息集视图解组为 JAXB 对象树。
abstract
<T> JAXBElement<T>
Binder.unmarshal(XmlNode xmlNode, Class<T> declaredType)
          根据提供的 declaredType 将 XML 根元素解组为 JAXB 对象树。
 Object Unmarshaller.unmarshal(XMLStreamReader reader)
          从指定的 pull 解析器解组 XML 数据并返回得到的内容树。
<T> JAXBElement<T>
Unmarshaller.unmarshal(XMLStreamReader reader, Class<T> declaredType)
          将根元素解组到 JAXB 映射的 declaredType 并返回得到的内容树。
abstract  Object Binder.updateJAXB(XmlNode xmlNode)
          取一个 XML 节点,并更新与其关联的 JAXB 对象和该对象的子级。
abstract  XmlNode Binder.updateXML(Object jaxbObject)
          取一个 JAXB 对象,并更新与其关联的 XML 节点和该节点的子级。
abstract  XmlNode Binder.updateXML(Object jaxbObject, XmlNode xmlNode)
          JAXB 对象树中所做的更改在与其关联的 XML 解析树中得到更新。
 boolean Validator.validate(Object subrootObj)
          已过时。 从 JAXB2.0 开始
 boolean Validator.validateRoot(Object rootObj)
          已过时。 从 JAXB2.0 开始
 

javax.xml.bind.helpersJAXBException 的使用
 

抛出 JAXBExceptionjavax.xml.bind.helpers 中的方法
 ValidationEventHandler AbstractMarshallerImpl.getEventHandler()
           
 ValidationEventHandler AbstractUnmarshallerImpl.getEventHandler()
          返回当前的事件处理程序,如果没有设置该处理程序,则返回默认的事件处理程序。
 Node AbstractMarshallerImpl.getNode(Object obj)
          默认情况下,getNode 方法不受支持并抛出 UnsupportedOperationException
protected  XMLReader AbstractUnmarshallerImpl.getXMLReader()
          获取配置好的 XMLReader。
 boolean AbstractUnmarshallerImpl.isValidating()
          指示 Unmarshaller 是否被配置为在执行解组操作期间进行验证。
 void AbstractMarshallerImpl.marshal(Object obj, ContentHandler handler)
           
 void AbstractMarshallerImpl.marshal(Object obj, Node node)
           
 void AbstractMarshallerImpl.marshal(Object obj, OutputStream os)
           
 void AbstractMarshallerImpl.marshal(Object obj, Writer w)
           
 void AbstractMarshallerImpl.marshal(Object obj, XMLEventWriter writer)
           
 void AbstractMarshallerImpl.marshal(Object obj, XMLStreamWriter writer)
           
 void AbstractMarshallerImpl.setEventHandler(ValidationEventHandler handler)
           
 void AbstractUnmarshallerImpl.setEventHandler(ValidationEventHandler handler)
          允许应用程序注册一个验证事件处理程序。
 void AbstractUnmarshallerImpl.setValidating(boolean validating)
          指定 Unmarshaller 是否应该在执行解组操作期间进行验证。
 Object AbstractUnmarshallerImpl.unmarshal(File f)
           
 Object AbstractUnmarshallerImpl.unmarshal(InputSource source)
           
 Object AbstractUnmarshallerImpl.unmarshal(InputStream is)
           
<T> JAXBElement<T>
AbstractUnmarshallerImpl.unmarshal(Node node, Class<T> expectedType)
           
 Object AbstractUnmarshallerImpl.unmarshal(Reader reader)
           
 Object AbstractUnmarshallerImpl.unmarshal(Source source)
           
<T> JAXBElement<T>
AbstractUnmarshallerImpl.unmarshal(Source source, Class<T> expectedType)
           
 Object AbstractUnmarshallerImpl.unmarshal(URL url)
           
 Object AbstractUnmarshallerImpl.unmarshal(XMLEventReader reader)
           
<T> JAXBElement<T>
AbstractUnmarshallerImpl.unmarshal(XMLEventReader reader, Class<T> expectedType)
           
protected abstract  Object AbstractUnmarshallerImpl.unmarshal(XMLReader reader, InputSource source)
          使用指定的 XMLReader 和 InputSource 解组对象。
 Object AbstractUnmarshallerImpl.unmarshal(XMLStreamReader reader)
           
<T> JAXBElement<T>
AbstractUnmarshallerImpl.unmarshal(XMLStreamReader reader, Class<T> expectedType)
           
 

javax.xml.bind.utilJAXBException 的使用
 

抛出 JAXBExceptionjavax.xml.bind.util 中的方法
 Object JAXBResult.getResult()
          获取通过转换创建的已解组对象。
 

抛出 JAXBExceptionjavax.xml.bind.util 中的构造方法
JAXBResult(JAXBContext context)
          创建一个使用指定 JAXBContext 来解组的新实例。
JAXBResult(Unmarshaller _unmarshaller)
          创建一个使用指定 Unmarshaller 来解组对象的新实例。
JAXBSource(JAXBContext context, Object contentObject)
          针对给定的内容对象创建一个新 Source
JAXBSource(Marshaller marshaller, Object contentObject)
          针对给定的内容对象创建一个新 Source
 


JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策