java.security
クラス IdentityScope

java.lang.Object
  |
  +--java.security.Identity
        |
        +--java.security.IdentityScope

推奨されません。 このクラスは現在使用されていません。このクラスの機能は、java.security.KeyStore クラス、java.security.cert パッケージ、および java.security.Principal クラスに置き換えられました。

public abstract class IdentityScope

extends Identity

このクラスはアイデンティティの有効範囲を表します。このクラスは Identity 自身であるため、名前と範囲を持つことができます。また、オプションとして公開鍵および関連する証明書を持つこともできます。

IdentityScope は、Signer を始めとしたすべての種類の Identity オブジェクトを含みます。すべての種類の Identity オブジェクトを、同じメソッドを使用して取り出し、追加、削除を行うことができます。異なる種類のアイデンティティの範囲は、各種の Identity の各種の操作に対して異なる方法を適用することが可能であり、また実際にそのような方法が要求されることに注意してください。

鍵とアイデンティティの間には 1 対 1 のマッピングが存在し、アイデンティティの有効範囲あたり 1 つの鍵の 1 つのコピーしか存在できません。たとえば、Acme Software, Inc という、ユーザに知られたソフトウェア出版社があるとします。その出版社が 1 つの Identity、すなわち公開鍵および関連する証明書のセットを持つものとします。Acme Software, Inc という名前を使用して有効範囲内で名前が付けられます。その有効範囲内で名前の付いているほかの Identity が同じ公開鍵を持つことはありません。また、同じ名前を持つものも存在しません。

関連項目:

Identity, Signer, Principal, Key, 直列化された形式

コンストラクタの概要

protected	IdentityScope() 推奨されません。 このコンストラクタは、直列化専用に使用し、サブクラスでは使用すべきではありません。
	IdentityScope(String name) 推奨されません。 指定された名前を持つ新しいアイデンティティの有効範囲を構築します。
	IdentityScope(String name, IdentityScope scope) 推奨されません。 指定された名前と有効範囲を持つ新しいアイデンティティの有効範囲を構築します。

メソッドの概要

abstract void	addIdentity(Identity identity) 推奨されません。 このアイデンティティの有効範囲に 1 つのアイデンティティを追加します。
Identity	getIdentity(Principal principal) 推奨されません。 指定された Principal (主体) と同じ名前のアイデンティティを取り出します (注: Identity は Principal (主体) を実装する)。
abstract Identity	getIdentity(PublicKey key) 推奨されません。 指定された公開鍵のアイデンティティを取り出します。
abstract Identity	getIdentity(String name) 推奨されません。 この有効範囲内にある指定された名前を持つアイデンティティを (存在する場合に) 返します。
static IdentityScope	getSystemScope() 推奨されません。 システムのアイデンティティの有効範囲を返します。
abstract Enumeration	identities() 推奨されません。 このアイデンティティの有効範囲内のすべてのアイデンティティを列挙したものを返します。
abstract void	removeIdentity(Identity identity) 推奨されません。 このアイデンティティの有効範囲から 1 つのアイデンティティの有効範囲を削除します。
protected static void	setSystemScope(IdentityScope scope) 推奨されません。 システムのアイデンティティの有効範囲を設定します。
abstract int	size() 推奨されません。 このアイデンティティの有効範囲内にあるアイデンティティの数を返します。
String	toString() 推奨されません。 名前、有効範囲名、このアイデンティティの範囲内のアイデンティティ数を含む、このアイデンティティの範囲の文字列表現を返します。

クラス java.security.Identity から継承したメソッド

addCertificate, certificates, equals, getInfo, getName, getPublicKey, getScope, hashCode, identityEquals, removeCertificate, setInfo, setPublicKey, toString

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

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

コンストラクタの詳細

IdentityScope

protected IdentityScope()

推奨されません。

このコンストラクタは、直列化専用に使用し、サブクラスでは使用すべきではありません。

IdentityScope

public IdentityScope(String name)

推奨されません。

指定された名前を持つ新しいアイデンティティの有効範囲を構築します。

