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

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

public interface Unmarshaller

Класс Unmarshaller управляет процессом десериализации данных XML в недавно создаваемые деревья контента Java, дополнительно проверяя данных XML, поскольку это неупорядочивается. Это обеспечивает, перегрузка неупорядочивают методы для многих различных входных видов.

Немаршалинг от Файла:

       JAXBContext jc = JAXBContext.newInstance( "com.acme.foo" );
       Unmarshaller u = jc.createUnmarshaller();
       Object o = u.unmarshal( new File( "nosferatu.xml" ) );

Немаршалинг от InputStream:

       InputStream is = new FileInputStream( "nosferatu.xml" );
       JAXBContext jc = JAXBContext.newInstance( "com.acme.foo" );
       Unmarshaller u = jc.createUnmarshaller();
       Object o = u.unmarshal( is );

Немаршалинг от URL:

       JAXBContext jc = JAXBContext.newInstance( "com.acme.foo" );
       Unmarshaller u = jc.createUnmarshaller();
       URL url = new URL( "http://beaker.east/nosferatu.xml" );
       Object o = u.unmarshal( url );

Немаршалинг от StringBuffer, используя javax.xml.transform.stream.StreamSource:

       JAXBContext jc = JAXBContext.newInstance( "com.acme.foo" );
       Unmarshaller u = jc.createUnmarshaller();
       StringBuffer xmlStr = new StringBuffer( "<?xml version="1.0"?>..." );
       Object o = u.unmarshal( new StreamSource( new StringReader( xmlStr.toString() ) ) );

Немаршалинг от org.w3c.dom.Node:

       JAXBContext jc = JAXBContext.newInstance( "com.acme.foo" );
       Unmarshaller u = jc.createUnmarshaller();

       DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
       dbf.setNamespaceAware(true);
       DocumentBuilder db = dbf.newDocumentBuilder();
       Document doc = db.parse(new File( "nosferatu.xml"));

       Object o = u.unmarshal( doc );

Немаршалинг от javax.xml.transform.sax.SAXSource, используя клиент определил проверку допустимости синтаксический анализатор SAX2.0:

       // configure a validating SAX2.0 parser (Xerces2)
       static final String JAXP_SCHEMA_LANGUAGE =
           "http://java.sun.com/xml/jaxp/properties/schemaLanguage";
       static final String JAXP_SCHEMA_LOCATION =
           "http://java.sun.com/xml/jaxp/properties/schemaSource";
       static final String W3C_XML_SCHEMA =
           "http://www.w3.org/2001/XMLSchema";

       System.setProperty( "javax.xml.parsers.SAXParserFactory",
                           "org.apache.xerces.jaxp.SAXParserFactoryImpl" );

       SAXParserFactory spf = SAXParserFactory.newInstance();
       spf.setNamespaceAware(true);
       spf.setValidating(true);
       SAXParser saxParser = spf.newSAXParser();

       try {
           saxParser.setProperty(JAXP_SCHEMA_LANGUAGE, W3C_XML_SCHEMA);
           saxParser.setProperty(JAXP_SCHEMA_LOCATION, "http://....");
       } catch (SAXNotRecognizedException x) {
           // exception handling omitted
       }

       XMLReader xmlReader = saxParser.getXMLReader();
       SAXSource source =
           new SAXSource( xmlReader, new InputSource( "http://..." ) );

       // Setup JAXB to unmarshal
       JAXBContext jc = JAXBContext.newInstance( "com.acme.foo" );
       Unmarshaller u = jc.createUnmarshaller();
       ValidationEventCollector vec = new ValidationEventCollector();
       u.setEventHandler( vec );

       // turn off the JAXB provider's default validation mechanism to
       // avoid duplicate validation
       u.setValidating( false )

       // unmarshal
       Object o = u.unmarshal( source );

       // check for events
       if( vec.hasEvents() ) {
          // iterate over events
       }

Немаршалинг от StAX XMLStreamReader:

       JAXBContext jc = JAXBContext.newInstance( "com.acme.foo" );
       Unmarshaller u = jc.createUnmarshaller();

       javax.xml.stream.XMLStreamReader xmlStreamReader =
           javax.xml.stream.XMLInputFactory().newInstance().createXMLStreamReader( ... );

       Object o = u.unmarshal( xmlStreamReader );

Немаршалинг от StAX XMLEventReader:

       JAXBContext jc = JAXBContext.newInstance( "com.acme.foo" );
       Unmarshaller u = jc.createUnmarshaller();

       javax.xml.stream.XMLEventReader xmlEventReader =
           javax.xml.stream.XMLInputFactory().newInstance().createXMLEventReader( ... );

       Object o = u.unmarshal( xmlEventReader );

Немаршалинг Данных XML

Немаршалинг может десериализовать данные XML, который представляет или весь XML-документ или поддерево XML-документа. Как правило, достаточно использовать методы немаршалинга, описанные, Неупорядочивают корневой элемент, который объявляется глобально. Они неупорядочивают методы, используют JAXBContext's отображение глобальных объявлений элемента XML и определений типа JAXB отображенные классы, чтобы инициировать немаршалинг корневого элемента данных XML. Когда JAXBContext's отображения не достаточны, чтобы неупорядочить корневой элемент данных XML, приложение может помочь процессу немаршалинга при использовании неупорядочивания по declaredType методам. Эти методы полезны для немаршалинга данных XML, где корневой элемент соответствует локальному объявлению элемента в схеме.

