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

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

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

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

public static void setPolicy(Policy p)

Устарело и предназначено для удаления: этот элемент API может быть удалён в будущей версии.

Выбрасывает UnsupportedOperationException. Установка общесистемного объекта Policy не поддерживается.

Примечание API:

Первоначально этот метод устанавливал общесистемный объект Policy. Установка общесистемного объекта Policy больше не поддерживается. Объект Policy был полезен только совместно с менеджером безопасности, который больше не поддерживается. Замены этому методу нет.

Параметры:

p — игнорируется

Выбрасывает:

UnsupportedOperationException — всегда

См. также:

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

См. также:

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

См. также:

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

См. также:

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

См. также:

refresh

public void refresh()

Устарело и предназначено для удаления: этот элемент API может быть удалён в будущей версии.

Обновляет или перезагружает конфигурацию политики.

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

© 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.