Класс MimeHeaders
- java.lang.Object
-
- javax.xml.soap.MimeHeaders
public class MimeHeaders extends Object
Контейнер для объектов MimeHeader, представляющих MIME-заголовки, присутствующие в части MIME сообщения.
Этот класс используется в основном, когда приложение хочет получить определённые вложения на основе определённых MIME-заголовков и значений. Этот класс, скорее всего, будет использоваться реализациями AttachmentPart и другими частями API SAAJ, зависящими от MIME.
- См. также:
-
SOAPMessage.getAttachments(),AttachmentPart
Конструкторы
| Конструктор и описание |
|---|
MimeHeaders()
Создаёт объект |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
void |
addHeader(String name,
String value)
Добавляет объект |
Iterator |
getAllHeaders()
Возвращает все |
String[] |
getHeader(String name)
Возвращает все значения для указанного заголовка в виде массива объектов |
Iterator |
getMatchingHeaders(String[] names)
Возвращает все объекты |
Iterator |
getNonMatchingHeaders(String[] names)
Возвращает все объекты |
void |
removeAllHeaders()
Удаляет все записи заголовков из этого объекта |
void |
removeHeader(String name)
Удаляет все объекты |
void |
setHeader(String name,
String value)
Заменяет текущее значение первой записи заголовка, имя которого совпадает с заданным именем, указанным значением, добавляя новый заголовок, если имя существующего заголовка не совпадает. Этот метод также удаляет все совпадающие заголовки после первого. |
Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Конструкторы
MimeHeaders
public MimeHeaders()
Создаёт объект MimeHeaders по умолчанию, инициализированный пустым объектом Vector.
Методы
getHeader
public String[] getHeader(String name)
Возвращает все значения для указанного заголовка в виде массива объектов String.
- Параметры:
-
name- имя заголовка, для которого будут возвращены значения - Возвращает:
- массив
Stringсо всеми значениями для указанного заголовка - См. также:
setHeader(java.lang.String, java.lang.String)
setHeader
public void setHeader(String name,
String value)
Заменяет текущее значение первой записи заголовка, имя которого совпадает с заданным именем, указанным значением, добавляя новый заголовок, если имя существующего заголовка не совпадает. Этот метод также удаляет все совпадающие заголовки после первого.
Заметьте, что заголовки RFC822 могут содержать только символы US-ASCII.
- Параметры:
-
name- строка с именем заголовка, для которого требуется поиск -
value- строка со значением, которое заменит текущее значение указанного заголовка - Исключения:
-
IllegalArgumentException- если возникла проблема с именем MIME-заголовка или устанавливаемым значением - См. также:
getHeader(java.lang.String)
addHeader
public void addHeader(String name,
String value)
Добавляет объект MimeHeader с указанным именем и значением в список заголовков этого объекта MimeHeaders.
Заметьте, что заголовки RFC822 могут содержать только символы US-ASCII.
- Параметры:
-
name- строка с именем добавляемого заголовка -
value- строка со значением добавляемого заголовка - Исключения:
-
IllegalArgumentException- если возникла проблема с именем или значением добавляемого MIME-заголовка
removeHeader
public void removeHeader(String name)
Удаляет все объекты MimeHeader, имена которых совпадают с заданным именем.
- Параметры:
-
name- строка с именем заголовка, для которого требуется поиск
removeAllHeaders
public void removeAllHeaders()
Удаляет все записи заголовков из этого объекта MimeHeaders.
getAllHeaders
public Iterator getAllHeaders()
Возвращает все MimeHeader в этом объекте MimeHeaders.
- Возвращает:
- объект
Iteratorнад списком объектовMimeHeaderэтого объектаMimeHeaders.
getMatchingHeaders
public Iterator getMatchingHeaders(String[] names)
Возвращает все объекты MimeHeader, имена которых совпадают с именами в заданном массиве имён.
- Параметры:
-
names- массив объектовStringс именами, для которых требуется поиск - Возвращает:
- объект
Iteratorнад объектамиMimeHeader, имена которых совпадают с одним из имён в заданном списке.
getNonMatchingHeaders
public Iterator getNonMatchingHeaders(String[] names)
Возвращает все объекты MimeHeader, имена которых не совпадают с именами в заданном массиве имён.
- Параметры:
-
names- массив объектовStringс именами, для которых требуется поиск - Возвращает:
- объект
Iteratorнад объектамиMimeHeader, имена которых не совпадают ни с одним из имён в заданном списке.
© 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.