Класс IdentityScope

java.lang.Object

java.security.Identity

java.security.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

См. также:

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

IdentityScope()

IdentityScope(String name)

IdentityScope(String name,
 IdentityScope scope)

Модификатор	Конструктор	Описание
`protected`	Устаревший, подлежит удалению: Элемент API может быть удален в будущей версии. Этот конструктор используется только для сериализации и не должен использоваться подклассами.
	Устаревший, подлежит удалению: Элемент API может быть удален в будущей версии. Создаёт новую область видимости идентификатора с указанным именем.
	Устаревший, подлежит удалению: Элемент 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 не разрешает установку области видимости идентификатора.

См. также:

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, 2021, 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/17/docs/api/java.base/java/security/IdentityScope.html