モジュール java.base
パッケージ java.security

クラスIdentityScope

java.lang.Object
java.security.Identity
java.security.IdentityScope
すべての実装されたインタフェース:
Serializable, Principal
@Deprecated(since="1.2", forRemoval=true) public abstract class IdentityScope extends Identity
削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
このクラスは推奨されなくなり、Java SEの将来のバージョンで削除される可能性があります。 これは、java.security.KeyStore、java.security.certパッケージ、およびjava.security.Principalに置き換えられています。

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

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

キーとアイデンティティの間には1対1のマッピングが存在し、アイデンティティのスコープあたり1つのキーの1つのコピーしか存在できません。 たとえば、Acme Software, Incという、ユーザーが知っているソフトウェア出版社があるとします。 その出版社が1つのIdentity、すなわち公開キーおよび関連する証明書のセットを持つものとします。 「Acme Software」という名前を使用して有効範囲内で名前が付けられます。 その有効範囲内で名前の付いているほかのIdentityが同じ公開キーを持つことはありません。 また、同じ名前を持つものも存在しません。

導入されたバージョン:
1.1
関連項目:

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

    コンストラクタ
    修飾子
    コンストラクタ
    説明
    protected
    IdentityScope()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このコンストラクタは、直列化だけに使用し、サブクラスでは使用すべきではありません。
     
    IdentityScope(String name)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    指定された名前を持つ新しいアイデンティティのスコープを構築します。
     
    IdentityScope(String name, IdentityScope scope)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    名前とスコープを指定して新しいアイデンティティ・スコープを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    abstract void
    addIdentity(Identity identity)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このアイデンティティ・スコープにIdentityを追加します。
    abstract Identity
    getIdentity(String name)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    指定された名前(もしあれば)でこのスコープのIdentityを返します。
    Identity
    getIdentity(Principal principal)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    指定したプリンシパルの名前と同じ名前のIdentityを取得します。
    abstract Identity
    getIdentity(PublicKey key)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    指定された公開キーでidentityを取得します。
    static IdentityScope
    getSystemScope()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    システムのアイデンティティ・スコープを返します。
    abstract Enumeration<Identity>
    identities()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このアイデンティティ・スコープ内のすべてのアイデンティティを列挙したものを返します。
    abstract void
    removeIdentity(Identity identity)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このアイデンティティ・スコープからIdentityを削除します。
    protected static void
    setSystemScope(IdentityScope scope)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    システムのアイデンティティ・スコープを設定します。
    abstract int
    size()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このアイデンティティ・スコープにあるアイデンティティの数を返します。
    String
    toString()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    名前、スコープ名、このアイデンティティ・スコープ内のアイデンティティ数を含む、このアイデンティティ・スコープの文字列表現を返します。

    クラス 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()
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      このコンストラクタは、直列化だけに使用し、サブクラスでは使用すべきではありません。

    • IdentityScope

      public IdentityScope(String name)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      指定された名前を持つ新しいアイデンティティのスコープを構築します。
      パラメータ:
      name - スコープ名。

    • IdentityScope

      public IdentityScope(String name, IdentityScope scope) throws KeyManagementException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      名前とスコープを指定して新しいアイデンティティ・スコープを構築します。
      パラメータ:
      name - スコープ名。
      scope - 新しいアイデンティティ・スコープに対するスコープ。
      例外:
      KeyManagementException - スコープに同じ名前のIdentityがすでに存在する場合。

  • メソッドの詳細

    • getSystemScope

      public static IdentityScope getSystemScope()
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      システムのアイデンティティ・スコープを返します。
      戻り値:
      システムのアイデンティティ・スコープ。設定されたものがない場合はnull。
      関連項目:

    • setSystemScope

      protected static void setSystemScope(IdentityScope scope)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      システムのアイデンティティ・スコープを設定します。

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

      パラメータ:
      scope - 設定されるスコープ。
      例外:
      SecurityException - セキュリティ・マネージャが存在し、セキュリティ・マネージャのcheckSecurityAccessメソッドがアイデンティティ・スコープの設定を許可しない場合。
      関連項目:

    • size

      public abstract int size()
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      このアイデンティティ・スコープにあるアイデンティティの数を返します。
      戻り値:
      このアイデンティティ・スコープにあるアイデンティティの数。

    • getIdentity

      public abstract Identity getIdentity(String name)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      指定された名前(もしあれば)でこのスコープのIdentityを返します。
      パラメータ:
      name - 取得するIdentityの名前。
      戻り値:
      このスコープにnameという名前のアイデンティティがない場合は、nameまたはnullという名前のIdentity。

    • getIdentity

      public Identity getIdentity(Principal principal)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      指定したプリンシパルの名前と同じ名前のIdentityを取得します。 (ノート: Identityは、Principalを実装します。)
      パラメータ:
      principal - 取得するIdentityに対応するプリンシパル。
      戻り値:
      名前がプリンシパルの名前と同じであるIdentity、またはこのスコープに同じ名前のアイデンティティがない場合はnull。

    • getIdentity

      public abstract Identity getIdentity(PublicKey key)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      指定された公開キーでidentityを取得します。
      パラメータ:
      key - 返されるアイデンティティに対する公開キー。
      戻り値:
      指定されたキーを持つアイデンティティ。このスコープにそのキーを持つアイデンティティがない場合はnull。

    • addIdentity

      public abstract void addIdentity(Identity identity) throws KeyManagementException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      このアイデンティティ・スコープにIdentityを追加します。
      パラメータ:
      identity - 追加するIdentity。
      例外:
      KeyManagementException - アイデンティティが有効でない場合、名前が重複した場合、ほかのアイデンティティが追加するアイデンティティと同じ公開キーを持っている場合、またはほかの例外が発生した場合。

    • removeIdentity

      public abstract void removeIdentity(Identity identity) throws KeyManagementException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      このアイデンティティ・スコープからIdentityを削除します。
      パラメータ:
      identity - 削除するIdentity。
      例外:
      KeyManagementException - アイデンティティがない場合、またはほかの例外が発生した場合。

    • identities

      public abstract Enumeration<Identity> identities()
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      このアイデンティティ・スコープ内のすべてのアイデンティティを列挙したものを返します。
      戻り値:
      このアイデンティティ・スコープ内のすべてのアイデンティティを列挙したもの。

    • toString

      public String toString()
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      名前、スコープ名、このアイデンティティ・スコープ内のアイデンティティ数を含む、このアイデンティティ・スコープの文字列表現を返します。
      定義:
      toString、インタフェースPrincipal
      オーバーライド:
      toString、クラスIdentity
      戻り値:
      このアイデンティティ・スコープの文字列表現。
      関連項目: