モジュール java.base

パッケージ java.security

クラスIdentity

java.lang.Object

java.security.Identity

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

Serializable, Principal

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

IdentityScope, Signer

@Deprecated(since="1.2", forRemoval=true) public abstract class Identity extends Object implements Principal, Serializable

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

このクラスは推奨されなくなり、Java SEの将来のバージョンで削除される可能性があります。 これは、java.security.KeyStore、java.security.certパッケージ、およびjava.security.Principalに置き換えられています。

このクラスは、アイデンティティを表します。アイデンティティは、人々、会社、組織などの実際の世界のオブジェクトで、そのアイデンティティがその公開キーを使用して認証できるものです。 アイデンティティはまた、デーモン・スレッドやスマート・カードのようなより抽象的、あるいはより具象的な構成概念であってもかまいません。

すべてのIdentityオブジェクトには、名前と公開キーがあります。 名前は不変です。 Identityにはスコープを指定することもできます。 つまり、Identityに特定のスコープが指定されている場合、Identityの名前と公開キーはそのスコープ内で一意になります。

Identityには、一連の証明書(自身の公開キーを証明するすべて)もあります。 それらの証明書に指定されている主体名は同一でなくてもかまいませんが、キーだけは同一である必要があります。

Identityをサブクラス化して、郵送先住所とEメール・アドレス、電話番号、顔とロゴのイメージなどを含めることができます。

導入されたバージョン:

1.1

関連項目:

• IdentityScope
• Signer
• Principal
• 直列化された形式

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタ	説明
protected	Identity()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 直列化専用のコンストラクタです。
	Identity(String name)	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 指定された名前でスコープなしでIdentityを構築します。
	Identity(String name, IdentityScope scope)	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 指定された名前とスコープでIdentityを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	addCertificate(Certificate certificate)	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 このIdentityの証明書を追加します。
Certificate[]	certificates()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 このIdentityのすべての証明書のコピーを返します。
final boolean	equals(Object identity)	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 指定されたオブジェクトとこのIdentityの間の等価性をテストします。
String	getInfo()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 このIdentityに対して以前に指定された一般情報を返します。
final String	getName()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 このアイデンティティの名前を返します。
PublicKey	getPublicKey()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 このアイデンティティの公開キーを返します。
final IdentityScope	getScope()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 このアイデンティティのスコープを返します。
int	hashCode()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 このIdentityのハッシュ・コードを返します。
protected boolean	identityEquals(Identity identity)	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 指定されたIdentityとこのIdentityの間の等価性をテストします。
void	removeCertificate(Certificate certificate)	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 このIdentityから証明書を削除します。
void	setInfo(String info)	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 このIdentityの一般情報文字列を指定します。
void	setPublicKey(PublicKey key)	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 このアイデンティティの公開キーを設定します。
String	toString()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 このIdentityを記述する短い文字列を返し、名前とそのスコープ(もしあれば)を示します。
String	toString(boolean detailed)	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 このIdentityの文字列表現を返します。オプションで、引数なしのtoStringメソッドで提供されるものよりも詳細な情報を提供します。

クラスjava.lang.Objectで宣言されたメソッド

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

インタフェースjava.security.Principalで宣言されたメソッド

implies

コンストラクタの詳細

Identity

protected Identity()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

直列化専用のコンストラクタです。

Identity

public Identity(String name, IdentityScope scope) throws KeyManagementException

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

指定された名前とスコープでIdentityを構築します。

パラメータ:

name - Identity名。

scope - Identityのスコープ。

例外:

KeyManagementException - スコープに同じ名前のIdentityがすでに存在する場合。

Identity

public Identity(String name)

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

指定された名前でスコープなしでIdentityを構築します。

パラメータ:

name - アイデンティティ名。

メソッドの詳細

getName

public final String getName()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

このアイデンティティの名前を返します。

定義:

getName、インタフェースPrincipal

戻り値:

このIdentityの名前。

getScope

public final IdentityScope getScope()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

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

戻り値:

このIdentityのスコープ。

getPublicKey

public PublicKey getPublicKey()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

このアイデンティティの公開キーを返します。

戻り値:

このIdentityの公開キー。

関連項目:

• setPublicKey(java.security.PublicKey)

setPublicKey

public void setPublicKey(PublicKey key) throws KeyManagementException

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

このアイデンティティの公開キーを設定します。 元のキーとこのアイデンティティのすべての証明書は、この操作によって削除されます。

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

パラメータ:

key - このIdentityの公開キー。

例外:

KeyManagementException - アイデンティティのスコープ内に同じ公開キーを持つ別のアイデンティティが存在する場合、または別の例外が発生した場合。

SecurityException - セキュリティ・マネージャが存在し、セキュリティ・マネージャのcheckSecurityAccessメソッドが公開キーの設定を許可しない場合。

関連項目:

• getPublicKey()
• SecurityManager.checkSecurityAccess(java.lang.String)

setInfo

public void setInfo(String info)

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

このIdentityの一般情報文字列を指定します。

セキュリティ・マネージャが存在する場合、最初にセキュリティ・マネージャのcheckSecurityAccessメソッドが引数として"setIdentityInfo"を指定して呼び出され、情報文字列の設定をしてもよいかどうかを確認します。

パラメータ:

info - 情報文字列。

例外:

SecurityException - セキュリティ・マネージャが存在し、セキュリティ・マネージャのcheckSecurityAccessメソッドが情報文字列の設定を許可しない場合。

関連項目:

