JavaTM 2 Platform
Standard Ed. 5.0

java.security
クラス BasicPermission

java.lang.Object
  上位を拡張 java.security.Permission
      上位を拡張 java.security.BasicPermission
すべての実装されたインタフェース:
Serializable, Guard
直系の既知のサブクラス:
AudioPermission, AuthPermission, AWTPermission, DelegationPermission, LoggingPermission, ManagementPermission, MBeanServerPermission, MBeanTrustPermission, NetPermission, PropertyPermission, ReflectPermission, RuntimePermission, SecurityPermission, SerializablePermission, SQLPermission, SSLPermission, SubjectDelegationPermission

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 - namenull の場合
IllegalArgumentException - name が空の場合

BasicPermission

public BasicPermission(String name,
                       String actions)
指定された名前で新しい BasicPermission オブジェクトを作成します。name は BasicPermission の記号名です。actions の文字列は現在使用されていません。

パラメータ:
name - BasicPermission の名前
actions - 無視される
例外:
NullPointerException - namenull の場合
IllegalArgumentException - name が空の場合
メソッドの詳細

implies

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

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

定義:
クラス Permission 内の implies
パラメータ:
p - チェック対象のアクセス権
戻り値:
渡したアクセス権がこのアクセス権と同じであるか、このアクセス権に包含される場合は true、そうでない場合は false

equals

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

定義:
クラス Permission 内の equals
パラメータ:
obj - このオブジェクトと等しいかどうかを判定するオブジェクト
戻り値:
obj が BasicPermission で、この BasicPermission オブジェクトと同じ名前である場合は true、そうでない場合は false
関連項目:
Object.hashCode(), Hashtable

hashCode

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

定義:
クラス Permission 内の hashCode
戻り値:
このオブジェクトのハッシュコード値
関連項目:
Object.equals(java.lang.Object), Hashtable

getActions

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

定義:
クラス Permission 内の getActions
戻り値:
空の文字列 ""

newPermissionCollection

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

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

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

オーバーライド:
クラス Permission 内の newPermissionCollection
戻り値:
BasicPermissions を格納するのに適切な、新しい PermissionCollection オブジェクト

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。