Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
java.lang.Object javax.mail.BodyPart javax.mail.internet.MimeBodyPart
public class MimeBodyPart
Этот class представляет часть тела MIME. Это реализует BodyPart
абстрактный class и MimePart
интерфейс. MimeBodyParts содержатся в MimeMultipart
объекты.
MimeBodyPart использует InternetHeaders
class, чтобы проанализировать и сохранить заголовки той части тела.
Поля заголовка RFC 822 должны содержать только символы US-ASCII. MIME позволяет не символам ASCII присутствовать в определенных частях определенных заголовков, кодируя те символы. RFC 2047 определяет правила для того, чтобы сделать это. MimeUtility class, обеспеченный в этом пакете, может привыкнуть к достигнуть этого. Вызывающие стороны setHeader
, addHeader
, и addHeaderLine
методы ответственны за осуществление требований MIME для указанных заголовков. Кроме того, эти поля заголовка должны быть свернуты (обернутые) прежде, чем быть отправленным, если они превышают ограничение длины строки для транспорта (1000 байтов для SMTP)., Возможно, были свернуты полученные заголовки. Приложение ответственно за сворачивание и разворачивание заголовков как соответствующий.
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
protected byte[] content
protected java.io.InputStream contentStream
contentStream
другой такой поток, представляющий контент этой части тела. В этом случае, content
будет нуль.
protected InternetHeaders headers
Деталь конструктора |
---|
public MimeBodyPart()
public MimeBodyPart(java.io.InputStream is) throws MessagingException
Отметьте, что "граничная" строка, которая разграничивает части тела, не должна быть включена во входной поток. Намерение состоит в том, что синтаксический анализатор MimeMultipart извлечет каждое тело байты части из многослойного потока и подаст их в этого конструктора без строк разделителя.
is
- Входной Поток части тела MessagingException
public MimeBodyPart(InternetHeaders headers, byte[] content) throws MessagingException
Используемый провайдерами.
headers
- Заголовок этой частиcontent
- байты, представляющие тело этой части. 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(name)
получить необходимое поле заголовка.
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 недоступно, нулевой возвращается.
Эта реализация использование getHeader(name)
получить необходимое поле заголовка.
getDisposition
в интерфейсе Part
MessagingException
headers
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)
public java.lang.String getEncoding() throws MessagingException
null
если заголовок недоступен, или его значение отсутствует. Эта реализация использование getHeader(name)
получить необходимое поле заголовка.
getEncoding
в интерфейсе MimePart
MessagingException
headers
public java.lang.String getContentID() throws MessagingException
null
если поле недоступно, или его значение отсутствует. Эта реализация использование getHeader(name)
получить необходимое поле заголовка.
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(name)
получить необходимое поле заголовка.
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[] getContentLanguage() throws MessagingException
null
если этот заголовок не доступен, или его значение отсутствует. Эта реализация использование getHeader(name)
получить необходимое поле заголовка.
getContentLanguage
в интерфейсе MimePart
MessagingException
public void setContentLanguage(java.lang.String[] languages) throws MessagingException
setContentLanguage
в интерфейсе MimePart
languages
- массив тегов языка MessagingException
public java.lang.String getDescription() throws MessagingException
Если поле Content-Description кодируется согласно RFC 2047, оно декодируется и преобразовывается в Unicode. Если декодирование или сбои преобразования, необработанные данные возвращаются, как.
Эта реализация использование getHeader(name)
получить необходимое поле заголовка.
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 может быть включен в цепочку исключения, если преобразование набора символов перестало работать.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 может быть включен в цепочку исключения, если преобразование набора символов перестало работать.public java.lang.String getFileName() throws MessagingException
Возвращает значение параметра "имени файла" от поля заголовка "Расположения контента" этой части тела. Если не доступный, возвращает значение параметра "имени" от поля заголовка "Типа контента" этой части тела. Возвраты null
если оба отсутствуют.
Если mail.mime.decodefilename
Системное свойство устанавливается в истину, 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
MessagingException
content
, MimeMessage#getContentStream
public java.io.InputStream getRawInputStream() throws MessagingException
getInputStream
метод или getContent
метод от возврата корректных данных. В таком случае приложение может использовать этот метод и попытаться декодировать необработанные данные самостоятельно. Эта реализация просто вызывает getContentStream
метод.
MessagingException
getInputStream()
, getContentStream()
public javax.activation.DataHandler getDataHandler() throws MessagingException
Реализация, обеспеченная здесь, работает точно так же как реализация в MimeMessage.
getDataHandler
в интерфейсе Part
MessagingException
MimeMessage#getDataHandler
public java.lang.Object getContent() throws java.io.IOException, MessagingException
Эта реализация получает контент из DataHandler. Таким образом, это вызывает getDataHandler ().getContent (); Если контент является Многослойным объектом или объектом сообщения и создавался, анализируя поток, объект кэшируется и возвращается в последующих вызовах так, чтобы модификации к контенту не были потеряны.
getContent
в интерфейсе Part
MessagingException
java.io.IOException
- это обычно бросается DataHandler. Сошлитесь на документацию для javax.activation. DataHandler для большего количества деталей.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 void attachFile(java.io.File file) throws java.io.IOException, MessagingException
file
- объект Файла присоединить java.io.IOException
- ошибки, связанные с доступом к файлу MessagingException
- передайте связанные ошибкиpublic void attachFile(java.lang.String file) throws java.io.IOException, MessagingException
file
- имя файла, чтобы присоединить java.io.IOException
- ошибки, связанные с доступом к файлу MessagingException
- передайте связанные ошибкиpublic void saveFile(java.io.File file) throws java.io.IOException, MessagingException
file
- объект Файла записать в java.io.IOException
- ошибки, связанные с доступом к файлу MessagingException
- передайте связанные ошибкиpublic void saveFile(java.lang.String file) throws java.io.IOException, MessagingException
file
- имя файла, чтобы записать в java.io.IOException
- ошибки, связанные с доступом к файлу MessagingException
- передайте связанные ошибкиpublic void writeTo(java.io.OutputStream os) throws java.io.IOException, MessagingException
writeTo
в интерфейсе Part
MessagingException
java.io.IOException
- если ошибка происходит, пишущий в поток или если ошибка сгенерирована javax.activation уровнем.DataHandler.writeTo(java.io.OutputStream)
public java.lang.String[] getHeader(java.lang.String name) throws MessagingException
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
- значение заголовка MessagingException
MimeUtility
public void addHeader(java.lang.String name, java.lang.String value) throws MessagingException
addHeader
в интерфейсе Part
name
- имя заголовкаvalue
- значение заголовка MessagingException
MimeUtility
public void removeHeader(java.lang.String name) throws MessagingException
removeHeader
в интерфейсе Part
name
- имя этого заголовка MessagingException
public java.util.Enumeration getAllHeaders() throws MessagingException
getAllHeaders
в интерфейсе Part
MessagingException
public java.util.Enumeration getMatchingHeaders(java.lang.String[] names) throws MessagingException
getMatchingHeaders
в интерфейсе Part
MessagingException
public java.util.Enumeration getNonMatchingHeaders(java.lang.String[] names) throws MessagingException
getNonMatchingHeaders
в интерфейсе Part
MessagingException
public void addHeaderLine(java.lang.String line) throws MessagingException
addHeaderLine
в интерфейсе MimePart
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
protected void updateHeaders() throws MessagingException
Content-Type
и Content-Transfer-Encoding
. Заголовки, возможно, должны были бы быть обновлены в двух случаях: Message.saveChanges
метод.
MessagingException
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41