Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ ПАКЕТ ПАКЕТ NEXT | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ |
См.:
Описание
Сводка интерфейса | |
---|---|
MessageAware | Интерфейс, дополнительно реализованный DataSources предоставлять информацию к a DataContentHandler о контексте сообщения, в котором работает объект контента данных. |
MultipartDataSource | MultipartDataSource является a DataSource это содержит части тела. |
Часть | Part интерфейс является общим основным интерфейсом для сообщений и BodyParts. |
QuotaAwareStore | Интерфейс, реализованный Хранилищами та поддержка квоты. |
UIDFolder | UIDFolder интерфейс реализуется Папками, которые могут поддерживать "разъединенный" режим работы, обеспечивая уникальные идентификаторы для сообщений в папке. |
Сводка класса | |
---|---|
Адрес | Этот абстрактный class моделирует адреса в сообщении. |
Аутентификатор | Аутентификатор class представляет объект, который знает, как получить аутентификацию для сетевого соединения. |
BodyPart | Этот class моделирует Часть, которая содержится в пределах Многослойного. |
FetchProfile | Клиенты используют FetchProfile, чтобы перечислить атрибуты сообщения, которые он хочет выбрать с упреждением от сервера для диапазона сообщений. |
FetchProfile. Элемент | Этим внутренним class является основной class всех элементов, которые можно требовать в FetchProfile. |
Флаги | Флаги class представляют набор флагов на сообщении. |
Флаги. Флаг | Этот внутренний class представляет отдельный системный флаг. |
Папка | Папкой является абстрактный class, который представляет папку для почтовых сообщений. |
Заголовок | Заголовок class хранит пару имя/значение, чтобы представить заголовки. |
Сообщение | Этот class моделирует электронное письмо. |
Сообщение. RecipientType | Этот внутренний class определяет типы получателей, разрешенных сообщением class. |
MessageContext | Контекст, в котором содержится часть контента сообщения. |
Многослойный | Многослойный контейнер, который содержит многократные части тела. |
PasswordAuthentication | PasswordAuthentication class является держателем данных, который используется Аутентификатором. |
Провайдер | Провайдером является class, который описывает реализацию протокола. |
Провайдер. Ввести | Этот внутренний class определяет тип Провайдера. |
Квота | Этот class представляет ряд квот для данного корня квоты. |
Квота. Ресурс | Отдельный ресурс в корне квоты. |
Служба | Абстрактный class, который содержит функциональность, характерную для служб обмена сообщениями, таких как хранилища и транспорты. |
Сеанс | Сеанс class представляет почтовый сеанс и не разделяется на подклассы. |
Хранилище | Абстрактный class, который моделирует банк сообщений и его протокол доступа для хранения и получения сообщений. |
Транспорт | Абстрактный class, который моделирует транспорт сообщения. |
UIDFolder. FetchProfileItem | Элемент профиля выборки для того, чтобы выбрать UID. |
URLName | Имя URL. |
Сводка исключения | |
---|---|
AuthenticationFailedException | Это исключение выдается, когда соединить метод на Хранилище или Транспортном объекте перестал работать из-за отказа аутентификации (например, плохое имя пользователя или пароль). |
FolderClosedException | Это исключение выдается, когда метод вызывается на объект Обмена сообщениями и Папку, которой принадлежит тот объект, умер из-за некоторой причины. |
FolderNotFoundException | Это исключение выдается методами Folder, когда те методы вызываются на не существующую папку. |
IllegalWriteException | Исключение, выданное, когда запись предпринимается на атрибуте "только для чтения" любого объекта Обмена сообщениями. |
MessageRemovedException | Исключение, выданное, когда недопустимый метод вызывается на вычеркнутое сообщение. |
MessagingException | Основной class для всех исключений, выданных классами Обмена сообщениями |
MethodNotSupportedException | Исключение, выданное, когда метод не поддерживается реализацией |
NoSuchProviderException | Это исключение выдается, когда Сеанс пытается инстанцировать Провайдера, который не существует. |
ReadOnlyFolderException | Это исключение выдается, когда попытка предпринимается, чтобы открыть доступ для чтения-записи папки, когда папка отмечается только для чтения. |
SendFailedException | Это исключение выдается, когда сообщение не может быть отправлено. |
StoreClosedException | Это исключение выдается, когда метод вызывается на объект Обмена сообщениями и Хранилище, которому принадлежит тот объект, умер из-за некоторой причины. |
API JavaMailTM обеспечивает классы, которые моделируют почтовую систему. javax.mail
пакет определяет классы, которые характерны для всех почтовых систем. javax.mail.internet
пакет определяет классы, которые являются определенными для почтовых систем, основанных на интернет-стандартах, таких как MIME, SMTP, POP3, и IMAP. API JavaMail включает javax.mail
пакет и подпакеты.
Для краткого обзора API JavaMail считайте спецификацию JavaMail, включенную в пакет загрузки или
Код, чтобы отправить сообщение простого текста может быть столь же простым как следующее:
Properties props = new Properties(); props.put("mail.smtp.host", "my-mail-server"); props.put("mail.from", "me@example.com"); Session session = Session.getInstance(props, null); try { MimeMessage msg = new MimeMessage(session); msg.setFrom(); msg.setRecipients(Message.RecipientType.TO, "you@example.com"); msg.setSubject("JavaMail hello world example"); msg.setSentDate(new Date()); msg.setText("Hello, world!\n"); Transport.send(msg); } catch (MessagingException mex) { System.out.println("send failed, exception: " + mex); }Пакет загрузки JavaMail содержит много более полных примеров в "демонстрационном" каталоге.
Не забывайте видеть
API JavaMail поддерживает следующие стандартные свойства, которые могут быть установлены в Session
объект, или в Properties
объект, используемый, чтобы создать Session
объект. Свойства всегда устанавливаются как строки; столбец Type описывает, как строка интерпретируется. Например, использовать
props.put("mail.debug", "true");установить
mail.debug
свойство, которое имеет булев тип.
Имя | Ввести | Описание |
---|---|---|
mail.debug | булев | Начальный режим отладки. Значение по умолчанию является ложью. |
mail.from | Строка | Адрес электронной почты возврата текущего пользователя, используемого InternetAddress метод getLocalAddress . |
mail.mime.address.strict | булев | MimeMessage class использует InternetAddress метод parseHeader проанализировать заголовки в сообщениях. Это свойство управляет строгим флагом, который передают к parseHeader метод. Значение по умолчанию является истиной. |
mail.host | Строка | Имя хоста значения по умолчанию почтового сервера и для Хранилищ и для Транспортов. Используемый, если mail.protocol.host свойство не устанавливается. |
mail.store.protocol | Строка | Определяет протокол доступа сообщения значения по умолчанию. Session метод getStore() возвращается Хранилище возражают, что реализует этот протокол. По умолчанию первый провайдер Хранилища в конфигурационных файлах возвращается. |
mail.transport.protocol | Строка | Определяет, что значение по умолчанию передает транспортный протокол. Session метод getTransport() возвращает Транспортный объект, который реализует этот протокол. По умолчанию первый Транспортный провайдер в конфигурационных файлах возвращается. |
mail.user | Строка | Имя пользователя значения по умолчанию, чтобы использовать, соединяясь с почтовым сервером. Используемый, если mail.protocol.user свойство не устанавливается. |
mail.protocol. class | Строка | Определяет полностью определенное имя class провайдера для указанного протокола. Используемый в случаях, где больше чем один провайдер для данного протокола существует; это свойство может использоваться, чтобы определить который провайдер использовать по умолчанию. Провайдер должен все еще быть перечислен в конфигурационном файле. |
mail.protocol.host | Строка | Имя хоста почтового сервера для указанного протокола. Переопределения mail.host свойство. |
mail.protocol.port | интервал | Номер порта почтового сервера для указанного протокола. Если не определенный номер порта значения по умолчанию протокола используется. |
mail.protocol.user | Строка | Имя пользователя, чтобы использовать, соединяясь с почтовыми серверами, используя указанный протокол. Переопределения mail.user свойство. |
Следующие свойства поддерживаются реализацией Sun JavaMail, но не являются в настоящий момент необходимой частью спецификации. Имена, типы, значения по умолчанию, и семантика этих свойств могут измениться в будущих выпусках.
Имя | Ввести | Описание |
---|---|---|
mail.transport.protocol.address-ввести | Строка | Определяет, что значение по умолчанию передает транспортный протокол для указанного типа адреса. Session метод getTransport(Address) возвращает Транспортный объект, который реализует этот протокол, когда адрес имеет указанный тип (например, "rfc822" для стандартных интернет-адресов). По умолчанию первый Транспорт, сконфигурированный для того типа адреса, используется. Это свойство может использоваться, чтобы переопределить поведение send метод Transport class так, чтобы (например) "smtps" протокол использовался вместо "smtp" протокола, устанавливая свойство mail.transport.protocol.rfc822 к "smtps" . |
API JavaMail также поддерживает несколько свойств System; см. javax.mail.internet
документация пакета для деталей.
Ссылочная реализация JavaMail от Sun включает провайдеров протокола в подпакеты com.sun.mail
. Отметьте, что API к этим провайдерам протокола не являются частью стандартного API JavaMail. Переносимые программы не будут использовать эти API.
Непереносимые программы могут использовать API провайдеров протокола Sun, (например) бросая возвращенный Folder
возразите против a com.sun.mail.imap.IMAPFolder
объект. Так же для Store
и Message
объекты возвратились из стандартных API JavaMail.
Провайдеры протокола Sun также поддерживают свойства, которые являются определенными для тех провайдеров. Документация пакета для IMAP
, POP3
, и SMTP
пакеты обеспечивают детали.
|
|||||||||
ПРЕДЫДУЩИЙ ПАКЕТ ПАКЕТ NEXT | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41