compact1, compact2, compact3

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.*」はワイルドカード・マッチングを表しますが、「*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オブジェクト。