JAXB (Платформа Java SE 7)

java.lang. Объект
- javax.xml.bind. JAXB

```
public final class JAXB
extends Object
```
Класс, который определяет методы удобства для общего, простого использования JAXB.
Методы, определенные в этом классе, являются методами удобства, которые комбинируют несколько основных операций в JAXBContext, Unmarshaller, и Marshaller. Они разрабатываются, чтобы быть предпочтенными методами для разработчиков, плохо знакомых с JAXB. У них есть следующий characterstics:
1. Вообще говоря, производительность не обязательно оптимальна. Ожидается, что люди, которые нуждаются к производительности записи в критическом коде, будут использовать остальную часть API JAXB непосредственно.
2. Ошибки, которые происходят во время обработки, обертываются в DataBindingException (который будет иметь JAXBException как cause. Ожидается, что люди, которые предпочитают проверенное исключение, использовали бы остальную часть API JAXB непосредственно.
Кроме того, у методов unmarshal есть следующая характеристика:
1. Проверка допустимости схемы не выполняется на входном XML. Обработка попытается продолжаться, даже если будут ошибки в XML в максимально возможной степени. Только как последнее средство, этот метод перестал работать с DataBindingException.
Точно так же у методов marshal есть следующая характеристика:
1. Обработка попытается продолжаться, даже если Java возразит, что дерево не удовлетворяет требование законности. Только как последнее средство, этот метод перестал работать с DataBindingException.
Все методы на этом классе требуют ненулевых параметров всем параметрам. Методы 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.

Методы 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 на его определении класса, которое будет использоваться, поскольку корневое имя тега и данный объект обеспечат тело. Иначе, корневое имя тега infered от the short class name. Этот параметр не должен быть нулем.
    xml - XML будет записан этому файлу. Если это уже будет существовать, то это будет перезаписано.
    
    Броски:
    
    DataBindingException - Если работа перестала работать, такой как из-за ошибки ввода-вывода, несвязываемых классов.
  - упорядочить
```
public static void marshal(Object jaxbObject,
           URL xml)
```
    Пишет, что Java возражает дереву против XML и хранит это к указанному расположению.
    
    Параметры:
    jaxbObject - Объект Java, который будет упорядочен в XML. Если этот объект является a JAXBElement, это обеспечит корневое имя тега и тело. Если этот объект имеет XmlRootElement на его определении класса, которое будет использоваться, поскольку корневое имя тега и данный объект обеспечат тело. Иначе, корневое имя тега 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 на его определении класса, которое будет использоваться, поскольку корневое имя тега и данный объект обеспечат тело. Иначе, корневое имя тега 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 на его определении класса, которое будет использоваться, поскольку корневое имя тега и данный объект обеспечат тело. Иначе, корневое имя тега 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 на его определении класса, которое будет использоваться, поскольку корневое имя тега и данный объект обеспечат тело. Иначе, корневое имя тега 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 на его определении класса, которое будет использоваться, поскольку корневое имя тега и данный объект обеспечат тело. Иначе, корневое имя тега 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 на его определении класса, которое будет использоваться, поскольку корневое имя тега и данный объект обеспечат тело. Иначе, корневое имя тега infered от the short class name. Этот параметр не должен быть нулем.
    xml - XML будет отправлен Result объект.
    
    Броски:
    
    DataBindingException - Если работа перестала работать, такой как из-за ошибки ввода-вывода, несвязываемых классов.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс JAXB

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

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

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

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

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

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

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

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

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

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

упорядочить

упорядочить

упорядочить

упорядочить

упорядочить

упорядочить

упорядочить