java.security
クラス BasicPermission

java.lang.Object
  |
  +--java.security.Permission
        |
        +--java.security.BasicPermission

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

Guard, Serializable

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

AudioPermission, AuthPermission, AWTPermission, DelegationPermission, LoggingPermission, NetPermission, PropertyPermission, ReflectPermission, RuntimePermission, SecurityPermission, SerializablePermission, SQLPermission, SSLPermission

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, RuntimePermission, SecurityPermission, PropertyPermission, AWTPermission, NetPermission, SecurityManager, 直列化された形式

コンストラクタの概要

BasicPermission(String name)
指定された名前で新しい BasicPermission を作成します。

BasicPermission(String name, String actions)
指定された名前で新しい BasicPermission オブジェクトを作成します。

メソッドの概要

boolean	equals(Object obj) 2 つの BasicPermission オブジェクトが同等であるかどうかを判定します。
String	getActions() アクションの標準的な文字列表現を返します。
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 の記号名です。現在、アクションの文字列は使用されません。このコンストラクタは、新しい Permission オブジェクトのインスタンスを生成するために Policy オブジェクトによって使用されます。

パラメータ:

name - BasicPermission の名前

actions - 無視される

例外:

NullPointerException - name が null の場合

IllegalArgumentException - name が空の場合

メソッドの詳細

implies

public boolean implies(Permission p)

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

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

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

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

定義:

クラス Permission 内の implies

パラメータ:

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

戻り値:

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

equals

public boolean equals(Object obj)

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

定義:

クラス Permission 内の equals

パラメータ:

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

戻り値:

obj が BasicPermission で、この BasicPermission オブジェクトと同じ名前である場合は true、そうでない場合は false

hashCode

public int hashCode()

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

定義:

クラス Permission 内の hashCode

戻り値:

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

getActions

public String getActions()

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

定義:

クラス Permission 内の getActions

戻り値:

空の文字列 ""

newPermissionCollection

public PermissionCollection newPermissionCollection()

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

BasicPermissionCollection は、BasicPermission アクセス権のコレクションを格納します。

BasicPermission オブジェクトは、それらのオブジェクトをどの順番でも挿入でき、PermissionCollection の implies メソッドを効率的に一貫して実装できる方法で格納する必要があります。

オーバーライド:

クラス Permission 内の newPermissionCollection

戻り値:

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