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

Все Известные Классы с реализацией:

AbstractMarshallerImpl
```
public interface Marshaller
```
Класс Marshaller ответственен за управление процессом сериализации деревьев контента Java назад в данные XML. Это обеспечивает основные методы маршалинга:
Примите следующий код установки для всего после фрагментов кода:
```
       JAXBContext jc = JAXBContext.newInstance( "com.acme.foo" );
       Unmarshaller u = jc.createUnmarshaller();
       Object element = u.unmarshal( new File( "foo.xml" ) );
       Marshaller m = jc.createMarshaller();
    
```
Маршалинг к Файлу:
```
       OutputStream os = new FileOutputStream( "nosferatu.xml" );
       m.marshal( element, os );
    
```
Маршалинг к SAX ContentHandler:
```
       // assume MyContentHandler instanceof ContentHandler
       m.marshal( element, new MyContentHandler() );
    
```
Маршалинг ДОМУ Ноуду:
```
       DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
       dbf.setNamespaceAware(true);
       DocumentBuilder db = dbf.newDocumentBuilder();
       Document doc = db.newDocument();

       m.marshal( element, doc );
    
```
Маршалинг к java.io. OutputStream:
```
       m.marshal( element, System.out );
    
```
Маршалинг к java.io. Писатель:
```
       m.marshal( element, new PrintWriter( System.out ) );
    
```
Маршалинг к javax.xml.transform. SAXResult:
```
       // assume MyContentHandler instanceof ContentHandler
       SAXResult result = new SAXResult( new MyContentHandler() );

       m.marshal( element, result );
    
```
Маршалинг к javax.xml.transform. DOMResult:
```
       DOMResult result = new DOMResult();

       m.marshal( element, result );
    
```
Маршалинг к javax.xml.transform. StreamResult:
```
       StreamResult result = new StreamResult( System.out );

       m.marshal( element, result );
    
```
Маршалинг к javax.xml.stream. XMLStreamWriter:
```
       XMLStreamWriter xmlStreamWriter =
           XMLOutputFactory.newInstance().createXMLStreamWriter( ... );

       m.marshal( element, xmlStreamWriter );
    
```
Маршалинг к javax.xml.stream. XMLEventWriter:
```
       XMLEventWriter xmlEventWriter =
           XMLOutputFactory.newInstance().createXMLEventWriter( ... );

       m.marshal( element, xmlEventWriter );
    
```
Маршалинг дерева контента базировался элементом JAXB

Первый параметр перегруженных методов Marshaller.marshal(java.lang.Object, ...) должен быть элементом JAXB как вычислено JAXBIntrospector.isElement(java.lang.Object); иначе, метод Marshaller.marshal должен бросить a MarshalException. Там существуйте два механизма, чтобы позволить упорядочить экземпляр, который не является элементом JAXB. Один метод должен обернуть экземпляр как значение a JAXBElement, и передайте элемент обертки как первый параметр к методу Marshaller.marshal. Для java к привязке схемы также возможно просто аннотировать класс экземпляраXmlRootElement.

Кодирование

По умолчанию Marshaller будет использовать кодирование UTF-8, генерируя данные XML к java.io.OutputStream, или java.io.Writer. Используйте setProperty API, чтобы изменить выходное кодирование, используемое во время них, упорядочивает операции. Клиентские приложения, как ожидают, предоставят допустимое имя кодировки символов как определено в XML 1.0 W3C Рекомендация и поддерживаются Вашей Платформой Java.

Проверка допустимости и Отмеченность

Клиентские приложения не обязаны проверять дерева контента Java до вызова любого упорядочивать API. Кроме того нет никакого требования, что дерево контента Java быть допустимым относительно его исходной схемы, чтобы упорядочить его назад в данные XML. Различные Провайдеры JAXB будут поддерживать упорядочивающие недопустимые деревья контента Java на переменных уровнях, однако все Провайдеры JAXB должны быть в состоянии упорядочить допустимое дерево контента назад к данным XML. Провайдер JAXB должен бросить MarshalException, когда это неспособно завершить упорядочивать работу из-за недопустимого контента. Некоторые Провайдеры JAXB полностью позволят упорядочивать недопустимый контент, другие перестанут работать на первой ошибке проверки допустимости.
Даже когда проверка допустимости схемы не является explictly, включенным для упорядочивать работы, возможно, что определенные типы событий проверки допустимости будут обнаружены во время работы. О событиях проверки допустимости сообщат зарегистрированному обработчику событий. Если клиентское приложение не зарегистрировало обработчик событий до вызова одного из упорядочивать API, то события будут поставлены обработчику стандартного события, который завершит упорядочивать работу после обнаружения с первой ошибкой или фатальной ошибкой. Отметьте это JAXB 2.0 и более поздними версиями, DefaultValidationEventHandler больше не используется.