• getInfo()
• SecurityManager.checkSecurityAccess(java.lang.String)

getInfo

public String getInfo()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

このIdentityに対して以前に指定された一般情報を返します。

戻り値:

このIdentityに関する一般情報。

関連項目:

• setInfo(java.lang.String)

addCertificate

public void addCertificate(Certificate certificate) throws KeyManagementException

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

このIdentityの証明書を追加します。 Identityに公開キーがある場合、証明書内の公開キーは同じである必要があり、Identityに公開キーがない場合、アイデンティティの公開キーは証明書で指定されたものに設定されます。

セキュリティ・マネージャが存在する場合、最初にセキュリティ・マネージャのcheckSecurityAccessメソッドが引数として"addIdentityCertificate"を指定して呼び出され、証明書を追加してもよいかどうかを確認します。

パラメータ:

certificate - 追加される証明書。

例外:

KeyManagementException - 証明書が有効でない場合、追加される証明書中の公開キーがこのアイデンティティの公開キーと重複する場合、あるいはほかの例外が発生した場合。

SecurityException - セキュリティ・マネージャが存在し、セキュリティ・マネージャのcheckSecurityAccessメソッドが証明書の追加を許可しない場合。

関連項目:

• SecurityManager.checkSecurityAccess(java.lang.String)

removeCertificate

public void removeCertificate(Certificate certificate) throws KeyManagementException

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

このIdentityから証明書を削除します。

セキュリティ・マネージャが存在する場合、最初にセキュリティ・マネージャのcheckSecurityAccessメソッドが引数として"removeIdentityCertificate"を指定して呼び出され、証明書を削除してもよいかどうかを確認します。

パラメータ:

certificate - 削除される証明書。

例外:

KeyManagementException - 証明書がない場合、またはほかの例外が発生した場合。

SecurityException - セキュリティ・マネージャが存在し、セキュリティ・マネージャのcheckSecurityAccessメソッドが証明書の削除を許可しない場合。

関連項目:

• SecurityManager.checkSecurityAccess(java.lang.String)

certificates

public Certificate[] certificates()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

このIdentityのすべての証明書のコピーを返します。

戻り値:

このIdentityのすべての証明書のコピー。

equals

public final boolean equals(Object identity)

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

指定されたオブジェクトとこのIdentityの間の等価性をテストします。 最初に、エンティティが同じオブジェクトを参照しているかどうかがテストされ、その場合はtrueが返されます。 次に、各エンティティの名前とスコープが等しいかどうかを調べます。 その場合、メソッドはtrueを返します。 それ以外の場合は、サブクラスがオーバーライドする必要があるidentityEqualsを呼び出します。

定義:

equals、インタフェースPrincipal

オーバーライド:

equals、クラスObject

パラメータ:

identity - このIdentityと等しいかどうかをテストするオブジェクト。

戻り値:

オブジェクトが等しいとみなされる場合はtrue、そうでない場合はfalse。

関連項目:

• identityEquals(java.security.Identity)

identityEquals

protected boolean identityEquals(Identity identity)

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

指定されたIdentityとこのIdentityの間の等価性をテストします。 このメソッドは、等価性をテストするためにサブクラスによってオーバーライドされる必要があります。 デフォルトの動作では、名前と公開キーが等しい場合にtrueが返されます。

パラメータ:

identity - このidentityと等しいかどうかをテストするアイデンティティ。

戻り値:

IDが等しいとみなされる場合はtrue、そうでない場合はfalse。

関連項目:

• equals(java.lang.Object)

toString

public String toString()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

このIdentityを記述する短い文字列を返し、名前とそのスコープ(もしあれば)を示します。

セキュリティ・マネージャが存在する場合、最初にセキュリティ・マネージャのcheckSecurityAccessメソッドが引数として"printIdentity"を指定して呼び出され、文字列を返してもよいかどうかを確認します。

定義:

toString、インタフェースPrincipal

オーバーライド:

toString、クラスObject

戻り値:

このIdentityに関する情報(スコープの名前や(もしあれば)の名前など)。

例外:

SecurityException - セキュリティ・マネージャが存在し、そのcheckSecurityAccessメソッドがこのIdentityを記述する文字列を返さない場合。

関連項目:

• SecurityManager.checkSecurityAccess(java.lang.String)

toString

public String toString(boolean detailed)

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

このIdentityの文字列表現を返します。オプションで、引数なしのtoStringメソッドで提供されるものよりも詳細な情報を提供します。

セキュリティ・マネージャが存在する場合、最初にセキュリティ・マネージャのcheckSecurityAccessメソッドが引数として"printIdentity"を指定して呼び出され、文字列を返してもよいかどうかを確認します。

パラメータ:

detailed - 詳細情報を提供するかどうか。

戻り値:

このIdentityに関する情報。 detailedがtrueの場合、このメソッドは、引数なしでtoStringメソッドによって提供されるより多くの情報を返します。

例外:

SecurityException - セキュリティ・マネージャが存在し、そのcheckSecurityAccessメソッドがこのIdentityを記述する文字列を返さない場合。

関連項目:

• toString()
• SecurityManager.checkSecurityAccess(java.lang.String)

hashCode

public int hashCode()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

このIdentityのハッシュ・コードを返します。

定義:

hashCode、インタフェースPrincipal

オーバーライド:

hashCode、クラスObject

戻り値:

このIdentityのハッシュ・コード

関連項目:

• Object.equals(java.lang.Object)
• System.identityHashCode(java.lang.Object)