Класс 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

См. также:

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

Identity()

Identity(String name)

Identity(String name,
 IdentityScope scope)

Модификатор	Конструктор	Описание
`protected`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Конструктор только для сериализации.
	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Создаёт идентичность с указанным именем и без области.
	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Создаёт идентичность с указанным именем и областью.

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

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

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

Параметры:: name - имя идентификатора.; scope - область идентификатора.
Исключения:: KeyManagementException - если в области уже существует идентификатор с таким же именем.

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

public Identity(String name)

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

Создаёт идентификатор с указанным именем и без области.

Параметры:: name - имя идентификатора.

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

getName

public final String getName()

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

Возвращает имя этого идентификатора.

Унаследовано от:: getName в интерфейсе Principal
Возвращает:: имя этого идентификатора.

getScope

public final IdentityScope getScope()

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

Возвращает область этого идентификатора.

Возвращает:: область этого идентификатора.

getPublicKey

public PublicKey getPublicKey()

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

Возвращает открытый ключ этого идентификатора.

Возвращает:

открытый ключ этого идентификатора.

См. также:

setPublicKey(java.security.PublicKey)

setPublicKey

public void setPublicKey(PublicKey key) throws KeyManagementException

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

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

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

Параметры:

key - открытый ключ для этого идентификатора.

Исключения:

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

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

См. также:

setInfo

public void setInfo(String info)

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

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

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

Параметры:

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

Исключения:

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

См. также:

getInfo

public String getInfo()

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

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

Возвращает:

общая информация об этом идентификаторе.

См. также:

setInfo(java.lang.String)

addCertificate

public void addCertificate(Certificate certificate) throws KeyManagementException

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

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

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

Параметры:

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

Исключения:

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

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

См. также:

SecurityManager.checkSecurityAccess(java.lang.String)

removeCertificate

public void removeCertificate(Certificate certificate) throws KeyManagementException

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

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

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

Параметры:

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

Исключения:

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

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

См. также:

SecurityManager.checkSecurityAccess(java.lang.String)

certificates

public Certificate[] certificates()

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

Возвращает копию всех сертификатов для этого идентификатора.

Возвращает:: копию всех сертификатов для этого идентификатора.

equals

public final boolean equals(Object identity)

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

Проверяет равенство указанного объекта и этого идентификатора. Сначала проверяется, ссылаются ли сущности на один и тот же объект, в этом случае возвращается true. Далее проверяется, имеют ли сущности одинаковое имя и область. Если они одинаковы, метод возвращает true. В противном случае вызывается identityEquals, который подклассы должны переопределять.

Унаследовано от:

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

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

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

identityEquals(java.security.Identity)

identityEquals

protected boolean identityEquals(Identity identity)

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

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

Параметры:

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

Возвращает:

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

См. также:

equals(java.lang.Object)

toString

public String toString()

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

Возвращает короткую строку, описывающую данную идентичность, указывая её имя и область действия (если таковая есть).

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

Указано в:

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

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

toString в классе Object

Возвращает:

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

Выбрасывает:

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

См. также:

SecurityManager.checkSecurityAccess(java.lang.String)

toString

public String toString(boolean detailed)

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

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

Параметры:

detailed - указывает, предоставлять ли подробную информацию.

Возвращает:

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

Выбрасывает:

См. также:

hashCode

public int hashCode()

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

Возвращает хэш-код для этой идентичности.

Указано в:

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

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

hashCode в классе Object

Возвращает:

хэш-код для этой идентичности.

См. также:

© 1993, 2021, 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/17/docs/api/java.base/java/security/Identity.html