compact1, compact2, compact3

java.io

Class FilePermission

java.lang.Object

java.security.Permission

java.io.FilePermission

All Implemented Interfaces:

Serializable ， Guard

public final class FilePermission
extends Permission
implements Serializable

此类表示访问文件或目录。 FilePermission由路径名和对该路径名有效的一组操作组成。

路径名是授予指定操作的文件或目录的路径名。 以“/ *”结尾的路径名（其中“/”为文件分隔符File.separatorChar ）表示该目录中包含的所有文件和目录。 以“/ - ”结尾的路径名表示（递归）该目录中包含的所有文件和子目录。 由特殊令牌“<<所有文件>>”组成的路径名匹配任何文件。

注意：由单个“*”组成的路径名表示当前目录中的所有文件，而由单个“ - ”组成的路径名表示当前目录中的所有文件，并递归地显示当前目录中包含的所有文件和子目录目录。

要授予的操作将以包含一个或多个以逗号分隔的关键字的列表的字符串的形式传递给构造函数。 可能的关键字是“读取”，“写入”，“执行”，“删除”和“读取链接”。 其含义定义如下：

读

读权限

写

写许可

执行

执行权限 允许Runtime.exec 。 对应于SecurityManager.checkExec 。

删除

删除权限。 允许File.delete 。 对应于SecurityManager.checkDelete 。

readlink

阅读链接权限 通过调用readSymbolicLink 方法可以读取symbolic link的目标。

操作字符串在处理之前转换为小写。

授予FilePermissions时要小心。 考虑授予读取和特别写入访问各种文件和目录的含义。 使用写入操作的“<<所有文件>>”权限特别危险。 这允许写入整个文件系统的权限。 有效的一件事是更换系统二进制文件，包括JVM运行时环境。

请注意：代码可以随时从同一目录中读取文件（或该目录的子目录）; 它不需要明确的许可这样做。

从以下版本开始：

1.2

另请参见：

Permission ， Permissions ， PermissionCollection

构造方法摘要

构造方法

Constructor and Description
FilePermission(String path, String actions) 使用指定的操作创建一个新的FilePermission对象。

方法摘要

Modifier and Type	Method and Description
boolean	equals(Object obj) 检查两个FilePermission对象是否相等。
String	getActions() 返回动作的“规范字符串表示”。
int	hashCode() 返回此对象的哈希码值。
boolean	implies(Permission p) 检查此FilePermission对象是否“暗示”指定的权限。
PermissionCollection	newPermissionCollection() 返回一个新的PermissionCollection对象，用于存储FilePermission对象。

Methods inherited from class java.security.Permission

checkGuard, getName, toString

Methods inherited from class java.lang.Object

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

构造方法详细信息

FilePermission

public FilePermission(String path,
                      String actions)

使用指定的操作创建一个新的FilePermission对象。 path是文件或目录的路径名， 操作包含在文件或目录上授予的所需操作的逗号分隔列表。 可能的操作是“读取”，“写入”，“执行”，“删除”和“读取链接”。

以“/ *”结尾的路径名（其中“/”是文件分隔符File.separatorChar ）表示该目录中包含的所有文件和目录。 以“/ - ”结尾的路径名表示（递归）该目录中包含的所有文件和子目录。 特殊路径名“<<所有文件>>”匹配任何文件。

由单个“*”组成的路径名表示当前目录中的所有文件，而由单个“ - ”组成的路径名表示当前目录中的所有文件，并递归地显示当前目录中包含的所有文件和子目录。

包含空字符串的路径名表示空的路径。

参数

path - 文件/目录的路径名。

actions - 动作字符串。

异常

IllegalArgumentException - 如果操作为 null ， null空或包含除指定的可能操作之外的操作。

方法详细信息

implies

public boolean implies(Permission p)

检查此FilePermission对象是否“暗示”指定的权限。

更具体地说，这个方法返回true：

• p是FilePermission的一个实例，
• p的动作是这个对象的动作的一个子集，
• p的路径名由该对象的路径名隐含。 例如，“/ tmp / *”意味着“/ tmp / foo”，因为“/ tmp / *”包含“/ tmp”目录中的所有文件，包括名为“foo”的文件。

Specified by:

implies在 Permission类

参数

p - 允许检查。

结果

true如果指定的权限不是 null并且由该对象暗示， false false。

equals

public boolean equals(Object obj)

检查两个FilePermission对象是否相等。 检查obj是否是FilePermission，并且具有与该对象相同的路径名和操作。

Specified by:

equals在 Permission

参数

obj - 我们正在测试与此对象相等的对象。

结果

true如果obj是FilePermission，并且具有与该FilePermission对象相同的路径名和操作， false false。

另请参见：

Object.hashCode() ， HashMap

hashCode

public int hashCode()

返回此对象的哈希码值。

Specified by:

hashCode在 Permission

结果

该对象的哈希码值。

另请参见：

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

getActions

public String getActions()

返回动作的“规范字符串表示”。 也就是说，该方法总是按照以下顺序返回当前动作：read，write，execute，delete，readlink。 例如，如果此FilePermission对象允许写入和读取操作，则调用getActions将返回字符串“读取，写入”。

Specified by:

getActions在 Permission

结果

规范字符串表示的动作。

newPermissionCollection

public PermissionCollection newPermissionCollection()

返回一个新的PermissionCollection对象，用于存储FilePermission对象。

必须以允许以任何顺序将它们插入到集合中的方式存储FilePermission对象，但这也允许以有效（一致）的方式实现PermissionCollection implies方法。

例如，如果您有两个FilePermissions：

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

并且您正在使用implies调用implies方法：

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

那么implies功能必须考虑到“/ tmp / - ”和“/ tmp / scratch / foo”的权限，所以有效权限是“read，write”， implies返回true。 FilePermissions的“暗示”语义由该newPermissionCollection方法返回的PermissionCollection对象正确处理。

重写：

newPermissionCollection在 Permission

结果

适用于存储FilePermissions的新PermissionCollection对象。