javax.mail.internet
Класс MimeBodyPart

java.lang.Object
  расширенный javax.mail.BodyPart
      расширенный javax.mail.internet.MimeBodyPart
Все Реализованные Интерфейсы:
MimePart, Часть
Прямые Известные Подклассы:
PreencodedMimeBodyPart

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

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

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


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

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

Автор:
Джон Мани, Билл Шеннон, Kanwar Oberoi
См. Также:
Part, MimePart, MimeUtility

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

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

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

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


контент

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


contentStream

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

С тех пор:
JavaMail 1.2

заголовки

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

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

MimeBodyPart

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


MimeBodyPart

public MimeBodyPart(java.io.InputStream is)
             throws MessagingException
Создает MimeBodyPart, читая и анализируя данные от указанного входного потока. Синтаксический анализатор использует данные до конца данного входного потока. Входной поток должен запуститься в начале допустимой части тела MIME и должен завершиться в конце той части тела.

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

Параметры:
is - Входной Поток части тела
Броски:
MessagingException

MimeBodyPart

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

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

Параметры:
headers - Заголовок этой части
content - байты, представляющие тело этой части.
Броски:
MessagingException
Деталь метода

getSize

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

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

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

Определенный:
getSize в интерфейсе Part
Возвраты:
размер в байтах, или-1, если не известный
Броски:
MessagingException

getLineCount

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

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

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

Определенный:
getLineCount в интерфейсе Part
Возвраты:
число строк, или-1, если не известный
Броски:
MessagingException

getContentType

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

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

Определенный:
getContentType в интерфейсе Part
Возвраты:
Тип контента этой части тела
Броски:
MessagingException
См. Также:
DataHandler

isMimeType

public boolean isMimeType(java.lang.String mimeType)
                   throws MessagingException
Эта Часть имеет указанный тип MIME? Этот метод сравнивается только primaryType и subType. Параметры типов контента игнорируются.

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

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

Определенный:
isMimeType в интерфейсе Part
Броски:
MessagingException

getDisposition

public java.lang.String getDisposition()
                                throws MessagingException
Возвращает значение поля заголовка "Расположения контента". Это представляет расположение этой части. Расположение описывает, как часть должна быть представлена пользователю.

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

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

Определенный:
getDisposition в интерфейсе Part
Возвраты:
расположение этой части, или нуль если неизвестный
Броски:
MessagingException
См. Также:
headers

setDisposition

public void setDisposition(java.lang.String disposition)
                    throws MessagingException
Установите поле заголовка "Расположения контента" этой части тела. Если расположение является нулем, любое существующее поле заголовка "Расположения контента" удаляется.

Определенный:
setDisposition в интерфейсе Part
Параметры:
disposition - расположение этой части
Броски:
IllegalWriteException - если базовая реализация не поддерживает модификацию
IllegalStateException - если эта часть тела получается из папки READ_ONLY.
MessagingException
См. Также:
Part.ATTACHMENT, Part.INLINE, Part.setFileName(java.lang.String)

getEncoding

public java.lang.String getEncoding()
                             throws MessagingException
Возвращает кодирование передачи контента из поля заголовка "Кодирования передачи контента". Возвраты null если заголовок недоступен, или его значение отсутствует.

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

Определенный:
getEncoding в интерфейсе MimePart
Возвраты:
кодирование передачи контента
Броски:
MessagingException
См. Также:
headers

getContentID

public java.lang.String getContentID()
                              throws MessagingException
Возвращает значение поля заголовка "ID контента". Возвраты null если поле недоступно, или его значение отсутствует.

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

Определенный:
getContentID в интерфейсе MimePart
Возвраты:
ID контента
Броски:
MessagingException

setContentID

public void setContentID(java.lang.String cid)
                  throws MessagingException
Установите поле заголовка "ID контента" этой части тела. Если cid параметр является нулем, любой существующий "ID контента" удаляется.

Броски:
IllegalWriteException - если базовая реализация не поддерживает модификацию
IllegalStateException - если эта часть тела получается из папки READ_ONLY.
MessagingException
С тех пор:
JavaMail 1.3

