Интерфейс Certificate

Устаревшее.

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

@Deprecated
public interface Certificate

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

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

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

Методы

getGuarantor

Principal getGuarantor()

Устаревшее.

Возвращает гаранта сертификата, то есть субъекта, гарантирующего, что открытый ключ, связанный с этим сертификатом, принадлежит субъекту, связанному с этим сертификатом. Для сертификатов X.509 гарантом обычно является центр сертификации (например, United States Postal Service или Verisign, Inc.).

Возвращает:

гаранта, гарантировавшего связь «субъект-ключ».

getPrincipal

Principal getPrincipal()

Устаревшее.

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

Возвращает:

субъекта, которому привязан этот сертификат.

getPublicKey

PublicKey getPublicKey()

Устаревшее.

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

Возвращает:

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

encode

void encode(OutputStream stream)
     throws KeyException,
            IOException

Устаревшее.

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

Параметры:

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

Исключения:

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

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

См. также:

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

decode

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

Возвращает:

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