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

javax.mail.internet
Класс MimeMessage

java.lang.Object
  javax.mail.Message
      javax.mail.internet.MimeMessage

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

MimePart, Часть

public class MimeMessage
расширяет сообщение
реализации MimePart

Этот class представляет электронное письмо стиля MIME. Это реализует Message абстрактный class и MimePart интерфейс.

Клиенты, желающие создать новые сообщения стиля MIME, инстанцируют пустого объекта MimeMessage и затем заполнят его соответствующими атрибутами и контентом.

Поставщики услуг, которые реализуют MIME совместимые хранилища бэкэнда, могут хотеть разделить MimeMessage на подклассы и переопределить определенные методы, чтобы обеспечить определенные реализации. Самый простой случай является, вероятно, провайдером, который генерирует входной поток стиля MIME и листы парсинг потока к этому class.

MimeMessage использует InternetHeaders class, чтобы проанализировать и сохранить высокоуровневые RFC 822 заголовки сообщения.

mail.mime.address.strict свойство сеанса управляет парсингом заголовков адреса. По умолчанию строгий парсинг заголовков адреса делается. Если это свойство устанавливается в "false", строгий парсинг не делается и много недопустимых адресов, которые иногда происходят в реальных сообщениях, позволяются. См. InternetAddress class для деталей.

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

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

Автор:

Джон Мани, Билл Шеннон, Макс Спивэк, Kanwar Oberoi

См. Также:

MimeUtility, Part, Message, MimePart, InternetAddress

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

static class

MimeMessage. RecipientType Этот внутренний class расширяет javax.mail. Сообщение. RecipientType class, чтобы добавить дополнительный RecipientTypes.

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

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

Поля, наследованные от class javax.mail. Сообщение

expunged, folder, msgnum, session

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

ATTACHMENT, INLINE

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

protected	MimeMessage(Folder folder, java.io.InputStream is, int msgnum) Создает MimeMessage, читая и анализируя данные от указанного MIME InputStream.
protected	MimeMessage(Folder folder, int msgnum) Создает пустой объект MimeMessage с данной Папкой и номером сообщения.
protected	MimeMessage(Folder folder, InternetHeaders headers, byte[] content, int msgnum) Создает MimeMessage из данного объекта InternetHeaders и контента.
	MimeMessage(MimeMessage source) Создает новый MimeMessage с контентом, инициализированным от source MimeMessage.
	MimeMessage(Session session) Конструктор по умолчанию.
	MimeMessage(Session session, java.io.InputStream is) Создает MimeMessage, читая и анализируя данные от указанного MIME InputStream.

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

