Spec-Zone .ru спецификации, руководства, описания, API

javax.xml.bind
Класс JAXB

java.lang.Object
  javax.xml.bind.JAXB

public final class JAXB
расширяет java.lang. Объект

Класс, который определяет методы удобства для общего, простого использования JAXB.

Методы, определенные в этом class, являются методами удобства, которые комбинируют несколько основных операций в JAXBContext, Unmarshaller, и Marshaller. Они разрабатываются, чтобы быть предпочтенными методами для разработчиков, плохо знакомых с JAXB. У них есть следующий characterstics:

1. Вообще говоря, производительность не обязательно оптимальна. Ожидается, что люди, которые нуждаются к производительности записи в критическом коде, будут использовать остальную часть API JAXB непосредственно.
2. Ошибки, которые происходят во время обработки, обертываются в DataBindingException (который будет иметь JAXBException как cause. Ожидается, что люди, которые предпочитают проверенное исключение, использовали бы остальную часть API JAXB непосредственно.

Кроме того, у методов unmarshal есть следующая характеристика:

1. Проверка допустимости схемы не выполняется на входном XML. Обработка попытается продолжаться, даже если будут ошибки в XML в максимально возможной степени. Только как последнее средство, этот метод перестал работать с DataBindingException.

Точно так же у методов marshal есть следующая характеристика:

1. Обработка попытается продолжаться, даже если Java возразит, что дерево не удовлетворяет требование законности. Только как последнее средство, этот метод перестал работать с DataBindingException.

Все методы на этом class требуют ненулевых параметров всем параметрам. Методы unmarshal или приводят к сбою с исключением или возвратом ненулевое значение.

С тех пор:

2.1

Автор:

Kohsuke Кавагути

Сводка метода

static void	marshal(java.lang.Object jaxbObject, java.io.File xml) Пишет, что Java возражает дереву против XML и хранит это к указанному расположению.
static void	marshal(java.lang.Object jaxbObject, java.io.OutputStream xml) Пишет, что Java возражает дереву против XML и хранит это к указанному расположению.
static void	marshal(java.lang.Object jaxbObject, javax.xml.transform.Result xml) Пишет, что Java возражает дереву против XML и хранит это к указанному расположению.
static void	marshal(java.lang.Object jaxbObject, java.lang.String xml) Пишет, что Java возражает дереву против XML и хранит это к указанному расположению.
static void	marshal(java.lang.Object jaxbObject, java.net.URI xml) Пишет, что Java возражает дереву против XML и хранит это к указанному расположению.
static void	marshal(java.lang.Object jaxbObject, java.net.URL xml) Пишет, что Java возражает дереву против XML и хранит это к указанному расположению.
static void	marshal(java.lang.Object jaxbObject, java.io.Writer xml) Пишет, что Java возражает дереву против XML и хранит это к указанному расположению.
static <T> T	unmarshal(java.io.File xml, java.lang.Class<T> type) Чтения в Java возражают дереву от данного ввода XML.
static <T> T	unmarshal(java.io.InputStream xml, java.lang.Class<T> type) Чтения в Java возражают дереву от данного ввода XML.
static <T> T	unmarshal(java.io.Reader xml, java.lang.Class<T> type) Чтения в Java возражают дереву от данного ввода XML.
static <T> T	unmarshal(javax.xml.transform.Source xml, java.lang.Class<T> type) Чтения в Java возражают дереву от данного ввода XML.
static <T> T	unmarshal(java.lang.String xml, java.lang.Class<T> type) Чтения в Java возражают дереву от данного ввода XML.
static <T> T	unmarshal(java.net.URI xml, java.lang.Class<T> type) Чтения в Java возражают дереву от данного ввода XML.
static <T> T	unmarshal(java.net.URL xml, java.lang.Class<T> type) Чтения в Java возражают дереву от данного ввода XML.

Методы, наследованные от class java.lang. Объект

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

Деталь метода

неупорядочить

public static <T> T unmarshal(java.io.File xml,
                              java.lang.Class<T> type)

Чтения в Java возражают дереву от данного ввода XML.

Параметры:

xml - Читает весь файл как XML.

неупорядочить

public static <T> T unmarshal(java.net.URL xml,
                              java.lang.Class<T> type)

Чтения в Java возражают дереву от данного ввода XML.

Параметры:

xml - Ресурс, на который указывает URL, читается полностью.

неупорядочить

public static <T> T unmarshal(java.net.URI xml,
                              java.lang.Class<T> type)

Чтения в Java возражают дереву от данного ввода XML.

Параметры:

xml - URI turned into URL и затем следует за обработкой URL.

неупорядочить

public static <T> T unmarshal(java.lang.String xml,
                              java.lang.Class<T> type)

Чтения в Java возражают дереву от данного ввода XML.

Параметры:

xml - Строка сначала интерпретируется как абсолютный URI. Если это не a valid absolute URI, тогда это интерпретируется как File

неупорядочить

public static <T> T unmarshal(java.io.InputStream xml,
                              java.lang.Class<T> type)

Чтения в Java возражают дереву от данного ввода XML.

Параметры:

xml - Весь поток читается как инфонабор XML. После успешного завершения поток будет закрыт этим методом.

неупорядочить

public static <T> T unmarshal(java.io.Reader xml,
                              java.lang.Class<T> type)

Чтения в Java возражают дереву от данного ввода XML.

Параметры:

xml - Символьный поток читается как инфонабор XML. Объявление кодирования в XML будет проигнорировано. После успешного завершения поток будет закрыт этим методом.

неупорядочить

public static <T> T unmarshal(javax.xml.transform.Source xml,
                              java.lang.Class<T> type)

Чтения в Java возражают дереву от данного ввода XML.

Параметры:

xml - Инфонабор XML, что Source представляет читается.

упорядочить

public static void marshal(java.lang.Object jaxbObject,
                           java.io.File xml)

Пишет, что Java возражает дереву против XML и хранит это к указанному расположению.

Параметры:

jaxbObject - Объект Java, который будет упорядочен в XML. Если этот объект является a JAXBElement, это обеспечит корневое имя тега и тело. Если этот объект имеет XmlRootElement на его определении class, которое будет использоваться, поскольку корневое имя тега и данный объект обеспечат тело. Иначе, корневое имя тега infered от the short class name. Этот параметр не должен быть нулем.

xml - XML будет записан этому файлу. Если это уже будет существовать, то это будет перезаписано.

Броски:

DataBindingException - Если работа перестала работать, такой как из-за ошибки ввода-вывода, несвязываемых классов.

упорядочить

public static void marshal(java.lang.Object jaxbObject,
                           java.net.URL xml)

Пишет, что Java возражает дереву против XML и хранит это к указанному расположению.

Параметры:

jaxbObject - Объект Java, который будет упорядочен в XML. Если этот объект является a JAXBElement, это обеспечит корневое имя тега и тело. Если этот объект имеет XmlRootElement на его определении class, которое будет использоваться, поскольку корневое имя тега и данный объект обеспечат тело. Иначе, корневое имя тега infered от the short class name. Этот параметр не должен быть нулем.

xml - XML будет sent к ресурсу, на который указывает этот URL. Отметьте, что не весь URL s поддерживает такую работу, и точная семантика зависит от реализаций URL. В случае HTTP URLs, это выполнит POST HTTP.

Броски:

DataBindingException - Если работа перестала работать, такой как из-за ошибки ввода-вывода, несвязываемых классов.

упорядочить

public static void marshal(java.lang.Object jaxbObject,
                           java.net.URI xml)

Пишет, что Java возражает дереву против XML и хранит это к указанному расположению.

Параметры:

jaxbObject - Объект Java, который будет упорядочен в XML. Если этот объект является a JAXBElement, это обеспечит корневое имя тега и тело. Если этот объект имеет XmlRootElement на его определении class, которое будет использоваться, поскольку корневое имя тега и данный объект обеспечат тело. Иначе, корневое имя тега infered от the short class name. Этот параметр не должен быть нулем.

xml - URI turned into URL и затем следует за обработкой URL. См. выше.

Броски:

DataBindingException - Если работа перестала работать, такой как из-за ошибки ввода-вывода, несвязываемых классов.

упорядочить

public static void marshal(java.lang.Object jaxbObject,
                           java.lang.String xml)

Пишет, что Java возражает дереву против XML и хранит это к указанному расположению.

Параметры:

jaxbObject - Объект Java, который будет упорядочен в XML. Если этот объект является a JAXBElement, это обеспечит корневое имя тега и тело. Если этот объект имеет XmlRootElement на его определении class, которое будет использоваться, поскольку корневое имя тега и данный объект обеспечат тело. Иначе, корневое имя тега infered от the short class name. Этот параметр не должен быть нулем.

xml - Строка сначала интерпретируется как абсолютный URI. Если это не a valid absolute URI, тогда это интерпретируется как File

Броски:

DataBindingException - Если работа перестала работать, такой как из-за ошибки ввода-вывода, несвязываемых классов.

упорядочить

public static void marshal(java.lang.Object jaxbObject,
                           java.io.OutputStream xml)

Пишет, что Java возражает дереву против XML и хранит это к указанному расположению.

Параметры:

jaxbObject - Объект Java, который будет упорядочен в XML. Если этот объект является a JAXBElement, это обеспечит корневое имя тега и тело. Если этот объект имеет XmlRootElement на его определении class, которое будет использоваться, поскольку корневое имя тега и данный объект обеспечат тело. Иначе, корневое имя тега infered от the short class name. Этот параметр не должен быть нулем.

xml - XML будет отправлен данному OutputStream. После успешного завершения поток будет закрыт этим методом.

Броски:

DataBindingException - Если работа перестала работать, такой как из-за ошибки ввода-вывода, несвязываемых классов.

упорядочить

public static void marshal(java.lang.Object jaxbObject,
                           java.io.Writer xml)

Пишет, что Java возражает дереву против XML и хранит это к указанному расположению.

Параметры:

jaxbObject - Объект Java, который будет упорядочен в XML. Если этот объект является a JAXBElement, это обеспечит корневое имя тега и тело. Если этот объект имеет XmlRootElement на его определении class, которое будет использоваться, поскольку корневое имя тега и данный объект обеспечат тело. Иначе, корневое имя тега infered от the short class name. Этот параметр не должен быть нулем.

xml - XML будет отправлен как символьный поток данному Writer. После успешного завершения поток будет закрыт этим методом.

Броски:

DataBindingException - Если работа перестала работать, такой как из-за ошибки ввода-вывода, несвязываемых классов.

упорядочить

public static void marshal(java.lang.Object jaxbObject,
                           javax.xml.transform.Result xml)

Пишет, что Java возражает дереву против XML и хранит это к указанному расположению.

Параметры:

jaxbObject - Объект Java, который будет упорядочен в XML. Если этот объект является a JAXBElement, это обеспечит корневое имя тега и тело. Если этот объект имеет XmlRootElement на его определении class, которое будет использоваться, поскольку корневое имя тега и данный объект обеспечат тело. Иначе, корневое имя тега infered от the short class name. Этот параметр не должен быть нулем.

xml - XML будет отправлен Result объект.

Броски:

DataBindingException - Если работа перестала работать, такой как из-за ошибки ввода-вывода, несвязываемых классов.