Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
java.lang.Object javax.mail.Message javax.mail.internet.MimeMessage
public class MimeMessage
Этот 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 должны содержать только символы US-ASCII. MIME позволяет не символам ASCII присутствовать в определенных частях определенных заголовков, кодируя те символы. RFC 2047 определяет правила для того, чтобы сделать это. MimeUtility class, обеспеченный в этом пакете, может привыкнуть к достигнуть этого. Вызывающие стороны setHeader
, addHeader
, и addHeaderLine
методы ответственны за осуществление требований MIME для указанных заголовков. Кроме того, эти поля заголовка должны быть свернуты (обернутые) прежде, чем быть отправленным, если они превышают ограничение длины строки для транспорта (1000 байтов для SMTP)., Возможно, были свернуты полученные заголовки. Приложение ответственно за сворачивание и разворачивание заголовков как соответствующий.
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
protected byte[] content
protected java.io.InputStream contentStream
contentStream
другой такой поток, представляющий контент этого сообщения. В этом случае, content
будет нуль.
protected InternetHeaders headers
protected Flags flags
protected boolean modified
content
массив, как предполагается, допустим и используется непосредственно в writeTo
метод. Этот флаг устанавливается в истину, когда пустое сообщение создается или когда saveChanges
метод вызывают.
protected boolean saved
saveChanges
потребность метода, которую вызовут на этом сообщении? Этот флаг устанавливается в ложь общедоступным конструктором и устанавливается в истину saveChanges
метод. writeTo
метод проверяет этот флаг и вызывает saveChanges
метод по мере необходимости. Это избегает частой ошибки упущения вызвать saveChanges
метод на недавно созданном сообщении.
Деталь конструктора |
---|
public MimeMessage(Session session)
headers
поле устанавливается в пустой объект InternetHeaders. flags
поле устанавливается в пустой объект Флагов. modified
флаг устанавливается в истину.
public MimeMessage(Session session, java.io.InputStream is) throws MessagingException
Входной поток содержит весь MIME отформатированное сообщение с заголовками и данными.
session
- Объект сеанса для этого сообщенияis
- входной поток сообщения MessagingException
public MimeMessage(MimeMessage source) throws MessagingException
source
MimeMessage. Новое сообщение независимо от оригинала. Отметьте: текущая реализация довольно неэффективна, копируя данные больше раз чем строго необходимый.
source
- сообщение, чтобы скопировать контент с MessagingException
protected MimeMessage(Folder folder, int msgnum)
Этот метод для разделения на подклассы провайдеров MimeMessage
.
protected MimeMessage(Folder folder, java.io.InputStream is, int msgnum) throws MessagingException
Этот метод для разделения на подклассы провайдеров MimeMessage
.
folder
- Содержание папки.is
- входной поток сообщенияmsgnum
- Номер сообщения этого сообщения в пределах его папки MessagingException
protected MimeMessage(Folder folder, InternetHeaders headers, byte[] content, int msgnum) throws MessagingException
MimeMessage
.
folder
- Содержание папки.headers
- Заголовкиcontent
- Контент сообщенияmsgnum
- Номер сообщения этого сообщения в пределах его папки MessagingException
Деталь метода |
---|
protected void parse(java.io.InputStream is) throws MessagingException
headers
и content
поля соответственно. Также сбросы modified
флаг. Этот метод предназначается для использования подклассами, которые должны управлять, когда InputStream анализируется.
is
- Входной поток сообщения MessagingException
public Address[] getFrom() throws MessagingException
null
возвращается. Эта реализация использует getHeader
метод, чтобы получить необходимое поле заголовка.
getFrom
в class Message
MessagingException
headers
public void setFrom(Address address) throws MessagingException
null
, этот заголовок удаляется.
setFrom
в class Message
address
- отправитель этого сообщения IllegalWriteException
- если базовая реализация не поддерживает модификацию существующих значений IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
public void setFrom() throws MessagingException
InternetAddress.getLocalAddress
метод.
setFrom
в class Message
IllegalWriteException
- если базовая реализация не поддерживает модификацию существующих значений IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
public void addFrom(Address[] addresses) throws MessagingException
addFrom
в class Message
addresses
- отправители этого сообщения IllegalWriteException
- если базовая реализация не поддерживает модификацию существующих значений IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
public Address getSender() throws MessagingException
null
возвращается. Эта реализация использует getHeader
метод, чтобы получить необходимое поле заголовка.
MessagingException
headers
public void setSender(Address address) throws MessagingException
null
, этот заголовок удаляется.
address
- отправитель этого сообщения IllegalWriteException
- если базовая реализация не поддерживает модификацию существующих значений IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
public Address[] getRecipients(Message.RecipientType type) throws MessagingException
Message.RecipientType.TO "To" Message.RecipientType.CC "Cc" Message.RecipientType.BCC "Bcc" MimeMessage.RecipientType.NEWSGROUPS "Newsgroups"
Эта реализация использует getHeader
метод, чтобы получить необходимое поле заголовка.
getRecipients
в class Message
type
- Тип получателя MessagingException
- если заголовок не мог бы быть получен AddressException
- если заголовок является misformattedheaders
, Message.RecipientType.TO
, Message.RecipientType.CC
, Message.RecipientType.BCC
, MimeMessage.RecipientType.NEWSGROUPS
public Address[] getAllRecipients() throws MessagingException
getAllRecipients
в class Message
MessagingException
Message.RecipientType.TO
, Message.RecipientType.CC
, Message.RecipientType.BCC
, MimeMessage.RecipientType.NEWSGROUPS
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)
public void setRecipients(Message.RecipientType type, java.lang.String addresses) throws MessagingException
null
, соответствующее поле получателя удаляется.
type
- Тип получателяaddresses
- Адреса AddressException
- если попытка проанализировать Строковые сбои адресов IllegalWriteException
- если базовая реализация не поддерживает модификацию существующих значений IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
getRecipients(javax.mail.Message.RecipientType)
public void addRecipients(Message.RecipientType type, Address[] addresses) throws MessagingException
addRecipients
в class Message
type
- Тип получателяaddresses
- Адреса IllegalWriteException
- если базовая реализация не поддерживает модификацию существующих значений IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
public void addRecipients(Message.RecipientType type, java.lang.String addresses) throws MessagingException
type
- Тип получателяaddresses
- Адреса AddressException
- если попытка проанализировать Строковые сбои адресов IllegalWriteException
- если базовая реализация не поддерживает модификацию существующих значений IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
public Address[] getReplyTo() throws MessagingException
getFrom
метод вызывают, и его значение возвращается. Эта реализация использует getHeader
метод, чтобы получить необходимое поле заголовка.
getReplyTo
в class Message
MessagingException
headers
public void setReplyTo(Address[] addresses) throws MessagingException
null
, этот заголовок удаляется.
setReplyTo
в class Message
addresses
- адреса, к которым должны быть направлены ответы IllegalWriteException
- если базовая реализация не поддерживает модификацию существующих значений IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
public java.lang.String getSubject() throws MessagingException
Если предмет кодируется согласно RFC 2047, он декодируется и преобразовывается в Unicode. Если декодирование или сбои преобразования, необработанные данные возвращаются, как.
Эта реализация использует getHeader
метод, чтобы получить необходимое поле заголовка.
getSubject
в class Message
MessagingException
headers
public void setSubject(java.lang.String subject) throws MessagingException
Приложение должно гарантировать, что предмет не содержит разрывов строки.
Отметьте, что, если процесс кодирования набора символов перестал работать, MessagingException бросается, и UnsupportedEncodingException включается в цепочку вложенных исключений в пределах MessagingException.
setSubject
в class Message
subject
- Предмет IllegalWriteException
- если базовая реализация не поддерживает модификацию существующих значений IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException.
- UnsupportedEncodingException может быть включен в цепочку исключения, если преобразование набора символов перестало работать. MessagingException
public void setSubject(java.lang.String subject, java.lang.String charset) throws MessagingException
Приложение должно гарантировать, что предмет не содержит разрывов строки.
Отметьте, что, если процесс кодирования набора символов перестал работать, MessagingException бросается, и UnsupportedEncodingException включается в цепочку вложенных исключений в пределах MessagingException.
subject
- Предметcharset
- Набор символов IllegalWriteException
- если базовая реализация не поддерживает модификацию существующих значений IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException.
- UnsupportedEncodingException может быть включен в цепочку исключения, если преобразование набора символов перестало работать. MessagingException
public java.util.Date getSentDate() throws MessagingException
Эта реализация использует getHeader
метод, чтобы получить необходимое поле заголовка.
getSentDate
в class Message
MessagingException
public void setSentDate(java.util.Date d) throws MessagingException
null
, существующее поле "Date" удаляется.
setSentDate
в class Message
d
- отправленная дата этого сообщения IllegalWriteException
- если базовая реализация не поддерживает модификацию IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
public java.util.Date getReceivedDate() throws MessagingException
null
если эта дата не может быть получена. Отметьте, что RFC 822 не определяет поле для полученной даты. Следовательно только реализации, которые могут обеспечить эту дату, должны возвратить допустимое значение.
Эта реализация возвраты null
.
getReceivedDate
в class Message
MessagingException
public int getSize() throws MessagingException
Отметьте, что это число, возможно, не точная мера размера контента, и можете, или, возможно, не учитывает кодирования передачи контента.
Эта реализация возвращает размер content
массив (если не нуль), или, если contentStream
не нуль, и available
метод возвращает положительное число, он возвращает то число как размер. Иначе, это возвращается-1.
getSize
в интерфейсе Part
MessagingException
public int getLineCount() throws MessagingException
Отметьте, что это число, возможно, не точная мера длины контента, и можете, или, возможно, не учитывает кодирования передачи контента.
Эта реализация возвращается-1.
getLineCount
в интерфейсе Part
MessagingException
public java.lang.String getContentType() throws MessagingException
Эта реализация использует getHeader
метод, чтобы получить необходимое поле заголовка.
getContentType
в интерфейсе Part
MessagingException
DataHandler
public boolean isMimeType(java.lang.String mimeType) throws MessagingException
primaryType
и subType
. Параметры типов контента игнорируются. Например, этот метод возвратится true
сравнивая Часть типа контента "текст/плоскость" с "текстом/плоскостью; charset=foobar".
Если subType
из mimeType
специальный символ '*', тогда подтип игнорируется во время сравнения.
isMimeType
в интерфейсе Part
MessagingException
public java.lang.String getDisposition() throws MessagingException
Если поле Content-Disposition недоступно, null
возвращается.
Эта реализация использует getHeader
метод, чтобы получить необходимое поле заголовка.
getDisposition
в интерфейсе Part
MessagingException
Part.ATTACHMENT
, Part.INLINE
, Part.getFileName()
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)
public java.lang.String getEncoding() throws MessagingException
null
если заголовок недоступен, или его значение отсутствует. Эта реализация использует getHeader
метод, чтобы получить необходимое поле заголовка.
getEncoding
в интерфейсе MimePart
MessagingException
public java.lang.String getContentID() throws MessagingException
null
если поле недоступно, или его значение отсутствует. Эта реализация использует getHeader
метод, чтобы получить необходимое поле заголовка.
getContentID
в интерфейсе MimePart
MessagingException
public void setContentID(java.lang.String cid) throws MessagingException
cid
параметр является нулем, любой существующий "ID контента" удаляется.
IllegalWriteException
- если базовая реализация не поддерживает модификацию IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
public java.lang.String getContentMD5() throws MessagingException
null
если это поле недоступно, или его значение отсутствует. Эта реализация использует getHeader
метод, чтобы получить необходимое поле заголовка.
getContentMD5
в интерфейсе MimePart
MessagingException
public void setContentMD5(java.lang.String md5) throws MessagingException
setContentMD5
в интерфейсе MimePart
md5
- значение MD5 IllegalWriteException
- если базовая реализация не поддерживает модификацию IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
public java.lang.String getDescription() throws MessagingException
Если поле Content-Description кодируется согласно RFC 2047, оно декодируется и преобразовывается в Unicode. Если декодирование или сбои преобразования, необработанные данные возвращаются как есть
Эта реализация использует getHeader
метод, чтобы получить необходимое поле заголовка.
getDescription
в интерфейсе Part
MessagingException
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
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
public java.lang.String[] getContentLanguage() throws MessagingException
null
если это поле недоступно, или его значение отсутствует. Эта реализация использует getHeader
метод, чтобы получить необходимое поле заголовка.
getContentLanguage
в интерфейсе MimePart
MessagingException
public void setContentLanguage(java.lang.String[] languages) throws MessagingException
setContentLanguage
в интерфейсе MimePart
languages
- массив тегов языка IllegalWriteException
- если базовая реализация не поддерживает модификацию IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
public java.lang.String getMessageID() throws MessagingException
Реализация по умолчанию, обеспеченная здесь, использует getHeader
метод, чтобы возвратить значение поля "ID сообщения".
MessagingException
- если извлечение этого поля вызывает какое-либо исключение.MessageIDTerm
public java.lang.String getFileName() throws MessagingException
Возвращает значение параметра "имени файла" от поля заголовка "Расположения контента" этого сообщения. Если это не доступно, возвращает значение параметра "имени" от поля заголовка "Типа контента" этого BodyPart. Возвраты null
если оба отсутствуют.
Если mail.mime.encodefilename
Системное свойство устанавливается в истину, MimeUtility.decodeText
метод будет использоваться, чтобы декодировать имя файла. В то время как такое кодирование не поддерживается спецификацией MIME, много почтовых программ используют этот метод, чтобы поддерживать символы неASCII в именах файлов. Значение по умолчанию этого свойства является ложью.
getFileName
в интерфейсе Part
MessagingException
public void setFileName(java.lang.String filename) throws MessagingException
Устанавливает параметры "имени файла" поля заголовка "Расположения контента" этого сообщения.
Если mail.mime.encodefilename
Системное свойство устанавливается в истину, MimeUtility.encodeText
метод будет использоваться, чтобы закодировать имя файла. В то время как такое кодирование не поддерживается спецификацией MIME, много почтовых программ используют этот метод, чтобы поддерживать символы неASCII в именах файлов. Значение по умолчанию этого свойства является ложью.
setFileName
в интерфейсе Part
filename
- Имя файла, чтобы связаться с этой частью IllegalWriteException
- если базовая реализация не поддерживает модификацию IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
public java.io.InputStream getInputStream() throws java.io.IOException, MessagingException
Эта реализация получает входной поток из DataHandler, то есть, это вызывает getDataHandler().getInputStream()
.
getInputStream
в интерфейсе Part
MessagingException
java.io.IOException
- это обычно бросается DataHandler. Сошлитесь на документацию для javax.activation. DataHandler для большего количества деталей.getContentStream()
, DataHandler.getInputStream()
protected java.io.InputStream getContentStream() throws MessagingException
Эта реализация возвращает SharedInputStream, если contentStream
не нуль. Иначе, это возвращает ByteArrayInputStream, созданный из content
байтовый массив.
MessagingException
content
public java.io.InputStream getRawInputStream() throws MessagingException
getInputStream
метод или getContent
метод от возврата корректных данных. В таком случае приложение может использовать этот метод и попытаться декодировать необработанные данные самостоятельно. Эта реализация просто вызывает getContentStream
метод.
MessagingException
getInputStream()
, getContentStream()
public javax.activation.DataHandler getDataHandler() throws MessagingException
Реализация, обеспеченная здесь, работает следующим образом. Отметьте использование 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
MessagingException
public java.lang.Object getContent() throws java.io.IOException, MessagingException
Эта реализация получает контент из DataHandler, то есть, это вызывает getDataHandler().getContent()
. Если контент является Многослойным объектом или объектом сообщения и создавался, анализируя поток, объект кэшируется и возвращается в последующих вызовах так, чтобы модификации к контенту не были потеряны.
getContent
в интерфейсе Part
MessagingException
java.io.IOException
- это обычно бросается DataHandler. Сошлитесь на документацию для javax.activation. DataHandler для большего количества деталей.Part
, DataHandler.getContent()
public void setDataHandler(javax.activation.DataHandler dh) throws MessagingException
setDataHandler
в интерфейсе Part
dh
- DataHandler для контента. IllegalWriteException
- если базовая реализация не поддерживает модификацию IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
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
public void setText(java.lang.String text) throws MessagingException
Отметьте, что может быть потеря производительности если text
является большим, так как этому методу, вероятно, придется отсканировать все символы, чтобы определить что набор символов использовать.
Если набор символов уже известен, используйте setText
метод, который берет параметр набора символов.
setText
в интерфейсе MimePart
setText
в интерфейсе Part
text
- текстовый контент, чтобы установить MessagingException
- если ошибка происходитsetText(String text, String charset)
public void setText(java.lang.String text, java.lang.String charset) throws MessagingException
setText
в интерфейсе MimePart
text
- текстовый контент, чтобы установитьcharset
- набор символов, чтобы использовать для текста MessagingException
- если ошибка происходитpublic void setText(java.lang.String text, java.lang.String charset, java.lang.String subtype) throws MessagingException
setText
в интерфейсе MimePart
text
- текстовый контент, чтобы установитьcharset
- набор символов, чтобы использовать для текстаsubtype
- подтип MIME, чтобы использовать (например, "html") MessagingException
- если ошибка происходит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
public void writeTo(java.io.OutputStream os) throws java.io.IOException, MessagingException
Отметьте, что, в зависимости от того, как messag был создан, он может использовать множество соглашений завершения строки. Обычно вывод должен быть отправлен через соответствующий FilterOutputStream, который преобразовывает разделители строки в требуемую форму, или CRLF для совместимости MIME и для использования в интернет-протоколах, или разделитель строки локальной платформы для хранения в локальном текстовом файле.
Эта реализация вызывает writeTo(OutputStream, String[])
метод с нулевым черным списком.
writeTo
в интерфейсе Part
java.io.IOException
- если ошибка происходит, пишущий в поток или если ошибка сгенерирована javax.activation уровнем. MessagingException
DataHandler.writeTo(java.io.OutputStream)
public void writeTo(java.io.OutputStream os, java.lang.String[] ignoreList) throws java.io.IOException, MessagingException
saved
флаг не устанавливается, saveChanges
метод вызывают. Если modified
флаг не устанавливается и content
массив не является нулем, content
массив пишется непосредственно после записи соответствующих заголовков сообщения.
MessagingException
java.io.IOException
- если ошибка происходит, пишущий в поток или если ошибка сгенерирована javax.activation уровнем.DataHandler.writeTo(java.io.OutputStream)
public java.lang.String[] getHeader(java.lang.String name) throws MessagingException
Эта реализация получает заголовки из headers
Объект InternetHeaders.
getHeader
в интерфейсе Part
name
- имя заголовка MessagingException
MimeUtility
public java.lang.String getHeader(java.lang.String name, java.lang.String delimiter) throws MessagingException
null
, только первый заголовок возвращается.
getHeader
в интерфейсе MimePart
name
- имя этого заголовкаdelimiter
- разделитель между значениями MessagingException
public void setHeader(java.lang.String name, java.lang.String value) throws MessagingException
setHeader
в интерфейсе Part
name
- имя заголовкаvalue
- значение заголовка IllegalWriteException
- если базовая реализация не поддерживает модификацию IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
MimeUtility
public void addHeader(java.lang.String name, java.lang.String value) throws MessagingException
addHeader
в интерфейсе Part
name
- имя заголовкаvalue
- значение заголовка IllegalWriteException
- если базовая реализация не поддерживает модификацию IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
MimeUtility
public void removeHeader(java.lang.String name) throws MessagingException
removeHeader
в интерфейсе Part
name
- имя этого заголовка IllegalWriteException
- если базовая реализация не поддерживает модификацию IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
public java.util.Enumeration getAllHeaders() throws MessagingException
Отметьте, что определенные заголовки могут быть закодированы согласно RFC 2047, если они содержат не символы US-ASCII, и они должны декодироваться.
Эта реализация получает заголовки из headers
Объект InternetHeaders.
getAllHeaders
в интерфейсе Part
MessagingException
MimeUtility
public java.util.Enumeration getMatchingHeaders(java.lang.String[] names) throws MessagingException
headers
Объект InternetHeaders.
getMatchingHeaders
в интерфейсе Part
MessagingException
public java.util.Enumeration getNonMatchingHeaders(java.lang.String[] names) throws MessagingException
headers
Объект InternetHeaders.
getNonMatchingHeaders
в интерфейсе Part
MessagingException
public void addHeaderLine(java.lang.String line) throws MessagingException
addHeaderLine
в интерфейсе MimePart
IllegalWriteException
- если базовая реализация не поддерживает модификацию IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
public java.util.Enumeration getAllHeaderLines() throws MessagingException
getAllHeaderLines
в интерфейсе MimePart
MessagingException
public java.util.Enumeration getMatchingHeaderLines(java.lang.String[] names) throws MessagingException
getMatchingHeaderLines
в интерфейсе MimePart
MessagingException
public java.util.Enumeration getNonMatchingHeaderLines(java.lang.String[] names) throws MessagingException
getNonMatchingHeaderLines
в интерфейсе MimePart
MessagingException
public Flags getFlags() throws MessagingException
Flags
объект, содержащий флаги для этого сообщения. Отметьте, что клон внутреннего объекта Флагов возвращается, так изменение возвращенного объекта Флагов не будет влиять на флаги этого сообщения.
getFlags
в class Message
MessagingException
Flags
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
public void setFlags(Flags flag, boolean set) throws MessagingException
Эта реализация изменяет flags
поле.
setFlags
в class Message
flag
- Объект флагов, содержащий флаги, которые будут установленыset
- значение, которое будет установлено IllegalWriteException
- если базовая реализация не поддерживает модификацию IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
MessageChangedEvent
public void saveChanges() throws MessagingException
Если какая-либо часть заголовков сообщения или содержания изменяется, saveChanges
должен быть вызван, чтобы гарантировать, что те изменения являются постоянными. Иначе, любые такие модификации могут или не могут быть сохранены, в зависимости от реализации папки.
Сообщения, полученные из папок, открытый READ_ONLY не должен быть изменен и saveChanges, нельзя вызвать на таких сообщениях.
Этот метод устанавливает modified
отметьте к истине, save
отметьте к истине, и затем вызовите updateHeaders
метод.
saveChanges
в class Message
IllegalWriteException
- если базовая реализация не поддерживает модификацию IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
protected void updateMessageID() throws MessagingException
updateHeaders
и позволяет подклассу переопределять только алгоритм для того, чтобы выбрать ID сообщения.
MessagingException
protected void updateHeaders() throws MessagingException
saveChanges
метод, чтобы фактически обновить заголовки MIME. Реализация здесь устанавливает Content-Transfer-Encoding
заголовок (если нужно и не уже набор), MIME-Version
заголовок и Message-ID
заголовок. Кроме того, если контент этого сообщения является a MimeMultipart
, это updateHeaders
метод вызывают.
IllegalWriteException
- если базовая реализация не поддерживает модификацию IllegalStateException
- если это сообщение получается из папки READ_ONLY. MessagingException
protected InternetHeaders createInternetHeaders(java.io.InputStream is) throws MessagingException
is
- InputStream, чтобы считать заголовки из MessagingException
protected MimeMessage createMimeMessage(Session session) throws MessagingException
session
- Сеанс, чтобы использовать для нового сообщения MessagingException
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41