Класс IdentityScope
- java.lang.Object
-
- java.security.Identity
-
- java.security.IdentityScope
- Все реализованные интерфейсы:
-
Serializable,Principal
@Deprecated(since="1.2",
forRemoval=true)
public abstract class IdentityScope
extends Identity 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()
Этот конструктор используется только для сериализации и не должен использоваться подклассами.
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)
Устанавливает контекст идентификации системы.
Сначала, если существует менеджер безопасности, вызывается его метод checkSecurityAccess с "setSystemScope" в качестве аргумента, чтобы проверить, можно ли установить контекст идентификации.
- Параметры:
-
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)
© 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