Spec-Zone.ru › OpenJDK 21

Интерфейс Certificate

@Deprecated(since="1.2", forRemoval=true) public interface Certificate
Устарело, подлежит удалению: Этот элемент API может быть удален в будущей версии.
Этот класс устарел и подлежит удалению в будущих версиях Java SE. Он был заменён на java.security.cert.Certificate и связанные классы.

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

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

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

С тех пор как:
1.1
См. также:
  • Certificate

Краткое описание методов

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

Подробное описание методов

getGuarantor

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

getPrincipal

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

getPublicKey

PublicKey getPublicKey()
Устарело, подлежит удалению: Этот элемент API может быть удален в будущей версии.
Возвращает ключ пары "принципал-ключ", гарантируемой гарантом.
Возвращает:
открытый ключ, который этот сертификат подтверждает как принадлежащий конкретному принципалу.

encode

void encode(OutputStream stream) throws KeyException, IOException
Устарело, подлежит удалению: Этот элемент API может быть удален в будущей версии.
Кодирует сертификат в выходной поток в формате, который может быть декодирован методом decode.
Параметры:
stream - выходной поток, в который кодировать сертификат.
Исключения:
KeyException - если сертификат не инициализирован должным образом или отсутствуют данные и т. п.
IOException - если возникает исключение потока во время вывода закодированного сертификата в выходной поток.
См. также:
  • decode(java.io.InputStream)
  • getFormat()

decode

void decode(InputStream stream) throws KeyException, IOException
Устарело, подлежит удалению: Этот элемент API может быть удален в будущей версии.
Декодирует сертификат из входного потока. Формат должен быть таким, который возвращается getFormat и создаётся методом encode.
Параметры:
stream - входной поток, из которого извлекаются декодированные данные.
Исключения:
KeyException - если сертификат не инициализирован должным образом или отсутствуют данные и т. п.
IOException - если возникает исключение при вводе закодированного сертификата из входного потока.
См. также:
  • encode(java.io.OutputStream)
  • getFormat()

getFormat

String getFormat()
Устарело, подлежит удалению: Этот элемент API может быть удален в будущей версии.
Возвращает имя кодировочного формата. Используется как подсказка для поиска подходящего парсера. Может быть "X.509", "PGP" и т. д. Это формат, создаваемый и понимаемый методами encode и decode.
Возвращает:
имя кодировочного формата.

toString

String toString(boolean detailed)
Устарело, подлежит удалению: Этот элемент API может быть удален в будущей версии.
Возвращает строку, представляющую содержимое сертификата.
Параметры:
detailed - требуется ли подробная информация о сертификате
Возвращает:
строку, представляющую содержимое сертификата

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/security/Certificate.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API