Класс 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.

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

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

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

С версии:

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

Модификатор и тип	Метод	Описание
`void`	`addCertificate(Certificate certificate)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Добавляет сертификат для этого `Identity`.
`Certificate[]`	`certificates()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Возвращает копию всех сертификатов для этого `Identity`.
`final boolean`	`equals(Object identity)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Проверяет равенство указанного объекта и этого `Identity`.
`String`	`getInfo()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Возвращает ранее заданные общие сведения для этого `Identity`.
`final String`	`getName()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Возвращает имя этого идентификатора.
`PublicKey`	`getPublicKey()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Возвращает открытый ключ этого идентификатора.
`final IdentityScope`	`getScope()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Возвращает область этого идентификатора.
`int`	`hashCode()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Возвращает хеш-код этого `Identity`.
`protected boolean`	`identityEquals(Identity identity)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Проверяет равенство указанного `Identity` и этого `Identity`.
`void`	`removeCertificate(Certificate certificate)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Удаляет сертификат из этого `Identity`.
`void`	`setInfo(String info)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Задает строку с общими сведениями для этого `Identity`.
`void`	`setPublicKey(PublicKey key)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Задает открытый ключ этого идентификатора.
`String`	`toString(boolean detailed)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Возвращает строковое представление этого `Identity`, которое может содержать больше подробностей, чем представление, возвращаемое методом `toString` без аргументов.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать до тех пор, пока он не будет пробужден, обычно путем вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать до тех пор, пока он не будет пробужден, обычно путем вызова notify или interrupt, либо пока не истечет заданное время.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать до тех пор, пока он не будет пробужден, обычно путем вызова notify или interrupt, либо пока не истечет заданное время.

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

implies

Модификатор и тип	Метод	Описание
`default boolean`	`implies(Subject subject)`	Возвращает `true`, если указанный субъект представлен этим `Principal`.

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

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.