compact1, compact2, compact3

java.security

クラスPermission

java.lang.Object

java.security.Permission

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

Serializable, Guard

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

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

public abstract class Permission
extends Object
implements Guard, Serializable

システム・リソースへのアクセスを表現する抽象クラスです。すべてのアクセス権は、特定の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

コンストラクタの詳細

Permission

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で返します。これは抽象メソッドなので、必要性が生じるまでサブクラスは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についての情報。