Spec-Zone .ru спецификации, руководства, описания, API

javax.mail.internet
Класс MimeBodyPart

java.lang.Object
  javax.mail.BodyPart
      javax.mail.internet.MimeBodyPart

Все Реализованные Интерфейсы:

MimePart, Часть

Прямые Известные Подклассы:

PreencodedMimeBodyPart

public class MimeBodyPart
расширяет BodyPart
реализации MimePart

Этот class представляет часть тела MIME. Это реализует BodyPart абстрактный class и MimePart интерфейс. MimeBodyParts содержатся в MimeMultipart объекты.

MimeBodyPart использует InternetHeaders class, чтобы проанализировать и сохранить заголовки той части тела.

Примечание по RFC 822 и заголовкам MIME

Поля заголовка RFC 822 должны содержать только символы US-ASCII. MIME позволяет не символам ASCII присутствовать в определенных частях определенных заголовков, кодируя те символы. RFC 2047 определяет правила для того, чтобы сделать это. MimeUtility class, обеспеченный в этом пакете, может привыкнуть к достигнуть этого. Вызывающие стороны setHeader, addHeader, и addHeaderLine методы ответственны за осуществление требований MIME для указанных заголовков. Кроме того, эти поля заголовка должны быть свернуты (обернутые) прежде, чем быть отправленным, если они превышают ограничение длины строки для транспорта (1000 байтов для SMTP)., Возможно, были свернуты полученные заголовки. Приложение ответственно за сворачивание и разворачивание заголовков как соответствующий.

Автор:

Джон Мани, Билл Шеннон, Kanwar Oberoi

См. Также:

Part, MimePart, MimeUtility

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

protected byte[]	контент Байтовый массив, который содержит байты контента этой Части.
protected java.io.InputStream	contentStream Если данными для этой части тела снабдил InputStream, который реализует интерфейс SharedInputStream, contentStream другой такой поток, представляющий контент этой части тела.
protected javax.activation.DataHandler	горячекатаный Объект DataHandler, представляющий контент этой Части.
protected InternetHeaders	заголовки InternetHeaders возражают, что хранит все заголовки этой части тела.

Поля, наследованные от class javax.mail. BodyPart

родитель

Поля, наследованные от интерфейса javax.mail. Часть

ATTACHMENT, INLINE

Сводка конструктора

MimeBodyPart()
Создается пустой объект MimeBodyPart.

MimeBodyPart(java.io.InputStream is)
Создает MimeBodyPart, читая и анализируя данные от указанного входного потока.

MimeBodyPart(InternetHeaders headers, byte[] content)
Создает MimeBodyPart, используя данный заголовок и байты контента.

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

