Класс 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 подлежит удалению в будущей версии. Создаёт `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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация устарела и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

implies

Модификатор и тип	Метод	Описание
`default boolean`	`implies(Subject subject)`	Возвращает `true`, если указанный субъект подразумевается этой `Principal`.

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

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

public void setPublicKey(PublicKey key) throws KeyManagementException

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

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

Параметры:

key — открытый ключ этой Identity.

Исключения:

KeyManagementException — если другая идентичность в области действия этой идентичности имеет такой же открытый ключ или возникает другое исключение.

См. также:

setInfo

public void setInfo(String info)

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

Задаёт строку с общими сведениями для этой Identity.

Параметры:

info — строка со сведениями.

См. также:

getInfo

public String getInfo()

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

Возвращает общие сведения, ранее заданные для этой Identity.

Возвращает:

общие сведения об этой Identity.

См. также:

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

protected boolean identityEquals(Identity identity)

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

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

Параметры:

identity — идентичность, равенство которой проверяется с этой identity.

Возвращает:

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

См. также:

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

См. также:

hashCode

public int hashCode()

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

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

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

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

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

hashCode в классе Object

Возвращает:

хеш-код этой Identity

См. также:

© 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.