void	addFrom(Address[] addresses) Добавьте указанные адреса к существующему полю "От".
void	addHeader(java.lang.String name, java.lang.String value) Добавьте это значение к существующим значениям для этого header_name.
void	addHeaderLine(java.lang.String line) Добавьте необработанную строку заголовка RFC 822.
void	addRecipients(Message.RecipientType type, Address[] addresses) Добавьте данные адреса к указанному типу получателя.
void	addRecipients(Message.RecipientType type, java.lang.String addresses) Добавьте данные адреса к указанному типу получателя.
protected InternetHeaders	createInternetHeaders(java.io.InputStream is) Создайте и возвратитесь, InternetHeaders возражают, что загружает заголовки из данного InputStream.
protected MimeMessage	createMimeMessage(Session session) Создайте и возвратите объект MimeMessage.
java.util.Enumeration	getAllHeaderLines() Получите все строки заголовка как Перечисление Строк.
java.util.Enumeration	getAllHeaders() Возвратите все заголовки из этого сообщения как перечисление объектов Заголовка.
Адрес[]	getAllRecipients() Получите все адреса получателя для сообщения.
java.lang.Object	getContent() Возвратите контент как объект Java.
java.lang.String	getContentID() Возвращает значение поля заголовка "ID контента".
java.lang.String[]	getContentLanguage() Определите языки в поле заголовка "Языка контента" этого сообщения.
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() Свяжите имя файла с этим сообщением.
Флаги	getFlags() Возвратите a Flags объект, содержащий флаги для этого сообщения.
Адрес[]	getFrom() Возвращает значение RFC 822 "От" полей заголовка.
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.lang.String	getMessageID() Возвращает значение поля заголовка "ID сообщения".
java.util.Enumeration	getNonMatchingHeaderLines(java.lang.String[] names) Получите несоответствие строк заголовка как Перечисление Строк.
java.util.Enumeration	getNonMatchingHeaders(java.lang.String[] names) Возвратите несоответствие заголовков из этого сообщения как Перечисление объектов Заголовка.
java.io.InputStream	getRawInputStream() Возвратите InputStream необработанным данным с любым неповрежденным Кодированием передачи контента.
java.util.Date	getReceivedDate() Возвращается Дата на этом сообщении была получена.
Адрес[]	getRecipients(Message.RecipientType type) Возвращает получателей, определенных типом.
Адрес[]	getReplyTo() Возвратите значение RFC 822 "Ответ - К" полю заголовка.
Адрес	getSender() Возвращает значение поля заголовка "Отправителя" RFC 822.
java.util.Date	getSentDate() Возвращает значение поля "Date" RFC 822.
int	getSize() Возвратите размер контента этого сообщения в байтах.
java.lang.String	getSubject() Возвращает значение "Подчиненного" поля заголовка.
boolean	isMimeType(java.lang.String mimeType) Эта Часть имеет указанный тип MIME? Этот метод сравнивается только primaryType и subType.
boolean	isSet(Flags.Flag flag) Проверьте ли флаг, определенный в flag параметр устанавливается в этом сообщении.
protected void	parse(java.io.InputStream is) Проанализируйте установку InputStream headers и content поля соответственно.
void	removeHeader(java.lang.String name) Удалите все заголовки с этим именем.
Сообщение	reply(boolean replyToAll) Получите новое сообщение, подходящее для ответа на это сообщение.
void	saveChanges() Обновляет соответствующие поля заголовка этого сообщения, чтобы быть непротиворечивым с содержанием сообщения.
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	setFlags(Flags flag, boolean set) Установите флаги для этого сообщения.
void	setFrom() Установите RFC 822 "От" поля заголовка, используя значение InternetAddress.getLocalAddress метод.
void	setFrom(Address address) Установите RFC 822 "От" поля заголовка.
void	setHeader(java.lang.String name, java.lang.String value) Установите значение для этого header_name.
void	setRecipients(Message.RecipientType type, Address[] addresses) Установите указанный тип получателя в данные адреса.
void	setRecipients(Message.RecipientType type, java.lang.String addresses) Установите указанный тип получателя в данные адреса.
void	setReplyTo(Address[] addresses) Установите RFC 822 "Ответ - К" полю заголовка.
void	setSender(Address address) Установите поле заголовка "Отправителя" RFC 822.
void	setSentDate(java.util.Date d) Установите поле заголовка "Даты" RFC 822.
void	setSubject(java.lang.String subject) Установите "Подчиненное" поле заголовка.
void	setSubject(java.lang.String subject, java.lang.String charset) Установите "Подчиненное" поле заголовка.
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() Вызванный saveChanges метод, чтобы фактически обновить заголовки MIME.
protected void	updateMessageID() Обновите заголовок ID сообщения.
void	writeTo(java.io.OutputStream os) Выведите сообщение как поток формата RFC 822.
void	writeTo(java.io.OutputStream os, java.lang.String[] ignoreList) Выведите сообщение как поток формата RFC 822 без указанных заголовков.

Методы, наследованные от class javax.mail. Сообщение

addRecipient, getFolder, getMessageNumber, isExpunged, match, setExpunged, setFlag, setMessageNumber, setRecipient

Методы, наследованные от 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 возражают, что хранит заголовок этого сообщения.

флаги

protected Flags flags

Флаги для этого сообщения.

измененный

protected boolean modified

Флаг, указывающий, было ли сообщение изменено. Если сообщение не было изменено, никакие данные в content массив, как предполагается, допустим и используется непосредственно в writeTo метод. Этот флаг устанавливается в истину, когда пустое сообщение создается или когда saveChanges метод вызывают.

С тех пор:

JavaMail 1.2

сохраненный

protected boolean saved

Делает saveChanges потребность метода, которую вызовут на этом сообщении? Этот флаг устанавливается в ложь общедоступным конструктором и устанавливается в истину saveChanges метод. writeTo метод проверяет этот флаг и вызывает saveChanges метод по мере необходимости. Это избегает частой ошибки упущения вызвать saveChanges метод на недавно созданном сообщении.