void	addHeader(java.lang.String name, java.lang.String value) Добавьте это значение к существующим значениям для этого header_name.
void	addHeaderLine(java.lang.String line) Добавьте строку заголовка к этой части тела
void	attachFile(java.io.File file) Используйте указанный файл, чтобы обеспечить данные для этой части.
void	attachFile(java.lang.String file) Используйте указанный файл, чтобы обеспечить данные для этой части.
java.util.Enumeration	getAllHeaderLines() Получите все строки заголовка как Перечисление Строк.
java.util.Enumeration	getAllHeaders() Возвратите все заголовки из этого сообщения как Перечисление объектов Заголовка.
java.lang.Object	getContent() Возвратите контент как объект Java.
java.lang.String	getContentID() Возвращает значение поля заголовка "ID контента".
java.lang.String[]	getContentLanguage() Определите языки в заголовке Языка контента этого MimePart.
java.lang.String	getContentMD5() Возвратите значение поля заголовка "Контента-MD5".
protected java.io.InputStream	getContentStream() Произведите необработанные байты контента.
java.lang.String	getContentType() Возвращает значение поля заголовка "Типа контента" RFC 822.
javax.activation.DataHandler	getDataHandler() Возвратите DataHandler для этого контента части тела.
java.lang.String	getDescription() Возвращает поле заголовка "Описания контента" этой части тела.
java.lang.String	getDisposition() Возвращает значение поля заголовка "Расположения контента".
java.lang.String	getEncoding() Возвращает кодирование передачи контента из поля заголовка "Кодирования передачи контента".
java.lang.String	getFileName() Свяжите имя файла с этой частью тела.
java.lang.String[]	getHeader(java.lang.String name) Получите все заголовки для этого header_name.
java.lang.String	getHeader(java.lang.String name, java.lang.String delimiter) Получите все заголовки для этого имени заголовка, возвращенного как единственная Строка, с заголовками, разделенными разделителем.
java.io.InputStream	getInputStream() Возвратите декодируемый входной поток для этой части тела "контент".
int	getLineCount() Возвратите число строк для контента этой Части.
java.util.Enumeration	getMatchingHeaderLines(java.lang.String[] names) Получите соответствие строк заголовка как Перечисление Строк.
java.util.Enumeration	getMatchingHeaders(java.lang.String[] names) Возвратите соответствие заголовков из этого сообщения как Перечисление объектов Заголовка.
java.util.Enumeration	getNonMatchingHeaderLines(java.lang.String[] names) Получите несоответствие строк заголовка как Перечисление Строк.
java.util.Enumeration	getNonMatchingHeaders(java.lang.String[] names) Возвратите несоответствие заголовков из этого сообщения как Перечисление объектов Заголовка.
java.io.InputStream	getRawInputStream() Возвратите InputStream необработанным данным с любым неповрежденным Кодированием передачи контента.
int	getSize() Возвратите размер контента этой части тела в байтах.
boolean	isMimeType(java.lang.String mimeType) Эта Часть имеет указанный тип MIME? Этот метод сравнивается только primaryType и subType.
void	removeHeader(java.lang.String name) Удалите все заголовки с этим именем.
void	saveFile(java.io.File file) Сохраните содержание этой части в указанном файле.
void	saveFile(java.lang.String file) Сохраните содержание этой части в указанном файле.
void	setContent(Multipart mp) Этот метод устанавливает контент части тела в Многослойный объект.
void	setContent(java.lang.Object o, java.lang.String type) Метод удобства для того, чтобы установить этот контент части тела.
void	setContentID(java.lang.String cid) Установите поле заголовка "ID контента" этой части тела.
void	setContentLanguage(java.lang.String[] languages) Установите заголовок Языка контента этого MimePart.
void	setContentMD5(java.lang.String md5) Установите поле заголовка "Контента-MD5" этой части тела.
void	setDataHandler(javax.activation.DataHandler dh) Этот метод обеспечивает механизм, чтобы установить этот контент части тела.
void	setDescription(java.lang.String description) Установите поле заголовка "Описания контента" для этой части тела.
void	setDescription(java.lang.String description, java.lang.String charset) Установите поле заголовка "Описания контента" для этой части тела.
void	setDisposition(java.lang.String disposition) Установите поле заголовка "Расположения контента" этой части тела.
void	setFileName(java.lang.String filename) Установите имя файла, связанное с этой частью тела, если возможный.
void	setHeader(java.lang.String name, java.lang.String value) Установите значение для этого header_name.
void	setText(java.lang.String text) Метод удобства, который устанавливает данную Строку как контент этой части с типом MIME "текста/плоскости".
void	setText(java.lang.String text, java.lang.String charset) Метод удобства, который устанавливает данную Строку как контент этой части с типом MIME "текста/плоскости" и указанного набора символов.
void	setText(java.lang.String text, java.lang.String charset, java.lang.String subtype) Метод удобства, который устанавливает данную Строку как контент этой части с основным типом MIME "текста" и указанного подтипа MIME.
protected void	updateHeaders() Исследуйте контент этой части тела и обновите соответствующие заголовки MIME.
void	writeTo(java.io.OutputStream os) Выведите часть тела как поток формата RFC 822.

Методы, наследованные от class javax.mail. BodyPart

getParent

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

горячекатаный

protected javax.activation.DataHandler dh

Объект DataHandler, представляющий контент этой Части.

контент

protected byte[] content

Байтовый массив, который содержит байты контента этой Части.

contentStream

protected java.io.InputStream contentStream

Если данными для этой части тела снабдил InputStream, который реализует интерфейс SharedInputStream, contentStream другой такой поток, представляющий контент этой части тела. В этом случае, content будет нуль.

С тех пор:

JavaMail 1.2

заголовки

protected InternetHeaders headers

InternetHeaders возражают, что хранит все заголовки этой части тела.

Деталь конструктора

MimeBodyPart

public MimeBodyPart()

Создается пустой объект MimeBodyPart. Эта часть тела, возможно заполненная клиентом, создающим многослойное сообщение.

MimeBodyPart

