Spec-Zone.ru › OpenJDK 25

Интерфейс 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 гарантом обычно является центр сертификации (например, Почтовая служба США или Verisign, Inc.).
Возвращает:
гаранта, подтвердившего связывание субъекта с ключом.

getPrincipal

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

getPublicKey

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

encode

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

decode

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

getFormat

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

toString

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

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, 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/25/docs/api/java.base/java/security/Certificate.html

Spec-Zone.ru

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