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

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

С:

1.1

См. также:

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

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` без аргументов.

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

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

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

implies

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

Идентификатор

protected Identity()

Устарело, подлежит удалению: Этот элемент API может быть удален в будущей версии.

Конструктор только для сериализации.

Идентификатор

public Identity(String name, IdentityScope scope) throws KeyManagementException

Устарело, подлежит удалению: Этот элемент API может быть удален в будущей версии.

Создает Identity с указанным именем и областью.

Параметры:: name - имя Identity.; scope - область Identity.
Исключения:: KeyManagementException - если в области уже существует 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

public void setPublicKey(PublicKey key) throws KeyManagementException

Устарело, подлежит удалению: Этот элемент API может быть удален в будущей версии.

Устанавливает открытый ключ данного идентификатора. Старый ключ и все сертификаты этого идентификатора удаляются в ходе этой операции.

Сначала, если менеджер безопасности существует, вызывается его метод checkSecurityAccess с "setIdentityPublicKey" в качестве аргумента, чтобы проверить, можно ли установить открытый ключ.

Параметры:

key - открытый ключ для данного Identity.

Исключения:

KeyManagementException - если другой идентификатор в области идентификатора имеет тот же открытый ключ, или если произошла другая ошибка.

SecurityException - если менеджер безопасности существует и его метод checkSecurityAccess не разрешает установить открытый ключ.

См. также:

setInfo

public void setInfo(String info)

Устарело, подлежит удалению: Этот элемент API может быть удален в будущей версии.

Указывает строку общей информации для данного Identity.

Сначала, если менеджер безопасности существует, вызывается его метод checkSecurityAccess с "setIdentityInfo" в качестве аргумента, чтобы проверить, можно ли указать строку информации.

Параметры:

info - строка информации.

Исключения:

SecurityException - если менеджер безопасности существует и его метод checkSecurityAccess не разрешает установить строку информации.

См. также:

getInfo

public String getInfo()

Устарело, подлежит удалению: Этот элемент API может быть удален в будущей версии.

Возвращает общую информацию, ранее указанную для данного Identity.

Возвращает:

общая информация об этом Identity.

См. также:

addCertificate

public void addCertificate(Certificate certificate) throws KeyManagementException

Устарело, подлежит удалению: Этот элемент API может быть удален в будущей версии.

Добавляет сертификат для данного Identity. Если у Identity есть открытый ключ, открытый ключ в сертификате должен быть таким же, а если у Identity нет открытого ключа, открытый ключ идентификатора устанавливается как указанный в сертификате.

Сначала, если менеджер безопасности существует, вызывается его метод checkSecurityAccess с "addIdentityCertificate" в качестве аргумента, чтобы проверить, можно ли добавить сертификат.

Параметры:

certificate - добавляемый сертификат.

Исключения:

KeyManagementException - если сертификат недействителен, если открытый ключ в добавляемом сертификате конфликтует с открытым ключом данного идентификатора или если произошла другая ошибка.

SecurityException - если менеджер безопасности существует и его метод checkSecurityAccess не разрешает добавление сертификата.

См. также:

removeCertificate

public void removeCertificate(Certificate certificate) throws KeyManagementException

Устарело, подлежит удалению: Этот элемент API может быть удален в будущей версии.

Удаляет сертификат из данного Identity.

Сначала, если менеджер безопасности существует, вызывается его метод checkSecurityAccess с "removeIdentityCertificate" в качестве аргумента, чтобы проверить, можно ли удалить сертификат.

Параметры:

certificate - удаляемый сертификат.

Исключения:

KeyManagementException - если сертификат отсутствует или произошла другая ошибка.

SecurityException - если менеджер безопасности существует и его метод checkSecurityAccess не разрешает удаление сертификата.

См. также:

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

protected boolean identityEquals(Identity identity)

Устарело, подлежит удалению: Этот элемент API может быть удален в будущей версии.

Проверяет равенство указанного Identity и этого Identity. Этот метод должен быть переопределен подклассами для проверки равенства. По умолчанию возвращается true если имена и открытые ключи равны.

Параметры:

identity - идентификатор для проверки равенства с этим identity.

Возвращает:

true если идентификаторы считаются равными, false в противном случае.

См. также:

toString

public String toString()

Устаревший, подлежит удалению: Этот элемент API может быть удалён в будущей версии.

Возвращает короткую строку, описывающую этот Identity, указывающую его имя и область (если есть).

Сначала, если существует менеджер безопасности, вызывается его метод checkSecurityAccess с "printIdentity" в качестве аргумента, чтобы проверить, разрешено ли возвращение строки.

Определено в:

toString в интерфейсе Principal

Переопределяет:

toString в классе Object

Возвращает:

информация об этом Identity, включая его имя и имя его области (если есть).

Исключения:

SecurityException - если существует менеджер безопасности, и его метод checkSecurityAccess не разрешает возвращение строки, описывающей этот Identity.

См. также:

toString

public String toString(boolean detailed)

Устаревший, подлежит удалению: Этот элемент API может быть удалён в будущей версии.

Возвращает строковое представление этого Identity, с опциональными дополнительными подробностями по сравнению с методом toString без аргументов.

Параметры:

detailed - требуется ли предоставление подробной информации.

Возвращает:

информация об этом Identity. Если detailed равно true, то этот метод возвращает более подробную информацию, чем метод toString без аргументов.

Исключения:

См. также:

hashCode

public int hashCode()

Устаревший, подлежит удалению: Этот элемент API может быть удалён в будущей версии.

Возвращает хэш-код для этого Identity.

Определено в:

hashCode в интерфейсе Principal

Переопределяет:

hashCode в классе Object

Возвращает:

хэш-код для этого Identity.

См. также:

© 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/Identity.html