public MimeBodyPart(java.io.InputStream is)
             throws MessagingException

Создает MimeBodyPart, читая и анализируя данные от указанного входного потока. Синтаксический анализатор использует данные до конца данного входного потока. Входной поток должен запуститься в начале допустимой части тела MIME и должен завершиться в конце той части тела.

Отметьте, что "граничная" строка, которая разграничивает части тела, не должна быть включена во входной поток. Намерение состоит в том, что синтаксический анализатор MimeMultipart извлечет каждое тело байты части из многослойного потока и подаст их в этого конструктора без строк разделителя.

Параметры:

is - Входной Поток части тела

Броски:

MessagingException

MimeBodyPart

public MimeBodyPart(InternetHeaders headers,
                    byte[] content)
             throws MessagingException

Создает MimeBodyPart, используя данный заголовок и байты контента.

Используемый провайдерами.

Параметры:

headers - Заголовок этой части

content - байты, представляющие тело этой части.

Броски:

MessagingException

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

getSize

public int getSize()
            throws MessagingException

Возвратите размер контента этой части тела в байтах. Возвратитесь-1, если размер не может быть определен.

Отметьте, что это число, возможно, не точная мера размера контента, и можете, или, возможно, не учитывает кодирования передачи контента.

Эта реализация возвращает размер content массив (если не нуль), или, если contentStream не нуль, и available метод возвращает положительное число, он возвращает то число как размер. Иначе, это возвращается-1.

Определенный:

getSize в интерфейсе Part

Возвраты:

размер в байтах, или-1, если не известный

Броски:

MessagingException

getLineCount

public int getLineCount()
                 throws MessagingException

Возвратите число строк для контента этой Части. Возвратитесь-1, если это число не может быть определено.

Отметьте, что это число, возможно, не точная мера длины контента, и можете, или, возможно, не учитывает кодирования передачи контента.

Эта реализация возвращается-1.

Определенный:

getLineCount в интерфейсе Part

Возвраты:

число строк, или-1, если не известный

Броски:

MessagingException

getContentType

public java.lang.String getContentType()
                                throws MessagingException

Возвращает значение поля заголовка "Типа контента" RFC 822. Это представляет тип контента контента этой части тела. Это значение не должно быть нулем. Если это поле недоступно, "текст/плоскость" должен быть возвращен.

Эта реализация использование getHeader(name) получить необходимое поле заголовка.

Определенный:

getContentType в интерфейсе Part

Возвраты:

Тип контента этой части тела

Броски:

MessagingException

См. Также:

DataHandler

isMimeType

public boolean isMimeType(java.lang.String mimeType)
                   throws MessagingException

Эта Часть имеет указанный тип MIME? Этот метод сравнивается только primaryType и subType. Параметры типов контента игнорируются.

Например, этот метод возвратится true сравнивая Часть типа контента "текст/плоскость" с "текстом/плоскостью; charset=foobar".

Если subType из mimeType специальный символ '*', тогда подтип игнорируется во время сравнения.

Определенный:

isMimeType в интерфейсе Part

Броски:

MessagingException

getDisposition

public java.lang.String getDisposition()
                                throws MessagingException

Возвращает значение поля заголовка "Расположения контента". Это представляет расположение этой части. Расположение описывает, как часть должна быть представлена пользователю.

Если поле Content-Disposition недоступно, нулевой возвращается.

Эта реализация использование getHeader(name) получить необходимое поле заголовка.

Определенный:

getDisposition в интерфейсе Part

Возвраты:

расположение этой части, или нуль если неизвестный

Броски:

MessagingException

См. Также:

headers

setDisposition

public void setDisposition(java.lang.String disposition)
                    throws MessagingException

Установите поле заголовка "Расположения контента" этой части тела. Если расположение является нулем, любое существующее поле заголовка "Расположения контента" удаляется.

Определенный:

setDisposition в интерфейсе Part

Параметры:

disposition - расположение этой части

Броски:

IllegalWriteException - если базовая реализация не поддерживает модификацию

IllegalStateException - если эта часть тела получается из папки READ_ONLY.

MessagingException

См. Также:

Part.ATTACHMENT, Part.INLINE, Part.setFileName(java.lang.String)

getEncoding

public java.lang.String getEncoding()
                             throws MessagingException

Возвращает кодирование передачи контента из поля заголовка "Кодирования передачи контента". Возвраты null если заголовок недоступен, или его значение отсутствует.