Неупорядочивать метод никогда не возвращает нуль. Если неупорядочивать процесс неспособен неупорядочить корень контента XML к JAXB отображенный объект, о фатальной ошибке сообщают, который завершает обработку, бросая JAXBException.

Неупорядочьте корневой элемент, который глобально объявляется

Неупорядочивать методы, у которых нет использования параметра declaredType JAXBContext неупорядочивать корневой элемент данные XML. JAXBContext экземпляр является тем, который использовался, чтобы создать этот Unmarshaller. JAXBContext экземпляр поддерживает отображение глобально объявленного элемента XML, и введите имена определения к JAXB отображенные классы. Неупорядочивать метод проверяет если JAXBContext имеет отображение с имени XML корневого элемента и/или @xsi:type к JAXB отображенный класс. Если это делает, это umarshalls данные XML, используя соответствующий JAXB отображенный класс. Отметьте, что, когда корневое имя элемента неизвестно и у корневого элемента есть @xsi:type, данные XML неупорядочивается, используя это JAXB отображенный класс как значение a JAXBElement. Когда JAXBContext у объекта нет отображения для имени корневого элемента, ни его @xsi:type, если это будет существовать, тогда то неупорядочивать работа сразу прервется, бросая a UnmarshalException. Этот сценарий исключения может работаться вокруг при использовании неупорядочивания по declaredType методам, описанным в следующем подразделе.

Неупорядочьте по Объявленному Типу

Неупорядочивать методы с a declaredType включение параметра приложение, чтобы десериализовать корневой элемент данных XML, даже когда нет никакого отображения в JAXBContext из имени XML корневого элемента. unmarshaller неупорядочивает корневой элемент, используя обеспеченное отображение приложения, определенное как параметр declaredType. Отметьте это, даже когда имя элемента корневого элемента отображается JAXBContext, declaredType переопределения параметра, что отображение для того, чтобы десериализовать корневой элемент при использовании их неупорядочивает методы. Дополнительно, когда у корневого элемента данных XML есть атрибут xsi:type и что значение атрибута ссылается на определение типа, которое отображается на JAXB отображенный класс JAXBContext, то, что атрибут xsi:type корневого элемента имеет приоритет по неупорядочивать параметру методов declaredType. Эти методы всегда возвращают экземпляр JAXBElement<declaredType>. Таблица ниже шоу, как свойства возвращенного экземпляра JAXBElement устанавливаются.

Неупорядочьте По Объявленному Типу возвращенный JAXBElement

Свойство JAXBElement Значение

имя xml element name

значение instanceof declaredType

declaredType неупорядочьте метод declaredType параметр

контекст null (фактический контекст неизвестен),

Неупорядочьте По Объявленному Типу возвращенный JAXBElement
значение	`instanceof declaredType`
declaredType	неупорядочьте метод `declaredType` параметр
контекст	`null` (фактический контекст неизвестен),

Следующее является примером, неупорядочивают по declaredType методу.

Неупорядочьте по declaredType от org.w3c.dom.Node:

       Schema fragment for example
       <xs:schema>
          <xs:complexType name="FooType">...<\xs:complexType>
          <!-- global element declaration "PurchaseOrder" -->
          <xs:element name="PurchaseOrder">
              <xs:complexType>
                 <xs:sequence>
                    <!-- local element declaration "foo" -->
                    <xs:element name="foo" type="FooType"/>
                    ...
                 </xs:sequence>
              </xs:complexType>
          </xs:element>
       </xs:schema>

       JAXBContext jc = JAXBContext.newInstance( "com.acme.foo" );
       Unmarshaller u = jc.createUnmarshaller();

       DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
       dbf.setNamespaceAware(true);
       DocumentBuilder db = dbf.newDocumentBuilder();
       Document doc = db.parse(new File( "nosferatu.xml"));
       Element  fooSubtree = ...; // traverse DOM till reach xml element foo, constrained by a
                                  // local element declaration in schema.

       // FooType is the JAXB mapping of the type of local element declaration foo.
       JAXBElement<FooType> foo = u.unmarshal( fooSubtree, FooType.class);

Поддержка Совместимых Синтаксических анализаторов SAX2.0

У клиентского приложения есть возможность выбрать совместимый синтаксический анализатор SAX2.0 их выбора. Если синтаксический анализатор SAX не будет выбран, то синтаксический анализатор Провайдера JAXB по умолчанию будет использоваться. Даже при том, что синтаксический анализатор Провайдера JAXB по умолчанию не обязан быть SAX2.0 совместимый, все провайдеры обязаны позволять клиентскому приложению определять их собственный синтаксический анализатор SAX2.0. Некоторые провайдеры могут потребовать, чтобы клиентское приложение определило синтаксический анализатор SAX2.0 во время компиляции схемы. См. unmarshal(Source) для большего количества детали.

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

Клиентское приложение может включить или отключить JAXP 1.3 механизма проверки допустимости через API setSchema(javax.xml.validation.Schema). Сложные клиенты могут определить свой собственный SAX проверки допустимости 2.0 совместимых синтаксических анализатора и обойти JAXP 1.3 механизма проверки допустимости, используя unmarshal(Source) API.
Начиная с немаршалинга недопустимого контента XML определяется в JAXB 2.0, обработчик событий проверки допустимости значения по умолчанию Unmarshaller был сделан более снисходительным чем в JAXB 1.0. Когда полученный из схемы код, сгенерированный JAXB 1.0 обязательных компилятора, регистрируется в JAXBContext, значение по умолчанию неупорядочивает обработчик проверки допустимости, DefaultValidationEventHandler и это завершает упорядочивать работу после обнаружения или фатальная ошибка или ошибка. Для JAXB 2.0 клиентских приложения нет никакого явно определенного обработчика проверки допустимости по умолчанию, и стандартное событие, обрабатывающее только, завершает упорядочивать работу после обнаружения с фатальной ошибкой.

