compact1、compact2、compact3

java.io

クラスFilePermission

java.lang.Object

java.security.Permission

java.io.FilePermission

すべての実装されたインタフェース:

Serializable, Guard

public final class FilePermission
extends Permission
implements Serializable

このクラスは、ファイルまたはディレクトリへのアクセスを表します。FilePermissionは、パス名と、そのパス名に対して有効なアクションの集合からなります。

パス名には、指定したアクションを許可するファイルまたはディレクトリのパス名を指定します。「/*」(「/」はファイル区切り文字File.separatorChar)で終わるパス名は、そのディレクトリに含まれるすべてのファイルとディレクトリを表します。「/-」で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリを(再帰的に)表します。パス名に特殊なトークン「<<ALL FILES>>」を指定した場合は、すべてのファイルに一致します。

注: 1つの「*」で構成されるパス名は、現在のディレクトリのすべてのファイルを示し、1つの「-」で構成されるパス名は、現在のディレクトリのすべてのファイル、および(再帰的に)現在のディレクトリに格納されているすべてのファイルおよびサブディレクトリを示します。

許可するアクションは、カンマで区切られた1個以上のキーワードのリストを内容とする文字列としてコンストラクタに引き渡されます。指定できるキーワードは、「read」、「write」、「execute」、「delete」、および「readlink」です。それぞれの意味は、次のように定義されます。

read

読込みアクセス権

write

書込みアクセス権

execute

実行権。Runtime.execの呼出しを許可します。SecurityManager.checkExecに対応します。

delete

削除権。File.deleteの呼出しを許可します。SecurityManager.checkDeleteに対応します。

readlink

リンク読取り権。readSymbolicLink メソッドを呼び出すことにより、シンボリック・リンクのターゲットを読み取ることができます。

アクション文字列は、処理の前に小文字に変換されます。

FilePermissionを許可する場合には注意してください。さまざまなファイルやディレクトリへの読取りアクセス、特に書込みアクセスを許可するとどうなるかをよく検討してください。writeアクションに対して「<<ALL FILES>>」アクセス権を指定するのは特に危険です。これは、ファイル・システム全体に対する書込みを許可するということです。このような指定をすると、事実上、JVM実行環境を含め、システム・バイナリを置き換えることが可能になってしまいます。

注: コードは同一ディレクトリ(またはそのディレクトリのサブディレクトリ)内のファイルを常に読み取ることができるので、読取り時のアクセス権を明示する必要はありません。

導入されたバージョン:

1.2

関連項目:

Permission, Permissions, PermissionCollection

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
FilePermission(String path, String actions) 指定されたアクションを持つ新しいFilePermissionオブジェクトを作成します。

メソッドのサマリー

修飾子と型	メソッドと説明
boolean	equals(Object obj) 2つのFilePermissionオブジェクトが等しいかどうかを判定します。
String	getActions() アクションの「正規の文字列表現」を返します。
int	hashCode() このオブジェクトのハッシュ・コード値を返します。
boolean	implies(Permission p) このFilePermissionオブジェクトに、指定されたアクセス権が含まれているかどうかを判定します。
PermissionCollection	newPermissionCollection() FilePermissionオブジェクトを格納するための新しいPermissionCollectionオブジェクトを返します。

クラス java.security.Permissionから継承されたメソッド

checkGuard, getName, toString

クラス java.lang.Objectから継承されたメソッド

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

コンストラクタの詳細

FilePermission

public FilePermission(String path,
                      String actions)

指定されたアクションを持つ新しいFilePermissionオブジェクトを作成します。pathはファイルまたはディレクトリのパス名で、actionsはファイルまたはディレクトリで許可されるアクションのカンマで区切られたリストです。指定できるアクションは、「read」、「write」、「execute」、「delete」、および「readlink」です。

「/*」(「/」はファイル区切り文字File.separatorChar)で終わるパス名は、そのディレクトリに含まれるすべてのファイルとディレクトリを表します。「/-」で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリを(再帰的に)表します。特殊なパス名「<<ALL FILES>>」は、すべてのファイルに一致します。

1つの「*」で構成されるパス名は、現在のディレクトリのすべてのファイルを示し、1つの「-」で構成されるパス名は、現在のディレクトリのすべてのファイル、および(再帰的に)現在のディレクトリに格納されているすべてのファイルおよびサブディレクトリを示します。

空の文字列を含むパス名は、空のパスを表します。

パラメータ:

path - ファイルまたはディレクトリのパス名。

actions - アクション文字列。

例外:

IllegalArgumentException - アクションがnullの場合、空の場合、または指定された有効なアクション以外のアクションを含む場合。

メソッドの詳細

implies

public boolean implies(Permission p)

このFilePermissionオブジェクトに、指定されたアクセス権が含まれているかどうかを判定します。

つまり、このメソッドは次の場合にtrueを返します。

• pがFilePermissionのインスタンスである。
• pのアクションは、このオブジェクトのアクションの適切なサブセットである。
• pのパス名がこのオブジェクトのパス名に含まれている。たとえば、「/tmp/*」は「/tmp/foo」を含んでいる。これは、「/tmp/*」には「foo」という名前のファイルも含めて「/tmp」ディレクトリ内のすべてのファイルが含まれているため。

定義:

implies、クラス: Permission

パラメータ:

p - チェック対象のアクセス権。

戻り値:

指定されたアクセス権がnullではなく、このオブジェクトに含まれている場合はtrue。それ以外の場合はfalse。

equals

public boolean equals(Object obj)

2つのFilePermissionオブジェクトが等しいかどうかを判定します。objがFilePermissionであり、このオブジェクトと同じパス名とアクションを持っているかどうかを判定します。

定義:

equals、クラス: Permission

パラメータ:

obj - このオブジェクトと等しいかどうかが判定されるオブジェクト。

戻り値:

objがFilePermissionであり、このFilePermissionオブジェクトと同じパス名とアクションを持っている場合はtrue。それ以外の場合はfalse。

関連項目:

Object.hashCode()、HashMap

hashCode

public int hashCode()

このオブジェクトのハッシュ・コード値を返します。

定義:

hashCode、クラス: Permission

戻り値:

このオブジェクトのハッシュ・コード値。

関連項目:

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

getActions

public String getActions()

アクションの「正規の文字列表現」を返します。つまり、このメソッドは常にread、write、execute、delete、readlinkの順序で現在のアクションを返します。たとえば、このFilePermissionオブジェクトがwriteとreadの両方のアクションを許可する場合、getActionsを呼び出すと、「read,write」という文字列が返されます。

定義:

getActions、クラス: Permission

戻り値:

アクションの正規の文字列表現。

newPermissionCollection

public PermissionCollection newPermissionCollection()

FilePermissionオブジェクトを格納するための新しいPermissionCollectionオブジェクトを返します。

FilePermissionオブジェクトは、任意の順序でコレクションに挿入されるように、さらにPermissionCollectionのimpliesメソッドが効率的に(および安定して)実装されるように格納される必要があります。

たとえば、次の2つのFilePermissionがあり、

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

そして次のFilePermissionでimpliesメソッドを呼び出す場合

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

implies関数は、「/tmp/-」および「/tmp/scratch/foo」の両方のアクセス権を考慮しなければならず、そのため、実質的なアクセス権は「read,write」であり、impliesはtrueを返します。FilePermissionの「implies」セマンティックスは、このnewPermissionCollectionメソッドによって返されるPermissionCollectionオブジェクトによって正しく処理されます。

オーバーライド:

newPermissionCollection、クラス: Permission

戻り値:

FilePermissionを格納するのに適切な新規PermissionCollectionオブジェクト。