Класс IdentityScope

Устаревший.

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

@Deprecated
public abstract class IdentityScope
extends Identity

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

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

Существует взаимно однозначное соответствие между ключами и идентификаторами, и может быть только одна копия одного ключа на область действия. Например, предположим, что Acme Software, Inc — это издатель программного обеспечения, известный пользователю. Предположим, что это идентификатор, то есть у него есть открытый ключ и набор связанных сертификатов. Он называется в области действия с именем «Acme Software». Ни один другой идентификатор с именем в области действия не имеет такого же открытого ключа. Конечно, ни один не имеет такого же имени.

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

IdentityScope

protected IdentityScope()

Устаревший.

Этот конструктор используется только для сериализации и не должен использоваться подклассами.

IdentityScope

public IdentityScope(String name)

Устаревший.

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

Параметры:

name - имя области действия.

IdentityScope

public IdentityScope(String name,
                     IdentityScope scope)
              throws KeyManagementException

Устаревший.

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

Параметры:

name - имя области действия.

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

Исключения:

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

Методы

getSystemScope

public static IdentityScope getSystemScope()

Устаревший.

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

Возвращает:

область действия идентификаторов системы, или null если она не была установлена.

См. также:

setSystemScope(java.security.IdentityScope)

setSystemScope

protected static void setSystemScope(IdentityScope scope)

Устаревший.

Параметры:

scope - область действия, которую нужно установить.

Исключения:

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

См. также:

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

size

public abstract int size()

Устаревший.

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

Возвращает:

количество идентификаторов в этой области действия идентификаторов.

getIdentity

public abstract Identity getIdentity(String name)

Устаревший.

Возвращает идентификатор в этой области действия с указанным именем (если есть).

Параметры:

name - имя идентификатора, который нужно получить.

Возвращает:

идентификатор с именем name, или null, если нет идентификаторов с именем name в этой области действия.

getIdentity

public Identity getIdentity(Principal principal)

Устаревший.

Возвращает идентификатор, имя которого совпадает с именем указанного субъекта. (Примечание: Identity реализует Principal.)

Параметры:

principal - субъект, соответствующий идентификатору, который нужно получить.

Возвращает:

идентификатор, имя которого совпадает с именем субъекта, или null, если нет идентификаторов с таким же именем в этой области действия.

getIdentity

public abstract Identity getIdentity(PublicKey key)

Устаревший.

Возвращает идентификатор с указанным открытым ключом.

Параметры:

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

Возвращает:

идентификатор с заданным ключом, или null, если нет идентификаторов в этой области действия с этим ключом.

addIdentity

public abstract void addIdentity(Identity identity)
                          throws KeyManagementException

Устаревший.

Добавляет идентификатор в эту область действия идентификаторов.

Параметры:

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

Исключения:

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

removeIdentity

public abstract void removeIdentity(Identity identity)
                             throws KeyManagementException

Устаревший.

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

Параметры:

identity - удаляемый идентификатор.

Исключения:

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

identities

public abstract Enumeration<Identity> identities()

Устаревший.

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

Возвращает:

перечисление всех идентификаторов в этой области действия идентификаторов.

toString

public String toString()

Устаревший.

Возвращает строковое представление этой области действия идентификаторов, включая её имя, имя области действия и количество идентификаторов в этой области действия идентификаторов.

Указано в:

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

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

toString в классе Identity

Возвращает:

строковое представление этой области действия идентификаторов.

См. также:

SecurityManager.checkSecurityAccess(java.lang.String)