Spec-Zone .ru
спецификации, руководства, описания, API
|
public abstract class AbstractUnmarshallerImpl extends Object implements Unmarshaller
Этот класс обеспечивает частичную реализацию по умолчанию для Unmarshaller
интерфейс.
Провайдер JAXB должен реализовать пять методов (getUnmarshallerHandler, неупорядочить (Узел), неупорядочить (XMLReader, InputSource), неупорядочить (XMLStreamReader), и неупорядочить (XMLEventReader).
Unmarshaller
Unmarshaller. Слушатель
Модификатор и Тип | Поле и Описание |
---|---|
protected boolean |
проверка допустимости
проверит ли unmarshaller
|
Конструктор и Описание |
---|
AbstractUnmarshallerImpl() |
Модификатор и Тип | Метод и Описание |
---|---|
protected UnmarshalException |
createUnmarshalException(SAXException e)
Создает UnmarshalException из SAXException.
|
<A extends XmlAdapter> |
getAdapter(Class<A> type)
Связали адаптер с указанным типом.
|
AttachmentUnmarshaller |
getAttachmentUnmarshaller() |
ValidationEventHandler |
getEventHandler()
Возвратите текущий обработчик событий или обработчик стандартного события, если Вы не были установлены.
|
Unmarshaller. Слушатель |
getListener()
Возвратиться
Unmarshaller.Listener зарегистрированный в этом Unmarshaller . |
Объект |
getProperty(String name)
Реализация по умолчанию getProperty метода всегда бросает PropertyException, так как нет никаких необходимых свойств.
|
Схема |
getSchema()
Получите JAXP 1.3
Schema объект, используемый, чтобы выполнить, неупорядочивает разовую проверку допустимости. |
protected XMLReader |
getXMLReader()
Получает сконфигурированный XMLReader.
|
boolean |
isValidating()
Указывает, конфигурируется ли Unmarshaller, чтобы проверить во время, неупорядочивают операции.
|
<A extends XmlAdapter> |
setAdapter(Class<A> type, A adapter)
Связывает сконфигурированный экземпляр
XmlAdapter с этим unmarshaller. |
void |
setAdapter(XmlAdapter adapter)
Связывает сконфигурированный экземпляр
XmlAdapter с этим unmarshaller. |
void |
setAttachmentUnmarshaller(AttachmentUnmarshaller au)
Свяжите контекст, который разрешает уголовного розыска, URI идентификатора контента, к двоичным данным, которых передают как присоединения.
|
void |
setEventHandler(ValidationEventHandler handler)
Позвольте приложению регистрировать обработчик событий проверки допустимости.
|
void |
setListener(Unmarshaller.Listener listener)
Регистр неупорядочивает обратный вызов события
Unmarshaller.Listener с этим Unmarshaller . |
void |
setProperty(String name, Object value)
Реализация по умолчанию setProperty метода всегда бросает PropertyException, так как нет никаких необходимых свойств.
|
void |
setSchema(Schema schema)
Определите JAXP 1.3
Schema объект, который должен использоваться, чтобы проверить последующий, неупорядочивает операции против. |
void |
setValidating(boolean validating)
Определяет, должен ли Unmarshaller проверить во время, неупорядочивают операции.
|
Объект |
unmarshal(File f)
Неупорядочьте данные XML от указанного файла и возвратите получающееся дерево контента.
|
Объект |
unmarshal(InputSource source)
Неупорядочьте данные XML от указанного SAX InputSource и возвратите получающееся дерево контента.
|
Объект |
unmarshal(InputStream is)
Неупорядочьте данные XML от указанного InputStream и возвратите получающееся дерево контента.
|
<T> JAXBElement<T> |
unmarshal(Node node, Class<T> expectedType)
Неупорядочьте данные XML по JAXB отображенный declaredType и возвратите получающееся дерево контента.
|
Объект |
unmarshal(Reader reader)
Неупорядочьте данные XML от указанного Читателя и возвратите получающееся дерево контента.
|
Объект |
unmarshal(Source source)
Неупорядочьте данные XML из указанного XML Источник и возвратите получающееся дерево контента.
|
<T> JAXBElement<T> |
unmarshal(Source source, Class<T> expectedType)
Неупорядочьте данные XML из указанного XML Источник declaredType и возвратите получающееся дерево контента.
|
Объект |
unmarshal(URL url)
Неупорядочьте данные XML от указанного URL и возвратите получающееся дерево контента.
|
Объект |
unmarshal(XMLEventReader reader)
Неупорядочьте данные XML от указанного синтаксического анализатора получения по запросу и возвратите получающееся дерево контента.
|
<T> JAXBElement<T> |
unmarshal(XMLEventReader reader, Class<T> expectedType)
Неупорядочьте корневой элемент к JAXB отображенный declaredType и возвратите получающееся дерево контента.
|
protected abstract Object |
unmarshal(XMLReader reader, InputSource source)
Неупорядочивает объект при использовании указанного XMLReader и InputSource.
|
Объект |
unmarshal(XMLStreamReader reader)
Неупорядочьте данные XML от указанного синтаксического анализатора получения по запросу и возвратите получающееся дерево контента.
|
<T> JAXBElement<T> |
unmarshal(XMLStreamReader reader, Class<T> expectedType)
Неупорядочьте корневой элемент к JAXB отображенный declaredType и возвратите получающееся дерево контента.
|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
getUnmarshallerHandler, unmarshal
protected XMLReader getXMLReader() throws JAXBException
SAXSource
у объекта нет XMLReader. Unmarshaller
не повторно используемо, таким образом, мы будем только использовать один экземпляр XMLReader.JAXBException
public Object unmarshal(Source source) throws JAXBException
Unmarshaller
Реализации Неупорядочивают Глобальный Корневой Элемент.
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 по умолчанию и механизмы блока проверки допустимости.
unmarshal
в интерфейсе Unmarshaller
source
- XML Источник, чтобы неупорядочить данные XML от (провайдеры только обязаны поддерживать SAXSource, DOMSource, и StreamSource),JAXBException
- Если какие-либо неожиданные ошибки происходят, неупорядочиваяUnmarshalException
- Если ValidationEventHandler
возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Данные XML НемаршалингаUnmarshaller.unmarshal(javax.xml.transform.Source, Class)
protected abstract Object unmarshal(XMLReader reader, InputSource source) throws JAXBException
JAXBException
public final Object unmarshal(InputSource source) throws JAXBException
Unmarshaller
Реализации Неупорядочивают Глобальный Корневой Элемент.
unmarshal
в интерфейсе Unmarshaller
source
- входной источник, чтобы неупорядочить данные XML отJAXBException
- Если какие-либо неожиданные ошибки происходят, неупорядочиваяUnmarshalException
- Если ValidationEventHandler
возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Данные XML Немаршалингаpublic final Object unmarshal(URL url) throws JAXBException
Unmarshaller
Реализации Неупорядочивают Глобальный Корневой Элемент.
unmarshal
в интерфейсе Unmarshaller
url
- url, чтобы неупорядочить данные XML отJAXBException
- Если какие-либо неожиданные ошибки происходят, неупорядочиваяUnmarshalException
- Если ValidationEventHandler
возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Данные XML Немаршалингаpublic final Object unmarshal(File f) throws JAXBException
Unmarshaller
Реализации Неупорядочивают Глобальный Корневой Элемент.
unmarshal
в интерфейсе Unmarshaller
f
- файл, чтобы неупорядочить данные XML отJAXBException
- Если какие-либо неожиданные ошибки происходят, неупорядочиваяUnmarshalException
- Если ValidationEventHandler
возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Данные XML Немаршалингаpublic final Object unmarshal(InputStream is) throws JAXBException
Unmarshaller
Реализации Неупорядочивают Глобальный Корневой Элемент.
unmarshal
в интерфейсе Unmarshaller
is
- InputStream, чтобы неупорядочить данные XML отJAXBException
- Если какие-либо неожиданные ошибки происходят, неупорядочиваяUnmarshalException
- Если ValidationEventHandler
возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Данные XML Немаршалингаpublic final Object unmarshal(Reader reader) throws JAXBException
Unmarshaller
Реализации Неупорядочивают Глобальный Корневой Элемент.
unmarshal
в интерфейсе Unmarshaller
reader
- Читатель, чтобы неупорядочить данные XML отJAXBException
- Если какие-либо неожиданные ошибки происходят, неупорядочиваяUnmarshalException
- Если ValidationEventHandler
возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Данные XML Немаршалингаpublic boolean isValidating() throws JAXBException
Отметьте: Я назвал этот метод isValidating (), чтобы остаться встроенным с JAXP, в противоположность именованию этого getValidating ().
isValidating
в интерфейсе Unmarshaller
JAXBException
- если ошибка происходит, получая флаг проверки допустимостиpublic void setEventHandler(ValidationEventHandler handler) throws JAXBException
Обработчик событий проверки допустимости вызовет Провайдер JAXB, если с какими-либо ошибками проверки допустимости встретятся во время звонков в какой-либо из методов unmarshal. Если клиентское приложение не зарегистрирует обработчик событий проверки допустимости прежде, чем вызвать неупорядочивать методы, то все события проверки допустимости будут тихо проигнорированы и могут привести к неожиданному поведению.
setEventHandler
в интерфейсе Unmarshaller
handler
- обработчик событий проверки допустимостиJAXBException
- если с ошибкой встретились, устанавливая обработчик событийpublic void setValidating(boolean validating) throws JAXBException
Этот метод может только быть вызван прежде или после вызова одного из неупорядочивать методов.
setValidating
в интерфейсе Unmarshaller
validating
- истина, если Unmarshaller должен проверить во время, неупорядочивает, ложь иначеJAXBException
- если ошибка произошла, в то время как включение или отключение проверки допустимости в неупорядочивают времяpublic ValidationEventHandler getEventHandler() throws JAXBException
getEventHandler
в интерфейсе Unmarshaller
JAXBException
- если с ошибкой встретились, получая текущий обработчик событийprotected UnmarshalException createUnmarshalException(SAXException e)
Когда реализованный провайдером ContentHandler хочет бросить JAXBException, он должен обернуть исключение SAXException. Если unmarshaller реализация вслепую обернет SAXException JAXBException, то такое исключение будет JAXBException, обернутым SAXException, обернутым другим JAXBException. Это глупо.
Этот метод проверяет вложенное исключение SAXException, и уменьшите тех чрезмерное обертывание.
public void setProperty(String name, Object value) throws PropertyException
setProperty
в интерфейсе Unmarshaller
name
- имя свойства, которое будет установлено. Это значение может или быть определено, используя одно из постоянных полей или пользователя предоставленная строка.value
- значение свойства, которое будет установленоPropertyException
- когда есть ошибка, обрабатывая данное свойство или значениеpublic Object getProperty(String name) throws PropertyException
getProperty
в интерфейсе Unmarshaller
name
- имя свойства, чтобы получитьPropertyException
- когда есть ошибка, получая данное свойство или имя свойства значенияpublic Object unmarshal(XMLEventReader reader) throws JAXBException
Unmarshaller
Этот метод является методом Unmarshal Global Root.
Этот метод предполагает, что синтаксический анализатор находится на событии START_DOCUMENT ИЛИ START_ELEMENT. Немаршалинг будет сделан от этого события запуска до соответствующего события конца. Если этот метод возвратится успешно, то reader будет указывать на маркер прямо после события конца.
unmarshal
в интерфейсе Unmarshaller
reader
- Синтаксический анализатор, который будет считан.JAXBException
- Если какие-либо неожиданные ошибки происходят, неупорядочиваяUnmarshalException
- Если ValidationEventHandler
возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Данные XML НемаршалингаUnmarshaller.unmarshal(javax.xml.stream.XMLEventReader, Class)
public Object unmarshal(XMLStreamReader reader) throws JAXBException
Unmarshaller
Реализации Неупорядочивают Глобальный Корневой Элемент.
Этот метод предполагает, что синтаксический анализатор находится на событии START_DOCUMENT ИЛИ START_ELEMENT. Немаршалинг будет сделан от этого события запуска до соответствующего события конца. Если этот метод возвратится успешно, то reader будет указывать на маркер прямо после события конца.
unmarshal
в интерфейсе Unmarshaller
reader
- Синтаксический анализатор, который будет считан.JAXBException
- Если какие-либо неожиданные ошибки происходят, неупорядочиваяUnmarshalException
- Если ValidationEventHandler
возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Данные XML НемаршалингаUnmarshaller.unmarshal(javax.xml.stream.XMLStreamReader, Class)
public <T> JAXBElement<T> unmarshal(Node node, Class<T> expectedType) throws JAXBException
Unmarshaller
Реализации Неупорядочивают по Объявленному Типу
unmarshal
в интерфейсе Unmarshaller
node
- документ/элемент, чтобы неупорядочить данные XML от. Вызывающая сторона должна поддерживать, по крайней мере, Документ и Элемент.expectedType
- приспособьте JAXB отображенный класс, чтобы содержать данные XML node.JAXBException
- Если какие-либо неожиданные ошибки происходят, неупорядочиваяUnmarshalException
- Если ValidationEventHandler
возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Данные XML Немаршалингаpublic <T> JAXBElement<T> unmarshal(Source source, Class<T> expectedType) throws JAXBException
Unmarshaller
Реализации Неупорядочивают по Объявленному Типу
unmarshal
в интерфейсе Unmarshaller
source
- XML Источник, чтобы неупорядочить данные XML от (провайдеры только обязаны поддерживать SAXSource, DOMSource, и StreamSource),expectedType
- приспособьте JAXB отображенный класс, чтобы содержать корневой элемент xml sourceJAXBException
- Если какие-либо неожиданные ошибки происходят, неупорядочиваяUnmarshalException
- Если ValidationEventHandler
возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Данные XML Немаршалингаpublic <T> JAXBElement<T> unmarshal(XMLStreamReader reader, Class<T> expectedType) throws JAXBException
Unmarshaller
Этот метод реализации неупорядочивает по declaredType.
Этот метод предполагает, что синтаксический анализатор находится на событии START_DOCUMENT ИЛИ START_ELEMENT. Немаршалинг будет сделан от этого события запуска до соответствующего события конца. Если этот метод возвратится успешно, то reader будет указывать на маркер прямо после события конца.
unmarshal
в интерфейсе Unmarshaller
reader
- Синтаксический анализатор, который будет считан.expectedType
- приспособьте JAXB отображенный класс, чтобы содержать данные XML reader START_ELEMENT.JAXBException
- Если какие-либо неожиданные ошибки происходят, неупорядочиваяUnmarshalException
- Если ValidationEventHandler
возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Данные XML Немаршалингаpublic <T> JAXBElement<T> unmarshal(XMLEventReader reader, Class<T> expectedType) throws JAXBException
Unmarshaller
Этот метод реализации неупорядочивает по declaredType.
Этот метод предполагает, что синтаксический анализатор находится на событии START_DOCUMENT ИЛИ START_ELEMENT. Немаршалинг будет сделан от этого события запуска до соответствующего события конца. Если этот метод возвратится успешно, то reader будет указывать на маркер прямо после события конца.
unmarshal
в интерфейсе Unmarshaller
reader
- Синтаксический анализатор, который будет считан.expectedType
- приспособьте JAXB отображенный класс, чтобы содержать данные XML reader START_ELEMENT.JAXBException
- Если какие-либо неожиданные ошибки происходят, неупорядочиваяUnmarshalException
- Если ValidationEventHandler
возвращает false от его метода handleEvent, или Unmarshaller неспособен выполнить XML к привязке Java. См. Данные XML Немаршалингаpublic void setSchema(Schema schema)
Unmarshaller
Schema
объект, который должен использоваться, чтобы проверить последующий, неупорядочивает операции против. Передача нуля в этот метод отключит проверку допустимости. Этот метод заменяет осуждаемый setValidating(boolean)
API.
Первоначально это свойство устанавливается в null.
setSchema
в интерфейсе Unmarshaller
schema
- Объект схемы проверить неупорядочивает операции против или нуль, чтобы отключить проверку допустимостиpublic Schema getSchema()
Unmarshaller
Schema
объект, используемый, чтобы выполнить, неупорядочивает разовую проверку допустимости. Если не будет никакого набора Схемы на unmarshaller, то этот метод возвратит нуль, указывающий, которые неупорядочивают разовую проверку допустимости, не будет выполняться. Этот метод обеспечивает заменяющую функциональность для осуждаемого Unmarshaller.isValidating()
API так же как доступ к объекту Схемы. Чтобы определить, включали ли Unmarshaller проверке допустимости, просто протестируйте тип возврата на нуль:
boolean isValidating = u.getSchema()!=null;
getSchema
в интерфейсе Unmarshaller
public void setAdapter(XmlAdapter adapter)
Unmarshaller
XmlAdapter
с этим unmarshaller. Это - метод удобства, который вызывает setAdapter(adapter.getClass(),adapter);
.
setAdapter
в интерфейсе Unmarshaller
Unmarshaller.setAdapter(Class,XmlAdapter)
public <A extends XmlAdapter> void setAdapter(Class<A> type, A adapter)
Unmarshaller
XmlAdapter
с этим unmarshaller. Каждый unmarshaller внутренне поддерживает a Map
<Class
,XmlAdapter
>, который это использует для того, чтобы неупорядочить классы, поля/методы которых аннотируются XmlJavaTypeAdapter
.
Этот метод позволяет приложениям использовать сконфигурированный экземпляр XmlAdapter
. Когда пример адаптера не будет приведен, unmarshaller создаст один, вызывая его конструктора по умолчанию.
setAdapter
в интерфейсе Unmarshaller
type
- Тип адаптера. Указанный экземпляр будет использоваться когда XmlJavaTypeAdapter.value()
обращается к этому типу.adapter
- Экземпляр адаптера, который будет использоваться. Если ноль, это незарегистрирует текущий набор адаптера для этого типа.public <A extends XmlAdapter> A getAdapter(Class<A> type)
Unmarshaller
Unmarshaller.setAdapter(javax.xml.bind.annotation.adapters.XmlAdapter)
метод.getAdapter
в интерфейсе Unmarshaller
public void setAttachmentUnmarshaller(AttachmentUnmarshaller au)
Unmarshaller
Свяжите контекст, который разрешает уголовного розыска, URI идентификатора контента, к двоичным данным, которых передают как присоединения.
Неупорядочьте проверку допустимости времени, включенную через Unmarshaller.setSchema(Schema)
, должен поддерживаться, даже когда unmarshaller выполняет обработку XOP.
setAttachmentUnmarshaller
в интерфейсе Unmarshaller
public AttachmentUnmarshaller getAttachmentUnmarshaller()
getAttachmentUnmarshaller
в интерфейсе Unmarshaller
public void setListener(Unmarshaller.Listener listener)
Unmarshaller
Регистр неупорядочивает обратный вызов события Unmarshaller.Listener
с этим Unmarshaller
.
Есть только один Слушатель на Unmarshaller. Установка Слушателя заменяет предыдущего Слушателя набора. Можно незарегистрировать текущего Слушателя, устанавливая слушателя null.
setListener
в интерфейсе Unmarshaller
listener
- обеспечивает неупорядочивают обратные вызовы события для этого Unmarshaller
public Unmarshaller.Listener getListener()
Unmarshaller
Возвратиться Unmarshaller.Listener
зарегистрированный в этом Unmarshaller
.
getListener
в интерфейсе Unmarshaller
Unmarshaller.Listener
или null
если никакой Слушатель не регистрируется в этом Unmarshaller.
Для дальнейшей ссылки API и документации разработчика, см.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.