Класс Identity
- Все реализованные интерфейсы:
-
Serializable,Principal
- Непосредственные известные подклассы:
-
IdentityScope,Signer
@Deprecated(since="1.2", forRemoval=true) public abstract class Identity extends Object implements Principal, Serializable
Этот класс представляет идентичности: объекты реального мира, такие как люди, компании или организации, чьи идентичности могут быть проверены с помощью их открытых ключей. Идентичности также могут быть более абстрактными (или конкретными) конструкциями, такими как демон-нити или смарт-карты.
Все объекты Identity имеют имя и открытый ключ. Имена неизменяемы. Идентичности также могут быть ограничены областью действия. То есть, если для Identity указана конкретная область действия, то имя и открытый ключ Identity уникальны в рамках этой области.
У Identity также есть набор сертификатов (все подтверждающие собственный открытый ключ). Имена субъектов, указанные в этих сертификатах, не обязательно должны быть одинаковыми, только ключ.
Класс Identity может быть расширен, чтобы включать почтовые и электронные адреса, номера телефонов, изображения лиц и логотипов и так далее.
- С тех пор:
- 1.1
- См. также:
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Устаревший, для удаления: Элемент API может быть удален в будущей версии. Конструктор только для сериализации. |
|
| Устаревший, для удаления: Элемент API может быть удален в будущей версии. Создаёт Identity с указанным именем и без области действия. |
||
| Устаревший, для удаления: Элемент API может быть удален в будущей версии. Создаёт Identity с указанным именем и областью действия. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addCertificate |
Устаревший, для удаления: Элемент API может быть удален в будущей версии. Добавляет сертификат для этого Identity. |
Certificate[] |
certificates() |
Устаревший, для удаления: Элемент API может быть удален в будущей версии. Возвращает копию всех сертификатов для этого Identity. |
final boolean |
equals |
Устаревший, для удаления: Элемент API может быть удален в будущей версии. Проверяет равенство указанного объекта и этого Identity. |
String |
getInfo() |
Устаревший, для удаления: Элемент API может быть удален в будущей версии. Возвращает общую информацию, ранее указанную для этого Identity. |
final String |
getName() |
Устаревший, для удаления: Элемент API может быть удален в будущей версии. Возвращает имя этой идентичности. |
PublicKey |
getPublicKey() |
Устаревший, для удаления: Элемент API может быть удален в будущей версии. Возвращает открытый ключ этой идентичности. |
final IdentityScope |
getScope() |
Устаревший, для удаления: Элемент API может быть удален в будущей версии. Возвращает область действия этой идентичности. |
int |
hashCode() |
Устаревший, для удаления: Элемент API может быть удален в будущей версии. Возвращает хэш-код для этого Identity. |
protected boolean |
identityEquals |
Устаревший, для удаления: Элемент API может быть удален в будущей версии. Проверяет равенство указанного Identity и этого Identity. |
void |
removeCertificate |
Устаревший, для удаления: Элемент API может быть удален в будущей версии. Удаляет сертификат из этого Identity. |
void |
setInfo |
Устаревший, для удаления: Элемент API может быть удален в будущей версии. Устанавливает строку общей информации для этого Identity. |
void |
setPublicKey |
Устаревший, для удаления: Элемент API может быть удален в будущей версии. Устанавливает открытый ключ этой идентичности. |
String |
toString() |
Устаревший, для удаления: Элемент API может быть удален в будущей версии. Возвращает короткую строку, описывающую эту Identity, указывая её имя и область действия (если есть). |
String |
toString |
Устаревший, для удаления: Элемент API может быть удален в будущей версии. Возвращает строковое представление этого Identity, с необязательными дополнительными подробностями, больше, чем те, которые предоставлены методом toString без аргументов. |
Подробное описание конструкторов
Идентификатор
protected Identity()
Идентификатор
public Identity(String name, IdentityScope scope) throws KeyManagementException
Identity с указанным именем и областью видимости.- Параметры:
-
name- имяIdentity. -
scope- область видимостиIdentity. - Исключения:
-
KeyManagementException- если в области видимости уже существуетIdentityс таким же именем.
Идентификатор
public Identity(String name)
Identity с указанным именем и без области видимости.- Параметры:
-
name- имя идентификатора.
Подробное описание методов
getName
getScope
public final IdentityScope getScope()
- Возвращает:
- область видимости этого
Identity.
getPublicKey
public PublicKey getPublicKey()
- Возвращает:
- открытый ключ для этого
Identity. - См. также:
setPublicKey
public void setPublicKey(PublicKey key) throws KeyManagementException
- Параметры:
-
key- открытый ключ для этогоIdentity. - Исключения:
-
KeyManagementException- если другой идентификатор в области видимости идентификатора имеет тот же открытый ключ, или если возникает другое исключение. - См. также:
setInfo
public void setInfo(String info)
Identity.- Параметры:
-
info- строка информации. - См. также:
getInfo
public String getInfo()
Identity.- Возвращает:
- общая информация об этом
Identity. - См. также:
addCertificate
public void addCertificate(Certificate certificate) throws KeyManagementException
Identity. Если у Identity есть открытый ключ, открытый ключ в сертификате должен быть таким же, а если у Identity нет открытого ключа, открытый ключ идентификатора устанавливается в соответствии с ключом, указанным в сертификате.- Параметры:
-
certificate- добавляемый сертификат. - Исключения:
-
KeyManagementException- если сертификат недействителен, если открытый ключ в добавляемом сертификате конфликтует с открытым ключом этого идентификатора, или если возникает другое исключение.
removeCertificate
public void removeCertificate(Certificate certificate) throws KeyManagementException
Identity.- Параметры:
-
certificate- удаляемый сертификат. - Исключения:
-
KeyManagementException- если сертификат отсутствует, или если возникает другое исключение.
certificates
public Certificate[] certificates()
Identity.- Возвращает:
- копию всех сертификатов для этого
Identity.
equals
public final boolean equals(Object identity)
Identity. Сначала проверяется, ссылаются ли сущности на один и тот же объект, в этом случае возвращается true. Затем проверяется, имеют ли сущности одинаковое имя и одинаковую область видимости. Если да, метод возвращает true. В противном случае вызывается identityEquals, который подклассы должны переопределить.identityEquals
protected boolean identityEquals(Identity identity)
Identity и этого Identity. Этот метод должен быть переопределен подклассами для проверки равенства. По умолчанию возвращает true, если имена и открытые ключи равны.- Параметры:
-
identity- идентификатор для проверки равенства с этимidentity. - Возвращает:
-
true, если идентификаторы считаются равными,falseв противном случае. - См. также:
toString
public String toString()
Identity, указывая его имя и область видимости (если таковая есть).toString
public String toString(boolean detailed)
Identity, с необязательно более подробной информацией, чем та, что предоставляется методом toString без аргументов.- Параметры:
-
detailed- указывает, предоставлять ли подробную информацию. - Возвращает:
- информация об этом
Identity. Еслиdetailedравноtrue, то этот метод возвращает более подробную информацию, чем методtoStringбез аргументов. - См. также:
hashCode
© 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/security/Identity.html
java.security.KeyStore, пакетjava.security.certиjava.security.Principal.