Класс AttachmentUnmarshaller
- java.lang.Object
-
- javax.xml.bind.attachment.AttachmentUnmarshaller
public abstract class AttachmentUnmarshaller extends Object
Обеспечивает разбор JAXB корневого документа, содержащего оптимизированные двоичные форматы данных.
Этот API позволяет эффективно обрабатывать оптимизированные двоичные форматы данных между реализацией JAXB 2.0 и процессором пакетов на основе MIME (MTOM/XOP и WS-I AP 1.0). JAXB разбирает тело пакета, делегируя понимание используемого формата упаковки процессору пакетов на основе MIME, который реализует этот абстрактный класс.
Этот абстрактный класс определяет, требует ли пакет обработки XOP, isXOPPackage(), и предоставляет доступ к двоиному содержимому, хранящемуся как вложения по идентификатору содержимого.
Определение идентификатора содержимого, cid, для передачи getAttachment*(String cid)
- Для обработки XOP представление cid в информационном наборе описано в шаге 2a в Раздел 3.2 Интерпретация пакетов XOP
- Для WS-I AP 1.0 cid определяется как элемент или атрибут типа
ref:swaRef, указанный в Раздел 4.4 Ссылка на вложения из SOAP-оборачивающего элемента
- Since:
- JAXB 2.0
- See Also:
-
Unmarshaller.setAttachmentUnmarshaller(AttachmentUnmarshaller), Оптимизированная упаковка XML-двоичных данных, Профиль вложений WS-I версии 1.0., Описание медиаконтента двоичных данных в XML
Конструкторы
| Конструктор и описание |
|---|
AttachmentUnmarshaller()
|
Методы
| Модификатор и тип | Метод и описание |
|---|---|
abstract byte[] |
getAttachmentAsByteArray(String cid) Получение вложения, идентифицированного идентификатором содержимого, |
abstract DataHandler |
getAttachmentAsDataHandler(String cid) Поиск MIME-содержимого по идентификатору содержимого, |
boolean |
isXOPPackage() Только для чтения свойство, возвращающее true, если JAXB-разборщику требуется выполнить обработку XOP. |
Наследованные методы из класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Конструкторы
AttachmentUnmarshaller
public AttachmentUnmarshaller()
Методы
getAttachmentAsDataHandler
public abstract DataHandler getAttachmentAsDataHandler(String cid)
Поиск MIME-содержимого по идентификатору содержимого, cid, и возвращение его в виде DataHandler.
Возвращаемый DataHandler экземпляр должен быть настроен для соответствия следующим обязательным ограничениям сопоставления.
| Обязательные сопоставления между MIME и типами Java | |
|---|---|
| MIME Тип | Тип Java |
DataHandler.getContentType() |
instanceof DataHandler.getContent() |
| image/gif | java.awt.Image |
| image/jpeg | java.awt.Image |
| text/xml или application/xml | javax.xml.transform.Source |
- Parameters:
-
cid- Ожидается, что это будет допустимая лексическая форма типа данных XML Schemaxs:anyURI. ЕслиisXOPPackage()==truecid:URI (см. RFC 2387) - Returns:
- a
DataHandler, представляющий MIME-вложение. - Throws:
-
IllegalArgumentException- если вложение для данного cid не найдено.
getAttachmentAsByteArray
public abstract byte[] getAttachmentAsByteArray(String cid)
Получение вложения, идентифицированного идентификатором содержимого, cid, в виде byte[]
- Parameters:
-
cid- Ожидается, что это будет допустимая лексическая форма типа данных XML Schemaxs:anyURI. ЕслиisXOPPackage()==truecid:URI (см. RFC 2387) - Returns:
- представление вложения в виде массива байтов byte[].
- Throws:
-
IllegalArgumentException- если вложение для данного cid не найдено.
isXOPPackage
public boolean isXOPPackage()
Свойство только для чтения, возвращающее true, если JAXB-разборщику требуется выполнить обработку XOP.
Этот метод возвращает true когда выполняются ограничения, указанные в Идентификация документов XOP. Это значение не должно изменяться во время процесса разбора.
- Returns:
- true, когда контекст MIME является документом XOP.
© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
