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

javax.mail
Класс FetchProfile

java.lang.Object
  javax.mail.FetchProfile

public class FetchProfile
расширяет java.lang. Объект

Клиенты используют FetchProfile, чтобы перечислить атрибуты сообщения, которые он хочет выбрать с упреждением от сервера для диапазона сообщений.

Сообщения, полученные из Папки, являются легкими объектами, которые обычно начинаются как пустые ссылки на фактические сообщения. Такой объект сообщения заполнен в "по требованию", когда соответствующие добираются * (), методы вызываются на то определенное сообщение. Определенные основанные на сервере протоколы доступа сообщения (Исключая: IMAP), позволяют пакетную выборку атрибутов сообщения для диапазона сообщений в единственном запросе. Клиенты, которые хотят использовать атрибуты сообщения для диапазона сообщений (Пример: вывести на экран высокоуровневые заголовки в headerlist), мог бы хотеть использовать оптимизацию, обеспеченную такими серверами. FetchProfile позволяет клиенту указывать на это требование к серверу.

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

Пример кода, который иллюстрирует использование FetchProfile, дается ниже:

  Message[] msgs = folder.getMessages();

  FetchProfile fp = new FetchProfile();
  fp.add(FetchProfile.Item.ENVELOPE);
  fp.add("X-mailer");
  folder.fetch(msgs, fp);

 

Автор:

Джон Мани, Билл Шеннон

См. Также:

Folder.fetch(javax.mail.Message[], javax.mail.FetchProfile)

Вложенная Сводка Класса

static class

FetchProfile. Элемент Этим внутренним class является основной class всех элементов, которые можно требовать в FetchProfile.

Сводка конструктора

FetchProfile()
Создайте пустой FetchProfile.

Сводка метода

void	add(FetchProfile.Item item) Добавьте данный специальный элемент как один из атрибутов, которые будут выбраны с упреждением.
void	add(java.lang.String headerName) Добавьте указанное поле заголовка к списку атрибутов, которые будут выбраны с упреждением.
boolean	contains(FetchProfile.Item item) Возвращает true, если профиль выборки содержит данный специальный элемент.
boolean	contains(java.lang.String headerName) Возвращает true, если профиль выборки содержит данное имя заголовка.
java.lang.String[]	getHeaderNames() Получите имена набора полей заголовка в этом профиле.
FetchProfile. Элемент[]	getItems() Установите элементы в этом профиле.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

FetchProfile

public FetchProfile()

Создайте пустой FetchProfile.

Деталь метода

добавить

public void add(FetchProfile.Item item)

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

Параметры:

item - специальный элемент, который будет выбран

См. Также:

FetchProfile.Item.ENVELOPE, FetchProfile.Item.CONTENT_INFO, FetchProfile.Item.FLAGS

добавить

public void add(java.lang.String headerName)

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

Параметры:

headerName - заголовок, который будет выбран с упреждением

содержит

public boolean contains(FetchProfile.Item item)

Возвращает true, если профиль выборки содержит данный специальный элемент.

содержит

public boolean contains(java.lang.String headerName)

Возвращает true, если профиль выборки содержит данное имя заголовка.

getItems

public FetchProfile.Item[] getItems()

Установите элементы в этом профиле.

Возвраты:

элементы устанавливаются в этом профиле

getHeaderNames

public java.lang.String[] getHeaderNames()

Получите имена набора полей заголовка в этом профиле.

Возвраты:

заголовки устанавливаются в этом профиле