Класс Policy
@Deprecated(since="17", forRemoval=true) public abstract class Policy extends Object
Policy отвечал за определение того, имел ли код, выполняющийся в среде выполнения Java, разрешение на выполнение операции, связанной с безопасностью. Эта возможность больше не существует.- С версии:
- 1.2
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
static interface |
Policy.Parameters |
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Этот класс был полезен только совместно с Менеджером безопасности, поддержка которого прекращена. |
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final PermissionCollection |
UNSUPPORTED_EMPTY_COLLECTION |
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Экземпляр пустой коллекции PermissionCollection, доступный только для чтения. |
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
Policy() |
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Конструктор, вызываемый подклассами. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
static Policy |
getInstance |
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Возвращает объект Policy указанного типа. |
static Policy |
getInstance |
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Возвращает объект Policy указанного типа. |
static Policy |
getInstance |
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Возвращает объект Policy указанного типа. |
Policy.Parameters |
getParameters() |
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Возвращает параметры Policy. |
PermissionCollection |
getPermissions |
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Возвращает объект PermissionCollection, содержащий набор разрешений, предоставленных указанному CodeSource. |
PermissionCollection |
getPermissions |
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Возвращает объект PermissionCollection, содержащий набор разрешений, предоставленных указанному ProtectionDomain. |
static Policy |
getPolicy() |
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Возвращает объект Policy, который не предоставляет никаких разрешений. |
Provider |
getProvider() |
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Возвращает Provider этой политики. |
String |
getType() |
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Возвращает тип этого объекта Policy. |
boolean |
implies |
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Оценивает разрешения, предоставленные ProtectionDomain, и проверяет, предоставлено ли разрешение. |
void |
refresh() |
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Обновляет/перезагружает конфигурацию политики. |
static void |
setPolicy |
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Вызывает исключение UnsupportedOperationException. |
Подробное описание полей
UNSUPPORTED_EMPTY_COLLECTION
public static final PermissionCollection UNSUPPORTED_EMPTY_COLLECTION
- С версии:
- 1.6
Подробное описание конструкторов
Policy
public Policy()
Подробное описание методов
getPolicy
public static Policy getPolicy()
Policy, который не предоставляет никаких разрешений. В частности: - Метод
getParametersвозвращаетnull. - Методы
getPermissions(CodeSource)иgetPermissions(ProtectionDomain)возвращают пустуюPermissionCollection, доступную только для чтения. - Метод
impliesвсегда возвращаетfalse.
- Примечание API:
- Изначально этот метод возвращал установленный объект
Policyили, если объектPolicyне был установлен, реализациюPolicyпо умолчанию. Установка общесистемного объектаPolicyбольше не поддерживается. Этот метод всегда возвращает объектPolicyпо умолчанию, который не предоставляет никаких разрешений. ОбъектPolicyбыл полезен только совместно с Менеджером безопасности, поддержка которого прекращена. Замены этому методу нет. - Возвращает:
- объект
Policy, который не предоставляет никаких разрешений - См. также:
setPolicy
public static void setPolicy(Policy p)
UnsupportedOperationException. Установка общесистемного объекта Policy не поддерживается.- Примечание API:
- Изначально этот метод устанавливал общесистемный объект
Policy. Установка общесистемного объектаPolicyбольше не поддерживается. ОбъектPolicyбыл полезен только совместно с Менеджером безопасности, поддержка которого прекращена. Замены этому методу нет. - Параметры:
-
p— игнорируется - Вызывает исключение:
-
UnsupportedOperationException— всегда - См. также:
getInstance
public static Policy getInstance(String type, Policy.Parameters params) throws NoSuchAlgorithmException
Этот метод перебирает список зарегистрированных поставщиков служб безопасности, начиная с наиболее предпочтительного. Возвращается новый объект Policy, инкапсулирующий реализацию PolicySpi первого поставщика, поддерживающего указанный тип.
Обратите внимание, что список зарегистрированных поставщиков можно получить с помощью метода Security.getProviders().
- Примечание по реализации:
- Эталонная реализация JDK дополнительно использует свойство
jdk.security.provider.preferredSecurityдля определения предпочтительного порядка поставщиков для указанного алгоритма. Этот порядок может отличаться от порядка поставщиков, возвращаемых методомSecurity.getProviders(). - Параметры:
-
type— указанный тип Policy -
params— параметры дляPolicy, которые могут бытьnull. - Возвращает:
- новый объект
Policy - Вызывает исключение:
-
IllegalArgumentException— если указанные параметры не распознаны реализациейPolicySpiвыбранногоProvider -
NoSuchAlgorithmException— если ни одинProviderне поддерживает реализациюPolicySpiдля указанного типа -
NullPointerException— еслиtypeравноnull - С версии:
- 1.6
- См. также:
getInstance
public static Policy getInstance(String type, Policy.Parameters params, String provider) throws NoSuchProviderException, NoSuchAlgorithmException
Policy указанного типа. Возвращается новый объект Policy, инкапсулирующий реализацию PolicySpi указанного поставщика. Указанный поставщик должен быть зарегистрирован в списке поставщиков.
Обратите внимание, что список зарегистрированных поставщиков можно получить с помощью метода Security.getProviders().
- Параметры:
-
type— указанный тип Policy -
params— параметры дляPolicy, которые могут бытьnull. -
provider— поставщик. - Возвращает:
- новый объект
Policy - Вызывает исключение:
-
IllegalArgumentException— если указанный поставщик равенnullили является пустым, либо если указанные параметры не распознаны реализациейPolicySpiуказанного поставщика -
NoSuchAlgorithmException— если указанный поставщик не поддерживает реализациюPolicySpiдля указанного типа -
NoSuchProviderException— если указанный поставщик не зарегистрирован в списке поставщиков служб безопасности -
NullPointerException— еслиtypeравноnull - С версии:
- 1.6
- См. также:
getInstance
public static Policy getInstance(String type, Policy.Parameters params, Provider provider) throws NoSuchAlgorithmException
Policy указанного типа. Возвращается новый объект Policy, инкапсулирующий реализацию PolicySpi указанного поставщика. Обратите внимание, что указанный поставщик не обязательно должен быть зарегистрирован в списке поставщиков.
- Параметры:
-
type— указанный тип Policy -
params— параметры дляPolicy, которые могут бытьnull. -
provider—Provider. - Возвращает:
- новый объект
Policy - Вызывает исключение:
-
IllegalArgumentException— если указанныйProviderравенnullили если указанные параметры не распознаны реализациейPolicySpiуказанногоProvider -
NoSuchAlgorithmException— если указанныйProviderне поддерживает реализациюPolicySpiдля указанного типа -
NullPointerException— еслиtypeравноnull - С версии:
- 1.6
- См. также:
getProvider
public Provider getProvider()
Provider этой политики. У этого экземпляра Policy будет поставщик, только если он был получен вызовом Policy.getInstance. В противном случае этот метод возвращает null.
- Возвращает:
Providerэтой политики илиnull.- С версии:
- 1.6
getType
public String getType()
Policy. У этого экземпляра Policy будет тип, только если он был получен вызовом Policy.getInstance. В противном случае этот метод возвращает null.
- Возвращает:
- тип этого объекта
Policyилиnull. - С версии:
- 1.6
getParameters
public Policy.Parameters getParameters()
Policy. У этого экземпляра Policy будут параметры, только если он был получен вызовом Policy.getInstance. В противном случае этот метод возвращает null.
- Возвращает:
-
параметры
Policyилиnull. - С версии:
- 1.6
getPermissions
public PermissionCollection getPermissions(CodeSource codesource)
Реализация этого метода по умолчанию игнорирует CodeSource и возвращает Policy.UNSUPPORTED_EMPTY_COLLECTION.
- Параметры:
-
codesource— игнорируется - Возвращает:
- набор разрешений, предоставленных указанному CodeSource. Если эта операция поддерживается, возвращаемый набор разрешений должен быть новым изменяемым экземпляром и поддерживать разнородные типы Permission. Если эта операция не поддерживается, возвращается Policy.UNSUPPORTED_EMPTY_COLLECTION.
getPermissions
public PermissionCollection getPermissions(ProtectionDomain domain)
Реализация этого метода по умолчанию игнорирует ProtectionDomain и возвращает Policy.UNSUPPORTED_EMPTY_COLLECTION.
- Параметры:
-
domain— игнорируется - Возвращает:
- набор разрешений, предоставленных указанному ProtectionDomain. Если эта операция поддерживается, возвращаемый набор разрешений должен быть новым изменяемым экземпляром и поддерживать разнородные типы Permission. Если эта операция не поддерживается, возвращается Policy.UNSUPPORTED_EMPTY_COLLECTION.
- С версии:
- 1.4
implies
public boolean implies(ProtectionDomain domain, Permission permission)
Реализация этого метода по умолчанию игнорирует параметры ProtectionDomain и Permission и всегда возвращает false.
- Параметры:
-
domain— игнорируется -
permission— игнорируется - Возвращает:
-
false— всегда - С версии:
- 1.4
- См. также:
refresh
public void refresh()
Реализация этого метода по умолчанию ничего не делает.
© 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
Policyбольше не поддерживается. Метод setPolicy изменён и всегда вызывает исключениеUnsupportedOperationException. Метод getPolicy изменён и всегда возвращает объектPolicy, который не предоставляет никаких разрешений. Замены Менеджеру безопасности или этому классу нет.