getContentMD5

public java.lang.String getContentMD5()
                               throws MessagingException
Возвратите значение поля заголовка "Контента-MD5". Возвраты null если это поле недоступно, или его значение отсутствует.

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

Определенный:
getContentMD5 в интерфейсе MimePart
Возвраты:
контент-MD5
Броски:
MessagingException

setContentMD5

public void setContentMD5(java.lang.String md5)
                   throws MessagingException
Установите поле заголовка "Контента-MD5" этой части тела.

Определенный:
setContentMD5 в интерфейсе MimePart
Параметры:
md5 - значение MD5
Броски:
IllegalWriteException - если базовая реализация не поддерживает модификацию
IllegalStateException - если эта часть тела получается из папки READ_ONLY.
MessagingException

getContentLanguage

public java.lang.String[] getContentLanguage()
                                      throws MessagingException
Определите языки в заголовке Языка контента этого MimePart. Заголовок Языка контента определяется RFC 1766. Возвраты null если этот заголовок не доступен, или его значение отсутствует.

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

Определенный:
getContentLanguage в интерфейсе MimePart
Броски:
MessagingException

setContentLanguage

public void setContentLanguage(java.lang.String[] languages)
                        throws MessagingException
Установите заголовок Языка контента этого MimePart. Заголовок Языка контента определяется RFC 1766.

Определенный:
setContentLanguage в интерфейсе MimePart
Параметры:
languages - массив тегов языка
Броски:
MessagingException

getDescription

public java.lang.String getDescription()
                                throws MessagingException
Возвращает поле заголовка "Описания контента" этой части тела. Это обычно связывает некоторую дескриптивную информацию с этой частью. Нуль возвратов, если это поле недоступно или его значение, отсутствует.

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

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

Определенный:
getDescription в интерфейсе Part
Возвраты:
описание контента
Броски:
MessagingException

setDescription

public void setDescription(java.lang.String description)
                    throws MessagingException
Установите поле заголовка "Описания контента" для этой части тела. Если параметр описания null, тогда любые существующие поля "Content-Description" удаляются.

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

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

Определенный:
setDescription в интерфейсе Part
Параметры:
description - описание контента
Броски:
IllegalWriteException - если базовая реализация не поддерживает модификацию
IllegalStateException - если эта часть тела получается из папки READ_ONLY.
MessagingException - иначе; UnsupportedEncodingException может быть включен в цепочку исключения, если преобразование набора символов перестало работать.

setDescription

public void setDescription(java.lang.String description,
                           java.lang.String charset)
                    throws MessagingException
Установите поле заголовка "Описания контента" для этой части тела. Если параметр описания null, тогда любые существующие поля "Content-Description" удаляются.

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

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

Параметры:
description - Описание
charset - Набор символов для того, чтобы закодировать
Броски:
IllegalWriteException - если базовая реализация не поддерживает модификацию
IllegalStateException - если эта часть тела получается из папки READ_ONLY.
MessagingException - иначе; UnsupportedEncodingException может быть включен в цепочку исключения, если преобразование набора символов перестало работать.

getFileName

public java.lang.String getFileName()
                             throws MessagingException
Свяжите имя файла с этой частью тела.

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

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

Определенный:
getFileName в интерфейсе Part
Возвраты:
имя файла
Броски:
MessagingException

setFileName

public void setFileName(java.lang.String filename)
                 throws MessagingException
Установите имя файла, связанное с этой частью тела, если возможный.

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

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

Определенный:
setFileName в интерфейсе Part
Параметры:
filename - Имя файла, чтобы связаться с этой частью
Броски:
IllegalWriteException - если базовая реализация не поддерживает модификацию
IllegalStateException - если эта часть тела получается из папки READ_ONLY.
MessagingException

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.io.IOException,
                                          MessagingException
Возвратите декодируемый входной поток для этой части тела "контент".

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

Определенный:
getInputStream в интерфейсе Part
Возвраты:
InputStream
Броски:
MessagingException
java.io.IOException - это обычно бросается DataHandler. Сошлитесь на документацию для javax.activation. DataHandler для большего количества деталей.
См. Также:
getContentStream(), DataHandler.getInputStream()