Поддерживаемые Свойства
Все Провайдеры JAXB обязаны поддерживать следующий набор свойств. Некоторые провайдеры могут поддерживать дополнительные свойства.
jaxb.encoding - значение должно быть java.lang. Строка

Выходное кодирование, чтобы использовать, упорядочивая данные XML. Marshaller будет использовать "UTF-8" по умолчанию, если это свойство не будет определено.

jaxb.formatted.output - значение должно быть java.lang. Булевская переменная

Это свойство управляет, отформатирует ли Marshaller получающиеся данные XML с разрывами строки и добавлением отступа. Истинное значение для этого свойства указывает удобочитаемый, располагал xml данные с отступом, в то время как ложное значение указывает на восстановленные после форматирования xml данные. Marshaller примет значение по умолчанию ко лжи (восстановленной после форматирования), если это свойство не будет определено.

jaxb.schemaLocation - значение должно быть java.lang. Строка

Это свойство позволяет клиентскому приложению определять атрибут xsi:schemaLocation в сгенерированных данных XML. Формат schemaLocation значения атрибута обсуждается в легком, чтобы понять, ненормативная форма в Разделе 5.6 из Части 0 XML-схемы W3C: Учебник для начинающих и определенный в Разделе 2.6 из Части 1 XML-схемы W3C: Структуры.

jaxb.noNamespaceSchemaLocation - значение должно быть java.lang. Строка

Это свойство позволяет клиентскому приложению определять атрибут xsi:noNamespaceSchemaLocation в сгенерированных данных XML. Формат schemaLocation значения атрибута обсуждается в легком, чтобы понять, ненормативная форма в Разделе 5.6 из Части 0 XML-схемы W3C: Учебник для начинающих и определенный в Разделе 2.6 из Части 1 XML-схемы W3C: Структуры.

jaxb.fragment - значение должно быть java.lang. Булевская переменная
Это свойство определяет, будут ли события уровня документа сгенерированы Marshaller. Если свойство не определяется, значением по умолчанию является false. У этого свойства есть различные импликации, в зависимости от которых упорядочивают api, который Вы используете - когда это свойство устанавливается в истину:

marshal(Object,ContentHandler) - Marshaller не будет вызывать ContentHandler.startDocument() и ContentHandler.endDocument().

marshal(Object,Node) - свойство не имеет никакого эффекта на этот API.

marshal(Object,OutputStream) - Marshaller не будет генерировать xml объявление.

marshal(Object,Writer) - Marshaller не будет генерировать xml объявление.

marshal(Object,Result) - зависит от вида объекта Результата, см. семантику для Узла, ContentHandler, и Потоковых API

marshal(Object,XMLEventWriter) - Marshaller не будет генерировать XMLStreamConstants.START_DOCUMENT и XMLStreamConstants.END_DOCUMENT события.

marshal(Object,XMLStreamWriter) - Marshaller не будет генерировать XMLStreamConstants.START_DOCUMENT и XMLStreamConstants.END_DOCUMENT события.
Упорядочьте Обратные вызовы События
" Marshaller обеспечивает два стиля механизмов обратного вызова, которые позволяют специализированную обработку во время ключевых пунктов в процессе немаршалинга. В 'классе определенные' обратные вызовы события специализированный код, помещенный в JAXB отображенные классы, инициирован во время маршалинга. 'Внешние слушатели' учитывают централизованную обработку, упорядочивают события в одном методе обратного вызова, а не обратными вызовами события типа.
Класс определенные методы обратного вызова события позволяет любому JAXB отображенный класс, чтобы определить его собственные определенные методы обратного вызова, определяя методы с помощью следующих сигнатур методов:
```
   // Invoked by Marshaller after it has created an instance of this object.
   boolean beforeMarshal(Marshaller);

   // Invoked by Marshaller after it has marshalled all properties of this object.
   void afterMmarshal(Marshaller);
 
```
Определенные методы обратного вызова события класса должны использоваться, когда метод обратного вызова требует доступа к непубличным методам и/или полям класса.
Внешний механизм обратного вызова слушателя включает регистрации a Marshaller.Listener экземпляр с a setListener(Listener). Внешний слушатель получает все события обратного вызова, учитывая более централизованную обработку чем на класс определенные методы обратного вызова.
'Класс определенные' и внешние методы обратного вызова события слушателя независимы друг от друга, обоих можно вызвать для одного события. Упорядочивание вызова, когда оба метода обратного вызова слушателя существуют, определяется в Marshaller.Listener.beforeMarshal(Object) и Marshaller.Listener.afterMarshal(Object).
Метод обратного вызова события, выдающий исключение, завершается, ток упорядочивают процесс.
С тех пор:

