Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
java.lang.Object javax.mail.Multipart javax.mail.internet.MimeMultipart
public class MimeMultipart
class MimeMultipart является реализацией абстрактного Многослойного class, который использует соглашения MIME для многослойных данных.
MimeMultipart получается из MimePart, основной тип которого является "многослойным" (вызывая часть getContent()
метод), или это может быть создано клиентом как часть создания нового MimeMessage.
Значение по умолчанию многослойный подтип "смешивается". Другие многослойные подтипы, такой столь же "альтернативный", "связанный", и так далее, могут быть реализованы как подклассы MimeMultipart с дополнительными методами, чтобы реализовать дополнительную семантику того типа многослойного контента. Намерение состоит в том, что поставщики услуг, почтовые писатели JavaBean и почтовые клиенты запишут много таких подклассов и их Бобы Команды, и установят их в Платформу Активации JavaBeans, так, чтобы любая реализация JavaMail и ее клиенты могли прозрачно найти и использовать эти классы. Таким образом MIME многослойный обработчик обрабатывается точно так же как любой другой обработчик типа, таким образом разъединяя процесс обеспечения многослойных обработчиков от API JavaMail. Испытывая недостаток в этих дополнительных подклассах MimeMultipart, все подтипы MIME, многослойные данные появляются как MimeMultipart, возражают.
Приложение может непосредственно создать MIME многослойный объект любого подтипа при использовании MimeMultipart(String subtype)
конструктор. Например, чтобы создать "многослойный/альтернативный" объект, использовать new MimeMultipart("alternative")
.
mail.mime.multipart.ignoremissingendboundary
свойство может быть установлено в false
вызвать a MessagingException
быть брошенным, если многослойные данные не заканчиваются необходимой границей конца. Если это свойство устанавливается в true
или не набор, недостающие границы конца не считают ошибкой и заключительными концами части тела в конце данных.
mail.mime.multipart.ignoremissingboundaryparameter
Системное свойство может быть установлено в false
вызвать a MessagingException
быть брошенным, если Тип контента MimeMultipart не включает a boundary
параметр. Если это свойство устанавливается в true
или не набор, многослойный код парсинга будет искать строку, которая похожа на bounary строку, и используйте это в качестве границы, разделяющей части.
Текущая реализация также поддерживает следующие свойства:
mail.mime.multipart.ignoreexistingboundaryparameter
Системное свойство может быть установлено в true
чтобы заставить любую границу, которая будет игнорироваться и вместо этого, ищут границу в сообщении как с mail.mime.multipart.ignoremissingboundaryparameter
.
Обычно, выписывая MimeMultipart, который не содержит частей тела, или пытаясь проанализировать многослойное сообщение без частей тела, a MessagingException
бросается. Спецификация MIME не позволяет многослойный контент без частей тела. mail.mime.multipart.allowempty
Системное свойство может быть установлено в true
переопределять это поведение. Выписывая такому MimeMultipart, единственная пустая часть будет включена. Читая такое многослойное, MimeMultipart будет создаваться без частей тела.
Полевая Сводка | |
---|---|
protected javax.activation.DataSource |
ds
DataSource, предоставляющий наш InputStream. |
protected boolean |
проанализированный
Мы проанализировали данные от нашего InputStream все же? Значения по умолчанию к истине; набор ко лжи, когда нашему конструктору дают DataSource с InputStream, который мы должны проанализировать. |
Поля, наследованные от class javax.mail. Многослойный |
---|
contentType, parent, parts |
Сводка конструктора | |
---|---|
MimeMultipart()
Конструктор по умолчанию. |
|
MimeMultipart(javax.activation.DataSource ds)
Создает объект MimeMultipart и его bodyparts от данного DataSource. |
|
MimeMultipart(java.lang.String subtype)
Создайте объект MimeMultipart данного подтипа. |
Сводка метода | |
---|---|
void |
addBodyPart(BodyPart part)
Добавляет Часть к многослойному. |
void |
addBodyPart(BodyPart part, int index)
Добавляет BodyPart в позиции index . |
protected InternetHeaders |
createInternetHeaders(java.io.InputStream is)
Создайте и возвратитесь, InternetHeaders возражают, что загружает заголовки из данного InputStream. |
protected MimeBodyPart |
createMimeBodyPart(java.io.InputStream is)
Создайте и возвратите объект MimeBodyPart представить часть тела, проанализированную от InputStream. |
protected MimeBodyPart |
createMimeBodyPart(InternetHeaders headers, byte[] content)
Создайте и возвратите объект MimeBodyPart представить часть тела, проанализированную от InputStream. |
BodyPart |
getBodyPart(int index)
Получите указанный BodyPart. |
BodyPart |
getBodyPart(java.lang.String CID)
Упомяните MimeBodyPart данным ContentID (идентификация вызывающего абонента). |
int |
getCount()
Возвратите число включенных объектов BodyPart. |
java.lang.String |
getPreamble()
Получите текст преамбулы, если таковые вообще имеются, который появляется перед первой частью тела этого многослойного. |
boolean |
isComplete()
Возвратите true, если заключительная граница для этого многослойного была замечена. |
protected void |
parse()
Проанализируйте InputStream от нашего DataSource, создавая соответствующий MimeBodyParts. |
boolean |
removeBodyPart(BodyPart part)
Удалите указанную часть из многослойного сообщения. |
void |
removeBodyPart(int index)
Удалите часть в указанном расположении (запускающийся от 0). |
void |
setPreamble(java.lang.String preamble)
Установите текст преамбулы, который будет включен перед первой частью тела. |
void |
setSubType(java.lang.String subtype)
Установите подтип. |
protected void |
updateHeaders()
Заголовки обновления. |
void |
writeTo(java.io.OutputStream os)
Выполняет итерации через все части и выводы каждой части MIME, разделенной границей. |
Методы, наследованные от class javax.mail. Многослойный |
---|
getContentType, getParent, setMultipartDataSource, setParent |
Методы, наследованные от class java.lang. Объект |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Полевая Деталь |
---|
protected javax.activation.DataSource ds
protected boolean parsed
Деталь конструктора |
---|
public MimeMultipart()
contentType
поле. MimeBodyParts может быть добавлен позже.
public MimeMultipart(java.lang.String subtype)
contentType
поле. MimeBodyParts может быть добавлен позже.
public MimeMultipart(javax.activation.DataSource ds) throws MessagingException
Этот конструктор обрабатывает как особый случай ситуация, где данный DataSource является объектом MultipartDataSource. В этом случае этот метод только вызывает суперкласс (то есть, Многослойный) конструктор, который берет объект MultipartDataSource.
Иначе, DataSource, как предполагается, обеспечивает MIME многослойный поток байтов. parsed
флаг устанавливается в ложь. Когда данные для частей тела необходимы, синтаксический анализатор извлекает "граничный" параметр из типа контента этого DataSource, пропускает 'преамбулу' и читает байты до завершающейся границы и создает MimeBodyParts для каждой части потока.
ds
- DataSource, может быть MultipartDataSource MessagingException
Деталь метода |
---|
public void setSubType(java.lang.String subtype) throws MessagingException
subtype
- Подтип MessagingException
public int getCount() throws MessagingException
getCount
в class Multipart
MessagingException
Multipart.parts
public BodyPart getBodyPart(int index) throws MessagingException
getBodyPart
в class Multipart
index
- индексирование требуемого BodyPart MessagingException
- если никакой такой BodyPart не существуетpublic BodyPart getBodyPart(java.lang.String CID) throws MessagingException
CID
- ContentID требуемой части MessagingException
public boolean removeBodyPart(BodyPart part) throws MessagingException
removeBodyPart
в class Multipart
part
- Часть, чтобы удалить MessagingException
- если никакая такая Часть не существует IllegalWriteException
- если базовая реализация не поддерживает модификацию существующих значенийpublic void removeBodyPart(int index) throws MessagingException
removeBodyPart
в class Multipart
index
- Индексируйте части, чтобы удалить MessagingException
java.lang.IndexOutOfBoundsException
- если данные индексируют, испытывает недостаток диапазона. IllegalWriteException
- если базовая реализация не поддерживает модификацию существующих значенийpublic void addBodyPart(BodyPart part) throws MessagingException
addBodyPart
в class Multipart
part
- Часть, которая будет добавлена MessagingException
IllegalWriteException
- если базовая реализация не поддерживает модификацию существующих значенийpublic void addBodyPart(BodyPart part, int index) throws MessagingException
index
. Если index
не последний в списке, последующие части смещаются. Если index
больше чем число существующих частей, BodyPart добавляется до конца.
addBodyPart
в class Multipart
part
- BodyPart, который будет вставленindex
- Расположение, где вставить часть MessagingException
IllegalWriteException
- если базовая реализация не поддерживает модификацию существующих значенийpublic boolean isComplete() throws MessagingException
MessagingException
public java.lang.String getPreamble() throws MessagingException
MessagingException
public void setPreamble(java.lang.String preamble) throws MessagingException
preamble
- текст преамбулы MessagingException
protected void updateHeaders() throws MessagingException
updateHeaders
метод на каждом из его дочерних элементов Бодипартса. Отметьте, что граничный параметр уже устанавливается, когда новый и пустой объект MimeMultipart создается.
Этот метод вызывают когда saveChanges
метод вызывается на объект сообщения, содержащий это Многослойное. Это обычно делается, поскольку часть сообщения отправляет процесс, однако отметьте, что клиент свободен вызвать это любое число раз. Так, если процесс обновления заголовка дорог для определенного подкласса MimeMultipart, то он мог бы самостоятельно хотеть отследить, изменялось ли его внутреннее состояние фактически, и делало обновление заголовка только если необходимый.
MessagingException
public void writeTo(java.io.OutputStream os) throws java.io.IOException, MessagingException
writeTo
в class Multipart
java.io.IOException
- если IO связанное исключение происходит MessagingException
protected void parse() throws MessagingException
parsed
флаг устанавливается в истину, и если истина на записи ничто не делается. Этот метод вызывают все другие методы, которые нуждаются в данных для частей тела, чтобы удостовериться, что данные были проанализированы.
MessagingException
protected InternetHeaders createInternetHeaders(java.io.InputStream is) throws MessagingException
is
- InputStream, чтобы считать заголовки из MessagingException
protected MimeBodyPart createMimeBodyPart(InternetHeaders headers, byte[] content) throws MessagingException
headers
- заголовки для части телаcontent
- контент части тела MessagingException
protected MimeBodyPart createMimeBodyPart(java.io.InputStream is) throws MessagingException
is
- InputStream, содержащий часть тела MessagingException
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41