全パッケージ  クラス階層  このパッケージ  前項目  次項目  インデックス

クラス java.security.Identity

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

public abstract class Identity

extends Object

implements Principal, Serializable

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

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

Identity は、証明書のセット (すべて、それ自身の公開鍵を証明する) をもつこともあります。その証明書に指定されているプリンシプル名は同じでなくてもよく、ただ鍵だけが同一である必要があります。

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

参照:

IdentityScope, Signer, Principal

Identity()

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

Identity(String)

指定された名前をもち範囲のないアイデンティティを作成する。

Identity(String, IdentityScope)

指定された名前と範囲のあるアイデンティティを作成する。

addCertificate(Certificate)

このアイデンティティに証明書を追加する。

certificates()

このアイデンティティに対するすべての証明書のコピーを返す。

equals(Object)

指定されたオブジェクトとこのアイデンティティとが等しいかをテストする。

getInfo()

このアイデンティティに対して以前指定された一般的な情報を返す。

getName()

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

getPublicKey()

このアイデンティティの公開鍵を返す。

getScope()

このアイデンティティの範囲を返す。

hashCode()

このアイデンティティに対するハッシュコードを返す。

identityEquals(Identity)

指定されたオブジェクトとこのアイデンティティとが等しいかをテストする。

removeCertificate(Certificate)

このアイデンティティの証明書を削除する。

setInfo(String)

このアイデンティティに対する一般的な情報文字列を指定する。

setPublicKey(PublicKey)

このアイデンティティの公開鍵をセットする。

toString()

このアイデンティティを記述する短い文字列でその名前と範囲 (存在する場合) を明らかにするものを返す。

toString(boolean)

引数なしの toString メソッドよりも少し詳しい情報を持つ、このアイデンティティの文字列表現を返す。

  protected Identity()

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

  public Identity(String name,
                  IdentityScope scope) throws KeyManagementException

指定された名前と有効範囲を持つアイデンティティを作成します。

パラメータ:

name - アイデンティティの名前

scope - アイデンティティの範囲

例外: KeyManagementException

範囲の中に同じ名前をもつアイデンティティが存在する場合

  public Identity(String name)

指定された名前を持ち有効範囲未定のアイデンティティを作成します。

パラメータ:

name - アイデンティティの名前

  public final String getName()

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

返り値:

このアイデンティティの名前

  public final IdentityScope getScope()

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

返り値:

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

  public PublicKey getPublicKey()

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

返り値:

このアイデンティティの公開鍵

  public void setPublicKey(PublicKey key) throws KeyManagementException

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

パラメータ:

key - このアイデンティティの公開鍵

例外: KeyManagementException

アイデンティティの範囲の中に同じ公開鍵がもつ別のアイデンティティが存在する場合、または別の例外が発生した場合

  public void setInfo(String info)

このアイデンティティに対する一般的な情報文字列を指定します。

パラメータ:

info - 情報文字列

参照:

getInfo

  public String getInfo()

このアイデンティティに対して以前指定された一般的な情報を返します。

返り値:

このアイデンティティの一般的な情報

参照:

setInfo

  public void addCertificate(Certificate certificate) throws KeyManagementException

このアイデンティティに証明書を追加します。アイデンティティが公開鍵をもっている場合には、証明書中のその公開鍵は等しくなれければなりません。アイデンティティが公開鍵をもたない場合には、アイデンティティの公開鍵には証明書中で指定されているものがセットになります。

パラメータ:

certificate - 追加する証明書

例外: KeyManagementException

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

  public void removeCertificate(Certificate certificate) throws KeyManagementException

このアイデンティティの証明書を削除します。

パラメータ:

certificate - 削除する証明書

例外: KeyManagementException

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

  public Certificate[] certificates()

このアイデンティティに対するすべての証明書のコピーを返します。

返り値:

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

  public final boolean equals(Object identity)

指定されたオブジェクトとこのアイデンティティとが等しいかをテストします。 これはまず、各エンティティが同じオブジェクトを実際に指しているかどうかを確認するテストを行い、同じ object をさしている場合には true を返します。次に、各エンティティの名前と範囲が等しいかをチェックします。等しい場合には、このメソッドは true を返します。それ以外の場合には、サブクラスで再定義される (筈の) identityEqualsを呼び出します。

パラメータ:

identity - このアイデンティティと等しいかをテストするオブジェクト

返り値:

オブジェクトが等しいと見なされた場合 true、それ以外の場合には false が返る。

オーバーライド:

クラス Object の equals

参照:

identityEquals

  protected boolean identityEquals(Identity identity)

指定されたアイデンティティとこのアイデンティティとが等しいかどうかをテストします。デフォルトの動作では、名前と公開鍵が等しい場合には true が返します。

パラメータ:

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

返り値:

オブジェクトが等しいと見なされた場合 true、それ以外の場合には false が返る。

参照:

equals

  public String toString()

このアイデンティティを記述する短い文字列でその名前と範囲 (存在する場合) を明らかにするものを返します。

返り値:

名前や (存在する場合) 範囲の名前などの、このアイデンティティに関する情報

オーバーライド:

クラス Object の toString

  public String toString(boolean detailed)

引数なしの toString メソッドよりも少し詳しい情報を持つ、このアイデンティティの文字列表現を返します。

パラメータ:

detailed - 詳細情報を取得するかどうかの指定。

返り値:

このアイデンティティの情報。 detailed が true の場合には、このメソッドは引数なしの toString メソッドが与えるよりも詳細な情報を返す。

参照:

toString

  public int hashCode()

このアイデンティティに対するハッシュコードを返します。

返り値:

このアイデンティティに対するハッシュコード

オーバーライド:

クラス Object の hashCode

全パッケージ  クラス階層  このパッケージ  前項目  次項目  インデックス