Поддерживаемые Свойства

В настоящий момент нет никаких свойств, требуемых поддерживаться всеми Провайдерами JAXB на Unmarshaller. Однако, некоторые провайдеры могут поддерживать свой собственный набор провайдера определенные свойства.

Неупорядочьте Обратные вызовы События

Unmarshaller обеспечивает два стиля механизмов обратного вызова, которые позволяют специализированную обработку во время ключевых пунктов в процессе немаршалинга. В 'классе определенные' обратные вызовы события специализированный код, помещенный в JAXB отображенные классы, инициирован во время немаршалинга. 'Внешние слушатели' учитывают централизованную обработку, неупорядочивают события в одном методе обратного вызова, а не обратными вызовами события типа.
Методы обратного вызова события 'Class defined' позволяют любому JAXB отображенный класс, чтобы определить его собственные определенные методы обратного вызова, определяя методы с помощью следующей сигнатуры метода:
   // This method is called immediately after the object is created and before the unmarshalling of this
   // object begins. The callback provides an opportunity to initialize JavaBean properties prior to unmarshalling.
   void beforeUnmarshal(Unmarshaller, Object parent);

   //This method is called after all the properties (except IDREF) are unmarshalled for this object,
   //but before this object is set to the parent object.
   void afterUnmarshal(Unmarshaller, Object parent);
 
Определенные методы обратного вызова класса должны использоваться, когда метод обратного вызова требует доступа к непубличным методам и/или полям класса.
Внешний механизм обратного вызова слушателя включает регистрации a Unmarshaller.Listener экземпляр с setListener(Listener). Внешний слушатель получает все события обратного вызова, учитывая более централизованную обработку чем на класс определенные методы обратного вызова. Внешний слушатель получает события, когда немаршалинг proces упорядочивает к элементу JAXB или к JAXB отображенный класс.
'Класс определенные' и внешние методы обратного вызова события слушателя независимы друг от друга, обоих можно вызвать для одного события. Упорядочивание вызова, когда оба метода обратного вызова слушателя существуют, определяется в Unmarshaller.Listener.beforeUnmarshal(Object, Object) и Unmarshaller.Listener.afterUnmarshal(Object, Object).
Метод обратного вызова события, выдающий исключение, завершается, ток неупорядочивают процесс.

С тех пор:: JAXB1.0
См. Также:: JAXBContext, Marshaller, Validator

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

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

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

Методы
Модификатор и Тип	Метод и Описание
`<A extends XmlAdapter> A`	`getAdapter(Class<A> type)` Связали адаптер с указанным типом.
`AttachmentUnmarshaller`	`getAttachmentUnmarshaller()`
`ValidationEventHandler`	`getEventHandler()` Возвратите текущий обработчик событий или обработчик стандартного события, если Вы не были установлены.
`Unmarshaller. Слушатель`	`getListener()` Возвратиться `Unmarshaller.Listener` зарегистрированный в этом `Unmarshaller`.
`Объект`	`getProperty(String name)` Получите определенное свойство в базовой реализации `Unmarshaller`.
`Схема`	`getSchema()` Получите JAXP 1.3 `Schema` объект, используемый, чтобы выполнить, неупорядочивает разовую проверку допустимости.
`UnmarshallerHandler`	`getUnmarshallerHandler()` Получите unmarshaller объект-обработчик, который может использоваться в качестве компонента в конвейере XML.
`boolean`	`isValidating()` Осуждаемый. начиная с JAXB2.0, пожалуйста, см. `getSchema()`
`<A extends XmlAdapter> void`	`setAdapter(Class<A> type, A adapter)` Связывает сконфигурированный экземпляр `XmlAdapter` с этим unmarshaller.
`void`	`setAdapter(XmlAdapter adapter)` Связывает сконфигурированный экземпляр `XmlAdapter` с этим unmarshaller.
`void`	`setAttachmentUnmarshaller(AttachmentUnmarshaller au)` Свяжите контекст, который разрешает уголовного розыска, URI идентификатора контента, к двоичным данным, которых передают как присоединения.
`void`	`setEventHandler(ValidationEventHandler handler)` Позвольте приложению регистрировать `ValidationEventHandler`.
`void`	`setListener(Unmarshaller.Listener listener)` Регистр неупорядочивает обратный вызов события `Unmarshaller.Listener` с этим `Unmarshaller`.
`void`	`setProperty(String name, Object value)` Установите определенное свойство в базовой реализации `Unmarshaller`.
`void`	`setSchema(Schema schema)` Определите JAXP 1.3 `Schema` объект, который должен использоваться, чтобы проверить последующий, неупорядочивает операции против.
`void`	`setValidating(boolean validating)` Осуждаемый. начиная с JAXB2.0, пожалуйста, см. `setSchema(javax.xml.validation.Schema)`
`Объект`	`unmarshal(File f)` Неупорядочьте данные XML от указанного файла и возвратите получающееся дерево контента.
`Объект`	`unmarshal(InputSource source)` Неупорядочьте данные XML от указанного SAX InputSource и возвратите получающееся дерево контента.
`Объект`	`unmarshal(InputStream is)` Неупорядочьте данные XML от указанного InputStream и возвратите получающееся дерево контента.
`Объект`	`unmarshal(Node node)` Неупорядочьте глобальные данные XML от указанного дерева ДОМА и возвратите получающееся дерево контента.
`<T> JAXBElement<T>`	`unmarshal(Node node, Class<T> declaredType)` Неупорядочьте данные XML по JAXB отображенный `declaredType` и возвратите получающееся дерево контента.
`Объект`	`unmarshal(Reader reader)` Неупорядочьте данные XML от указанного Читателя и возвратите получающееся дерево контента.
`Объект`	`unmarshal(Source source)` Неупорядочьте данные XML из указанного XML Источник и возвратите получающееся дерево контента.
`<T> JAXBElement<T>`	`unmarshal(Source source, Class<T> declaredType)` Неупорядочьте данные XML из указанного XML Источник `declaredType` и возвратите получающееся дерево контента.
`Объект`	`unmarshal(URL url)` Неупорядочьте данные XML от указанного URL и возвратите получающееся дерево контента.
`Объект`	`unmarshal(XMLEventReader reader)` Неупорядочьте данные XML от указанного синтаксического анализатора получения по запросу и возвратите получающееся дерево контента.
`<T> JAXBElement<T>`	`unmarshal(XMLEventReader reader, Class<T> declaredType)` Неупорядочьте корневой элемент к JAXB отображенный `declaredType` и возвратите получающееся дерево контента.
`Объект`	`unmarshal(XMLStreamReader reader)` Неупорядочьте данные XML от указанного синтаксического анализатора получения по запросу и возвратите получающееся дерево контента.
`<T> JAXBElement<T>`	`unmarshal(XMLStreamReader reader, Class<T> declaredType)` Неупорядочьте корневой элемент к JAXB отображенный `declaredType` и возвратите получающееся дерево контента.