JAXB1.0

См. Также:
JAXBContext, Validator, Unmarshaller

Вложенная Сводка Класса

Вложенные Классы
Модификатор и Тип	Интерфейс и Описание
`static class`	`Marshaller. Слушатель` Зарегистрируйте экземпляр реализации этого класса с a `Marshaller` чтобы внешне прислушаться упорядочивают события.

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`static String`	`JAXB_ENCODING` Имя свойства, используемого, чтобы определить выходное кодирование в упорядоченных данных XML.
`static String`	`JAXB_FORMATTED_OUTPUT` Имя свойства, используемого, чтобы определить, форматируются ли упорядоченные данные XML с переводами строки и добавлением отступа.
`static String`	`JAXB_FRAGMENT` Имя свойства, используемого, чтобы определить, генерирует ли marshaller события уровня документа (то есть вызывающий startDocument или endDocument).
`static String`	`JAXB_NO_NAMESPACE_SCHEMA_LOCATION` Имя свойства, используемого, чтобы определить xsi:noNamespaceSchemaLocation значение атрибута, чтобы поместить в упорядоченный вывод XML.
`static String`	`JAXB_SCHEMA_LOCATION` Имя свойства, используемого, чтобы определить xsi:schemaLocation значение атрибута, чтобы поместить в упорядоченный вывод XML.

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

Методы
Модификатор и Тип	Метод и Описание
`<A extends XmlAdapter> A`	`getAdapter(Class<A> type)` Связали адаптер с указанным типом.
`AttachmentMarshaller`	`getAttachmentMarshaller()`
`ValidationEventHandler`	`getEventHandler()` Возвратите текущий обработчик событий или обработчик стандартного события, если Вы не были установлены.
`Marshaller. Слушатель`	`getListener()` Возвратиться `Marshaller.Listener` зарегистрированный в этом `Marshaller`.
`Узел`	`getNode(Object contentTree)` Получите структурный вид ДОМА (Дополнительного) дерева контента.
`Объект`	`getProperty(String name)` Получите определенное свойство в базовой реализации `Marshaller`.
`Схема`	`getSchema()` Получите JAXP 1.3 `Schema` объект, используемый, чтобы выполнить, упорядочивает разовую проверку допустимости.
`void`	`marshal(Object jaxbElement, ContentHandler handler)` Упорядочьте дерево контента, базированное в событиях `jaxbElement` into SAX2.
`void`	`marshal(Object jaxbElement, File output)` Упорядочьте дерево контента, базированное в `jaxbElement` в файл.
`void`	`marshal(Object jaxbElement, Node node)` Упорядочьте дерево контента, базированное в `jaxbElement` в дерево ДОМА.
`void`	`marshal(Object jaxbElement, OutputStream os)` Упорядочьте дерево контента, базированное в `jaxbElement` в поток вывода.
`void`	`marshal(Object jaxbElement, Result result)` Упорядочьте дерево контента, базированное в `jaxbElement` в указанный `javax.xml.transform.Result`.
`void`	`marshal(Object jaxbElement, Writer writer)` Упорядочьте дерево контента, базированное в `jaxbElement` в Писателя.
`void`	`marshal(Object jaxbElement, XMLEventWriter writer)` Упорядочьте дерево контента, базированное в `jaxbElement` в a `XMLEventWriter`.
`void`	`marshal(Object jaxbElement, XMLStreamWriter writer)` Упорядочьте дерево контента, базированное в `jaxbElement` в a `XMLStreamWriter`.
`<A extends XmlAdapter> void`	`setAdapter(Class<A> type, A adapter)` Связывает сконфигурированный экземпляр `XmlAdapter` с этим marshaller.
`void`	`setAdapter(XmlAdapter adapter)` Связывает сконфигурированный экземпляр `XmlAdapter` с этим marshaller.
`void`	`setAttachmentMarshaller(AttachmentMarshaller am)` Свяжите контекст, который позволяет двоичным данным в пределах XML-документа быть переданными как двоичный файл XML оптимизированное присоединение.
`void`	`setEventHandler(ValidationEventHandler handler)` Позвольте приложению регистрировать обработчик событий проверки допустимости.
`void`	`setListener(Marshaller.Listener listener)` Регистр упорядочивает обратный вызов события `Marshaller.Listener` с этим `Marshaller`.
`void`	`setProperty(String name, Object value)` Установите определенное свойство в базовой реализации `Marshaller`.
`void`	`setSchema(Schema schema)` Определите JAXP 1.3 `Schema` объект, который должен использоваться, чтобы проверить последующий, упорядочивает операции против.

