Класс 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 всех видов, в том числе подписантов. Объекты 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 подлежит удалению в будущей версии. Добавляет `Identity` в эту область идентификаторов.
`abstract Identity`	`getIdentity(String name)`	Устарел, будет удалён: этот элемент API подлежит удалению в будущей версии. Возвращает `Identity` в этой области действия с указанным именем (если он есть).
`Identity`	`getIdentity(Principal principal)`	Устарел, будет удалён: этот элемент API подлежит удалению в будущей версии. Получает `Identity`, имя которого совпадает с именем указанного субъекта.
`abstract Identity`	`getIdentity(PublicKey key)`	Устарел, будет удалён: этот элемент API подлежит удалению в будущей версии. Получает `identity` с указанным открытым ключом.
`static IdentityScope`	`getSystemScope()`	Устарел, будет удалён: этот элемент API подлежит удалению в будущей версии. Возвращает системную область идентификаторов.
`abstract Enumeration<Identity>`	`identities()`	Устарел, будет удалён: этот элемент API подлежит удалению в будущей версии. Возвращает перечисление всех идентификаторов в этой области идентификаторов.
`abstract void`	`removeIdentity(Identity identity)`	Устарел, будет удалён: этот элемент API подлежит удалению в будущей версии. Удаляет `Identity` из этой области идентификаторов.
`protected static void`	`setSystemScope(IdentityScope scope)`	Устарел, будет удалён: этот элемент API подлежит удалению в будущей версии. Задаёт системную область идентификаторов.
`abstract int`	`size()`	Устарел, будет удалён: этот элемент API подлежит удалению в будущей версии. Возвращает количество идентификаторов в этой области идентификаторов.
`String`	`toString()`	Устарел, будет удалён: этот элемент API подлежит удалению в будущей версии. Возвращает строковое представление этой области идентификаторов, включая её имя, имя её области действия и количество содержащихся в ней идентификаторов.

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

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

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

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

Методы, объявленные в интерфейсе 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 — если в этой области действия уже есть Identity с таким же именем.

Подробное описание методов

getSystemScope

public static IdentityScope getSystemScope()

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

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

Возвращает:

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

См. также:

setSystemScope

protected static void setSystemScope(IdentityScope scope)

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

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

Параметры:

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

См. также:

size

public abstract int size()

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

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

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

getIdentity

public abstract Identity getIdentity(String name)

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

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

Параметры:: name — имя Identity, которое требуется получить.
Возвращает:: Identity с именем name или null, если в этой области действия нет идентификаторов с именем name.

getIdentity

public Identity getIdentity(Principal principal)

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

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

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

getIdentity

public abstract Identity getIdentity(PublicKey key)

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

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

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

addIdentity

public abstract void addIdentity(Identity identity) throws KeyManagementException

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

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

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

removeIdentity

public abstract void removeIdentity(Identity identity) throws KeyManagementException

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

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

Параметры:: identity — Identity, которое требуется удалить.
Исключения:: KeyManagementException — если идентификатор отсутствует или возникает другое исключение.

identities

public abstract Enumeration<Identity> identities()

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

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

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

toString

public String toString()

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

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

Определено в:: toString в интерфейсе Principal
Переопределяет:: toString в классе Identity
Возвращает:: строковое представление этой области идентификаторов.

© 1993, 2025, 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/25/docs/api/java.base/java/security/IdentityScope.html