Эта реализация использование getHeader(name) получить необходимое поле заголовка.

Определенный:

getEncoding в интерфейсе MimePart

Возвраты:

кодирование передачи контента

Броски:

MessagingException

См. Также:

headers

getContentID

public java.lang.String getContentID()
                              throws MessagingException

Возвращает значение поля заголовка "ID контента". Возвраты null если поле недоступно, или его значение отсутствует.

Эта реализация использование getHeader(name) получить необходимое поле заголовка.

Определенный:

getContentID в интерфейсе MimePart

Возвраты:

ID контента

Броски:

MessagingException

setContentID

public void setContentID(java.lang.String cid)
                  throws MessagingException

Установите поле заголовка "ID контента" этой части тела. Если cid параметр является нулем, любой существующий "ID контента" удаляется.

Броски:

IllegalWriteException - если базовая реализация не поддерживает модификацию

IllegalStateException - если эта часть тела получается из папки READ_ONLY.

MessagingException

С тех пор:

JavaMail 1.3

getContentMD5

public java.lang.String getContentMD5()
                               throws MessagingException

Возвратите значение поля заголовка "Контента-MD5". Возвраты null если это поле недоступно, или его значение отсутствует.

Эта реализация использование getHeader(name) получить необходимое поле заголовка.

Определенный:

getContentMD5 в интерфейсе MimePart

Возвраты:

контент-MD5

Броски:

MessagingException

setContentMD5

public void setContentMD5(java.lang.String md5)
                   throws MessagingException

Установите поле заголовка "Контента-MD5" этой части тела.

Определенный:

setContentMD5 в интерфейсе MimePart

Параметры:

md5 - значение MD5

Броски:

IllegalWriteException - если базовая реализация не поддерживает модификацию

IllegalStateException - если эта часть тела получается из папки READ_ONLY.

MessagingException

getContentLanguage

public java.lang.String[] getContentLanguage()
                                      throws MessagingException

Определите языки в заголовке Языка контента этого MimePart. Заголовок Языка контента определяется RFC 1766. Возвраты null если этот заголовок не доступен, или его значение отсутствует.

Эта реализация использование getHeader(name) получить необходимое поле заголовка.

Определенный:

getContentLanguage в интерфейсе MimePart

Броски:

MessagingException

setContentLanguage

public void setContentLanguage(java.lang.String[] languages)
                        throws MessagingException

Установите заголовок Языка контента этого MimePart. Заголовок Языка контента определяется RFC 1766.

Определенный:

setContentLanguage в интерфейсе MimePart

Параметры:

languages - массив тегов языка

Броски:

MessagingException

getDescription

public java.lang.String getDescription()
                                throws MessagingException

Возвращает поле заголовка "Описания контента" этой части тела. Это обычно связывает некоторую дескриптивную информацию с этой частью. Нуль возвратов, если это поле недоступно или его значение, отсутствует.

Если поле Content-Description кодируется согласно RFC 2047, оно декодируется и преобразовывается в Unicode. Если декодирование или сбои преобразования, необработанные данные возвращаются, как.

Эта реализация использование getHeader(name) получить необходимое поле заголовка.

Определенный:

getDescription в интерфейсе Part

Возвраты:

описание контента

Броски:

MessagingException

setDescription

public void setDescription(java.lang.String description)
                    throws MessagingException

Установите поле заголовка "Описания контента" для этой части тела. Если параметр описания null, тогда любые существующие поля "Content-Description" удаляются.

Если описание будет содержать не символы US-ASCII, то оно будет закодировано, используя набор символов значения по умолчанию платформы. Если описание содержит только символы US-ASCII, никакое кодирование не делается, и оно используется как есть.

Отметьте, что, если процесс кодирования набора символов перестал работать, MessagingException бросается, и UnsupportedEncodingException включается в цепочку вложенных исключений в пределах MessagingException.

Определенный:

setDescription в интерфейсе Part

Параметры:

description - описание контента

Броски:

IllegalWriteException - если базовая реализация не поддерживает модификацию

IllegalStateException - если эта часть тела получается из папки READ_ONLY.

MessagingException - иначе; UnsupportedEncodingException может быть включен в цепочку исключения, если преобразование набора символов перестало работать.

setDescription

public void setDescription(java.lang.String description,
                           java.lang.String charset)
                    throws MessagingException

