java.util
クラス PropertyPermission

java.lang.Object
  java.security.Permission
      java.security.BasicPermission
          java.util.PropertyPermission

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

Serializable, Guard

public final class PropertyPermission
extends BasicPermission

このクラスはプロパティーへのアクセス権のためのクラスです。

名前には、プロパティーの名前 (java.home や os.name など) を指定します。命名規約は、階層型プロパティーの命名規約に従います。また、ターゲット名のあとにアスタリスクを指定し (「.」のあとに指定するか、単独で指定)、ワイルドカードによる照合を行うこともできます。次に例を示します。たとえば、「java.*」や「*」は有効ですが、「*java」や「a*b」は無効です。

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

read

読み込み権。System.getProperty を呼び出せるようになる

write

書き込み権。System.setProperty を呼び出せるようになる

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

特定のシステムプロパティーへのアクセス権をコードに与えるときは注意してください。たとえば、システムプロパティー java.home へのアクセス権を与えると、悪意のあるコードにより、システム環境に関する機密情報 (Java のインストールディレクトリ) が盗まれる可能性があります。また、システムプロパティー user.name および user.home へのアクセス権を与えると、悪意のあるコードにより、ユーザー環境に関する重要な情報 (ユーザーのアカウント名とホームディレクトリ) が盗まれる可能性があります。

導入されたバージョン:

1.2

関連項目:

BasicPermission, Permission, Permissions, PermissionCollection, SecurityManager

コンストラクタの概要

PropertyPermission(String name, String actions)
名前を指定して新しい PropertyPermission オブジェクトを作成します。

メソッドの概要

boolean	equals(Object obj) 2 つの PropertyPermission オブジェクトが同じであるかどうかを判定します。
String	getActions() アクションの「正規の文字列表現」を返します。
int	hashCode() このオブジェクトのハッシュコード値を返します。
boolean	implies(Permission p) PropertyPermission オブジェクトが、指定されたアクセス権を含んでいるかどうかを判定します。
PermissionCollection	newPermissionCollection() PropertyPermission オブジェクトを格納するための新しい PermissionCollection オブジェクトを返します。

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

checkGuard, getName, toString

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

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

コンストラクタの詳細

PropertyPermission

public PropertyPermission(String name,
                          String actions)

名前を指定して新しい PropertyPermission オブジェクトを作成します。name はシステムプロパティーの名前で、actions には、プロパティーで許可されている目的のアクションのコンマで区切られたリストが入ります。有効なアクションは read と write です。

パラメータ:

name - PropertyPermission の名前

actions - アクションの文字列

例外:

NullPointerException - name が null の場合

IllegalArgumentException - name が空の場合、または actions が無効な場合

メソッドの詳細

implies

public boolean implies(Permission p)

PropertyPermission オブジェクトが、指定されたアクセス権を含んでいるかどうかを判定します。

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

• p が PropertyPermission のインスタンスである

• p のアクションは、このオブジェクトのアクションのサブセットである

• p の名前がこのオブジェクトの名前に含まれている。たとえば、java.* は java.home を含む

オーバーライド:

クラス BasicPermission 内の implies

パラメータ:

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

戻り値:

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

equals

public boolean equals(Object obj)

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

オーバーライド:

クラス BasicPermission 内の equals

パラメータ:

obj - このオブジェクトと等しいかどうかを判定するオブジェクト

戻り値:

obj が PropertyPermission であり、この PropertyPermission オブジェクトと同じ名前とアクションを持っている場合は true

関連項目:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

このオブジェクトのハッシュコード値を返します。使用されるハッシュコードは、このアクセス権の名前のハッシュコード、つまり、getName().hashCode() (Permission スーパークラスからの getName) です。

オーバーライド:

クラス BasicPermission 内の hashCode

戻り値:

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

関連項目:

Object.equals(java.lang.Object), Hashtable

getActions

public String getActions()

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

オーバーライド:

クラス BasicPermission 内の getActions

戻り値:

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

newPermissionCollection

public PermissionCollection newPermissionCollection()

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

オーバーライド:

クラス BasicPermission 内の newPermissionCollection

戻り値:

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