С тех пор:

JavaMail 1.2

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

MimeMessage

public MimeMessage(Session session)

Конструктор по умолчанию. Создается пустой объект сообщения. headers поле устанавливается в пустой объект InternetHeaders. flags поле устанавливается в пустой объект Флагов. modified флаг устанавливается в истину.

MimeMessage

public MimeMessage(Session session,
                   java.io.InputStream is)
            throws MessagingException

Создает MimeMessage, читая и анализируя данные от указанного MIME InputStream. InputStream оставят расположенным в конце данных для сообщения. Отметьте, что входной потоковый синтаксический анализ делается в пределах этого конструктора непосредственно.

Входной поток содержит весь MIME отформатированное сообщение с заголовками и данными.

Параметры:

session - Объект сеанса для этого сообщения

is - входной поток сообщения

Броски:

MessagingException

MimeMessage

public MimeMessage(MimeMessage source)
            throws MessagingException

Создает новый MimeMessage с контентом, инициализированным от source MimeMessage. Новое сообщение независимо от оригинала.

Отметьте: текущая реализация довольно неэффективна, копируя данные больше раз чем строго необходимый.

Параметры:

source - сообщение, чтобы скопировать контент с

Броски:

MessagingException

С тех пор:

JavaMail 1.2

MimeMessage

protected MimeMessage(Folder folder,
                      int msgnum)

Создает пустой объект MimeMessage с данной Папкой и номером сообщения.

Этот метод для разделения на подклассы провайдеров MimeMessage.

MimeMessage

protected MimeMessage(Folder folder,
                      java.io.InputStream is,
                      int msgnum)
               throws MessagingException

Создает MimeMessage, читая и анализируя данные от указанного MIME InputStream. InputStream оставят расположенным в конце данных для сообщения. Отметьте, что входной потоковый синтаксический анализ делается в пределах этого конструктора непосредственно.

Этот метод для разделения на подклассы провайдеров MimeMessage.

Параметры:

folder - Содержание папки.

is - входной поток сообщения

msgnum - Номер сообщения этого сообщения в пределах его папки

Броски:

MessagingException

MimeMessage

protected MimeMessage(Folder folder,
                      InternetHeaders headers,
                      byte[] content,
                      int msgnum)
               throws MessagingException

Создает MimeMessage из данного объекта InternetHeaders и контента. Этот метод для разделения на подклассы провайдеров MimeMessage.

Параметры:

folder - Содержание папки.

headers - Заголовки

content - Контент сообщения

msgnum - Номер сообщения этого сообщения в пределах его папки

Броски:

MessagingException

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

синтаксический анализ

protected void parse(java.io.InputStream is)
              throws MessagingException

Проанализируйте установку InputStream headers и content поля соответственно. Также сбросы modified флаг.

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

Параметры:

is - Входной поток сообщения

Броски:

MessagingException

getFrom

public Address[] getFrom()
                  throws MessagingException

Возвращает значение RFC 822 "От" полей заголовка. Если это поле заголовка отсутствует, поле заголовка "Отправителя" используется. Если поле заголовка "Отправителя" также отсутствует, null возвращается.

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

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

getFrom в class Message

Возвраты:

Объект адреса

Броски:

MessagingException

См. Также:

headers

setFrom

public void setFrom(Address address)
             throws MessagingException

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

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

setFrom в class Message

Параметры:

address - отправитель этого сообщения

Броски:

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

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

MessagingException

setFrom

public void setFrom()
             throws MessagingException

Установите RFC 822 "От" поля заголовка, используя значение InternetAddress.getLocalAddress метод.

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

setFrom в class Message

Броски:

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

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

MessagingException

addFrom

public void addFrom(Address[] addresses)
             throws MessagingException

Добавьте указанные адреса к существующему полю "От". Если поле "От" уже не существует, оно создается.

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

addFrom в class Message

Параметры:

addresses - отправители этого сообщения

Броски:

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

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

MessagingException

getSender

public Address getSender()
                  throws MessagingException

Возвращает значение поля заголовка "Отправителя" RFC 822. Если поле заголовка "Отправителя" отсутствует, null возвращается.

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

Возвраты:

Объект адреса