Установите поле заголовка "Описания контента" для этой части тела. Если параметр описания null, тогда любые существующие поля "Content-Description" удаляются.

Если описание будет содержать не символы US-ASCII, то оно будет закодировано, используя указанный набор символов. Если описание содержит только символы US-ASCII, никакое кодирование не делается, и оно используется как есть.

Отметьте, что, если процесс кодирования набора символов перестал работать, MessagingException бросается, и UnsupportedEncodingException включается в цепочку вложенных исключений в пределах MessagingException.

Параметры:

description - Описание

charset - Набор символов для того, чтобы закодировать

Броски:

IllegalWriteException - если базовая реализация не поддерживает модификацию

IllegalStateException - если эта часть тела получается из папки READ_ONLY.

MessagingException - иначе; UnsupportedEncodingException может быть включен в цепочку исключения, если преобразование набора символов перестало работать.

getFileName

public java.lang.String getFileName()
                             throws MessagingException

Свяжите имя файла с этой частью тела.

Возвращает значение параметра "имени файла" от поля заголовка "Расположения контента" этой части тела. Если не доступный, возвращает значение параметра "имени" от поля заголовка "Типа контента" этой части тела. Возвраты null если оба отсутствуют.

Если mail.mime.decodefilename Системное свойство устанавливается в истину, MimeUtility.decodeText метод будет использоваться, чтобы декодировать имя файла. В то время как такое кодирование не поддерживается спецификацией MIME, много почтовых программ используют этот метод, чтобы поддерживать символы неASCII в именах файлов. Значение по умолчанию этого свойства является ложью.

Определенный:

getFileName в интерфейсе Part

Возвраты:

имя файла

Броски:

MessagingException

setFileName

public void setFileName(java.lang.String filename)
                 throws MessagingException

Установите имя файла, связанное с этой частью тела, если возможный.

Устанавливает параметры "имени файла" поля заголовка "Расположения контента" этой части тела. Для совместимости с более старыми почтовыми программами также устанавливаются параметры "имени" заголовка "Типа контента".

Если mail.mime.encodefilename Системное свойство устанавливается в истину, MimeUtility.encodeText метод будет использоваться, чтобы закодировать имя файла. В то время как такое кодирование не поддерживается спецификацией MIME, много почтовых программ используют этот метод, чтобы поддерживать символы неASCII в именах файлов. Значение по умолчанию этого свойства является ложью.

Определенный:

setFileName в интерфейсе Part

Параметры:

filename - Имя файла, чтобы связаться с этой частью

Броски:

IllegalWriteException - если базовая реализация не поддерживает модификацию

IllegalStateException - если эта часть тела получается из папки READ_ONLY.

MessagingException

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.io.IOException,
                                          MessagingException

Возвратите декодируемый входной поток для этой части тела "контент".

Эта реализация получает входной поток из DataHandler. Таким образом, это вызывает getDataHandler ().getInputStream ();

Определенный:

getInputStream в интерфейсе Part

Возвраты:

InputStream

Броски:

MessagingException

java.io.IOException - это обычно бросается DataHandler. Сошлитесь на документацию для javax.activation. DataHandler для большего количества деталей.

См. Также:

getContentStream(), DataHandler.getInputStream()

getContentStream

protected java.io.InputStream getContentStream()
                                        throws MessagingException

Произведите необработанные байты контента. Этот метод используется, создавая объект DataHandler для контента. Подклассы, которые могут обеспечить отдельный входной поток для только контента Части, могли бы хотеть переопределить этот метод.

Броски:

MessagingException

См. Также:

content, MimeMessage#getContentStream

getRawInputStream

public java.io.InputStream getRawInputStream()
                                      throws MessagingException

Возвратите InputStream необработанным данным с любым неповрежденным Кодированием передачи контента. Этот метод полезен, если бы заголовок "Кодирования передачи контента" является неправильным или поврежденным, который предотвратил бы getInputStream метод или getContent метод от возврата корректных данных. В таком случае приложение может использовать этот метод и попытаться декодировать необработанные данные самостоятельно.

Эта реализация просто вызывает getContentStream метод.

Броски:

MessagingException

С тех пор:

JavaMail 1.2

См. Также:

getInputStream(), getContentStream()

getDataHandler

public javax.activation.DataHandler getDataHandler()
                                            throws MessagingException

Возвратите DataHandler для этого контента части тела.

