JavaTM 2 Platform
Standard Ed. 5.0

java.security
クラス Identity

java.lang.Object
  上位を拡張 java.security.Identity
すべての実装されたインタフェース:
Serializable, Principal
直系の既知のサブクラス:
IdentityScope, Signer

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

@Deprecated
public abstract class Identity
extends Object
implements Principal, Serializable

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

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

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

Identity はサブクラス化され、郵便用住所、電子メールアドレス、電話番号、顔やロゴの画像などを含めることができます。

関連項目:
IdentityScope, Signer, Principal, 直列化された形式

コンストラクタの概要
protected Identity()
          推奨されていません。 直列化専用のコンストラクタです。
  Identity(String name)
          推奨されていません。 指定された名前を持ち、スコープが未定のアイデンティティを構築します。
  Identity(String name, IdentityScope scope)
          推奨されていません。 指定された名前とスコープを持つアイデンティティを構築します。
 
メソッドの概要
 void addCertificate(Certificate certificate)
          推奨されていません。 このアイデンティティに証明書を追加します。
 Certificate[] certificates()
          推奨されていません。 このアイデンティティに対するすべての証明書のコピーを返します。
 boolean equals(Object identity)
          推奨されていません。 指定されたオブジェクトとこのアイデンティティとが等しいかどうかを判定します。
 String getInfo()
          推奨されていません。 このアイデンティティに対して以前指定された一般的な情報を返します。
 String getName()
          推奨されていません。 このアイデンティティの名前を返します。
 PublicKey getPublicKey()
          推奨されていません。 このアイデンティティの公開鍵を返します。
 IdentityScope getScope()
          推奨されていません。 このアイデンティティのスコープを返します。
 int hashCode()
          推奨されていません。 このアイデンティティに対するハッシュコードを返します。
protected  boolean identityEquals(Identity identity)
          推奨されていません。 指定されたアイデンティティとこのアイデンティティとが等しいかどうかを判定します。
 void removeCertificate(Certificate certificate)
          推奨されていません。 このアイデンティティの証明書を削除します。
 void setInfo(String info)
          推奨されていません。 このアイデンティティに対する一般的な情報文字列を指定します。
 void setPublicKey(PublicKey key)
          推奨されていません。 このアイデンティティの公開鍵を設定します。
 String toString()
          推奨されていません。 このアイデンティティを記述する短い文字列で、その名前と存在する場合はスコープを示すものを返します。
 String toString(boolean detailed)
          推奨されていません。 引数なしの toString メソッドよりも詳しい情報を持つ、このアイデンティティの文字列表現を返します。
 
クラス java.lang.Object から継承されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

コンストラクタの詳細

Identity

protected Identity()
推奨されていません。 
直列化専用のコンストラクタです。


Identity

public Identity(String name,
                IdentityScope scope)
         throws KeyManagementException
推奨されていません。 
指定された名前とスコープを持つアイデンティティを構築します。

パラメータ:
name - アイデンティティ名
scope - アイデンティティスコープ
例外:
KeyManagementException - スコープ内に同じ名前のアイデンティティがすでに存在する場合

Identity

public Identity(String name)
推奨されていません。 
指定された名前を持ち、スコープが未定のアイデンティティを構築します。

パラメータ:
name - アイデンティティ名
メソッドの詳細

getName

public final String getName()
推奨されていません。 
このアイデンティティの名前を返します。

定義:
インタフェース Principal 内の getName
戻り値:
アイデンティティの名前

getScope

public final IdentityScope getScope()
推奨されていません。 
このアイデンティティのスコープを返します。

戻り値:
アイデンティティのスコープ

getPublicKey

public PublicKey getPublicKey()
推奨されていません。 
このアイデンティティの公開鍵を返します。

戻り値:
アイデンティティに対応する公開鍵
関連項目:
setPublicKey(java.security.PublicKey)

setPublicKey

public void setPublicKey(PublicKey key)
                  throws KeyManagementException
推奨されていません。 
このアイデンティティの公開鍵を設定します。元の鍵とこのアイデンティティのすべての証明書は、この操作によって削除されます。

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

パラメータ:
key - アイデンティティに対応する公開鍵
例外:
KeyManagementException - アイデンティティのスコープ内に同じ公開鍵を持つ別のアイデンティティが存在する場合、または別の例外が発生した場合
SecurityException - セキュリティマネージャが存在する場合に、セキュリティマネージャの checkSecurityAccess メソッドが公開鍵の設定を許可しないとき
関連項目:
getPublicKey(), SecurityManager.checkSecurityAccess(java.lang.String)

setInfo

public void setInfo(String info)
推奨されていません。 
このアイデンティティに対する一般的な情報文字列を指定します。

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

パラメータ:
info - 情報文字列
例外:
SecurityException - セキュリティマネージャが存在する場合に、セキュリティマネージャの checkSecurityAccess メソッドが情報文字列の設定を許可しないとき
関連項目:
getInfo(), SecurityManager.checkSecurityAccess(java.lang.String)