Броски:

MessagingException

С тех пор:

JavaMail 1.3

См. Также:

headers

setSender

public void setSender(Address address)
               throws MessagingException

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

Параметры:

address - отправитель этого сообщения

Броски:

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

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

MessagingException

С тех пор:

JavaMail 1.3

getRecipients

public Address[] getRecipients(Message.RecipientType type)
                        throws MessagingException

Возвращает получателей, определенных типом. Отображение между типом и соответствующим заголовком RFC 822 следующие:

                Message.RecipientType.TO                "To"
                Message.RecipientType.CC                "Cc"
                Message.RecipientType.BCC               "Bcc"
                MimeMessage.RecipientType.NEWSGROUPS    "Newsgroups"
 

Нуль возвратов, если заголовок, определенный типом, не находится или если его значение пусто.

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

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

getRecipients в class Message

Параметры:

type - Тип получателя

Возвраты:

массив объектов Адреса

Броски:

MessagingException - если заголовок не мог бы быть получен

AddressException - если заголовок является misformatted

См. Также:

headers, Message.RecipientType.TO, Message.RecipientType.CC, Message.RecipientType.BCC, MimeMessage.RecipientType.NEWSGROUPS

getAllRecipients

public Address[] getAllRecipients()
                           throws MessagingException

Получите все адреса получателя для сообщения. Извлекает TO, CC, BCC, и получателей ГРУПП НОВОСТЕЙ.

Переопределения:

getAllRecipients в class Message

Возвраты:

массив объектов Адреса

Броски:

MessagingException

См. Также:

Message.RecipientType.TO, Message.RecipientType.CC, Message.RecipientType.BCC, MimeMessage.RecipientType.NEWSGROUPS

setRecipients

public void setRecipients(Message.RecipientType type,
                          Address[] addresses)
                   throws MessagingException

Установите указанный тип получателя в данные адреса. Если параметр адреса null, соответствующее поле получателя удаляется.

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

setRecipients в class Message

Параметры:

type - Тип получателя

addresses - Адреса

Броски:

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

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

MessagingException

См. Также:

getRecipients(javax.mail.Message.RecipientType)

setRecipients

public void setRecipients(Message.RecipientType type,
                          java.lang.String addresses)
                   throws MessagingException

Установите указанный тип получателя в данные адреса. Если параметр адреса null, соответствующее поле получателя удаляется.

Параметры:

type - Тип получателя

addresses - Адреса

Броски:

AddressException - если попытка проанализировать Строковые сбои адресов

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

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

MessagingException

С тех пор:

JavaMail 1.2

См. Также:

getRecipients(javax.mail.Message.RecipientType)

addRecipients

public void addRecipients(Message.RecipientType type,
                          Address[] addresses)
                   throws MessagingException

Добавьте данные адреса к указанному типу получателя.

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

addRecipients в class Message

Параметры:

type - Тип получателя

addresses - Адреса

Броски:

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

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

MessagingException

addRecipients

public void addRecipients(Message.RecipientType type,
                          java.lang.String addresses)
                   throws MessagingException

Добавьте данные адреса к указанному типу получателя.

Параметры:

type - Тип получателя

addresses - Адреса

Броски:

AddressException - если попытка проанализировать Строковые сбои адресов

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

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

MessagingException

С тех пор:

JavaMail 1.2

getReplyTo

public Address[] getReplyTo()
                     throws MessagingException

Возвратите значение RFC 822 "Ответ - К" полю заголовка. Если этот заголовок недоступен, или его значение отсутствует, то getFrom метод вызывают, и его значение возвращается. Эта реализация использует getHeader метод, чтобы получить необходимое поле заголовка.

Переопределения:

getReplyTo в class Message

Возвраты:

адреса, к которым должны быть направлены ответы

Броски:

MessagingException

См. Также:

headers

setReplyTo

public void setReplyTo(Address[] addresses)
                throws MessagingException

Установите RFC 822 "Ответ - К" полю заголовка. Если параметр адреса null, этот заголовок удаляется.

Переопределения:

setReplyTo в class Message

Параметры:

addresses - адреса, к которым должны быть направлены ответы

Броски:

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

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

MessagingException

getSubject

public java.lang.String getSubject()
                            throws MessagingException

