Spec-Zone.ru › OpenJDK 25

Класс Policy

java.lang.Object
java.security.Policy
@Deprecated(since="17", forRemoval=true) public abstract class Policy extends Object
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Этот класс был полезен только совместно с Менеджером безопасности, поддержка которого прекращена. Установка общесистемного объекта Policy больше не поддерживается. Метод setPolicy изменён и всегда вызывает исключение UnsupportedOperationException. Метод getPolicy изменён и всегда возвращает объект Policy, который не предоставляет никаких разрешений. Замены Менеджеру безопасности или этому классу нет.
Объект Policy отвечал за определение того, имел ли код, выполняющийся в среде выполнения Java, разрешение на выполнение операции, связанной с безопасностью. Эта возможность больше не существует.
С версии:
1.2

Краткое описание вложенных классов

Модификатор и тип Класс Описание
static interface  Policy.Parameters
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Этот класс был полезен только совместно с Менеджером безопасности, поддержка которого прекращена.

Краткое описание полей

Модификатор и тип Поле Описание
static final PermissionCollection UNSUPPORTED_EMPTY_COLLECTION
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Экземпляр пустой коллекции PermissionCollection, доступный только для чтения.

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

Конструктор Описание
Policy()
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Конструктор, вызываемый подклассами.

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

Модификатор и тип Метод Описание
static Policy getInstance(String type, Policy.Parameters params)
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает объект Policy указанного типа.
static Policy getInstance(String type, Policy.Parameters params, String provider)
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает объект Policy указанного типа.
static Policy getInstance(String type, Policy.Parameters params, Provider provider)
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает объект Policy указанного типа.
Policy.Parameters getParameters()
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает параметры Policy.
PermissionCollection getPermissions(CodeSource codesource)
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает объект PermissionCollection, содержащий набор разрешений, предоставленных указанному CodeSource.
PermissionCollection getPermissions(ProtectionDomain domain)
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает объект PermissionCollection, содержащий набор разрешений, предоставленных указанному ProtectionDomain.
static Policy getPolicy()
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает объект Policy, который не предоставляет никаких разрешений.
Provider getProvider()
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает Provider этой политики.
String getType()
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает тип этого объекта Policy.
boolean implies(ProtectionDomain domain, Permission permission)
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Оценивает разрешения, предоставленные ProtectionDomain, и проверяет, предоставлено ли разрешение.
void refresh()
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Обновляет/перезагружает конфигурацию политики.
static void setPolicy(Policy p)
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Вызывает исключение UnsupportedOperationException.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

UNSUPPORTED_EMPTY_COLLECTION

public static final PermissionCollection UNSUPPORTED_EMPTY_COLLECTION
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Экземпляр пустой коллекции PermissionCollection, доступный только для чтения.
С версии:
1.6

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

Policy

public Policy()
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Конструктор, вызываемый подклассами.

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

getPolicy

public static Policy getPolicy()
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает объект Policy, который не предоставляет никаких разрешений. В частности:
  • Метод getParameters возвращает null.
  • Методы getPermissions(CodeSource) и getPermissions(ProtectionDomain) возвращают пустую PermissionCollection, доступную только для чтения.
  • Метод implies всегда возвращает false.
Примечание API:
Изначально этот метод возвращал установленный объект Policy или, если объект Policy не был установлен, реализацию Policy по умолчанию. Установка общесистемного объекта Policy больше не поддерживается. Этот метод всегда возвращает объект Policy по умолчанию, который не предоставляет никаких разрешений. Объект Policy был полезен только совместно с Менеджером безопасности, поддержка которого прекращена. Замены этому методу нет.
Возвращает:
объект Policy, который не предоставляет никаких разрешений
См. также:
  • setPolicy(java.security.Policy)

setPolicy

public static void setPolicy(Policy p)
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Вызывает исключение UnsupportedOperationException. Установка общесистемного объекта Policy не поддерживается.
Примечание API:
Изначально этот метод устанавливал общесистемный объект Policy. Установка общесистемного объекта Policy больше не поддерживается. Объект Policy был полезен только совместно с Менеджером безопасности, поддержка которого прекращена. Замены этому методу нет.
Параметры:
p — игнорируется
Вызывает исключение:
UnsupportedOperationException — всегда
См. также:
  • getPolicy()

getInstance

public static Policy getInstance(String type, Policy.Parameters params) throws NoSuchAlgorithmException
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает объект Policy указанного типа.

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

Обратите внимание, что список зарегистрированных поставщиков можно получить с помощью метода Security.getProviders().

