java.security

Разрешение класса

java.lang. Объект

java.security. Разрешение

Все Реализованные Интерфейсы:

Сериализуемый, Защита

Прямые Известные Подклассы:

AllPermission, BasicPermission, FilePermission, MBeanPermission, PrivateCredentialPermission, ServicePermission, SocketPermission, UnresolvedPermission

public abstract class Permission
extends Object
implements Guard, Serializable

Абстрактный класс для того, чтобы представить доступ к системному ресурсу. У всех полномочий есть имя (чья интерпретация зависит от подкласса), так же как абстрактные функции для того, чтобы определить семантику определенного подкласса Разрешения.

Большинство Объектов полномочий также включает список "действий", который говорит действия, которые разрешаются для объекта. Например, для a java.io.FilePermission объект, имя разрешения является путем файла (или каталог), и список действий (такой как "считано, запишите"), определяет, какие действия предоставляют для указанного файла (или для файлов в указанном каталоге). Список действий является дополнительным для Объектов полномочий, такой как java.lang.RuntimePermission, это не нуждается в таком списке; Вы у любого есть именованное разрешение (такое как "system.exit") или Вы не делаете.

Важный метод, который должен быть реализован каждым подклассом, implies метод, чтобы сравнить Полномочия. В основном, "разрешение p1 подразумевает, что разрешение p2" означает, что, если Вам предоставляют разрешение p1, каждому естественно предоставляют разрешение p2. Таким образом это не тест равенства, а скорее больше теста подмножества.

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

См. Также:

Permissions, PermissionCollection, Сериализированная Форма

Сводка конструктора

Конструкторы

Конструктор и Описание
Permission(String name) Создает разрешение с указанным именем.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	checkGuard(Object object) Реализует интерфейс защиты для разрешения.
abstract boolean	equals(Object obj) Проверки два Объекта полномочий для равенства.
abstract String	getActions() Возвращает действия как Строку.
Строка	getName() Возвращает имя этого Разрешения.
abstract int	hashCode() Возвращает значение хэш-кода для этого Объекта полномочий.
abstract boolean	implies(Permission permission) Проверки, если действия указанного разрешения "подразумеваются действиями" этого объекта.
PermissionCollection	newPermissionCollection() Возвращает пустой PermissionCollection для данного Объекта полномочий, или нуль, если Вы не определяетесь.
Строка	toString() Возвращает строку, описывающую это Разрешение.

Методы java.lang унаследованный от класса. Объект

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Деталь конструктора

Разрешение

public Permission(String name)

Создает разрешение с указанным именем.

Параметры:

name - имя создаваемого Объекта полномочий.

Деталь метода

checkGuard

public void checkGuard(Object object)
                throws SecurityException

Реализует интерфейс защиты для разрешения. SecurityManager.checkPermission метод вызывают, передавая этот объект полномочий как разрешение, чтобы проверить. Возвраты тихо, если доступ предоставляется. Иначе, бросает SecurityException.

Определенный:

checkGuard в интерфейсе Guard

Параметры:

object - объект, который охраняют (в настоящий момент проигнорированный).

Броски:

SecurityException - если менеджер безопасности существует и checkPermission метод не предоставляет доступ.

См. Также:

Guard, GuardedObject, SecurityManager.checkPermission(java.security.Permission)

подразумевает

public abstract boolean implies(Permission permission)

Проверки, если действия указанного разрешения "подразумеваются действиями" этого объекта.

Это должно быть реализовано подклассами Разрешения, поскольку они - единственные, которые могут наложить семантику на Объект полномочий.

implies метод используется AccessController, чтобы определить, подразумевается ли требуемое разрешение другим разрешением, которое, как известно, допустимо в текущем контексте выполнения.

Параметры:

permission - разрешение, чтобы проверить по.

Возвраты:

истина, если указанное разрешение подразумевается этим объектом, ложь если нет.

равняется

public abstract boolean equals(Object obj)

Проверки два Объекта полномочий для равенства.

Не используйте equals метод для того, чтобы принять решения управления доступом; используйте implies метод.

Переопределения:

equals в классе Object

Параметры:

obj - объект мы тестируем на равенство с этим объектом.

Возвраты:

истина, если оба Объекта полномочий эквивалентны.

См. Также:

Object.hashCode(), HashMap

хэш-код

public abstract int hashCode()

Возвращает значение хэш-кода для этого Объекта полномочий.

Необходимое hashCode поведение для Объектов полномочий является следующим:

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

• Если два Объекта полномочий равны согласно equals метод, затем вызывая hashCode метод на каждом из этих двух Объектов полномочий должен привести к тому же самому целочисленному результату.

Переопределения:

hashCode в классе Object

Возвраты:

значение хэш-кода для этого объекта.

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

getName

public final String getName()

Возвращает имя этого Разрешения. Например, в случае a java.io.FilePermission, имя будет путем.

Возвраты:

имя этого Разрешения.

getActions

public abstract String getActions()

Возвращает действия как Строку. Это абстрактно, таким образом, подклассы могут задержать создание Строкового представления, пока каждый не необходим. Подклассы должны всегда возвращать действия в том, что они рассматривают, чтобы быть их канонической формой. Например, два объекта FilePermission создали через следующее:

   perm1 = new FilePermission(p1,"read,write");
   perm2 = new FilePermission(p2,"write,read");
 

оба возврата "читали, пишут" когда getActions метод вызывается.

Возвраты:

действия этого Разрешения.

newPermissionCollection

public PermissionCollection newPermissionCollection()

Возвращает пустой PermissionCollection для данного Объекта полномочий, или нуль, если Вы не определяетесь. Подклассы Разрешения класса должны переопределить это, если они должны сохранить свои полномочия в определенном объекте PermissionCollection, чтобы обеспечить корректную семантику когда PermissionCollection.implies метод вызывают. Если нуль возвращается, то вызывающая сторона этого метода свободна сохранить полномочия этого, вводят любой PermissionCollection, который они выбирают (тот, который использует Хеш-таблицу, тот, который использует Вектор, и т.д.).

Возвраты:

новый PermissionCollection возражает для этого типа Разрешения, или нуля, если Вы не определяетесь.

toString

public String toString()

Возвращает строку, описывающую это Разрешение. Соглашение состоит в том, чтобы определить имя класса, имя разрешения, и действия в следующем формате: '("имя" "Имени класса" "действия")', или' ("Имя класса" "имя")', если список действий является нулем или пустой.

Переопределения:

toString в классе Object

Возвраты:

информация об этом Разрешении.