Класс 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
См. также:
IdentityScope, Signer, Principal, Сериализованная форма

Конструкторы

Модификатор Конструктор Описание
protected Identity()

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

Конструктор только для сериализации.
Identity​(String name)

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

Создаёт идентичность с указанным именем и без области действия.
Identity​(String name, IdentityScope scope)

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

Создаёт идентичность с указанным именем и областью действия.

Методы

Модификатор и тип Метод Описание
void addCertificate​(Certificate certificate)

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

Добавляет сертификат для этой идентичности.
Certificate[] certificates()

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

Возвращает копию всех сертификатов для этой идентичности.
boolean equals​(Object identity)

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

Проверяет равенство указанного объекта и этой идентичности.
String getInfo()

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

Возвращает общую информацию, ранее указанную для этой идентичности.
String getName()

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

Возвращает имя этой идентичности.
PublicKey getPublicKey()

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

Возвращает открытый ключ этой идентичности.
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

Конструкторы

Identity

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

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

Identity

public Identity(String name,
                IdentityScope scope)
         throws KeyManagementException
Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии.

Создаёт идентичность с указанным именем и областью действия.

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

Identity

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 не разрешает установку открытого ключа.
См. также:
getPublicKey(), SecurityManager.checkSecurityAccess(java.lang.String)

setInfo

public void setInfo(String info)
Устаревшее, для удаления: Этот элемент API может быть удален в будущей версии.

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

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

Параметры:
info - строка информации.
Выбрасывает:
SecurityException - если менеджер безопасности существует и его метод checkSecurityAccess не разрешает установку строки информации.
См. также:
getInfo(), SecurityManager.checkSecurityAccess(java.lang.String)

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

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

Параметры:
detailed - нужно ли предоставлять подробную информацию.
Возвращает:
информация об этой сущности. Если detailed true, то этот метод возвращает более подробную информацию, чем метод toString без аргументов.
Выбрасывает:
SecurityException - если менеджер безопасности существует и его метод checkSecurityAccess не разрешает возвращение строки, описывающей эту сущность.
См. также:
toString(), SecurityManager.checkSecurityAccess(java.lang.String)

hashCode

public int hashCode()
Устаревшее, для удаления: Этот элемент API может быть удален в будущей версии.

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

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

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

Spec-Zone .ru
спецификации, руководства, описания, API