パラメータ:

name - 有効範囲名

IdentityScope

public IdentityScope(String name,
                     IdentityScope scope)
              throws KeyManagementException

推奨されません。

指定された名前と有効範囲を持つ新しいアイデンティティの有効範囲を構築します。

パラメータ:

name - 有効範囲名

scope - 新しいアイデンティティの有効範囲に対する有効範囲

例外:

KeyManagementException - 有効範囲内に同じ名前を持つアイデンティティがすでに存在する場合

メソッドの詳細

getSystemScope

public static IdentityScope getSystemScope()

推奨されません。

システムのアイデンティティの有効範囲を返します。

戻り値:

システムのアイデンティティの有効範囲

setSystemScope

protected static void setSystemScope(IdentityScope scope)

推奨されません。

システムのアイデンティティの有効範囲を設定します。

セキュリティマネージャが存在する場合、まず、セキュリティマネージャの checkSecurityAccess メソッドが引数として "setSystemScope" を指定して呼び出され、アイデンティティスコープを設定してもかまわないかどうかを確認します。

パラメータ:

設定される有効範囲 -

例外:

SecurityException - セキュリティマネージャが存在する場合に、セキュリティマネージャの checkSecurityAccess メソッドがアイデンティティスコープの設定を許可しないとき

関連項目:

SecurityManager.checkSecurityAccess(java.lang.String)

size

public abstract int size()

推奨されません。

このアイデンティティの有効範囲内にあるアイデンティティの数を返します。

戻り値:

このアイデンティティの有効範囲内のアイデンティティの数

getIdentity

public abstract Identity getIdentity(String name)

推奨されません。

この有効範囲内にある指定された名前を持つアイデンティティを (存在する場合に) 返します。

パラメータ:

name - 取り出す対象のアイデンティティの名前

戻り値:

name という名前のアイデンティティ。この有効範囲内に name という名前のアイデンティティが存在しない場合は null

getIdentity

public Identity getIdentity(Principal principal)

推奨されません。

指定された Principal (主体) と同じ名前のアイデンティティを取り出します (注: Identity は Principal (主体) を実装する)。

パラメータ:

principal - 取り出す対象のアイデンティティに対応する主体

戻り値:

主体と同じ名前のアイデンティティ。この有効範囲に同じ名前のアイデンティティが存在しない場合は null

getIdentity

public abstract Identity getIdentity(PublicKey key)

推奨されません。

指定された公開鍵のアイデンティティを取り出します。

パラメータ:

key - 要求するアイデンティティに対する公開鍵

戻り値:

指定された鍵のアイデンティティ。指定された鍵を持つアイデンティティがこの有効範囲に存在しない場合は null

addIdentity

public abstract void addIdentity(Identity identity)
                          throws KeyManagementException

推奨されません。

このアイデンティティの有効範囲に 1 つのアイデンティティを追加します。

パラメータ:

identity - 追加されるアイデンティティ

例外:

KeyManagementException - アイデンティティが有効でない場合、名前が重複した場合、ほかのアイデンティティが追加するアイデンティティと同じ公開鍵を持っている場合、またはほかの例外が発生した場合

removeIdentity

public abstract void removeIdentity(Identity identity)
                             throws KeyManagementException

推奨されません。

このアイデンティティの有効範囲から 1 つのアイデンティティの有効範囲を削除します。

パラメータ:

identity - 削除されるアイデンティティ

例外:

KeyManagementException - アイデンティティがない場合、あるいはほかの例外が発生した場合

identities

public abstract Enumeration identities()

推奨されません。

このアイデンティティの有効範囲内のすべてのアイデンティティを列挙したものを返します。

戻り値:

このアイデンティティの有効範囲内のすべてのアイデンティティの列挙

toString

public String toString()

推奨されません。

名前、有効範囲名、このアイデンティティの範囲内のアイデンティティ数を含む、このアイデンティティの範囲の文字列表現を返します。

戻り値:

このアイデンティティの有効範囲の文字列表現

オーバーライド:

クラス Identity 内の toString