- Деталь метода
  - неупорядочить
```
Object unmarshal(File f)
                 throws JAXBException
```
    Неупорядочьте данные XML от указанного файла и возвратите получающееся дерево контента.
    Реализации Неупорядочивают Глобальный Корневой Элемент.
    
    Параметры:
    f - файл, чтобы неупорядочить данные XML от
    
    Возвраты:
    недавно создаваемый корневой объект дерева контента java
    
    Броски:
    
    JAXBException - Если какие-либо неожиданные ошибки происходят, неупорядочивая
    
    UnmarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Немаршалинг Данных XML
    
    IllegalArgumentException - Если параметр файла является нулем
  - неупорядочить
```
Object unmarshal(InputStream is)
                 throws JAXBException
```
    Неупорядочьте данные XML от указанного InputStream и возвратите получающееся дерево контента. Информация о расположении события проверки допустимости может быть неполной при использовании этой формы неупорядочивать API.
    Реализации Неупорядочивают Глобальный Корневой Элемент.
    
    Параметры:
    is - InputStream, чтобы неупорядочить данные XML от
    
    Возвраты:
    недавно создаваемый корневой объект дерева контента java
    
    Броски:
    
    JAXBException - Если какие-либо неожиданные ошибки происходят, неупорядочивая
    
    UnmarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Немаршалинг Данных XML
    
    IllegalArgumentException - Если параметр InputStream является нулем
  - неупорядочить
```
Object unmarshal(Reader reader)
                 throws JAXBException
```
    Неупорядочьте данные XML от указанного Читателя и возвратите получающееся дерево контента. Информация о расположении события проверки допустимости может быть неполной при использовании этой формы неупорядочивать API, потому что Читатель не обеспечивает системный ID.
    Реализации Неупорядочивают Глобальный Корневой Элемент.
    
    Параметры:
    reader - Читатель, чтобы неупорядочить данные XML от
    
    Возвраты:
    недавно создаваемый корневой объект дерева контента java
    
    Броски:
    
    JAXBException - Если какие-либо неожиданные ошибки происходят, неупорядочивая
    
    UnmarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Немаршалинг Данных XML
    
    IllegalArgumentException - Если параметр InputStream является нулем
    С тех пор:
    
    JAXB2.0
  - неупорядочить
```
Object unmarshal(URL url)
                 throws JAXBException
```
    Неупорядочьте данные XML от указанного URL и возвратите получающееся дерево контента.
    Реализации Неупорядочивают Глобальный Корневой Элемент.
    
    Параметры:
    url - url, чтобы неупорядочить данные XML от
    
    Возвраты:
    недавно создаваемый корневой объект дерева контента java
    
    Броски:
    
    JAXBException - Если какие-либо неожиданные ошибки происходят, неупорядочивая
    
    UnmarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Немаршалинг Данных XML
    
    IllegalArgumentException - Если параметр URL является нулем
  - неупорядочить
```
Object unmarshal(InputSource source)
                 throws JAXBException
```
    Неупорядочьте данные XML от указанного SAX InputSource и возвратите получающееся дерево контента.
    Реализации Неупорядочивают Глобальный Корневой Элемент.
    
    Параметры:
    source - входной источник, чтобы неупорядочить данные XML от
    
    Возвраты:
    недавно создаваемый корневой объект дерева контента java
    
    Броски:
    
    JAXBException - Если какие-либо неожиданные ошибки происходят, неупорядочивая
    
    UnmarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Немаршалинг Данных XML
    
    IllegalArgumentException - Если параметр InputSource является нулем
  - неупорядочить
