compact1, compact2, compact3

java.security

クラスIdentityScope

java.lang.Object

java.security.Identity

java.security.IdentityScope

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

Serializable, Principal

非推奨。

このクラスは使用されなくなりました。その機能はjava.security.KeyStore、java.security.certパッケージ、およびjava.security.Principalに置き換えられています。

@Deprecated
public abstract class IdentityScope
extends Identity

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

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

鍵とアイデンティティの間には1対1のマッピングが存在し、アイデンティティのスコープあたり1つの鍵の1つのコピーしか存在できません。たとえば、Acme Software, Incという、ユーザーが知っているソフトウェア出版社があるとします。その出版社が1つのIdentity、すなわち公開鍵および関連する証明書のセットを持つものとします。「Acme Software」という名前を使用して有効範囲内で名前が付けられます。その有効範囲内で名前の付いているほかの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) 非推奨。 指定された主体と同じ名前のアイデンティティを取得します。
abstract Identity	getIdentity(PublicKey key) 非推奨。 指定された公開鍵のアイデンティティを取り出します。
abstract Identity	getIdentity(String name) 非推奨。 このスコープにある指定された名前を持つアイデンティティを(存在する場合に)返します。
static IdentityScope	getSystemScope() 非推奨。 システムのアイデンティティ・スコープを返します。
abstract Enumeration<Identity>	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

インタフェース java.security.Principalから継承されたメソッド

implies

コンストラクタの詳細

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()

非推奨。

システムのアイデンティティ・スコープを返します。

戻り値:

システムのアイデンティティ・スコープ。設定されたものがない場合はnull。

関連項目:

setSystemScope(java.security.IdentityScope)

setSystemScope

protected static void setSystemScope(IdentityScope scope)

非推奨。

システムのアイデンティティ・スコープを設定します。

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

パラメータ:

scope - 設定されるスコープ。

例外:

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

関連項目:

getSystemScope(), 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)

非推奨。

指定された主体と同じ名前のアイデンティティを取得します。なお、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<Identity> identities()

非推奨。

このアイデンティティ・スコープ内のすべてのアイデンティティを列挙したものを返します。

戻り値:

このアイデンティティ・スコープ内のすべてのアイデンティティを列挙したもの。

toString

public String toString()

非推奨。

名前、スコープ名、このアイデンティティ・スコープ内のアイデンティティ数を含む、このアイデンティティ・スコープの文字列表現を返します。

定義:

toString、インタフェース: Principal

オーバーライド:

toString、クラス: Identity

戻り値:

このアイデンティティ・スコープの文字列表現。

関連項目:

SecurityManager.checkSecurityAccess(java.lang.String)