javax.xml.bind

Класс JAXB

java.lang. Объект

javax.xml.bind. JAXB

public final class JAXB
extends Object

Класс, который определяет методы удобства для общего, простого использования 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

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

Модификатор и Тип	Метод и Описание
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, Class<T> type) Чтения в Java возражают дереву от данного ввода XML.
static <T> T	unmarshal(InputStream xml, Class<T> type) Чтения в Java возражают дереву от данного ввода XML.
static <T> T	unmarshal(Reader xml, Class<T> type) Чтения в Java возражают дереву от данного ввода XML.
static <T> T	unmarshal(Source xml, Class<T> type) Чтения в Java возражают дереву от данного ввода XML.
static <T> T	unmarshal(String xml, Class<T> type) Чтения в Java возражают дереву от данного ввода XML.
static <T> T	unmarshal(URI xml, Class<T> type) Чтения в Java возражают дереву от данного ввода XML.
static <T> T	unmarshal(URL xml, Class<T> type) Чтения в Java возражают дереву от данного ввода XML.

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

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

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

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

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

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

Параметры:

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

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

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

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

Параметры:

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

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

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

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

Параметры:

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

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

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

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

Параметры:

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

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

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

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

Параметры:

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

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

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

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

Параметры:

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

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

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

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

Параметры:

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

упорядочить

public static void marshal(Object jaxbObject,
                           File xml)

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

Параметры:

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

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

Броски:

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

упорядочить

public static void marshal(Object jaxbObject,
                           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(Object jaxbObject,
                           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(Object jaxbObject,
                           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(Object jaxbObject,
                           OutputStream xml)

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

Параметры:

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

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

Броски:

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

упорядочить

public static void marshal(Object jaxbObject,
                           Writer xml)

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

Параметры:

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

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

Броски:

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

упорядочить

public static void marshal(Object jaxbObject,
                           Result xml)

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

Параметры:

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

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

Броски:

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