Реализация, обеспеченная здесь, работает точно так же как реализация в MimeMessage.

Определенный:

getDataHandler в интерфейсе Part

Возвраты:

DataHandler для контента

Броски:

MessagingException

См. Также:

MimeMessage#getDataHandler

getContent

public java.lang.Object getContent()
                            throws java.io.IOException,
                                   MessagingException

Возвратите контент как объект Java. Тип возвращенного объекта, конечно, зависит от контента непосредственно. Например, собственный формат контента текста/плоскости обычно является Строковым объектом. Собственный формат для "многослойного" контента всегда является Многослойным подклассом. Для типов контента, которые неизвестны системе DataHandler, входной поток возвращается как контент.

Эта реализация получает контент из DataHandler. Таким образом, это вызывает getDataHandler ().getContent (); Если контент является Многослойным объектом или объектом сообщения и создавался, анализируя поток, объект кэшируется и возвращается в последующих вызовах так, чтобы модификации к контенту не были потеряны.

Определенный:

getContent в интерфейсе Part

Возвраты:

Объект

Броски:

MessagingException

java.io.IOException - это обычно бросается DataHandler. Сошлитесь на документацию для javax.activation. DataHandler для большего количества деталей.

См. Также:

DataHandler.getContent()

setDataHandler

public void setDataHandler(javax.activation.DataHandler dh)
                    throws MessagingException

Этот метод обеспечивает механизм, чтобы установить этот контент части тела. Данный объект DataHandler должен обернуть фактический контент.

Определенный:

setDataHandler в интерфейсе Part

Параметры:

dh - DataHandler для контента

Броски:

IllegalWriteException - если базовая реализация не поддерживает модификацию

IllegalStateException - если эта часть тела получается из папки READ_ONLY.

MessagingException

setContent

public void setContent(java.lang.Object o,
                       java.lang.String type)
                throws MessagingException

Метод удобства для того, чтобы установить этот контент части тела.

Контент обертывается в объект DataHandler. Отметьте, что DataContentHandler class для указанного типа должен быть доступным реализации JavaMail для этого, чтобы работать правильно. Таким образом, чтобы сделать setContent(foobar, "application/x-foobar"), DataContentHandler для "application/x-foobar" должен быть установлен. Обратитесь к Платформе Активации Java для получения дополнительной информации.

Определенный:

setContent в интерфейсе Part

Параметры:

o - объект контента

type - Тип пантомимы объекта

Броски:

IllegalWriteException - если базовая реализация не поддерживает модификацию существующих значений

IllegalStateException - если эта часть тела получается из папки READ_ONLY.

MessagingException

setText

public void setText(java.lang.String text)
             throws MessagingException

Метод удобства, который устанавливает данную Строку как контент этой части с типом MIME "текста/плоскости". Если строка будет содержать не символы US-ASCII, то она будет закодирована, используя набор символов значения по умолчанию платформы. Набор символов также используется, чтобы установить параметры "набора символов".

Отметьте, что может быть потеря производительности если text является большим, так как этому методу, вероятно, придется отсканировать все символы, чтобы определить что набор символов использовать.

Если набор символов уже известен, используйте setText метод, который берет параметр набора символов.

Определенный:

setText в интерфейсе MimePart

Определенный:

setText в интерфейсе Part

Параметры:

text - текстовый контент, чтобы установить

Броски:

MessagingException - если ошибка происходит

См. Также:

setText(String text, String charset)

setText

public void setText(java.lang.String text,
                    java.lang.String charset)
             throws MessagingException

Метод удобства, который устанавливает данную Строку как контент этой части с типом MIME "текста/плоскости" и указанного набора символов. Данная строка Unicode будет закодирована набором символов, используя указанный набор символов. Набор символов также используется, чтобы установить параметры "набора символов".

Определенный:

setText в интерфейсе MimePart

Параметры:

text - текстовый контент, чтобы установить

charset - набор символов, чтобы использовать для текста

Броски:

MessagingException - если ошибка происходит

setText

public void setText(java.lang.String text,
                    java.lang.String charset,
                    java.lang.String subtype)
             throws MessagingException

Метод удобства, который устанавливает данную Строку как контент этой части с основным типом MIME "текста" и указанного подтипа MIME. Данная строка Unicode будет закодирована набором символов, используя указанный набор символов. Набор символов также используется, чтобы установить параметры "набора символов".

Определенный:

setText в интерфейсе MimePart