- Полевая Деталь
  - JAXB_ENCODING
```
static final String JAXB_ENCODING
```
    Имя свойства, используемого, чтобы определить выходное кодирование в упорядоченных данных XML.
    
    См. Также:
    Постоянные Значения полей
  - JAXB_FORMATTED_OUTPUT
```
static final String JAXB_FORMATTED_OUTPUT
```
    Имя свойства, используемого, чтобы определить, форматируются ли упорядоченные данные XML с переводами строки и добавлением отступа.
    
    См. Также:
    Постоянные Значения полей
  - JAXB_SCHEMA_LOCATION
```
static final String JAXB_SCHEMA_LOCATION
```
    Имя свойства, используемого, чтобы определить xsi:schemaLocation значение атрибута, чтобы поместить в упорядоченный вывод XML.
    
    См. Также:
    Постоянные Значения полей
  - JAXB_NO_NAMESPACE_SCHEMA_LOCATION
```
static final String JAXB_NO_NAMESPACE_SCHEMA_LOCATION
```
    Имя свойства, используемого, чтобы определить xsi:noNamespaceSchemaLocation значение атрибута, чтобы поместить в упорядоченный вывод XML.
    
    См. Также:
    Постоянные Значения полей
  - JAXB_FRAGMENT
```
static final String JAXB_FRAGMENT
```
    Имя свойства, используемого, чтобы определить, генерирует ли marshaller события уровня документа (то есть вызывающий startDocument или endDocument).
    
    См. Также:
    Постоянные Значения полей
- Деталь метода
  - упорядочить
```
void marshal(Object jaxbElement,
           Result result)
             throws JAXBException
```
    Упорядочьте дерево контента, базированное в jaxbElement в указанный javax.xml.transform.Result.
    Все Провайдеры JAXB должны, по крайней мере, поддерживать DOMResult, SAXResult, и StreamResult. Это может поддерживать другие производные классы Result также.
    
    Параметры:
    jaxbElement - Корень дерева контента, которое будет упорядочено.
    result - XML будет отправлен этому Результату
    
    Броски:
    
    JAXBException - Если какая-либо неожиданная проблема происходит во время маршалинга.
    
    MarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Marshaller неспособен упорядочить obj (или любой объект, достижимый от obj). См. Маршалинг элемента JAXB.
    
    IllegalArgumentException - Если какой-либо из параметров метода является нулем
  - упорядочить
```
void marshal(Object jaxbElement,
           OutputStream os)
             throws JAXBException
```
    Упорядочьте дерево контента, базированное в jaxbElement в поток вывода.
    
    Параметры:
    jaxbElement - Корень дерева контента, которое будет упорядочено.
    os - XML будет добавлен к этому потоку.
    
    Броски:
    
    JAXBException - Если какая-либо неожиданная проблема происходит во время маршалинга.
    
    MarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Marshaller неспособен упорядочить obj (или любой объект, достижимый от obj). См. Маршалинг элемента JAXB.
    
    IllegalArgumentException - Если какой-либо из параметров метода является нулем
  - упорядочить
```
void marshal(Object jaxbElement,
           File output)
             throws JAXBException
```
    Упорядочьте дерево контента, базированное в jaxbElement в файл.
    
    Параметры:
    jaxbElement - Корень дерева контента, которое будет упорядочено.
    output - Файл, который будет записан. Если этот файл уже будет существовать, то он будет перезаписан.
    
    Броски:
    
    JAXBException - Если какая-либо неожиданная проблема происходит во время маршалинга.
    
    MarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Marshaller неспособен упорядочить obj (или любой объект, достижимый от obj). См. Маршалинг элемента JAXB.
    
    IllegalArgumentException - Если какой-либо из параметров метода является нулем
    С тех пор:
    
    JAXB2.1
  - упорядочить