Примечание по реализации:
Эталонная реализация JDK дополнительно использует свойство jdk.security.provider.preferred Security для определения предпочтительного порядка поставщиков для указанного алгоритма. Этот порядок может отличаться от порядка поставщиков, возвращаемых методом Security.getProviders().
Параметры:
type — указанный тип Policy
params — параметры для Policy, которые могут быть null.
Возвращает:
новый объект Policy
Вызывает исключение:
IllegalArgumentException — если указанные параметры не распознаны реализацией PolicySpi выбранного Provider
NoSuchAlgorithmException — если ни один Provider не поддерживает реализацию PolicySpi для указанного типа
NullPointerException — если type равно null
С версии:
1.6
См. также:
  • Provider

getInstance

public static Policy getInstance(String type, Policy.Parameters params, String provider) throws NoSuchProviderException, NoSuchAlgorithmException
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает объект Policy указанного типа.

Возвращается новый объект Policy, инкапсулирующий реализацию PolicySpi указанного поставщика. Указанный поставщик должен быть зарегистрирован в списке поставщиков.

Обратите внимание, что список зарегистрированных поставщиков можно получить с помощью метода Security.getProviders().

Параметры:
type — указанный тип Policy
params — параметры для Policy, которые могут быть null.
provider — поставщик.
Возвращает:
новый объект Policy
Вызывает исключение:
IllegalArgumentException — если указанный поставщик равен null или является пустым, либо если указанные параметры не распознаны реализацией PolicySpi указанного поставщика
NoSuchAlgorithmException — если указанный поставщик не поддерживает реализацию PolicySpi для указанного типа
NoSuchProviderException — если указанный поставщик не зарегистрирован в списке поставщиков служб безопасности
NullPointerException — если type равно null
С версии:
1.6
См. также:
  • Provider

getInstance

public static Policy getInstance(String type, Policy.Parameters params, Provider provider) throws NoSuchAlgorithmException
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает объект Policy указанного типа.

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

Параметры:
type — указанный тип Policy
params — параметры для Policy, которые могут быть null.
provider — Provider.
Возвращает:
новый объект Policy
Вызывает исключение:
IllegalArgumentException — если указанный Provider равен null или если указанные параметры не распознаны реализацией PolicySpi указанного Provider
NoSuchAlgorithmException — если указанный Provider не поддерживает реализацию PolicySpi для указанного типа
NullPointerException — если type равно null
С версии:
1.6
См. также:
  • Provider

getProvider

public Provider getProvider()
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает Provider этой политики.

У этого экземпляра Policy будет поставщик, только если он был получен вызовом Policy.getInstance. В противном случае этот метод возвращает null.

Возвращает:
Provider этой политики или null.
С версии:
1.6

getType

public String getType()
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает тип этого объекта Policy.

У этого экземпляра Policy будет тип, только если он был получен вызовом Policy.getInstance. В противном случае этот метод возвращает null.

Возвращает:
тип этого объекта Policy или null.
С версии:
1.6

getParameters

public Policy.Parameters getParameters()
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает параметры Policy.

У этого экземпляра Policy будут параметры, только если он был получен вызовом Policy.getInstance. В противном случае этот метод возвращает null.

Возвращает:
параметры Policy или null.
С версии:
1.6

getPermissions

public PermissionCollection getPermissions(CodeSource codesource)
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает объект PermissionCollection, содержащий набор разрешений, предоставленных указанному CodeSource.

Реализация этого метода по умолчанию игнорирует CodeSource и возвращает Policy.UNSUPPORTED_EMPTY_COLLECTION.

Параметры:
codesource — игнорируется
Возвращает:
набор разрешений, предоставленных указанному CodeSource. Если эта операция поддерживается, возвращаемый набор разрешений должен быть новым изменяемым экземпляром и поддерживать разнородные типы Permission. Если эта операция не поддерживается, возвращается Policy.UNSUPPORTED_EMPTY_COLLECTION.

getPermissions

public PermissionCollection getPermissions(ProtectionDomain domain)
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Возвращает объект PermissionCollection, содержащий набор разрешений, предоставленных указанному ProtectionDomain.

Реализация этого метода по умолчанию игнорирует ProtectionDomain и возвращает Policy.UNSUPPORTED_EMPTY_COLLECTION.

Параметры:
domain — игнорируется
Возвращает:
набор разрешений, предоставленных указанному ProtectionDomain. Если эта операция поддерживается, возвращаемый набор разрешений должен быть новым изменяемым экземпляром и поддерживать разнородные типы Permission. Если эта операция не поддерживается, возвращается Policy.UNSUPPORTED_EMPTY_COLLECTION.
С версии:
1.4

implies

public boolean implies(ProtectionDomain domain, Permission permission)
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Оценивает разрешения, предоставленные ProtectionDomain, и проверяет, предоставлено ли разрешение.

Реализация этого метода по умолчанию игнорирует параметры ProtectionDomain и Permission и всегда возвращает false.

Параметры:
domain — игнорируется
permission — игнорируется
Возвращает:
false — всегда
С версии:
1.4
См. также:
  • ProtectionDomain

refresh

public void refresh()
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Обновляет/перезагружает конфигурацию политики.

Реализация этого метода по умолчанию ничего не делает.

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API