Identity (Java Platform SE 8)

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

インタフェース java.security.Principalから継承されたメソッド
implies

- コンストラクタの詳細
  - 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()
```
    非推奨。
    
    このアイデンティティの名前を返します。
    
    定義:
    
    getName、インタフェース: Principal
    
    戻り値:
    
    アイデンティティの名前。
  - 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を呼び出します。
    
    定義:
    
    equals、インタフェース: Principal
    
    オーバーライド:
    
    equals、クラス: Object
    
    パラメータ:
    
    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"を指定して呼び出され、文字列を返してもよいかどうかを確認します。
    
    定義:
    
    toString、インタフェース: Principal
    
    オーバーライド:
    
    toString、クラス: Object
    
    戻り値:
    
    名前や存在する場合はスコープの名前などの、このアイデンティティに関する情報。
    
    例外:
    
    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()
```
    非推奨。
    
    このアイデンティティに対するハッシュ・コードを返します。
    
    定義:
    
    hashCode、インタフェース: Principal
    
    オーバーライド:
    
    hashCode、クラス: Object
    
    戻り値:
    
    このアイデンティティに対するハッシュ・コード。
    
    関連項目:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスIdentity

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

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

インタフェース java.security.Principalから継承されたメソッド

コンストラクタの詳細

Identity

Identity

Identity

メソッドの詳細

getName

getScope

getPublicKey

setPublicKey

setInfo

getInfo

addCertificate

removeCertificate

certificates

equals

identityEquals

toString

toString

hashCode