Возвращает значение "Подчиненного" поля заголовка. Нуль возвратов, если предметная область недоступна или ее значение, отсутствует.

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

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

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

getSubject в class Message

Возвраты:

Предмет

Броски:

MessagingException

См. Также:

headers

setSubject

public void setSubject(java.lang.String subject)
                throws MessagingException

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

Приложение должно гарантировать, что предмет не содержит разрывов строки.

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

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

setSubject в class Message

Параметры:

subject - Предмет

Броски:

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

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

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

MessagingException

setSubject

public void setSubject(java.lang.String subject,
                       java.lang.String charset)
                throws MessagingException

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

Приложение должно гарантировать, что предмет не содержит разрывов строки.

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

Параметры:

subject - Предмет

charset - Набор символов

Броски:

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

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

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

MessagingException

getSentDate

public java.util.Date getSentDate()
                           throws MessagingException

Возвращает значение поля "Date" RFC 822. Это - дата, в которую было отправлено это сообщение. Нуль возвратов, если это поле недоступно или его значение, отсутствует.

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

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

getSentDate в class Message

Возвраты:

Отправленная Дата

Броски:

MessagingException

setSentDate

public void setSentDate(java.util.Date d)
                 throws MessagingException

Установите поле заголовка "Даты" RFC 822. Это - дата, в которую создатель сообщения указывает, что сообщение полно и готово к поставке. Если параметр даты null, существующее поле "Date" удаляется.

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

setSentDate в class Message

Параметры:

d - отправленная дата этого сообщения

Броски:

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

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

MessagingException

getReceivedDate

public java.util.Date getReceivedDate()
                               throws MessagingException

Возвращается Дата на этом сообщении была получена. Возвраты null если эта дата не может быть получена.

Отметьте, что RFC 822 не определяет поле для полученной даты. Следовательно только реализации, которые могут обеспечить эту дату, должны возвратить допустимое значение.

Эта реализация возвраты null.

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

getReceivedDate в class Message

Возвраты:

дата это сообщение была получена

Броски:

MessagingException

getSize

public int getSize()
            throws MessagingException

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

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

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

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

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

Возвраты:

размер контента в байтах

Броски:

MessagingException

getLineCount

public int getLineCount()
                 throws MessagingException

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

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

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

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

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

Возвраты:

число строк в контенте.

Броски:

MessagingException

getContentType

public java.lang.String getContentType()
                                throws MessagingException

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

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

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

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

Возвраты:

ContentType этой части

Броски:

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 недоступно, null возвращается.

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

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

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

Возвраты:

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

Броски:

MessagingException

См. Также:

Part.ATTACHMENT, Part.INLINE, Part.getFileName()

setDisposition

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

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

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

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 метод, чтобы получить необходимое поле заголовка.

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

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

Возвраты:

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

Броски:

MessagingException

getContentID

public java.lang.String getContentID()
                              throws MessagingException

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

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

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

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

Возвраты:

ID контента

Броски:

MessagingException

setContentID

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

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

Броски:

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

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

MessagingException

getContentMD5

public java.lang.String getContentMD5()
                               throws MessagingException

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

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

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

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

Возвраты:

контент-MD5

Броски:

MessagingException

setContentMD5

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

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

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

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

Параметры:

md5 - значение MD5

Броски:

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

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

MessagingException

getDescription

public java.lang.String getDescription()
                                throws MessagingException

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

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

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

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

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 может быть включен в цепочку исключения, если преобразование набора символов перестало работать.

MessagingException

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 может быть включен в цепочку исключения, если преобразование набора символов перестало работать.

MessagingException

getContentLanguage

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

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

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

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

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

Возвраты:

значение заголовка языка контента.

Броски:

MessagingException

setContentLanguage

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

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

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

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

Параметры:

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

Броски:

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

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

MessagingException

getMessageID

public java.lang.String getMessageID()
                              throws MessagingException

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

Реализация по умолчанию, обеспеченная здесь, использует getHeader метод, чтобы возвратить значение поля "ID сообщения".

Возвраты:

ID сообщения

Броски:

MessagingException - если извлечение этого поля вызывает какое-либо исключение.

С тех пор:

JavaMail 1.1

См. Также:

MessageIDTerm

getFileName

public java.lang.String getFileName()
                             throws MessagingException