```
void marshal(Object jaxbElement,
           Writer writer)
             throws JAXBException
```
    Упорядочьте дерево контента, базированное в jaxbElement в Писателя.
    
    Параметры:
    jaxbElement - Корень дерева контента, которое будет упорядочено.
    writer - XML будет отправлен этому писателю.
    
    Броски:
    
    JAXBException - Если какая-либо неожиданная проблема происходит во время маршалинга.
    
    MarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Marshaller неспособен упорядочить obj (или любой объект, достижимый от obj). См. Маршалинг элемента JAXB.
    
    IllegalArgumentException - Если какой-либо из параметров метода является нулем
  - упорядочить
```
void marshal(Object jaxbElement,
           ContentHandler handler)
             throws JAXBException
```
    Упорядочьте дерево контента, базированное в событиях jaxbElement into SAX2.
    
    Параметры:
    jaxbElement - Корень дерева контента, которое будет упорядочено.
    handler - XML будет отправлен этому обработчику как события SAX2.
    
    Броски:
    
    JAXBException - Если какая-либо неожиданная проблема происходит во время маршалинга.
    
    MarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Marshaller неспособен упорядочить obj (или любой объект, достижимый от obj). См. Маршалинг элемента JAXB.
    
    IllegalArgumentException - Если какой-либо из параметров метода является нулем
  - упорядочить
```
void marshal(Object jaxbElement,
           Node node)
             throws JAXBException
```
    Упорядочьте дерево контента, базированное в jaxbElement в дерево ДОМА.
    
    Параметры:
    jaxbElement - Дерево контента, которое будет упорядочено.
    node - Узлы ДОМА будут добавлены как дочерние элементы этого узла. Этим параметром должен быть Узел, который принимает дочерние элементы (Document, DocumentFragment, или Element)
    
    Броски:
    
    JAXBException - Если какая-либо неожиданная проблема происходит во время маршалинга.
    
    MarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Marshaller неспособен упорядочить jaxbElement (или любой объект, достижимый от jaxbElement). См. Маршалинг элемента JAXB.
    
    IllegalArgumentException - Если какой-либо из параметров метода является нулем
  - упорядочить
```
void marshal(Object jaxbElement,
           XMLStreamWriter writer)
             throws JAXBException
```
    Упорядочьте дерево контента, базированное в jaxbElement в a XMLStreamWriter.
    
    Параметры:
    jaxbElement - Дерево контента, которое будет упорядочено.
    writer - XML будет отправлен этому писателю.
    
    Броски:
    
    JAXBException - Если какая-либо неожиданная проблема происходит во время маршалинга.
    
    MarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Marshaller неспособен упорядочить obj (или любой объект, достижимый от obj). См. Маршалинг элемента JAXB.
    
    IllegalArgumentException - Если какой-либо из параметров метода является нулем
    С тех пор:
    
    JAXB 2.0
  - упорядочить
```
void marshal(Object jaxbElement,
           XMLEventWriter writer)
             throws JAXBException
```
    Упорядочьте дерево контента, базированное в jaxbElement в a XMLEventWriter.
    
    Параметры:
    jaxbElement - Дерево контента базировалось в jaxbElement, который будет упорядочен.
    writer - XML будет отправлен этому писателю.
    
    Броски:
    
    JAXBException - Если какая-либо неожиданная проблема происходит во время маршалинга.
    
    MarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Marshaller неспособен упорядочить obj (или любой объект, достижимый от obj). См. Маршалинг элемента JAXB.
    
    IllegalArgumentException - Если какой-либо из параметров метода является нулем
    С тех пор:
    
    JAXB 2.0
  - getNode
```
Node getNode(Object contentTree)
             throws JAXBException
```
    Получите структурный вид ДОМА (Дополнительного) дерева контента. Если возвращенное дерево ДОМА обновляется, эти изменения также видимы в дереве контента. Использовать marshal(Object, org.w3c.dom.Node) вызвать глубокую копию дерева контента к представлению ДОМА.
    
    Параметры:
    contentTree - Представление Java JAXB контента XML
    
    Возвраты:
    структурный вид ДОМА contentTree
    
    Броски:
    
    UnsupportedOperationException - Если реализация провайдера JAXB не поддерживает представление ДОМА дерева контента
    
    IllegalArgumentException - Если какой-либо из параметров метода является нулем
    
    JAXBException - Если какая-либо неожиданная проблема происходит
  - setProperty
