java.io

Класс FilePermission

java.lang. Объект

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

java.io. FilePermission

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

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

public final class FilePermission
extends Permission
implements Serializable

Этот класс представляет доступ к файлу или каталогу. FilePermission состоит из пути и ряда действий, допустимых для того пути.

Путь является путем файла или каталога, предоставленного указанные действия. Путь, который заканчивается в "/*" (где "/" символ разделителя файлов, File.separatorChar) указывает на все файлы и каталоги, содержавшиеся в том каталоге. Путь, который заканчивается "/-", указывает (рекурсивно) на все файлы и подкаталоги, содержавшиеся в том каталоге. Путь, состоящий из специального маркера" <<ВСЕ ФАЙЛЫ>>", соответствует любой файл.

Отметьте: путь, состоящий из сингла "*", указывает на все файлы в текущем каталоге, в то время как путь, состоящий из сингла "-", указывает на все файлы в текущем каталоге и (рекурсивно) все файлы и подкаталоги, содержавшиеся в текущем каталоге.

Действия, которые будут предоставлены, передают конструктору в строке, содержащей список один или более разделенные от запятой ключевые слова. Возможные ключевые слова "читаются", "пишут", "выполняют", "удаляют", и "readlink". Их значение определяется следующим образом:

читать

считайте разрешение

записать

запишите разрешение

выполниться

выполните разрешение. Позволяет Runtime.exec быть вызванным. Соответствует SecurityManager.checkExec.

удалить

удалите разрешение. Позволяет File.delete быть вызванным. Соответствует SecurityManager.checkDelete.

readlink

считайте разрешение ссылки. Позволяет цели символьной ссылки быть считанной, вызывая readSymbolicLink метод.

Строка действий преобразовывается в нижний регистр перед обработкой.

Будьте осторожны, предоставляя FilePermissions. Думайте об импликациях предоставления чтения и особенно доступа для записи к различным файлам и каталогам." <<ВСЕ ФАЙЛЫ>>" разрешение с действием записи особенно опасно. Это предоставляет, что разрешение пишет во всю файловую систему. Одной вещью, которую это эффективно позволяет, является замена системного двоичного файла, включая среду выполнения JVM.

Пожалуйста, отметьте: Код может всегда читать файл из того же самого каталога, это находится в (или подкаталог того каталога); это не нуждается в явном разрешении, чтобы сделать так.

С тех пор:

1.2

См. Также:

Permission, Permissions, PermissionCollection

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

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

Конструктор и Описание
FilePermission(String path, String actions) Создает новый объект FilePermission с указанными действиями.

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

Методы

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

Методы java.security унаследованный от класса. Разрешение

checkGuard, getName, toString

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

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

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

FilePermission

public FilePermission(String path,
              String actions)

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

Путь, который заканчивается в "/*" (где "/" символ разделителя файлов, File.separatorChar) указывает на все файлы и каталоги, содержавшиеся в том каталоге. Путь, который заканчивается "/-", указывает (рекурсивно) на все файлы и подкаталоги, содержавшиеся в том каталоге. Специальный путь" <<ВСЕ ФАЙЛЫ>>" соответствует любой файл.

Путь, состоящий из сингла "*", указывает на все файлы в текущем каталоге, в то время как путь, состоящий из сингла "-", указывает на все файлы в текущем каталоге и (рекурсивно) все файлы и подкаталоги, содержавшиеся в текущем каталоге.

Путь, содержащий пустую строку, представляет пустой путь.

Параметры:

path - путь файла/каталога.

actions - строка действия.

Броски:

IllegalArgumentException - Если действия null, пустой или содержит действие кроме указанных возможных действий.

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

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

public boolean implies(Permission p)

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

Более определенно этот метод возвращает true если:

• p является instanceof FilePermission,

• действия p являются собственным подмножеством действий этого объекта, и

• путь p подразумевается путем этого объекта. Например, "/tmp/*" подразумевает "/tmp/foo", так как "/tmp/*" охватывает все файлы в "/tmp" каталоге, включая тот, названный "foo".

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

implies в классе Permission

Параметры:

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

Возвраты:

true если указанное разрешение не null и подразумевается этим объектом, false иначе.

равняется

public boolean equals(Object obj)

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

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

equals в классе Permission

Параметры:

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

Возвраты:

true если obj является FilePermission, и имеет тот же самый путь и действия как этот объект FilePermission, false иначе.

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

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

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

hashCode в классе Permission

Возвраты:

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

См. Также:

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

getActions

public String getActions()

Возвращает "каноническое строковое представление" действий. Таким образом, этот метод всегда возвращает существующие действия в следующем порядке: считайте, запишите, выполните, удалите, readlink. Например, если этот объект FilePermission позволяет и запись, и считайте действия, звонок getActions возвратит строку "чтение, записать".

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

getActions в классе Permission

Возвраты:

каноническое строковое представление действий.

newPermissionCollection

public PermissionCollection newPermissionCollection()

Возвращает новый объект PermissionCollection для того, чтобы хранить объекты FilePermission.

Объекты FilePermission должны храниться способом, который позволяет им быть вставленными в набор в любом порядке, но это также включает PermissionCollection implies метод, который будет реализован в эффективном (и непротиворечивый) способ.

Например, если у Вас есть два FilePermissions:

1. "/tmp/-", "read"
2. "/tmp/scratch/foo", "write"

и Вы вызываете implies метод с FilePermission:

   "/tmp/scratch/foo", "read,write",
 

тогда implies функция должна принять во внимание и "/tmp/-" и "/tmp/scratch/foo" полномочия, таким образом, эффективное разрешение "читается, запишите", и implies возвращает true. "Подразумевает", что семантика для FilePermissions обрабатывается должным образом объектом PermissionCollection, возвращенным этим newPermissionCollection метод.

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

newPermissionCollection в классе Permission

Возвраты:

новый объект PermissionCollection, подходящий для того, чтобы сохранить FilePermissions.