Свяжите имя файла с этим сообщением.

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

Если mail.mime.encodefilename Системное свойство устанавливается в истину, 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 для контента. Подклассы, которые могут обеспечить отдельный входной поток для только контента сообщения, могли бы хотеть переопределить этот метод.

Эта реализация возвращает SharedInputStream, если contentStream не нуль. Иначе, это возвращает ByteArrayInputStream, созданный из content байтовый массив.

Броски:

MessagingException

См. Также:

content

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 для контента этого сообщения.

Реализация, обеспеченная здесь, работает следующим образом. Отметьте использование getContentStream метод, чтобы генерировать поток байтов для контента. Также отметьте, что любое декодирование передачи делается автоматически в пределах этого метода.

  getDataHandler() {
      if (dh == null) {
          dh = new DataHandler(new MimePartDataSource(this));
      }
      return dh;
  }
  

  class MimePartDataSource implements DataSource {
      public getInputStream() {
          return MimeUtility.decode(
                     getContentStream(), getEncoding());
      }
        
                .... 
  }
 

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

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

Возвраты:

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

Броски:

MessagingException

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 для большего количества деталей.

См. Также:

Part, 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

ответ

public Message reply(boolean replyToAll)
              throws MessagingException

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

Если replyToAll устанавливается, новое сообщение будет адресоваться всем получателям этого сообщения. Иначе, ответ будет адресоваться только отправителю этого сообщения (использующий значение getReplyTo метод).

Поле "Subject" заполнено в исходным предметом, снабженным префиксом "Ре:" (если это уже не запускается с "Ре:"). "В ответ на" заголовок устанавливается в новом сообщении, если у этого сообщения есть заголовок "Идентификатора сообщения". ANSWERED флаг устанавливается в этом сообщении. Текущая реализация также устанавливает "Ссылочный" заголовок в новом сообщении, чтобы включать содержание "Ссылочного" заголовка (или, отсутствуя, "В ответ на" заголовок) в этом сообщении, плюс содержание заголовка "Идентификатора сообщения" этого сообщения, как описано в RFC 2822.

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

reply в class Message

Параметры:

replyToAll - ответ должен быть отправлен всем получателям этого сообщения

Возвраты:

ответное сообщение

Броски:

MessagingException

writeTo

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

Выведите сообщение как поток формата RFC 822.

Отметьте, что, в зависимости от того, как messag был создан, он может использовать множество соглашений завершения строки. Обычно вывод должен быть отправлен через соответствующий FilterOutputStream, который преобразовывает разделители строки в требуемую форму, или CRLF для совместимости MIME и для использования в интернет-протоколах, или разделитель строки локальной платформы для хранения в локальном текстовом файле.

Эта реализация вызывает writeTo(OutputStream, String[]) метод с нулевым черным списком.

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

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

Броски:

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

MessagingException

См. Также:

DataHandler.writeTo(java.io.OutputStream)

writeTo

public void writeTo(java.io.OutputStream os,
                    java.lang.String[] ignoreList)
             throws java.io.IOException,
                    MessagingException

Выведите сообщение как поток формата RFC 822 без указанных заголовков. Если saved флаг не устанавливается, saveChanges метод вызывают. Если modified флаг не устанавливается и content массив не является нулем, content массив пишется непосредственно после записи соответствующих заголовков сообщения.

Броски:

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, и они должны декодироваться.

Эта реализация получает заголовки из headers Объект InternetHeaders.

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

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 - значение заголовка

Броски:

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

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

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 - значение заголовка

Броски:

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

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

MessagingException

См. Также:

MimeUtility

removeHeader

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

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

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

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

Параметры:

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

Броски:

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

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

MessagingException

getAllHeaders

public java.util.Enumeration getAllHeaders()
                                    throws MessagingException

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

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

Эта реализация получает заголовки из headers Объект InternetHeaders.

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

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

Возвраты:

массив объектов заголовка

Броски:

MessagingException

См. Также:

MimeUtility

getMatchingHeaders

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

Возвратите соответствие заголовков из этого сообщения как Перечисление объектов Заголовка. Эта реализация получает заголовки из headers Объект InternetHeaders.

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

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

Возвраты:

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

Броски:

MessagingException

getNonMatchingHeaders

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