```
void setProperty(String name,
               Object value)
                 throws PropertyException
```
    Установите определенное свойство в базовой реализации Marshaller. Этот метод может только использоваться, чтобы установить один из стандартных JAXB определенные свойства выше или провайдер определенное свойство. Попытка установить неопределенное свойство приведет к бросаемому PropertyException. См. Поддерживаемые Свойства.
    
    Параметры:
    name - имя свойства, которое будет установлено. Это значение может или быть определено, используя одно из постоянных полей или пользователя предоставленная строка.
    value - значение свойства, которое будет установлено
    
    Броски:
    
    PropertyException - когда есть ошибка, обрабатывая данное свойство или значение
    
    IllegalArgumentException - Если параметр имени является нулем
  - getProperty
```
Object getProperty(String name)
                   throws PropertyException
```
    Получите определенное свойство в базовой реализации Marshaller. Этот метод может только использоваться, чтобы получить один из стандартных JAXB определенные свойства выше или провайдер определенное свойство. Попытка получить неопределенное свойство приведет к бросаемому PropertyException. См. Поддерживаемые Свойства.
    
    Параметры:
    name - имя свойства, чтобы получить
    
    Возвраты:
    значение требуемого свойства
    
    Броски:
    
    PropertyException - когда есть ошибка, получая данное свойство или имя свойства значения
    
    IllegalArgumentException - Если параметр имени является нулем
  - setEventHandler
```
void setEventHandler(ValidationEventHandler handler)
                     throws JAXBException
```
    Позвольте приложению регистрировать обработчик событий проверки допустимости.
    Обработчик событий проверки допустимости вызовет Провайдер JAXB, если с какими-либо ошибками проверки допустимости встретятся во время звонков в какой-либо упорядочивать API. Если клиентское приложение не зарегистрирует обработчик событий проверки допустимости прежде, чем вызвать один из упорядочивать методов, то события проверки допустимости будут обработаны обработчиком стандартного события, который завершит упорядочивать работу после первой ошибки, или с фатальной ошибкой встречаются.
    Вызов этого метода с нулевым параметром заставит Marshaller возвращаться назад к обработчику стандартного события по умолчанию.
    
    Параметры:
    handler - обработчик событий проверки допустимости
    
    Броски:
    
    JAXBException - если с ошибкой встретились, устанавливая обработчик событий
  - getEventHandler
```
ValidationEventHandler getEventHandler()
                                       throws JAXBException
```
    Возвратите текущий обработчик событий или обработчик стандартного события, если Вы не были установлены.
    
    Возвраты:
    текущий ValidationEventHandler или обработчик стандартного события, если это не было установлено
    
    Броски:
    
    JAXBException - если с ошибкой встретились, получая текущий обработчик событий
  - setAdapter
```
void setAdapter(XmlAdapter adapter)
```
    Связывает сконфигурированный экземпляр XmlAdapter с этим marshaller.
    Это - метод удобства, который вызывает setAdapter(adapter.getClass(),adapter);.
    
    Броски:
    
    IllegalArgumentException - если параметр адаптера является нулем.
    
    UnsupportedOperationException - если вызвано agains JAXB 1.0 реализации.
    С тех пор:
    
    JAXB 2.0
    
    См. Также:
    setAdapter(Class,XmlAdapter)
  - setAdapter
```
<A extends XmlAdapter> void setAdapter(Class<A> type,
                                     A adapter)
```
    Связывает сконфигурированный экземпляр XmlAdapter с этим marshaller.
    Каждый marshaller внутренне поддерживает a Map<Class,XmlAdapter>, который это использует для того, чтобы упорядочить классы, поля/методы которых аннотируются XmlJavaTypeAdapter.
    Этот метод позволяет приложениям использовать сконфигурированный экземпляр XmlAdapter. Когда пример адаптера не будет приведен, marshaller создаст один, вызывая его конструктора по умолчанию.
    
    Параметры:
    type - Тип адаптера. Указанный экземпляр будет использоваться когда XmlJavaTypeAdapter.value() обращается к этому типу.
    adapter - Экземпляр адаптера, который будет использоваться. Если ноль, это незарегистрирует текущий набор адаптера для этого типа.
    
    Броски:
    
    IllegalArgumentException - если параметр типа является нулем.
    
    UnsupportedOperationException - если вызвано agains JAXB 1.0 реализации.
    С тех пор:
    
    JAXB 2.0
  - getAdapter
