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」は無効です。

許可するアクションは、コンマで区切られた 1 個以上のキーワードのリストを内容とする文字列としてコンストラクタに引き渡されます。指定できるキーワードは、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 を含む

オーバーライド:

implies、クラス: BasicPermission

パラメータ:

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

戻り値:

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

equals

public boolean equals(Object obj)

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

オーバーライド:

equals、クラス: BasicPermission

パラメータ:

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

戻り値:

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

関連項目:

Object.hashCode()、HashMap

hashCode

public int hashCode()

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

オーバーライド:

hashCode、クラス: BasicPermission

戻り値:

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

関連項目:

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

getActions

public String getActions()

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

オーバーライド:

getActions、クラス: BasicPermission

戻り値:

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

newPermissionCollection

public PermissionCollection newPermissionCollection()

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

オーバーライド:

newPermissionCollection、クラス: BasicPermission

戻り値:

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