```
Object unmarshal(Node node)
                 throws JAXBException
```
    Неупорядочьте глобальные данные XML от указанного дерева ДОМА и возвратите получающееся дерево контента.
    Реализации Неупорядочивают Глобальный Корневой Элемент.
    
    Параметры:
    node - документ/элемент, чтобы неупорядочить данные XML от. Вызывающая сторона должна поддерживать, по крайней мере, Документ и Элемент.
    
    Возвраты:
    недавно создаваемый корневой объект дерева контента java
    
    Броски:
    
    JAXBException - Если какие-либо неожиданные ошибки происходят, неупорядочивая
    
    UnmarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Немаршалинг Данных XML
    
    IllegalArgumentException - Если параметр Узла является нулем
    См. Также:
    unmarshal(org.w3c.dom.Node, Class)
  - неупорядочить
```
<T> JAXBElement<T> unmarshal(Node node,
                           Class<T> declaredType)
                         throws JAXBException
```
    Неупорядочьте данные XML по JAXB отображенный declaredType и возвратите получающееся дерево контента.
    Реализации Неупорядочивают по Объявленному Типу
    
    Параметры:
    node - документ/элемент, чтобы неупорядочить данные XML от. Вызывающая сторона должна поддерживать, по крайней мере, Документ и Элемент.
    declaredType - приспособьте JAXB отображенный класс, чтобы содержать данные XML node.
    
    Возвраты:
    Представление Элемента JAXB node
    
    Броски:
    
    JAXBException - Если какие-либо неожиданные ошибки происходят, неупорядочивая
    
    UnmarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Немаршалинг Данных XML
    
    IllegalArgumentException - Если какой-либо параметр является нулем
    С тех пор:
    
    JAXB2.0
  - неупорядочить
```
Object unmarshal(Source source)
                 throws JAXBException
```
    Неупорядочьте данные XML из указанного XML Источник и возвратите получающееся дерево контента.
    Реализации Неупорядочивают Глобальный Корневой Элемент.
    SAX 2.0 Синтаксических анализатора Pluggability
    Клиентское приложение может хотеть не использовать механизм синтаксического анализатора по умолчанию, предоставленный их провайдером JAXB. Любым SAX 2.0 совместимых синтаксических анализатора можно заменить механизм провайдера JAXB по умолчанию. Чтобы сделать так, клиентское приложение должно должным образом сконфигурировать SAXSource, содержащий XMLReader, реализованный SAX 2.0 провайдера синтаксического анализатора. Если XMLReader зарегистрируют org.xml.sax.ErrorHandler на этом, то это будет заменено Провайдером JAXB так, чтобы об ошибках проверки допустимости можно было сообщить через механизм ValidationEventHandler JAXB. Если SAXSource не будет содержать XMLReader, то механизм синтаксического анализатора провайдера JAXB по умолчанию будет использоваться.
    Этот заменяющий механизм синтаксического анализатора может также использоваться, чтобы заменить провайдера JAXB, неупорядочивают разовый механизм проверки допустимости. Клиентское приложение должно должным образом сконфигурировать их SAX 2.0 совместимых синтаксических анализатора, чтобы выполнить проверку допустимости (как показано в примере выше). Любой SAXParserExceptions , с которым встречается синтаксический анализатор во время неупорядочивать работы, будет обработан провайдером JAXB и преобразован в объекты ValidationEvent JAXB, которые отчитаются клиенту через ValidationEventHandler, зарегистрированный в Unmarshaller. Отметьте: определение SAX проверки допустимости замены 2.0 синтаксических анализатора для того, чтобы неупорядочить не обязательно заменяет механизм проверки допустимости, используемый провайдером JAXB для того, чтобы выполнить по требованию проверку допустимости.
    Единственный путь к клиентскому приложению, чтобы определить альтернативный механизм синтаксического анализатора, который будет использоваться во время, неупорядочивает, через API unmarshal(SAXSource). Все другие формы неупорядочивать метода (Файл, URL, Узел, и т.д.) будут использовать синтаксический анализатор провайдера JAXB по умолчанию и механизмы блока проверки допустимости.
    
    Параметры:
    source - XML Источник, чтобы неупорядочить данные XML от (провайдеры только обязаны поддерживать SAXSource, DOMSource, и StreamSource),
    
    Возвраты:
    недавно создаваемый корневой объект дерева контента java
    
    Броски:
    
    JAXBException - Если какие-либо неожиданные ошибки происходят, неупорядочивая
    
    UnmarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Немаршалинг Данных XML
    
    IllegalArgumentException - Если Исходный параметр является нулем
    См. Также:
    unmarshal(javax.xml.transform.Source, Class)
  - неупорядочить
```
<T> JAXBElement<T> unmarshal(Source source,
                           Class<T> declaredType)
                         throws JAXBException
```
    Неупорядочьте данные XML из указанного XML Источник declaredType и возвратите получающееся дерево контента.
    Реализации Неупорядочивают по Объявленному Типу
    См. SAX 2.0 Синтаксических анализатора Pluggability
    
    Параметры:
    source - XML Источник, чтобы неупорядочить данные XML от (провайдеры только обязаны поддерживать SAXSource, DOMSource, и StreamSource),
    declaredType - приспособьте JAXB отображенный класс, чтобы содержать корневой элемент xml source
    
    Возвраты:
    Контент Java базировался Элементом JAXB
    
    Броски:
    
    JAXBException - Если какие-либо неожиданные ошибки происходят, неупорядочивая
    
    UnmarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Немаршалинг Данных XML
    
    IllegalArgumentException - Если какой-либо параметр является нулем
    С тех пор:
    
    JAXB2.0
  - неупорядочить
