java.security

クラス Permission

java.lang.Object

java.security.Permission

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

Serializable、Guard

直系の既知のサブクラス:

AllPermission, BasicPermission, FilePermission, MBeanPermission, PrivateCredentialPermission, ServicePermission, SocketPermission, UnresolvedPermission

public abstract class Permission
extends Object
implements Guard, Serializable

システムリソースへのアクセスを表現する abstract クラスです。すべてのアクセス権は、特定の Permission サブクラスのセマンティクスを定義するための抽象機能を持つほか、実装をサブクラスに依存する名前を持ちます。

ほとんどの Permission オブジェクトはまた、オブジェクトに許可されているアクションを通知するアクションリストを含みます。たとえば java.io.FilePermission オブジェクトでは、アクセス権の名前はファイルまたはディレクトリのパス名で、アクションリスト (読み込み、書き込みなど) は、指定されたファイル、またはディレクトリ内のファイルにどのアクションが許可されているかを指定します。アクションリストは、そうしたリストを必要としない java.lang.RuntimePermission などの Permission オブジェクトではオプションです。ユーザーは、名前付きのアクセス権 (system.exit など) を持つ場合と持たない場合があります。

各サブクラスによって実装しなければならない重要なメソッドは、Permissions を比較する implies メソッドです。基本的に、「permission p1 は permission p2 を包含する」とは、permission p1 が許可された場合には permission p2 も当然許可されるということです。したがって、これは適性テストではなく、サブセットテストです。

Permission オブジェクトは、一度作成すると不変になるという点では String オブジェクトと似ています。サブクラスは、一度作成されたアクセス権の状態を変更できるメソッドを提供することはできません。

関連項目:

Permissions, PermissionCollection, 直列化された形式

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

コンストラクタ

コンストラクタと説明
Permission(String name) 指定された名前でアクセス権を構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	checkGuard(Object object) アクセス権のガードインタフェースを実装します。
abstract boolean	equals(Object obj) 2 つの Permission オブジェクトが等しいかどうかを判定します。
abstract String	getActions() アクションを String で返します。
String	getName() Permission の名前を返します。
abstract int	hashCode() Permission オブジェクトのハッシュコード値を返します。
abstract boolean	implies(Permission permission) このオブジェクトのアクションによって、指定されたアクセス権のアクションが包含されるかどうかを判定します。
PermissionCollection	newPermissionCollection() 指定された Permission オブジェクトの空の PermissionCollection を返します。ただし、定義済みのものがない場合は null を返します。
String	toString() Permission を記述する文字列を返します。

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

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

コンストラクタの詳細

アクセス権

public Permission(String name)

指定された名前でアクセス権を構築します。

パラメータ:

name - 作成する Permission オブジェクトの名前。

メソッドの詳細

checkGuard

public void checkGuard(Object object)
                throws SecurityException

アクセス権のガードインタフェースを実装します。SecurityManager.checkPermission メソッドが呼び出され、このアクセス権オブジェクトを検査対象として渡します。アクセスが許可されると、何も行わずに復帰します。そうでない場合は、SecurityException をスローします。

定義:

checkGuard、インタフェース: Guard

パラメータ:

object - ガードのあるオブジェクト (現在は無視)。

例外:

SecurityException - セキュリティーマネージャーが存在し、セキュリティーマネージャーの checkPermission メソッドがアクセスを許可しない場合。

関連項目:

Guard, GuardedObject, SecurityManager.checkPermission(java.security.Permission)

implies

public abstract boolean implies(Permission permission)

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

Permission オブジェクトにセマンティクスを課すことができるのは Permission のサブクラスだけなので、このメソッドはそのようなサブクラスによって実装されなければいけません。

implies メソッドは、AccessController によって使用されます。現在実行中のコンテキストで有効であることがわかっているほかのアクセス権によって、要求されたアクセス権が包含されているかどうかを、このメソッドを使って調べます。

パラメータ:

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

戻り値:

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

equals

public abstract boolean equals(Object obj)

2 つの Permission オブジェクトが等しいかどうかを判定します。

アクセス制御を決定するのに equals メソッドは使わないでください。代わりに implies メソッドを使ってください。

オーバーライド:

equals、クラス: Object

パラメータ:

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

戻り値:

2 つの Permission オブジェクトが等しい場合は true

関連項目:

Object.hashCode()、HashMap

hashCode

public abstract int hashCode()

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

次に、Permission オブジェクトの必要な hashCode 動作を示します。

• 同じ Permission オブジェクトに対して Java アプリケーションの実行時に複数回呼び出すたびに、hashCode メソッドは一貫して同じ整数を返さなければならない。ただし、この整数は同じアプリケーションの実行ごとに同じである必要はありません。

• equals メソッドに基づいて 2 つの Permission オブジェクトが等しい場合は、2 つの Permission オブジェクトでそれぞれ hashCode メソッドを呼び出したとき、結果として同じ整数が生成されなければなりません。

オーバーライド:

hashCode、クラス: Object

戻り値:

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

関連項目:

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

getName

public final String getName()

Permission の名前を返します。たとえば java.io.FilePermission の場合は、名前はパス名になります。

戻り値:

Permission の名前

getActions

public abstract String getActions()

アクションを String で返します。これは abstract メソッドなので、必要性が生じるまでサブクラスは String 表現の作成を遅延させることができます。サブクラスは常に、正規形式と見なす形式でアクションを返さなければいけません。たとえば、2 つの FilePermission オブジェクトは次の方法で作成されます。

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

getActions メソッドが呼び出されると、どちらも「read,write」を返します。

戻り値:

Permission のアクション

newPermissionCollection

public PermissionCollection newPermissionCollection()

指定された Permission オブジェクトの空の PermissionCollection を返します。ただし、定義済みのものがない場合は null を返します。PermissionCollection.implies メソッドが呼び出されたときに、正しいセマンティクスを提供するために、特定の PermissionCollection オブジェクトにそのアクセス権を格納する必要がある場合、Permission クラスのサブクラスはこのメソッドをオーバーライドします。null が返された場合、このメソッドの呼び出し側はこの種類のアクセス権を、選択するどの PermissionCollection に対しても自由に格納できます (Hashtable を使うもの、Vector を使うものなど)。

戻り値:

この型の Permission の新規 PermissionCollection オブジェクト。定義済みのものがない場合は null。

toString

public String toString()

Permission を記述する文字列を返します。規約では、クラス名、アクセス権の名前、アクションを、'("ClassName" "name" "actions")' という形式で指定します。アクションリストが null または空の場合は、'("ClassName" "name")' と指定します。

オーバーライド:

toString、クラス: Object

戻り値:

この Permission についての情報。