Класс IdentityScope

Все реализованные интерфейсы:
Serializable, Principal
@Deprecated(since="1.2",
            forRemoval=true)
public abstract class IdentityScope
extends Identity
Устаревший, подлежащий удалению: Элемент API может быть удалён в будущих версиях.
Этот класс устарел и подлежит удалению в будущих версиях Java SE. Он был заменён на java.security.KeyStore, в пакете java.security.cert и java.security.Principal.

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

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

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

С тех пор:
1.1
См. также:
Identity, Signer, Principal, Key, Сериализованная форма

Краткое описание конструкторов

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

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

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

IdentityScope​(String name)

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

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

IdentityScope​(String name, IdentityScope scope)

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

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

Краткое описание методов

Модификатор и тип Метод Описание
abstract void addIdentity​(Identity identity)

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

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

abstract Identity getIdentity​(String name)

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

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

Identity getIdentity​(Principal principal)

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

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

abstract Identity getIdentity​(PublicKey key)

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

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

static IdentityScope getSystemScope()

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

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

abstract Enumeration<Identity> identities()

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

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

abstract void removeIdentity​(Identity identity)

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

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

protected static void setSystemScope​(IdentityScope scope)

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

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

abstract int size()

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

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

String toString()

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

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

Методы, объявленные в классе java.security.Identity

addCertificate, certificates, equals, getInfo, getName, getPublicKey, getScope, hashCode, identityEquals, removeCertificate, setInfo, setPublicKey, toString

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

implies

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

IdentityScope

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

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

IdentityScope

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

Создаёт новый контекст идентификации с указанным именем.

Параметры:
name - имя контекста.

IdentityScope

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

Создаёт новый контекст идентификации с указанным именем и контекстом.

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

Методы

getSystemScope

public static IdentityScope getSystemScope()
Устарело, подлежит удалению: Этот элемент API может быть удалён в будущей версии.

Возвращает контекст идентификации системы.

Возвращает:
контекст идентификации системы или null , если он не был установлен.
См. также:
setSystemScope(java.security.IdentityScope)

setSystemScope

protected static void setSystemScope(IdentityScope scope)
Устарело, подлежит удалению: Этот элемент API может быть удалён в будущей версии.

Устанавливает контекст идентификации системы.

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

Параметры:
scope - контекст для установки.
Исключения:
SecurityException - если существует менеджер безопасности, и его метод checkSecurityAccess не позволяет установить контекст идентификации.
См. также:
getSystemScope(), SecurityManager.checkSecurityAccess(java.lang.String)

size

public abstract int size()
Устарело, подлежит удалению: Этот элемент API может быть удалён в будущей версии.

Возвращает количество идентификаторов в этом контексте идентификации.

Возвращает:
количество идентификаторов в этом контексте идентификации.

getIdentity

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

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

Параметры:
name - имя идентификатора для извлечения.
Возвращает:
идентификатор с именем name, или null, если в этом контексте нет идентификаторов с именем name.

getIdentity

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

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

Параметры:
principal - принципал, соответствующий идентификатору для извлечения.
Возвращает:
идентификатор, имя которого совпадает с именем принципала, или null, если в этом контексте нет идентификаторов с таким же именем.

getIdentity

public abstract Identity getIdentity(PublicKey key)
Устарело, подлежит удалению: Этот элемент API может быть удалён в будущей версии.

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

Параметры:
key - открытый ключ для возвращаемого идентификатора.
Возвращает:
идентификатор с заданным ключом, или null, если в этом контексте нет идентификаторов с этим ключом.

addIdentity

public abstract void addIdentity(Identity identity)
                          throws KeyManagementException
Устарело, подлежит удалению: Этот элемент API может быть удалён в будущей версии.

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

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

removeIdentity

public abstract void removeIdentity(Identity identity)
                             throws KeyManagementException
Устарело, подлежит удалению: Этот элемент API может быть удалён в будущей версии.

Удаляет идентификатор из этого контекста идентификации.

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

identities

public abstract Enumeration<Identity> identities()
Устарело, подлежит удалению: Этот элемент API может быть удалён в будущей версии.

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

Возвращает:
перечисление всех идентификаторов в этом контексте идентификации.

toString

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

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

Задано:
toString в интерфейсе Principal
Переопределяет:
toString в классе Identity
Возвращает:
строковое представление этого контекста идентификации.
См. также:
SecurityManager.checkSecurityAccess(java.lang.String)

© 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/IdentityScope.html

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