Параметры:

text - текстовый контент, чтобы установить

charset - набор символов, чтобы использовать для текста

subtype - подтип MIME, чтобы использовать (например, "html")

Броски:

MessagingException - если ошибка происходит

С тех пор:

JavaMail 1.4

setContent

public void setContent(Multipart mp)
                throws MessagingException

Этот метод устанавливает контент части тела в Многослойный объект.

Определенный:

setContent в интерфейсе Part

Параметры:

mp - Многослойный объект, который является контентом сообщения

Броски:

IllegalWriteException - если базовая реализация не поддерживает модификацию существующих значений.

IllegalStateException - если эта часть тела получается из папки READ_ONLY.

MessagingException

attachFile

public void attachFile(java.io.File file)
                throws java.io.IOException,
                       MessagingException

Используйте указанный файл, чтобы обеспечить данные для этой части. Простое имя файла используется в качестве имени файла для этой части, и данные в файле используются в качестве данных для этой части. Кодирование будет выбрано соответственно для данных файла.

Параметры:

file - объект Файла присоединить

Броски:

java.io.IOException - ошибки, связанные с доступом к файлу

MessagingException - передайте связанные ошибки

С тех пор:

JavaMail 1.4

attachFile

public void attachFile(java.lang.String file)
                throws java.io.IOException,
                       MessagingException

Используйте указанный файл, чтобы обеспечить данные для этой части. Простое имя файла используется в качестве имени файла для этой части, и данные в файле используются в качестве данных для этой части. Кодирование будет выбрано соответственно для данных файла.

Параметры:

file - имя файла, чтобы присоединить

Броски:

java.io.IOException - ошибки, связанные с доступом к файлу

MessagingException - передайте связанные ошибки

С тех пор:

JavaMail 1.4

saveFile

public void saveFile(java.io.File file)
              throws java.io.IOException,
                     MessagingException

Сохраните содержание этой части в указанном файле. Контент декодируется и сохраняется без любого из заголовков MIME.

Параметры:

file - объект Файла записать в

Броски:

java.io.IOException - ошибки, связанные с доступом к файлу

MessagingException - передайте связанные ошибки

С тех пор:

JavaMail 1.4

saveFile

public void saveFile(java.lang.String file)
              throws java.io.IOException,
                     MessagingException

Сохраните содержание этой части в указанном файле. Контент декодируется и сохраняется без любого из заголовков MIME.

Параметры:

file - имя файла, чтобы записать в

Броски:

java.io.IOException - ошибки, связанные с доступом к файлу

MessagingException - передайте связанные ошибки

С тех пор:

JavaMail 1.4

writeTo

public void writeTo(java.io.OutputStream os)
             throws java.io.IOException,
                    MessagingException

Выведите часть тела как поток формата RFC 822.

Определенный:

writeTo в интерфейсе Part

Броски:

MessagingException

java.io.IOException - если ошибка происходит, пишущий в поток или если ошибка сгенерирована javax.activation уровнем.

См. Также:

DataHandler.writeTo(java.io.OutputStream)

getHeader

public java.lang.String[] getHeader(java.lang.String name)
                             throws MessagingException

Получите все заголовки для этого header_name. Отметьте, что определенные заголовки могут быть закодированы согласно RFC 2047, если они содержат не символы US-ASCII, и они должны декодироваться.

Определенный:

getHeader в интерфейсе Part

Параметры:

name - имя заголовка

Возвраты:

массив заголовков

Броски:

MessagingException

См. Также:

MimeUtility

getHeader

public java.lang.String getHeader(java.lang.String name,
                                  java.lang.String delimiter)
                           throws MessagingException

Получите все заголовки для этого имени заголовка, возвращенного как единственная Строка, с заголовками, разделенными разделителем. Если разделитель null, только первый заголовок возвращается.

Определенный:

getHeader в интерфейсе MimePart

Параметры:

name - имя этого заголовка

delimiter - разделитель между полями в возвращенной строке

Возвраты:

поля значения для всех заголовков с этим именем

Броски:

MessagingException

setHeader

public void setHeader(java.lang.String name,
                      java.lang.String value)
               throws MessagingException

Установите значение для этого header_name. Замены весь существующий заголовок оценивают с этим новым значением. Отметьте, что заголовки RFC 822 должны содержать только символы US-ASCII, таким образом, заголовок, который содержит не символы US-ASCII, должен быть закодирован согласно правилам RFC 2047.