getContentStream

protected java.io.InputStream getContentStream()
                                        throws MessagingException
Произведите необработанные байты контента. Этот метод используется, создавая объект DataHandler для контента. Подклассы, которые могут обеспечить отдельный входной поток для только контента Части, могли бы хотеть переопределить этот метод.

Броски:
MessagingException
См. Также:
content, MimeMessage#getContentStream

getRawInputStream

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

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

Броски:
MessagingException
С тех пор:
JavaMail 1.2
См. Также:
getInputStream(), getContentStream()

getDataHandler

public javax.activation.DataHandler getDataHandler()
                                            throws MessagingException
Возвратите DataHandler для этого контента части тела.

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

Определенный:
getDataHandler в интерфейсе Part
Возвраты:
DataHandler для контента
Броски:
MessagingException
См. Также:
MimeMessage#getDataHandler

getContent

public java.lang.Object getContent()
                            throws java.io.IOException,
                                   MessagingException
Возвратите контент как объект Java. Тип возвращенного объекта, конечно, зависит от контента непосредственно. Например, собственный формат контента текста/плоскости обычно является Строковым объектом. Собственный формат для "многослойного" контента всегда является Многослойным подклассом. Для типов контента, которые неизвестны системе DataHandler, входной поток возвращается как контент.

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

Определенный:
getContent в интерфейсе Part
Возвраты:
Объект
Броски:
MessagingException
java.io.IOException - это обычно бросается DataHandler. Сошлитесь на документацию для javax.activation. DataHandler для большего количества деталей.
См. Также:
DataHandler.getContent()

setDataHandler

public void setDataHandler(javax.activation.DataHandler dh)
                    throws MessagingException
Этот метод обеспечивает механизм, чтобы установить этот контент части тела. Данный объект DataHandler должен обернуть фактический контент.

Определенный:
setDataHandler в интерфейсе Part
Параметры:
dh - DataHandler для контента
Броски:
IllegalWriteException - если базовая реализация не поддерживает модификацию
IllegalStateException - если эта часть тела получается из папки READ_ONLY.
MessagingException

setContent

public void setContent(java.lang.Object o,
                       java.lang.String type)
                throws MessagingException
Метод удобства для того, чтобы установить этот контент части тела.

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

Определенный:
setContent в интерфейсе Part
Параметры:
o - объект контента
type - Тип пантомимы объекта
Броски:
IllegalWriteException - если базовая реализация не поддерживает модификацию существующих значений
IllegalStateException - если эта часть тела получается из папки READ_ONLY.
MessagingException

setText

public void setText(java.lang.String text)
             throws MessagingException
Метод удобства, который устанавливает данную Строку как контент этой части с типом MIME "текста/плоскости". Если строка будет содержать не символы US-ASCII, то она будет закодирована, используя набор символов значения по умолчанию платформы. Набор символов также используется, чтобы установить параметры "набора символов".

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

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

Определенный:
setText в интерфейсе MimePart
Определенный:
setText в интерфейсе Part
Параметры:
text - текстовый контент, чтобы установить
Броски:
MessagingException - если ошибка происходит
См. Также:
setText(String text, String charset)

setText

public void setText(java.lang.String text,
                    java.lang.String charset)
             throws MessagingException
Метод удобства, который устанавливает данную Строку как контент этой части с типом MIME "текста/плоскости" и указанного набора символов. Данная строка Unicode будет закодирована набором символов, используя указанный набор символов. Набор символов также используется, чтобы установить параметры "набора символов".

Определенный:
setText в интерфейсе MimePart
Параметры:
text - текстовый контент, чтобы установить
charset - набор символов, чтобы использовать для текста
Броски:
MessagingException - если ошибка происходит

setText

public void setText(java.lang.String text,
                    java.lang.String charset,
                    java.lang.String subtype)
             throws MessagingException
Метод удобства, который устанавливает данную Строку как контент этой части с основным типом MIME "текста" и указанного подтипа MIME. Данная строка Unicode будет закодирована набором символов, используя указанный набор символов. Набор символов также используется, чтобы установить параметры "набора символов".