```
Object unmarshal(XMLStreamReader reader)
                 throws JAXBException
```
    Неупорядочьте данные XML от указанного синтаксического анализатора получения по запросу и возвратите получающееся дерево контента.
    Реализации Неупорядочивают Глобальный Корневой Элемент.
    Этот метод предполагает, что синтаксический анализатор находится на событии START_DOCUMENT ИЛИ START_ELEMENT. Немаршалинг будет сделан от этого события запуска до соответствующего события конца. Если этот метод возвратится успешно, то reader будет указывать на маркер прямо после события конца.
    
    Параметры:
    reader - Синтаксический анализатор, который будет считан.
    
    Возвраты:
    недавно создаваемый корневой объект дерева контента java.
    
    Броски:
    
    JAXBException - Если какие-либо неожиданные ошибки происходят, неупорядочивая
    
    UnmarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Немаршалинг Данных XML
    
    IllegalArgumentException - Если параметр reader является нулем
    
    IllegalStateException - Если reader не указывает на событие START_DOCUMENT ИЛИ START_ELEMENT.
    С тех пор:
    
    JAXB2.0
    
    См. Также:
    unmarshal(javax.xml.stream.XMLStreamReader, Class)
  - неупорядочить
```
<T> JAXBElement<T> unmarshal(XMLStreamReader reader,
                           Class<T> declaredType)
                         throws JAXBException
```
    Неупорядочьте корневой элемент к JAXB отображенный declaredType и возвратите получающееся дерево контента.
    Этот метод реализации неупорядочивает по declaredType.
    Этот метод предполагает, что синтаксический анализатор находится на событии START_DOCUMENT ИЛИ START_ELEMENT. Немаршалинг будет сделан от этого события запуска до соответствующего события конца. Если этот метод возвратится успешно, то reader будет указывать на маркер прямо после события конца.
    
    Параметры:
    reader - Синтаксический анализатор, который будет считан.
    declaredType - приспособьте JAXB отображенный класс, чтобы содержать данные XML reader START_ELEMENT.
    
    Возвраты:
    дерево контента базировалось представлением Элемента JAXB
    
    Броски:
    
    JAXBException - Если какие-либо неожиданные ошибки происходят, неупорядочивая
    
    UnmarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Немаршалинг Данных XML
    
    IllegalArgumentException - Если какой-либо параметр является нулем
    С тех пор:
    
    JAXB2.0
  - неупорядочить
```
Object unmarshal(XMLEventReader reader)
                 throws JAXBException
```
    Неупорядочьте данные XML от указанного синтаксического анализатора получения по запросу и возвратите получающееся дерево контента.
    Этот метод является методом Unmarshal Global Root.
    Этот метод предполагает, что синтаксический анализатор находится на событии START_DOCUMENT ИЛИ START_ELEMENT. Немаршалинг будет сделан от этого события запуска до соответствующего события конца. Если этот метод возвратится успешно, то reader будет указывать на маркер прямо после события конца.
    
    Параметры:
    reader - Синтаксический анализатор, который будет считан.
    
    Возвраты:
    недавно создаваемый корневой объект дерева контента java.
    
    Броски:
    
    JAXBException - Если какие-либо неожиданные ошибки происходят, неупорядочивая
    
    UnmarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Немаршалинг Данных XML
    
    IllegalArgumentException - Если параметр reader является нулем
    
    IllegalStateException - Если reader не указывает на событие START_DOCUMENT ИЛИ START_ELEMENT.
    С тех пор:
    
    JAXB2.0
    
    См. Также:
    unmarshal(javax.xml.stream.XMLEventReader, Class)
  - неупорядочить
```
<T> JAXBElement<T> unmarshal(XMLEventReader reader,
                           Class<T> declaredType)
                         throws JAXBException
```
    Неупорядочьте корневой элемент к JAXB отображенный declaredType и возвратите получающееся дерево контента.
    Этот метод реализации неупорядочивает по declaredType.
    Этот метод предполагает, что синтаксический анализатор находится на событии START_DOCUMENT ИЛИ START_ELEMENT. Немаршалинг будет сделан от этого события запуска до соответствующего события конца. Если этот метод возвратится успешно, то reader будет указывать на маркер прямо после события конца.
    
    Параметры:
    reader - Синтаксический анализатор, который будет считан.
    declaredType - приспособьте JAXB отображенный класс, чтобы содержать данные XML reader START_ELEMENT.
    
    Возвраты:
    дерево контента базировалось представлением Элемента JAXB
    
    Броски:
    
    JAXBException - Если какие-либо неожиданные ошибки происходят, неупорядочивая
    
    UnmarshalException - Если ValidationEventHandler возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Немаршалинг Данных XML
    
    IllegalArgumentException - Если какой-либо параметр является нулем
    С тех пор:
    
    JAXB2.0
  - getUnmarshallerHandler
```
UnmarshallerHandler getUnmarshallerHandler()
```
    Получите unmarshaller объект-обработчик, который может использоваться в качестве компонента в конвейере XML.
    Провайдер JAXB может возвратить тот же самый объект-обработчик для многократных вызовов этого метода. Другими словами этот метод не обязательно создает новый экземпляр UnmarshallerHandler. Если приложение должно использовать больше чем один UnmarshallerHandler, оно должно создать больше чем один Unmarshaller.
    
    Возвраты:
    unmarshaller объект-обработчик
    См. Также:
    UnmarshallerHandler
  - setValidating
