java.security

クラス BasicPermission

java.lang.Object

java.security.Permission

java.security.BasicPermission

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

Serializable、Guard

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

AudioPermission, AuthPermission, AWTPermission, DelegationPermission, JAXBPermission, LinkPermission, LoggingPermission, ManagementPermission, MBeanServerPermission, MBeanTrustPermission, NetPermission, PropertyPermission, ReflectPermission, RuntimePermission, SecurityPermission, SerializablePermission, SQLPermission, SSLPermission, SubjectDelegationPermission, WebServicePermission

public abstract class BasicPermission
extends Permission
implements Serializable

BasicPermission は Permission クラスを拡張するクラスで、BasicPermission と同じ命名規約に従う必要のある、アクセス権の基底クラスとして使用できます。

BasicPermission の名前は、「exit」、「setFactory」、「print.queueJob」など、指定したアクセス権の名前です。命名規約は、階層的なプロパティー命名規約に従います。また、単独でアスタリスクを置いたり、名前の末尾にアスタリスクを置いたりして、ワイルドカードマッチングを表すことができます。たとえば、「*」や「java.*」は有効ですが、「a*b」や「*java」は無効です。

Permission から継承したアクション文字列は使用しません。したがって通常、BasicPermission は名前付きアクセス権の基底クラスとして使用します。名前付きアクセス権は名前を持ちますが、アクションリストは持ちません。ユーザーは名前付きアクセス権を持つ場合と、持たない場合があります。サブクラスは、必要に応じて BasicPermission の上位クラスでアクションを実装できます。

関連項目:

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

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

コンストラクタ

コンストラクタと説明
BasicPermission(String name) 指定された名前で新しい BasicPermission を作成します。
BasicPermission(String name, String actions) 指定された名前で新しい BasicPermission オブジェクトを作成します。

メソッドのサマリー

メソッド

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

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

checkGuard, getName, toString

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

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

コンストラクタの詳細

BasicPermission

public BasicPermission(String name)

指定された名前で新しい BasicPermission を作成します。名前は「setFactory」、「print.queueJob」、「topLevelWindow」といったアクセス権のシンボリック名です。

パラメータ:

name - BasicPermission の名前

例外:

NullPointerException - name が null の場合。

IllegalArgumentException - name が空である場合。

BasicPermission

public BasicPermission(String name,
               String actions)

指定された名前で新しい BasicPermission オブジェクトを作成します。name は BasicPermission のシンボリック名です。actions の文字列は現在使用されていません。

パラメータ:

name - BasicPermission の名前

actions - 無視される

例外:

NullPointerException - name が null の場合。

IllegalArgumentException - name が空である場合。

メソッドの詳細

implies

public boolean implies(Permission p)

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

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

• p のクラスがこのオブジェクトのクラスと同じである。

• p の名前がこのオブジェクトの名前と同じか、あるいはワイルドカードを使用している場合に、このオブジェクトの名前によって包含される。たとえば、「a.b.*」は「a.b.c」を包含する。

定義:

implies、クラス: Permission

パラメータ:

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

戻り値:

渡されたアクセス権がこのアクセス権と同じであるか、このアクセス権に包含される場合は true、そうでない場合は false。

equals

public boolean equals(Object obj)

2 つの BasicPermission オブジェクトが同等であるかどうかを判定します。つまり、obj のクラスがこのオブジェクトのクラスと同じで、obj の名前がこのオブジェクトと同じであるかどうかを調べます。

定義:

equals、クラス: Permission

パラメータ:

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

戻り値:

つまり、obj のクラスがこのオブジェクトのクラスと同じで、obj の名前がこの BasicPermission オブジェクトと同じ場合は true、そうでない場合は false。

関連項目:

Object.hashCode()、HashMap

hashCode

public int hashCode()

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

定義:

hashCode、クラス: Permission

戻り値:

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

関連項目:

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

getActions

public String getActions()

アクションの正規の文字列表現を返します。現在、BasicPermission にはアクションがないため、返されるのは空文字列の "" です。

定義:

getActions、クラス: Permission

戻り値:

空の文字列 ""。

newPermissionCollection

public PermissionCollection newPermissionCollection()

BasicPermission オブジェクトを格納する新しい PermissionCollection オブジェクトを返します。

BasicPermission オブジェクトは、挿入する順番は任意でかまわないけれども、PermissionCollection の implies メソッドを効率的な (かつ一貫した) 方法で実装できるように格納される必要があります。

オーバーライド:

newPermissionCollection、クラス: Permission

戻り値:

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