Класс Permission

public Permission(String name)

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

public void checkGuard(Object object) throws SecurityException

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

public abstract boolean implies(Permission permission)

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

Это должно быть реализовано подклассами Permission, так как только они могут наложить семантику на объект Permission.

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

public abstract boolean equals(Object obj)

Проверяет два объекта Permission на равенство.

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

public abstract int hashCode()

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

Требуемое поведение hashCode для объектов Permission следующее:

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

public final String getName()

Возвращает имя этого объекта Permission. Например, в случае java.io.FilePermission, имя будет путём к файлу.

public abstract String getActions()

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

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

оба возвращают "read,write", когда вызывается метод getActions.

public PermissionCollection newPermissionCollection()

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

public String toString()

Возвращает строку, описывающую этот объект Permission. Конвенция заключается в указании имени класса, имени разрешения и действий в следующем формате: '("ИмяКласс" "имя" "действия")', или '("ИмяКласс" "имя")' если список действий null или пуст.