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。

读符号链接的值

读取链路权限。允许一个 symbolic link目标是通过调用 readSymbolicLink 读取方法。

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

小心当授予filepermissions。考虑授予读，特别是写访问各种文件和目录的影响。“所有文件”的权限与写操作是特别危险的。此授予权限写入整个文件系统。这一点可以有效的让系统是二进制的更换，包括JVM运行环境。

请注意：代码可以读取一个文件的目录中（或它的一个子目录，目录）；它不需要显式允许这样做。

从以下版本开始：

一点二

另请参见：

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() 返回存储对象的一种新filepermission PermissionCollection对象。

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

Constructor Detail

FilePermission

public FilePermission(String path,
                      String actions)

创建一个新的指定动作filepermission对象。路径是一个文件或目录的路径名，并行动包含一个逗号分隔的文件或目录授予所需的行动清单。可能采取的行动是“读”、“写”、“执行”、“删除”、“读符号链接的值”。

一个路径，在“/*”结束（“/”是字符文件，File.separatorChar）显示所有的文件和目录，目录中。一个路径以“/”表示（递归）在该目录中包含的所有文件和子目录。特殊路径”< <所有文件> >”匹配任何文件。

一个路径由一个单一的“*”表示在当前目录下的所有文件，而路径由一个单一的“-”表示所有的文件在当前目录和当前目录（递归）中包含的所有文件和子目录。

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

参数

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

actions -动作字符串。

异常

IllegalArgumentException如果行动是 null，空或包含以外的指定可能的动作。

方法详细信息

implies

public boolean implies(Permission p)

如果这个检查filepermission对象”意味着“指定权限。

更具体地说，这种方法返回真的：

• P是一个实例filepermission，
• P的动作是这个对象的动作的一个适当的子集，和
• P的路径是由该对象的路径名的暗示。例如，“/tmp / *”意味着“/tmp /富”，因为“/tmp / *”包括所有的文件在“/tmp”目录，包括一个名为“foo”。

Specified by:

implies 方法重写，继承类 Permission

参数

p的权限检查。

结果

true如果指定的权限不 null和由该对象的暗示， false否则。

equals

public boolean equals(Object obj)

检查两filepermission对象平等。检查obj是一个filepermission，并具有相同的路径和行为对象。

Specified by:

equals 方法重写，继承类 Permission

参数

obj我们对这个对象的相等测试对象。

结果

true如果obj是一个filepermission，并具有相同的路径和行动，这filepermission对象， 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()

返回操作的“规范字符串表示”。那就是，这个方法总是返回当前行动的顺序是：读、写、执行、删除、读符号链接的值。例如，如果这filepermission对象允许读写操作，一个叫 getActions将返回“读取字符串，写”。

Specified by:

getActions 方法重写，继承类 Permission

结果

动作的正则字符串表示。

newPermissionCollection

public PermissionCollection newPermissionCollection()

返回存储对象的一种新filepermission PermissionCollection对象。

filepermission对象必须贮存方式，允许它们被插入到集合中的任何命令，但这也使得PermissionCollection implies方法是一个有效的实现方式（一致）。

例如，如果你有两个filepermissions：

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

和你在一起的filepermission调用implies方法：

“/甲氧苄啶/划痕/富”、“读、写”，

然后 implies功能必须兼顾“/tmp /”和“/tmp /划痕/ foo”权限，所以有效权限是“读、写”，并 implies返回true。“暗示”的语义filepermissions由PermissionCollection对象妥善处理这 newPermissionCollection方法返回。

重写：

newPermissionCollection 方法重写，继承类 Permission

结果

适合存储filepermissions新PermissionCollection对象。