Spec-Zone.ru › OpenJDK 25

Класс Identity

java.lang.Object
java.security.Identity
Все реализуемые интерфейсы:
Serializable, Principal
Непосредственные известные подклассы:
IdentityScope, Signer
@Deprecated(since="1.2", forRemoval=true) public abstract class Identity extends Object implements Principal, Serializable
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Этот класс устарел и подлежит удалению в будущей версии Java SE. Он заменён java.security.KeyStore, пакетом java.security.cert и java.security.Principal.

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

Все объекты Identity имеют имя и открытый ключ. Имена неизменяемы. Идентичности также могут иметь область действия. То есть, если для Identity указана определённая область действия, то имя и открытый ключ Identity уникальны в пределах этой области.

У Identity также имеется набор сертификатов (каждый из которых подтверждает его собственный открытый ключ). Имена Principal, указанные в этих сертификатах, могут различаться; совпадать должен только ключ.

Класс Identity можно расширить, добавив почтовые и электронные адреса, номера телефонов, изображения лиц и логотипы и так далее.

Начиная с:
1.1
См. также:
  • IdentityScope
  • Signer
  • Principal
  • Сериализованная форма

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

Identity()
Identity(String name)
Identity(String name, IdentityScope scope)
Модификатор Конструктор Описание
protected
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Конструктор предназначен только для сериализации.
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Создаёт Identity с указанным именем без области действия.
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Создаёт Identity с указанным именем и областью действия.

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

Модификатор и тип Метод Описание
void addCertificate(Certificate certificate)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Добавляет сертификат для этой Identity.
Certificate[] certificates()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает копию всех сертификатов этой Identity.
final boolean equals(Object identity)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Проверяет равенство указанного объекта и этой Identity.
String getInfo()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает общую информацию, ранее заданную для этой Identity.
final String getName()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает имя этой идентичности.
PublicKey getPublicKey()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает открытый ключ этой идентичности.
final IdentityScope getScope()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает область действия этой идентичности.
int hashCode()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает хеш-код этой Identity.
protected boolean identityEquals(Identity identity)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Проверяет равенство указанной Identity и этой Identity.
void removeCertificate(Certificate certificate)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Удаляет сертификат из этой Identity.
void setInfo(String info)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Задаёт строку с общей информацией для этой Identity.
void setPublicKey(PublicKey key)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Задаёт открытый ключ этой идентичности.
String toString()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает краткую строку с описанием этой Identity, содержащую её имя и область действия (если есть).
String toString(boolean detailed)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает строковое представление этой Identity, которое может содержать больше сведений, чем метод toString без аргументов.

Методы, объявленные в классе Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе Principal

implies

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

Identity

protected Identity()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Конструктор предназначен только для сериализации.

Identity

public Identity(String name, IdentityScope scope) throws KeyManagementException
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Создаёт Identity с указанным именем и областью действия.
Параметры:
name — имя Identity.
scope — область действия Identity.
Исключения:
KeyManagementException — если в этой области действия уже существует Identity с таким именем.

Identity

public Identity(String name)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Создаёт Identity с указанным именем без области действия.
Параметры:
name — имя идентичности.

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

getName

public final String getName()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает имя этой идентичности.
Определено в:
getName в интерфейсе Principal
Возвращает:
имя этой Identity.

getScope

public final IdentityScope getScope()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает область действия этой идентичности.
Возвращает:
область действия этой Identity.

getPublicKey

public PublicKey getPublicKey()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает открытый ключ этой идентичности.
Возвращает:
открытый ключ этой Identity.
См. также:
  • setPublicKey(PublicKey)

setPublicKey

public void setPublicKey(PublicKey key) throws KeyManagementException
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Задаёт открытый ключ этой идентичности. В результате этой операции старый ключ и все сертификаты данной идентичности удаляются.
Параметры:
key — открытый ключ этой Identity.
Исключения:
KeyManagementException — если другая идентичность в области действия этой идентичности имеет такой же открытый ключ или возникает другое исключение.
См. также:
  • getPublicKey()

setInfo

public void setInfo(String info)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Задаёт строку с общей информацией для этой Identity.
Параметры:
info — строка с информацией.
См. также:
  • getInfo()

getInfo

public String getInfo()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает общую информацию, ранее заданную для этой Identity.
Возвращает:
общую информацию об этой Identity.
См. также:
  • setInfo(String)

addCertificate

public void addCertificate(Certificate certificate) throws KeyManagementException
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Добавляет сертификат для этой Identity. Если у Identity есть открытый ключ, открытый ключ в сертификате должен совпадать с ним. Если у Identity нет открытого ключа, открытый ключ идентичности устанавливается равным ключу, указанному в сертификате.
Параметры:
certificate — добавляемый сертификат.
Исключения:
KeyManagementException — если сертификат недействителен, если открытый ключ в добавляемом сертификате не совпадает с открытым ключом этой идентичности или если возникает другое исключение.

removeCertificate

public void removeCertificate(Certificate certificate) throws KeyManagementException
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Удаляет сертификат из этой Identity.
Параметры:
certificate — удаляемый сертификат.
Исключения:
KeyManagementException — если сертификат отсутствует или возникает другое исключение.

certificates

public Certificate[] certificates()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает копию всех сертификатов этой Identity.
Возвращает:
копию всех сертификатов этой Identity.

equals

public final boolean equals(Object identity)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Проверяет равенство указанного объекта и этой Identity. Сначала проверяется, ссылаются ли сущности на один и тот же объект; в этом случае возвращается true. Затем проверяется, имеют ли сущности одинаковые имя и область действия. Если да, метод возвращает true. В противном случае вызывается identityEquals, который следует переопределить в подклассах.
Определено в:
equals в интерфейсе Principal
Переопределяет:
equals в классе Object
Параметры:
identity — объект, равенство которого с этой Identity нужно проверить.
Возвращает:
true, если объекты считаются равными; в противном случае — false.
См. также:
  • identityEquals(Identity)

identityEquals

protected boolean identityEquals(Identity identity)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Проверяет равенство указанной Identity и этой Identity. Этот метод следует переопределить в подклассах для проверки равенства. По умолчанию метод возвращает true, если имена и открытые ключи совпадают.
Параметры:
identity — идентичность, равенство которой с этой identity нужно проверить.
Возвращает:
true, если идентичности считаются равными; в противном случае — false.
См. также:
  • equals(Object)

toString

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

toString

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

hashCode

public int hashCode()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает хеш-код этой Identity.
Определено в:
hashCode в интерфейсе Principal
Переопределяет:
hashCode в классе Object
Возвращает:
хеш-код этой Identity
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(Object)

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по 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/Identity.html

Spec-Zone.ru

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