Spec-Zone .ru
спецификации, руководства, описания, API


Пакет javax.mail

API JavaMailTM обеспечивает классы, которые моделируют почтовую систему.

См.:
          Описание

Сводка интерфейса
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 Это исключение выдается, когда метод вызывается на объект Обмена сообщениями и Хранилище, которому принадлежит тот объект, умер из-за некоторой причины.
 

Пакет javax.mail Описание

API JavaMailTM обеспечивает классы, которые моделируют почтовую систему. javax.mail пакет определяет классы, которые характерны для всех почтовых систем. javax.mail.internet пакет определяет классы, которые являются определенными для почтовых систем, основанных на интернет-стандартах, таких как MIME, SMTP, POP3, и IMAP. API JavaMail включает javax.mail пакет и подпакеты.

Для краткого обзора API JavaMail считайте спецификацию 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 содержит много более полных примеров в "демонстрационном" каталоге.

Не забывайте видеть FAQ API JavaMail для ответов на наиболее распространенные вопросы. Веб-сайт 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 пакеты обеспечивают детали.



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

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

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

free hit counter