```
<A extends XmlAdapter> A getAdapter(Class<A> type)
```
    Связали адаптер с указанным типом. Это - обратная работа setAdapter(javax.xml.bind.annotation.adapters.XmlAdapter) метод.
    
    Броски:
    
    IllegalArgumentException - если параметр типа является нулем.
    
    UnsupportedOperationException - если вызвано agains JAXB 1.0 реализации.
    С тех пор:
    
    JAXB 2.0
  - setAttachmentMarshaller
```
void setAttachmentMarshaller(AttachmentMarshaller am)
```
    Свяжите контекст, который позволяет двоичным данным в пределах XML-документа быть переданными как двоичный файл XML оптимизированное присоединение. На присоединение ссылаются от модели контента XML-документа URI идентификатора контента (уголовный розыск) ссылки, сохраненные в пределах xml документа.
    
    Броски:
    
    IllegalStateException - если попытка одновременно вызвать этот метод во время упорядочивать работы.
  - getAttachmentMarshaller
```
AttachmentMarshaller getAttachmentMarshaller()
```
  - setSchema
```
void setSchema(Schema schema)
```
    Определите JAXP 1.3 Schema объект, который должен использоваться, чтобы проверить последующий, упорядочивает операции против. Передача нуля в этот метод отключит проверку допустимости.
    Этот метод позволяет вызывающей стороне проверять упорядоченного XML, поскольку это упорядочивается.
    Первоначально это свойство устанавливается в null.
    
    Параметры:
    schema - Объект схемы проверить упорядочивает операции против или нуль, чтобы отключить проверку допустимости
    
    Броски:
    
    UnsupportedOperationException - мог быть брошен, если этот метод вызывается на Marshaller, создаваемый из JAXBContext, ссылающегося на JAXB 1.0 отображенных класса
    С тех пор:
    
    JAXB2.0
  - getSchema
```
Schema getSchema()
```
    Получите JAXP 1.3 Schema объект, используемый, чтобы выполнить, упорядочивает разовую проверку допустимости. Если не будет никакого набора Схемы на marshaller, то этот метод возвратит нуль, указывающий, которые упорядочивают разовую проверку допустимости, не будет выполняться.
    
    Возвраты:
    объект Схемы, используемый, чтобы выполнить, упорядочивает разовую проверку допустимости или нуль если не существующий.
    
    Броски:
    
    UnsupportedOperationException - мог быть брошен, если этот метод вызывается на Marshaller, создаваемый из JAXBContext, ссылающегося на JAXB 1.0 отображенных класса
    С тех пор:
    
    JAXB2.0
  - setListener
```
void setListener(Marshaller.Listener listener)
```
    Регистр упорядочивает обратный вызов события Marshaller.Listener с этим Marshaller.
    Есть только один Слушатель на Marshaller. Установка Слушателя заменяет предыдущего Слушателя набора. Можно незарегистрировать текущего Слушателя, устанавливая слушателя null.
    
    Параметры:
    listener - экземпляр класса, который реализует Marshaller.Listener
    С тех пор:
    
    JAXB2.0
  - getListener
```
Marshaller.Listener getListener()
```
    Возвратиться Marshaller.Listener зарегистрированный в этом Marshaller.
    
    Возвраты:
    зарегистрированный Marshaller.Listener или null если никакой Слушатель не регистрируется в этом Marshaller.
    С тех пор:
    
    JAXB2.0

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

Интерфейсный Marshaller

Вложенная Сводка Класса

Полевая Сводка

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

Полевая Деталь

JAXB_ENCODING

JAXB_FORMATTED_OUTPUT

JAXB_SCHEMA_LOCATION

JAXB_NO_NAMESPACE_SCHEMA_LOCATION

JAXB_FRAGMENT

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

упорядочить

упорядочить

упорядочить

упорядочить

упорядочить

упорядочить

упорядочить

упорядочить

getNode

setProperty

getProperty

setEventHandler

getEventHandler

setAdapter

setAdapter

getAdapter

setAttachmentMarshaller

getAttachmentMarshaller

setSchema

getSchema

setListener

getListener