Возвратите несоответствие заголовков из этого сообщения как Перечисление объектов Заголовка. Эта реализация получает заголовок из headers Объект InternetHeaders.

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

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

Возвраты:

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

Броски:

MessagingException

addHeaderLine

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

Добавьте необработанную строку заголовка RFC 822.

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

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

Броски:

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

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

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

getFlags

public Flags getFlags()
               throws MessagingException

Возвратите a Flags объект, содержащий флаги для этого сообщения.

Отметьте, что клон внутреннего объекта Флагов возвращается, так изменение возвращенного объекта Флагов не будет влиять на флаги этого сообщения.

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

getFlags в class Message

Возвраты:

Объект флагов, содержащий флаги для этого сообщения

Броски:

MessagingException

См. Также:

Flags

isSet

public boolean isSet(Flags.Flag flag)
              throws MessagingException

Проверьте ли флаг, определенный в flag параметр устанавливается в этом сообщении.

Эта реализация проверяет это внутреннее сообщение flags объект.

Переопределения:

isSet в class Message

Параметры:

flag - флаг

Возвраты:

значение указанного флага для этого сообщения

Броски:

MessagingException

См. Также:

Flags.Flag, Flags.Flag.ANSWERED, Flags.Flag.DELETED, Flags.Flag.DRAFT, Flags.Flag.FLAGGED, Flags.Flag.RECENT, Flags.Flag.SEEN

setFlags

public void setFlags(Flags flag,
                     boolean set)
              throws MessagingException

Установите флаги для этого сообщения.

Эта реализация изменяет flags поле.

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

setFlags в class Message

Параметры:

flag - Объект флагов, содержащий флаги, которые будут установлены

set - значение, которое будет установлено

Броски:

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

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

MessagingException

См. Также:

MessageChangedEvent

saveChanges

public void saveChanges()
                 throws MessagingException

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

Если какая-либо часть заголовков сообщения или содержания изменяется, saveChanges должен быть вызван, чтобы гарантировать, что те изменения являются постоянными. Иначе, любые такие модификации могут или не могут быть сохранены, в зависимости от реализации папки.

Сообщения, полученные из папок, открытый READ_ONLY не должен быть изменен и saveChanges, нельзя вызвать на таких сообщениях.

Этот метод устанавливает modified отметьте к истине, save отметьте к истине, и затем вызовите updateHeaders метод.

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

saveChanges в class Message

Броски:

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

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

MessagingException

updateMessageID

protected void updateMessageID()
                        throws MessagingException

Обновите заголовок ID сообщения. Этот метод вызывают updateHeaders и позволяет подклассу переопределять только алгоритм для того, чтобы выбрать ID сообщения.

Броски:

MessagingException

С тех пор:

JavaMail 1.4

updateHeaders

protected void updateHeaders()
                      throws MessagingException

Вызванный saveChanges метод, чтобы фактически обновить заголовки MIME. Реализация здесь устанавливает Content-Transfer-Encoding заголовок (если нужно и не уже набор), MIME-Version заголовок и Message-ID заголовок. Кроме того, если контент этого сообщения является a MimeMultipart, это updateHeaders метод вызывают.

Броски:

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

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

MessagingException

createInternetHeaders

protected InternetHeaders createInternetHeaders(java.io.InputStream is)
                                         throws MessagingException

Создайте и возвратитесь, InternetHeaders возражают, что загружает заголовки из данного InputStream. Подклассы могут переопределить этот метод, чтобы возвратить подкласс InternetHeaders в случае необходимости. Эта реализация просто создает и возвращает объект InternetHeaders.

Параметры:

is - InputStream, чтобы считать заголовки из

Броски:

MessagingException

С тех пор:

JavaMail 1.2

createMimeMessage

protected MimeMessage createMimeMessage(Session session)
                                 throws MessagingException

Создайте и возвратите объект MimeMessage. Метод ответа использует этот метод, чтобы создать объект MimeMessage, что это возвратится. Подклассы могут переопределить этот метод, чтобы возвратить подкласс MimeMessage. Эта реализация просто создает и возвращает объект MimeMessage использование предоставленного Сеанса.

Параметры:

session - Сеанс, чтобы использовать для нового сообщения

Возвраты:

новый объект MimeMessage

Броски:

MessagingException

С тех пор:

JavaMail 1.4