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


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41


Spec-Zone.ru - all specs in one place



free hit counter