Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
public interface UIDFolder
UIDFolder
интерфейс реализуется Папками, которые могут поддерживать "разъединенный" режим работы, обеспечивая уникальные идентификаторы для сообщений в папке. Этот интерфейс основан на модели IMAP для того, чтобы поддерживать разъединенную работу.
Уникальный идентификатор (UID) является положительным длинным значением, присвоенным каждому сообщению в определенной папке. Уникальные идентификаторы присваиваются строго возрастающим способом в почтовом ящике. Таким образом, поскольку каждое сообщение добавляется к почтовому ящику, это присваивается более высокий UID чем сообщение (я), которые были добавлены ранее. Уникальные идентификаторы сохраняются через сеансы. Это разрешает клиенту ресинхронизировать его состояние от предыдущего сеанса с сервером.
Связанный с каждым почтовым ящиком значение законности уникального идентификатора. Если уникальные идентификаторы от более раннего сеанса не в состоянии сохраниться к этому сеансу, значение законности уникального идентификатора должно быть больше чем то, используемое в более раннем сеансе.
Обратитесь к RFC 2060
Вложенная Сводка Класса | |
---|---|
static class |
UIDFolder. FetchProfileItem
Элемент профиля выборки для того, чтобы выбрать UID. |
Полевая Сводка | |
---|---|
static long |
LASTUID
Это - специальное значение, которое может использоваться в качестве end параметр в getMessagesByUID(start, end) , обозначить UID последнего сообщения в папке. |
Сводка метода | |
---|---|
Сообщение |
getMessageByUID(long uid)
Получите сообщение, соответствующее данному UID. |
Сообщение[] |
getMessagesByUID(long[] uids)
Определите сообщения данным массивом UID. |
Сообщение[] |
getMessagesByUID(long start, long end)
Определите сообщения данным диапазоном. |
long |
getUID(Message message)
Получите UID для указанного сообщения. |
long |
getUIDValidity()
Возвращает значение UIDValidity, связанное с этой папкой. |
Полевая Деталь |
---|
static final long LASTUID
end
параметр в getMessagesByUID(start, end)
, обозначить UID последнего сообщения в папке.
getMessagesByUID(long, long)
, Постоянные Значения полейДеталь метода |
---|
long getUIDValidity() throws MessagingException
Клиенты обычно сравнивают это значение со значением UIDValidity, сохраненным от предыдущего сеанса, чтобы обеспечить, чтобы любые кэшируемые UID не были устарелыми.
MessagingException
Message getMessageByUID(long uid) throws MessagingException
null
возвращается.
uid
- UID для требуемого сообщения null
возвращается, если никакое сообщение, соответствующее этому UID, не получается. MessagingException
Message[] getMessagesByUID(long start, long end) throws MessagingException
end
параметр, чтобы указать на UID последнего сообщения в папке. Отметьте это end
не должно быть больше чем start
; порядок диапазона не имеет значения. Отметьте также, что, если папка не пуста, использование LASTUID гарантирует, что по крайней мере одно сообщение будет возвращено - последнее сообщение в папке.
start
- запустите UIDend
- UID конца MessagingException
LASTUID
Message[] getMessagesByUID(long[] uids) throws MessagingException
null
возвращается для той записи. Отметьте, что возвращенный массив будет иметь тот же самый размер как указанный массив UID, и null
записи могут присутствовать в массиве, чтобы указать на недопустимые UID.
uids
- массив UID MessagingException
long getUID(Message message) throws MessagingException
message
- Сообщение от этой папки java.util.NoSuchElementException
- если данное сообщение не находится в этой Папке. MessagingException
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41