getInfo

public String getInfo()
推奨されていません。 
このアイデンティティに対して以前指定された一般的な情報を返します。

戻り値:
このアイデンティティの一般的な情報
関連項目:
setInfo(java.lang.String)

addCertificate

public void addCertificate(Certificate certificate)
                    throws KeyManagementException
推奨されていません。 
このアイデンティティに証明書を追加します。アイデンティティが公開鍵を持っている場合は、証明書中のその公開鍵は等しくなければいけません。アイデンティティが公開鍵を持たない場合は、アイデンティティの公開鍵には証明書中で指定されているものが設定されます。

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

パラメータ:
certificate - 追加される証明書
例外:
KeyManagementException - 証明書が有効でない場合、追加される証明書中の公開鍵がこのアイデンティティの公開鍵と重複する場合、あるいはほかの例外が発生した場合
SecurityException - セキュリティマネージャが存在する場合に、セキュリティマネージャの checkSecurityAccess メソッドが証明書の追加を許可しないとき
関連項目:
SecurityManager.checkSecurityAccess(java.lang.String)

removeCertificate

public void removeCertificate(Certificate certificate)
                       throws KeyManagementException
推奨されていません。 
このアイデンティティの証明書を削除します。

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

パラメータ:
certificate - 削除される証明書
例外:
KeyManagementException - 証明書がない場合、またはほかの例外が発生した場合
SecurityException - セキュリティマネージャが存在する場合に、セキュリティマネージャの checkSecurityAccess メソッドが証明書の削除を許可しないとき
関連項目:
SecurityManager.checkSecurityAccess(java.lang.String)

certificates

public Certificate[] certificates()
推奨されていません。 
このアイデンティティに対するすべての証明書のコピーを返します。

戻り値:
このアイデンティティに対するすべての証明書のコピー

equals

public final boolean equals(Object identity)
推奨されていません。 
指定されたオブジェクトとこのアイデンティティとが等しいかどうかを判定します。最初に各エンティティが同じオブジェクトを実際に指しているかどうかを確認し、同じオブジェクトを指している場合は true を返します。次に、各エンティティの名前とスコープが等しいかどうかを調べます。等しい場合、このメソッドは true を返します。そうでない場合は、サブクラスでオーバーライドされる identityEquals を呼び出します。

定義:
インタフェース Principal 内の equals
オーバーライド:
クラス Object 内の equals
パラメータ:
identity - このアイデンティティと等しいかどうかが判定されるオブジェクト
戻り値:
オブジェクトが等しいと見なされた場合は true、そうでない場合は false
関連項目:
identityEquals(java.security.Identity)

identityEquals

protected boolean identityEquals(Identity identity)
推奨されていません。 
指定されたアイデンティティとこのアイデンティティとが等しいかどうかを判定します。判定するには、このメソッドはサブクラスを使ってオーバーライドされる必要があります。デフォルトの動作では、名前と公開鍵が等しい場合は true を返します。

パラメータ:
identity - このアイデンティティと等しいかどうかが判定されるアイデンティティ
戻り値:
アイデンティティが等しいと見なされた場合は true、そうでない場合は false
関連項目:
equals(java.lang.Object)

toString

public String toString()
推奨されていません。 
このアイデンティティを記述する短い文字列で、その名前と存在する場合はスコープを示すものを返します。

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

定義:
インタフェース Principal 内の toString
オーバーライド:
クラス Object 内の toString
戻り値:
名前や存在する場合はスコープの名前などの、このアイデンティティに関する情報
例外:
SecurityException - セキュリティマネージャが存在する場合に、セキュリティマネージャの checkSecurityAccess メソッドが、このアイデンティティを記述する文字列を返すことを許可しないとき
関連項目:
SecurityManager.checkSecurityAccess(java.lang.String)

toString

public String toString(boolean detailed)
推奨されていません。 
引数なしの toString メソッドよりも詳しい情報を持つ、このアイデンティティの文字列表現を返します。

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

パラメータ:
detailed - 詳細情報を提供するかどうか
戻り値:
このアイデンティティの情報。detailed が true の場合は、このメソッドは引数なしの toString メソッドが返すよりも詳細な情報を返す
例外:
SecurityException - セキュリティマネージャが存在する場合に、セキュリティマネージャの checkSecurityAccess メソッドが、このアイデンティティを記述する文字列を返すことを許可しないとき
関連項目:
toString(), SecurityManager.checkSecurityAccess(java.lang.String)

hashCode

public int hashCode()
推奨されていません。 
このアイデンティティに対するハッシュコードを返します。

定義:
インタフェース Principal 内の hashCode
オーバーライド:
クラス Object 内の hashCode
戻り値:
このアイデンティティに対するハッシュコード
関連項目:
Object.equals(java.lang.Object), Hashtable

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 も参照してください。