Определенный:
setText в интерфейсе MimePart
Параметры:
text - текстовый контент, чтобы установить
charset - набор символов, чтобы использовать для текста
subtype - подтип MIME, чтобы использовать (например, "html")
Броски:
MessagingException - если ошибка происходит
С тех пор:
JavaMail 1.4

setContent

public void setContent(Multipart mp)
                throws MessagingException
Этот метод устанавливает контент части тела в Многослойный объект.

Определенный:
setContent в интерфейсе Part
Параметры:
mp - Многослойный объект, который является контентом сообщения
Броски:
IllegalWriteException - если базовая реализация не поддерживает модификацию существующих значений.
IllegalStateException - если эта часть тела получается из папки READ_ONLY.
MessagingException

attachFile

public void attachFile(java.io.File file)
                throws java.io.IOException,
                       MessagingException
Используйте указанный файл, чтобы обеспечить данные для этой части. Простое имя файла используется в качестве имени файла для этой части, и данные в файле используются в качестве данных для этой части. Кодирование будет выбрано соответственно для данных файла.

Параметры:
file - объект Файла присоединить
Броски:
java.io.IOException - ошибки, связанные с доступом к файлу
MessagingException - передайте связанные ошибки
С тех пор:
JavaMail 1.4

attachFile

public void attachFile(java.lang.String file)
                throws java.io.IOException,
                       MessagingException
Используйте указанный файл, чтобы обеспечить данные для этой части. Простое имя файла используется в качестве имени файла для этой части, и данные в файле используются в качестве данных для этой части. Кодирование будет выбрано соответственно для данных файла.

Параметры:
file - имя файла, чтобы присоединить
Броски:
java.io.IOException - ошибки, связанные с доступом к файлу
MessagingException - передайте связанные ошибки
С тех пор:
JavaMail 1.4

saveFile

public void saveFile(java.io.File file)
              throws java.io.IOException,
                     MessagingException
Сохраните содержание этой части в указанном файле. Контент декодируется и сохраняется без любого из заголовков MIME.

Параметры:
file - объект Файла записать в
Броски:
java.io.IOException - ошибки, связанные с доступом к файлу
MessagingException - передайте связанные ошибки
С тех пор:
JavaMail 1.4

saveFile

public void saveFile(java.lang.String file)
              throws java.io.IOException,
                     MessagingException
Сохраните содержание этой части в указанном файле. Контент декодируется и сохраняется без любого из заголовков MIME.

Параметры:
file - имя файла, чтобы записать в
Броски:
java.io.IOException - ошибки, связанные с доступом к файлу
MessagingException - передайте связанные ошибки
С тех пор:
JavaMail 1.4

writeTo

public void writeTo(java.io.OutputStream os)
             throws java.io.IOException,
                    MessagingException
Выведите часть тела как поток формата RFC 822.

Определенный:
writeTo в интерфейсе Part
Броски:
MessagingException
java.io.IOException - если ошибка происходит, пишущий в поток или если ошибка сгенерирована javax.activation уровнем.
См. Также:
DataHandler.writeTo(java.io.OutputStream)

getHeader

public java.lang.String[] getHeader(java.lang.String name)
                             throws MessagingException
Получите все заголовки для этого header_name. Отметьте, что определенные заголовки могут быть закодированы согласно RFC 2047, если они содержат не символы US-ASCII, и они должны декодироваться.

Определенный:
getHeader в интерфейсе Part
Параметры:
name - имя заголовка
Возвраты:
массив заголовков
Броски:
MessagingException
См. Также:
MimeUtility

getHeader

public java.lang.String getHeader(java.lang.String name,
                                  java.lang.String delimiter)
                           throws MessagingException
Получите все заголовки для этого имени заголовка, возвращенного как единственная Строка, с заголовками, разделенными разделителем. Если разделитель null, только первый заголовок возвращается.

