Класс Identity

Устаревшее.

Этот класс больше не используется. Его функциональность заменена на java.security.KeyStore, пакет java.security.cert и java.security.Principal.

@Deprecated
public abstract class Identity
extends Object
implements Principal, Serializable

Этот класс представляет идентичности: реальные объекты, такие как люди, компании или организации, чьи идентичности могут быть аутентифицированы с помощью их открытых ключей. Идентичности также могут быть более абстрактными (или конкретными) конструкциями, такими как демон-потоки или смарт-карты.

Все объекты Identity имеют имя и открытый ключ. Имена неизменяемы. Идентичности также могут быть ограничены областью действия. То есть, если идентичность имеет определённую область действия, то имя и открытый ключ идентичности уникальны в этой области действия.

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

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

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

Identity

protected Identity()

Устаревший.

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

Identity

public Identity(String name,
                IdentityScope scope)
         throws KeyManagementException

Устаревший.

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

Параметры:

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

scope - область видимости идентификатора.

Исключения:

KeyManagementException - если в области видимости уже существует идентификатор с таким же именем.

Identity

public Identity(String name)

Устаревший.

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

Параметры:

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

Методы

getName

public final String getName()

Устаревший.

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

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

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

Возвращает:

имя этого идентификатора.

getScope

public final IdentityScope getScope()

Устаревший.

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

Возвращает:

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

getPublicKey

public PublicKey getPublicKey()

Устаревший.

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

Возвращает:

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

См. также:

setPublicKey(java.security.PublicKey)

setPublicKey

public void setPublicKey(PublicKey key)
                  throws KeyManagementException

Устаревший.

Параметры:

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

Исключения:

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

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

См. также:

getPublicKey(), SecurityManager.checkSecurityAccess(java.lang.String)

setInfo

public void setInfo(String info)

Устаревший.

Параметры:

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

Исключения:

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

См. также:

getInfo(), SecurityManager.checkSecurityAccess(java.lang.String)

getInfo

public String getInfo()

Устаревший.

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

Возвращает:

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

См. также:

setInfo(java.lang.String)

addCertificate

public void addCertificate(Certificate certificate)
                    throws KeyManagementException

Устаревший.

Параметры:

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

Исключения:

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

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

См. также:

SecurityManager.checkSecurityAccess(java.lang.String)

removeCertificate

public void removeCertificate(Certificate certificate)
                       throws KeyManagementException

Устаревший.

Параметры:

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

Исключения:

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

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

См. также:

SecurityManager.checkSecurityAccess(java.lang.String)

certificates

public Certificate[] certificates()

Устаревший.

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

Возвращает:

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

equals

public final boolean equals(Object identity)

Устаревший.

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

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

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

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

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

identityEquals(java.security.Identity)

identityEquals

protected boolean identityEquals(Identity identity)

Устаревший.

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

Параметры:

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

Возвращает:

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

См. также:

equals(java.lang.Object)

toString

public String toString()

Устаревший.

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

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

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

toString в классе Object

Возвращает:

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

Исключения:

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

См. также:

SecurityManager.checkSecurityAccess(java.lang.String)

toString

public String toString(boolean detailed)

Устаревший.

Параметры:

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

Возвращает:

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

Исключения:

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

См. также:

toString(), SecurityManager.checkSecurityAccess(java.lang.String)

hashCode

public int hashCode()

Устаревший.

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

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

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

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

hashCode в классе Object

Возвращает:

хэш-код для этого идентификатора.

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)