java.security

Интерфейсный Сертификат

Осуждаемый.

Новый пакет обработки сертификата создается в платформе Java. Этот интерфейс Сертификата полностью осуждается и должен здесь учесть гладкий переход к новому пакету.

@Deprecated
public interface Certificate

Это - интерфейс абстрактных методов для того, чтобы управлять множеством удостоверений личности. Удостоверение личности является гарантией принципалом, что открытый ключ является открытым ключом другого принципала. (Принципал представляет объект, такой как отдельный пользователь, группа, или корпорация.)

В частности этот интерфейс предназначается, чтобы быть общей абстракцией для конструкций, у которых есть различные форматы, но важное общее использование. Например, различные типы сертификатов, такие как сертификаты X.509 и сертификаты PGP, совместно используют общую функциональность сертификата (потребность закодировать и декодировать сертификаты) и некоторые типы информации, такие как открытый ключ, принципал, ключ которого это, и гарант, гарантирующий, что открытый ключ является открытым ключом указанного принципала. Таким образом, реализация сертификатов X.509 и реализация сертификатов PGP могут и использовать интерфейс Сертификата, даже при том, что их форматы и дополнительные типы и количество хранившей информации отличаются.

Важный: Этот интерфейс полезен для каталогизации и группировки объектов, совместно использующих определенное общее использование. У этого нет никакой собственной семантики. В частности объект Сертификата не делает оператора относительно законности привязки. Это - режим работы приложения, реализовывая этот интерфейс, чтобы проверить сертификат и убедиться его законности.

См. Также:

Certificate

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

Методы

Модификатор и Тип	Метод и Описание
void	decode(InputStream stream) Осуждаемый. Декодирует сертификат от входного потока.
void	encode(OutputStream stream) Осуждаемый. Кодирует сертификат потоку вывода в формате, который может декодироваться decode метод.
Строка	getFormat() Осуждаемый. Возвращает имя формата кода.
Принципал	getGuarantor() Осуждаемый. Возвращает гарант сертификата, то есть, принципал, гарантирующий, что открытый ключ, связанный с этим сертификатом, является открытым ключом принципала, связанного с этим сертификатом.
Принципал	getPrincipal() Осуждаемый. Возвращает принципал основной пары ключей, гарантируемой гарантом.
PublicKey	getPublicKey() Осуждаемый. Возвращает ключ основной пары ключей, гарантируемой гарантом.
Строка	toString(boolean detailed) Осуждаемый. Возвращает строку, которая представляет содержание сертификата.

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

getGuarantor

Principal getGuarantor()

Осуждаемый.

Возвращает гарант сертификата, то есть, принципал, гарантирующий, что открытый ключ, связанный с этим сертификатом, является открытым ключом принципала, связанного с этим сертификатом. Для сертификатов X.509 гарантом обычно будет Центр сертификации (такой как Почтовая служба Соединенных Штатов или Verisign, Inc.).

Возвраты:

гарант, который гарантировал основную привязку клавиш.

getPrincipal

Principal getPrincipal()

Осуждаемый.

Возвращает принципал основной пары ключей, гарантируемой гарантом.

Возвраты:

принципал, с которым связывается этот сертификат.

getPublicKey

PublicKey getPublicKey()

Осуждаемый.

Возвращает ключ основной пары ключей, гарантируемой гарантом.

Возвраты:

открытый ключ, который сертифицировал этот сертификат, принадлежит определенному принципалу.

закодировать

void encode(OutputStream stream)
            throws KeyException,
                   IOException

Осуждаемый.

Кодирует сертификат потоку вывода в формате, который может декодироваться decode метод.

Параметры:

stream - поток вывода, которому можно закодировать сертификат.

Броски:

KeyException - если сертификат должным образом не инициализируется, или данные отсутствуют и т.д.

IOException - если потоковое исключение происходит, пытаясь вывести закодированный сертификат потоку вывода.

См. Также:

decode(java.io.InputStream), getFormat()

декодировать

void decode(InputStream stream)
            throws KeyException,
                   IOException

Осуждаемый.

Декодирует сертификат от входного потока. Формат должен быть то, что возвращен getFormat и произведенный encode.

Параметры:

stream - входной поток, от которого можно выбрать декодируемые данные.

Броски:

KeyException - если сертификат должным образом не инициализируется, или данные отсутствуют и т.д.

IOException - если исключение происходит, пытаясь ввести закодированный сертификат от входного потока.

См. Также:

encode(java.io.OutputStream), getFormat()

getFormat

String getFormat()

Осуждаемый.

Возвращает имя формата кода. Это используется в качестве подсказки, чтобы найти соответствующий синтаксический анализатор. Это мог быть "X.509", "PGP", и т.д. Это - формат, произведенный и понятый под encode и decode методы.

Возвраты:

имя формата кода.

toString

String toString(boolean detailed)

Осуждаемый.

Возвращает строку, которая представляет содержание сертификата.

Параметры:

detailed - дать ли подробную информацию о сертификате

Возвраты:

строка, представляющая содержание сертификата