Определенный:
getHeader в интерфейсе MimePart
Параметры:
name - имя этого заголовка
delimiter - разделитель между полями в возвращенной строке
Возвраты:
поля значения для всех заголовков с этим именем
Броски:
MessagingException

setHeader

public void setHeader(java.lang.String name,
                      java.lang.String value)
               throws MessagingException
Установите значение для этого header_name. Замены весь существующий заголовок оценивают с этим новым значением. Отметьте, что заголовки RFC 822 должны содержать только символы US-ASCII, таким образом, заголовок, который содержит не символы US-ASCII, должен быть закодирован согласно правилам RFC 2047.

Определенный:
setHeader в интерфейсе Part
Параметры:
name - имя заголовка
value - значение заголовка
Броски:
MessagingException
См. Также:
MimeUtility

addHeader

public void addHeader(java.lang.String name,
                      java.lang.String value)
               throws MessagingException
Добавьте это значение к существующим значениям для этого header_name. Отметьте, что заголовки RFC 822 должны содержать только символы US-ASCII, таким образом, заголовок, который содержит не символы US-ASCII, должен быть закодирован согласно правилам RFC 2047.

Определенный:
addHeader в интерфейсе Part
Параметры:
name - имя заголовка
value - значение заголовка
Броски:
MessagingException
См. Также:
MimeUtility

removeHeader

public void removeHeader(java.lang.String name)
                  throws MessagingException
Удалите все заголовки с этим именем.

Определенный:
removeHeader в интерфейсе Part
Параметры:
name - имя этого заголовка
Броски:
MessagingException

getAllHeaders

public java.util.Enumeration getAllHeaders()
                                    throws MessagingException
Возвратите все заголовки из этого сообщения как Перечисление объектов Заголовка.

Определенный:
getAllHeaders в интерфейсе Part
Возвраты:
перечисление объектов Заголовка
Броски:
MessagingException

getMatchingHeaders

public java.util.Enumeration getMatchingHeaders(java.lang.String[] names)
                                         throws MessagingException
Возвратите соответствие заголовков из этого сообщения как Перечисление объектов Заголовка.

Определенный:
getMatchingHeaders в интерфейсе Part
Возвраты:
перечисление объектов Заголовка
Броски:
MessagingException

getNonMatchingHeaders

public java.util.Enumeration getNonMatchingHeaders(java.lang.String[] names)
                                            throws MessagingException
Возвратите несоответствие заголовков из этого сообщения как Перечисление объектов Заголовка.

Определенный:
getNonMatchingHeaders в интерфейсе Part
Возвраты:
перечисление объектов Заголовка
Броски:
MessagingException

addHeaderLine

public void addHeaderLine(java.lang.String line)
                   throws MessagingException
Добавьте строку заголовка к этой части тела

Определенный:
addHeaderLine в интерфейсе MimePart
Броски:
MessagingException

getAllHeaderLines

public java.util.Enumeration getAllHeaderLines()
                                        throws MessagingException
Получите все строки заголовка как Перечисление Строк. Строка Заголовка является необработанной строкой заголовка RFC 822, содержа обоих поле "имени" и "значения".

Определенный:
getAllHeaderLines в интерфейсе MimePart
Броски:
MessagingException

getMatchingHeaderLines

public java.util.Enumeration getMatchingHeaderLines(java.lang.String[] names)
                                             throws MessagingException
Получите соответствие строк заголовка как Перечисление Строк. Строка Заголовка является необработанной строкой заголовка RFC 822, содержа обоих поле "имени" и "значения".

Определенный:
getMatchingHeaderLines в интерфейсе MimePart
Броски:
MessagingException

getNonMatchingHeaderLines

public java.util.Enumeration getNonMatchingHeaderLines(java.lang.String[] names)
                                                throws MessagingException
Получите несоответствие строк заголовка как Перечисление Строк. Строка Заголовка является необработанной строкой заголовка RFC 822, содержа обоих поле "имени" и "значения".

Определенный:
getNonMatchingHeaderLines в интерфейсе MimePart
Броски:
MessagingException

updateHeaders

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

Броски:
MessagingException


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

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

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


Spec-Zone.ru - all specs in one place



free hit counter