モジュール 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
関連項目:

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

    コンストラクタ
    修飾子
    コンストラクタ
    説明
    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

      public void setPublicKey(PublicKey key) throws KeyManagementException
      非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
      このアイデンティティの公開キーを設定します。 元のキーとこのアイデンティティのすべての証明書は、この操作によって削除されます。

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

      パラメータ:
      key - このIdentityの公開キー。
      例外:
      KeyManagementException - アイデンティティのスコープ内に同じ公開キーを持つ別のアイデンティティが存在する場合、または別の例外が発生した場合。
      SecurityException - セキュリティ・マネージャが存在し、セキュリティ・マネージャのcheckSecurityAccessメソッドが公開キーの設定を許可しない場合。
      関連項目:

    • setInfo

      public void setInfo(String info)
      非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
      このIdentityの一般情報文字列を指定します。

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

      パラメータ:
      info - 情報文字列。
      例外:
      SecurityException - セキュリティ・マネージャが存在し、セキュリティ・マネージャのcheckSecurityAccessメソッドが情報文字列の設定を許可しない場合。
      関連項目:

    • getInfo

      public String getInfo()
      非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
      このIdentityに対して以前に指定された一般情報を返します。
      戻り値:
      このIdentityに関する一般情報。
      関連項目:

    • addCertificate

      public void addCertificate(Certificate certificate) throws KeyManagementException
      非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
      このIdentityの証明書を追加します。 Identityに公開キーがある場合、証明書内の公開キーは同じである必要があり、Identityに公開キーがない場合、アイデンティティの公開キーは証明書で指定されたものに設定されます。

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

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

    • removeCertificate

      public void removeCertificate(Certificate certificate) throws KeyManagementException
      非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
      このIdentityから証明書を削除します。

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

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

    • 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

      protected boolean identityEquals(Identity identity)
      非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
      指定されたIdentityとこのIdentityの間の等価性をテストします。 このメソッドは、等価性をテストするためにサブクラスによってオーバーライドされる必要があります。 デフォルトの動作では、名前と公開キーが等しい場合にtrueが返されます。
      パラメータ:
      identity - このidentityと等しいかどうかをテストするアイデンティティ。
      戻り値:
      IDが等しいとみなされる場合はtrue、そうでない場合はfalse。
      関連項目:

    • toString

      public String toString()
      非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
      このIdentityを記述する短い文字列を返し、名前とそのスコープ(もしあれば)を示します。

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

      定義:
      toString、インタフェースPrincipal
      オーバーライド:
      toString、クラスObject
      戻り値:
      このIdentityに関する情報(スコープの名前や(もしあれば)の名前など)。
      例外:
      SecurityException - セキュリティ・マネージャが存在し、そのcheckSecurityAccessメソッドがこのIdentityを記述する文字列を返さない場合。
      関連項目:

    • toString

      public String toString(boolean detailed)
      非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
      このIdentityの文字列表現を返します。オプションで、引数なしのtoStringメソッドで提供されるものよりも詳細な情報を提供します。

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

      パラメータ:
      detailed - 詳細情報を提供するかどうか。
      戻り値:
      このIdentityに関する情報。 detailedがtrueの場合、このメソッドは、引数なしでtoStringメソッドによって提供されるより多くの情報を返します。
      例外:
      SecurityException - セキュリティ・マネージャが存在し、そのcheckSecurityAccessメソッドがこのIdentityを記述する文字列を返さない場合。
      関連項目:

    • hashCode

      public int hashCode()
      非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
      このIdentityのハッシュ・コードを返します。
      定義:
      hashCode、インタフェースPrincipal
      オーバーライド:
      hashCode、クラスObject
      戻り値:
      このIdentityのハッシュ・コード。
      関連項目: