Класс 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, разрешение на выполнение операций, чувствительных к безопасности. Эта функция больше не существует.

Since:: 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 может быть удален в будущей версии. Возвращает политику этого объекта.
`String`	`getType()`	Устаревшее, подлежит удалению: Этот элемент API может быть удален в будущей версии. Возвращает тип этого `Policy`.
`boolean`	`implies(ProtectionDomain domain, Permission permission)`	Устаревшее, подлежит удалению: Этот элемент API может быть удален в будущей версии. Оценивает разрешения, предоставленные ProtectionDomain, и проверяет, предоставлено ли разрешение.
`void`	`refresh()`	Устаревшее, подлежит удалению: Этот элемент API может быть удален в будущей версии. Обновляет/перезагружает конфигурацию политики.
`static void`	`setPolicy(Policy p)`	Устаревшее, подлежит удалению: Этот элемент API может быть удален в будущей версии. Выбрасывает `UnsupportedOperationException`.

Методы, объявленные в классе java.lang.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

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 от указанного поставщика. Указанный поставщик должен быть зарегистрирован в списке поставщиков.

Параметры:

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.

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

getPermissions

public PermissionCollection getPermissions(ProtectionDomain domain)

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

Возвращает объект PermissionCollection, содержащий набор разрешений, предоставленных указанному ProtectionDomain.

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

Parameters:: domain - игнорируется
Returns:: набор разрешений, предоставленных указанному ProtectionDomain. Если операция поддерживается, возвращаемый набор разрешений должен быть новой изменяемой сущностью и должен поддерживать разнородные типы Permission. Если операция не поддерживается, возвращается Policy.UNSUPPORTED_EMPTY_COLLECTION.
Since:: 1.4

implies

public boolean implies(ProtectionDomain domain, Permission permission)

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

Оценивает разрешения, предоставленные ProtectionDomain, и проверяет, предоставлено ли разрешение.

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

Parameters:

domain - игнорируется

permission - игнорируется

Returns:

false всегда

Since:

1.4

See Also:

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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/security/Policy.html