```
void setValidating(boolean validating)
                   throws JAXBException
```
    Осуждаемый. начиная с JAXB2.0, пожалуйста, см. setSchema(javax.xml.validation.Schema)
    
    Определяет, должен ли механизм проверки допустимости по умолчанию Unmarshaller проверить во время, неупорядочивают операции. По умолчанию Unmarshaller не проверяет.
    Этот метод может только быть вызван прежде или после вызова одного из неупорядочивать методов.
    Этот метод только управляет значением по умолчанию Провайдера JAXB, неупорядочивают разовый механизм проверки допустимости - это не оказывает влияния на клиенты, которые определяют их собственный SAX проверки допустимости 2.0 совместимых синтаксических анализатора. Клиенты, которые определяют их собственное, неупорядочивают разовый механизм проверки допустимости, может хотеть выключить механизм проверки допустимости Провайдера JAXB по умолчанию через этот API, чтобы избежать "двойной проверки допустимости".
    Этот метод осуждается с JAXB 2.0 - пожалуйста, используйте новое setSchema(javax.xml.validation.Schema) API.
    
    Параметры:
    validating - истина, если Unmarshaller должен проверить во время, неупорядочивает, ложь иначе
    
    Броски:
    
    JAXBException - если ошибка произошла, в то время как включение или отключение проверки допустимости в неупорядочивают время
    
    UnsupportedOperationException - мог быть брошен, если этот метод вызывается на Unmarshaller, создаваемый из JAXBContext, ссылающегося на JAXB 2.0 отображенных класса
  - isValidating
```
boolean isValidating()
                     throws JAXBException
```
    Осуждаемый. начиная с JAXB2.0, пожалуйста, см. getSchema()
    
    Указывает, конфигурируется ли Unmarshaller, чтобы проверить во время, неупорядочивают операции.
    Этот API возвращается, состояние значения по умолчанию Провайдера JAXB неупорядочивают разовый механизм проверки допустимости.
    Этот метод осуждается с JAXB 2.0 - пожалуйста, используйте новое getSchema() API.
    
    Возвраты:
    истина, если Unmarshaller конфигурируется, чтобы проверить во время, неупорядочивает операции, ложь иначе
    
    Броски:
    
    JAXBException - если ошибка происходит, получая флаг проверки допустимости
    
    UnsupportedOperationException - мог быть брошен, если этот метод вызывается на Unmarshaller, создаваемый из JAXBContext, ссылающегося на JAXB 2.0 отображенных класса
  - setEventHandler
```
void setEventHandler(ValidationEventHandler handler)
                     throws JAXBException
```
    Позвольте приложению регистрировать ValidationEventHandler.
    ValidationEventHandler вызовет Провайдер JAXB, если с какими-либо ошибками проверки допустимости встретятся во время звонков в какой-либо из неупорядочивать методов. Если клиентское приложение не зарегистрирует ValidationEventHandler прежде, чем вызвать неупорядочивать методы, то ValidationEvents будет обработан обработчиком стандартного события, который завершит неупорядочивать работу после первой ошибки, или с фатальной ошибкой встречаются.
    Вызов этого метода с нулевым параметром заставит Unmarshaller возвращаться назад к обработчику стандартного события.
    
    Параметры:
    handler - обработчик событий проверки допустимости
    
    Броски:
    
    JAXBException - если с ошибкой встретились, устанавливая обработчик событий
  - getEventHandler
```
ValidationEventHandler getEventHandler()
                                       throws JAXBException
```
    Возвратите текущий обработчик событий или обработчик стандартного события, если Вы не были установлены.
    
    Возвраты:
    текущий ValidationEventHandler или обработчик стандартного события, если это не было установлено
    
    Броски:
    
    JAXBException - если с ошибкой встретились, получая текущий обработчик событий
  - setProperty
```
void setProperty(String name,
               Object value)
                 throws PropertyException
```
    Установите определенное свойство в базовой реализации Unmarshaller. Этот метод может только использоваться, чтобы установить один из стандартных JAXB определенные свойства выше или провайдер определенное свойство. Попытка установить неопределенное свойство приведет к бросаемому PropertyException. См. Поддерживаемые Свойства.
    
    Параметры:
    name - имя свойства, которое будет установлено. Это значение может или быть определено, используя одно из постоянных полей или пользователя предоставленная строка.
    value - значение свойства, которое будет установлено
    
    Броски:
    
    PropertyException - когда есть ошибка, обрабатывая данное свойство или значение
    
    IllegalArgumentException - Если параметр имени является нулем
  - getProperty
```
Object getProperty(String name)
                   throws PropertyException
```
    Получите определенное свойство в базовой реализации Unmarshaller. Этот метод может только использоваться, чтобы получить один из стандартных JAXB определенные свойства выше или провайдер определенное свойство. Попытка получить неопределенное свойство приведет к бросаемому PropertyException. См. Поддерживаемые Свойства.
    
    Параметры:
    name - имя свойства, чтобы получить
    
    Возвраты:
    значение требуемого свойства
    
    Броски:
    
    PropertyException - когда есть ошибка, получая данное свойство или имя свойства значения
    
    IllegalArgumentException - Если параметр имени является нулем
  - setSchema
```
void setSchema(Schema schema)
```
    Определите JAXP 1.3 Schema объект, который должен использоваться, чтобы проверить последующий, неупорядочивает операции против. Передача нуля в этот метод отключит проверку допустимости.
    Этот метод заменяет осуждаемый setValidating(boolean) API.
    Первоначально это свойство устанавливается в null.
    
    Параметры:
    schema - Объект схемы проверить неупорядочивает операции против или нуль, чтобы отключить проверку допустимости
    
    Броски:
    
    UnsupportedOperationException - мог быть брошен, если этот метод вызывается на Unmarshaller, создаваемый из JAXBContext, ссылающегося на JAXB 1.0 отображенных класса
    С тех пор:
    
    JAXB2.0
  - getSchema
```
Schema getSchema()
```
    Получите JAXP 1.3 Schema объект, используемый, чтобы выполнить, неупорядочивает разовую проверку допустимости. Если не будет никакого набора Схемы на unmarshaller, то этот метод возвратит нуль, указывающий, которые неупорядочивают разовую проверку допустимости, не будет выполняться.
    Этот метод обеспечивает заменяющую функциональность для осуждаемого isValidating() API так же как доступ к объекту Схемы. Чтобы определить, включали ли Unmarshaller проверке допустимости, просто протестируйте тип возврата на нуль:
    boolean isValidating = u.getSchema()!=null;
    
    Возвраты:
    объект Схемы, используемый, чтобы выполнить, неупорядочивает разовую проверку допустимости или нуль если не существующий
    
    Броски:
    
    UnsupportedOperationException - мог быть брошен, если этот метод вызывается на Unmarshaller, создаваемый из JAXBContext, ссылающегося на JAXB 1.0 отображенных класса
    С тех пор:
    
    JAXB2.0
  - setAdapter
```
void setAdapter(XmlAdapter adapter)
```
    Связывает сконфигурированный экземпляр XmlAdapter с этим unmarshaller.
    Это - метод удобства, который вызывает setAdapter(adapter.getClass(),adapter);.
    
    Броски:
    
    IllegalArgumentException - если параметр адаптера является нулем.
    
    UnsupportedOperationException - если вызвано agains JAXB 1.0 реализации.
    С тех пор:
    
    JAXB2.0
    
    См. Также:
    setAdapter(Class,XmlAdapter)
  - setAdapter
```
<A extends XmlAdapter> void setAdapter(Class<A> type,
                                     A adapter)
```
    Связывает сконфигурированный экземпляр XmlAdapter с этим unmarshaller.
    Каждый unmarshaller внутренне поддерживает a Map<Class,XmlAdapter>, который это использует для того, чтобы неупорядочить классы, поля/методы которых аннотируются XmlJavaTypeAdapter.
    Этот метод позволяет приложениям использовать сконфигурированный экземпляр XmlAdapter. Когда пример адаптера не будет приведен, unmarshaller создаст один, вызывая его конструктора по умолчанию.
    
    Параметры:
    type - Тип адаптера. Указанный экземпляр будет использоваться когда XmlJavaTypeAdapter.value() обращается к этому типу.
    adapter - Экземпляр адаптера, который будет использоваться. Если ноль, это незарегистрирует текущий набор адаптера для этого типа.
    
    Броски:
    
    IllegalArgumentException - если параметр типа является нулем.
    
    UnsupportedOperationException - если вызвано agains JAXB 1.0 реализации.
    С тех пор:
    
    JAXB2.0
  - getAdapter
```
<A extends XmlAdapter> A getAdapter(Class<A> type)
```
    Связали адаптер с указанным типом. Это - обратная работа setAdapter(javax.xml.bind.annotation.adapters.XmlAdapter) метод.
    
    Броски:
    
    IllegalArgumentException - если параметр типа является нулем.
    
    UnsupportedOperationException - если вызвано agains JAXB 1.0 реализации.
    С тех пор:
    
    JAXB2.0
  - setAttachmentUnmarshaller
```
void setAttachmentUnmarshaller(AttachmentUnmarshaller au)
```
    Свяжите контекст, который разрешает уголовного розыска, URI идентификатора контента, к двоичным данным, которых передают как присоединения.
    
    Неупорядочьте проверку допустимости времени, включенную через setSchema(Schema), должен поддерживаться, даже когда unmarshaller выполняет обработку XOP.
    
    Броски:
    
    IllegalStateException - если попытка одновременно вызвать этот метод во время неупорядочивать работы.
  - getAttachmentUnmarshaller
```
AttachmentUnmarshaller getAttachmentUnmarshaller()
```
  - setListener
```
void setListener(Unmarshaller.Listener listener)
```
    Регистр неупорядочивает обратный вызов события Unmarshaller.Listener с этим Unmarshaller.
    Есть только один Слушатель на Unmarshaller. Установка Слушателя заменяет предыдущего Слушателя набора. Можно незарегистрировать текущего Слушателя, устанавливая слушателя null.
    
    Параметры:
    listener - обеспечивает неупорядочивают обратные вызовы события для этого Unmarshaller
    С тех пор:
    
    JAXB2.0
  - getListener
```
Unmarshaller.Listener getListener()
```
    Возвратиться Unmarshaller.Listener зарегистрированный в этом Unmarshaller.
    
    Возвраты:
    зарегистрированный Unmarshaller.Listener или null если никакой Слушатель не регистрируется в этом Unmarshaller.
    С тех пор:
    
    JAXB2.0

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

Неупорядочьте По Объявленному Типу возвращенный JAXBElement
Свойство JAXBElement	Значение
имя	`xml element name`
значение	`instanceof declaredType`
declaredType	неупорядочьте метод `declaredType` параметр
контекст	`null` (фактический контекст неизвестен),

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

getUnmarshallerHandler

setValidating

isValidating

setEventHandler

getEventHandler

setProperty

getProperty

setSchema

getSchema

setAdapter

setAdapter

getAdapter

setAttachmentUnmarshaller

getAttachmentUnmarshaller

setListener

getListener