Определенный:

setHeader в интерфейсе Part

Параметры:

name - имя заголовка

value - значение заголовка

Броски:

MessagingException

См. Также:

MimeUtility

addHeader

public void addHeader(java.lang.String name,
                      java.lang.String value)
               throws MessagingException

Добавьте это значение к существующим значениям для этого header_name. Отметьте, что заголовки RFC 822 должны содержать только символы US-ASCII, таким образом, заголовок, который содержит не символы US-ASCII, должен быть закодирован согласно правилам RFC 2047.

Определенный:

addHeader в интерфейсе Part

Параметры:

name - имя заголовка

value - значение заголовка

Броски:

MessagingException

См. Также:

MimeUtility

removeHeader

public void removeHeader(java.lang.String name)
                  throws MessagingException

Удалите все заголовки с этим именем.

Определенный:

removeHeader в интерфейсе Part

Параметры:

name - имя этого заголовка

Броски:

MessagingException

getAllHeaders

public java.util.Enumeration getAllHeaders()
                                    throws MessagingException

Возвратите все заголовки из этого сообщения как Перечисление объектов Заголовка.

Определенный:

getAllHeaders в интерфейсе Part

Возвраты:

перечисление объектов Заголовка

Броски:

MessagingException

getMatchingHeaders

public java.util.Enumeration getMatchingHeaders(java.lang.String[] names)
                                         throws MessagingException

Возвратите соответствие заголовков из этого сообщения как Перечисление объектов Заголовка.

Определенный:

getMatchingHeaders в интерфейсе Part

Возвраты:

перечисление объектов Заголовка

Броски:

MessagingException

getNonMatchingHeaders

public java.util.Enumeration getNonMatchingHeaders(java.lang.String[] names)
                                            throws MessagingException

Возвратите несоответствие заголовков из этого сообщения как Перечисление объектов Заголовка.

Определенный:

getNonMatchingHeaders в интерфейсе Part

Возвраты:

перечисление объектов Заголовка

Броски:

MessagingException

addHeaderLine

public void addHeaderLine(java.lang.String line)
                   throws MessagingException

Добавьте строку заголовка к этой части тела

Определенный:

addHeaderLine в интерфейсе MimePart

Броски:

MessagingException

getAllHeaderLines

public java.util.Enumeration getAllHeaderLines()
                                        throws MessagingException

Получите все строки заголовка как Перечисление Строк. Строка Заголовка является необработанной строкой заголовка RFC 822, содержа обоих поле "имени" и "значения".

Определенный:

getAllHeaderLines в интерфейсе MimePart

Броски:

MessagingException

getMatchingHeaderLines

public java.util.Enumeration getMatchingHeaderLines(java.lang.String[] names)
                                             throws MessagingException

Получите соответствие строк заголовка как Перечисление Строк. Строка Заголовка является необработанной строкой заголовка RFC 822, содержа обоих поле "имени" и "значения".

Определенный:

getMatchingHeaderLines в интерфейсе MimePart

Броски:

MessagingException

getNonMatchingHeaderLines

public java.util.Enumeration getNonMatchingHeaderLines(java.lang.String[] names)
                                                throws MessagingException

Получите несоответствие строк заголовка как Перечисление Строк. Строка Заголовка является необработанной строкой заголовка RFC 822, содержа обоих поле "имени" и "значения".

Определенный:

getNonMatchingHeaderLines в интерфейсе MimePart

Броски:

MessagingException

updateHeaders

protected void updateHeaders()
                      throws MessagingException

Исследуйте контент этой части тела и обновите соответствующие заголовки MIME. Типичные заголовки, которые устанавливаются здесь, Content-Type и Content-Transfer-Encoding. Заголовки, возможно, должны были бы быть обновлены в двух случаях:
- Сообщение, обрабатываемое почтовым приложением, должно будет, конечно, активировать этот метод в некоторый момент, чтобы заполнить его внутренние заголовки.
- Чтение сообщения в от Хранилища получит все свои заголовки из хранилища, и так не нуждается в этом. Однако, если это сообщение доступно для редактирования и если какие-либо редактирования были сделаны или к контенту или к структуре сообщения, мы, возможно, должны были бы повторно синхронизировать наши заголовки.
В обоих случаях этот метод обычно вызывают Message.saveChanges метод.

Броски:

MessagingException