Identity

java.lang.Object
- java.security.Identity

所有已实现的接口:

Serializable, Principal

直接已知子类:

IdentityScope, Signer

已过时。
This class is no longer used. Its functionality has been replaced by java.security.KeyStore, the java.security.cert package, and java.security.Principal.
```
@Deprecated
public abstract class Identity
extends Object
implements Principal, Serializable
```
This class represents identities: real-world objects such as people, companies or organizations whose identities can be authenticated using their public keys. Identities may also be more abstract (or concrete) constructs, such as daemon threads or smart cards.
All Identity objects have a name and a public key. Names are immutable. Identities may also be scoped. That is, if an Identity is specified to have a particular scope, then the name and public key of the Identity are unique within that scope.
An Identity also has a set of certificates (all certifying its own public key). The Principal names specified in these certificates need not be the same, only the key.
An Identity can be subclassed, to include postal and email addresses, telephone numbers, images of faces and logos, and so on.

另请参阅:

IdentityScope, Signer, Principal, 序列化表格

构造器概要

构造器
限定符	构造器	说明
`protected`	`Identity()`	已过时。 Constructor for serialization only.
	`Identity(String name)`	已过时。 Constructs an identity with the specified name and no scope.
	`Identity(String name, IdentityScope scope)`	已过时。 Constructs an identity with the specified name and scope.

方法概要

所有方法实例方法具体方法已过时的方法
限定符和类型	方法	说明
`void`	`addCertificate(Certificate certificate)`	已过时。 Adds a certificate for this identity.
`Certificate[]`	`certificates()`	已过时。 Returns a copy of all the certificates for this identity.
`boolean`	`equals(Object identity)`	已过时。 Tests for equality between the specified object and this identity.
`String`	`getInfo()`	已过时。 Returns general information previously specified for this identity.
`String`	`getName()`	已过时。 Returns this identity's name.
`PublicKey`	`getPublicKey()`	已过时。 Returns this identity's public key.
`IdentityScope`	`getScope()`	已过时。 Returns this identity's scope.
`int`	`hashCode()`	已过时。 Returns a hashcode for this identity.
`protected boolean`	`identityEquals(Identity identity)`	已过时。 Tests for equality between the specified identity and this identity.
`void`	`removeCertificate(Certificate certificate)`	已过时。 Removes a certificate from this identity.
`void`	`setInfo(String info)`	已过时。 Specifies a general information string for this identity.
`void`	`setPublicKey(PublicKey key)`	已过时。 Sets this identity's public key.
`String`	`toString()`	已过时。 Returns a short string describing this identity, telling its name and its scope (if any).
`String`	`toString(boolean detailed)`	已过时。 Returns a string representation of this identity, with optionally more details than that provided by the `toString` method without any arguments.

从类继承的方法 java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

从接口继承的方法 java.security.Principal
implies

- 构造器详细资料
  - Identity
```
protected Identity()
```
    已过时。
    
    Constructor for serialization only.
  - Identity
```
public Identity(String name,
                IdentityScope scope)
         throws KeyManagementException
```
    已过时。
    
    Constructs an identity with the specified name and scope.
    
    参数:
    
    name - the identity name.
    
    scope - the scope of the identity.
    
    抛出:
    
    KeyManagementException - if there is already an identity with the same name in the scope.
  - Identity
```
public Identity(String name)
```
    已过时。
    
    Constructs an identity with the specified name and no scope.
    
    参数:
    
    name - the identity name.
- 方法详细资料
  - getName
```
public final String getName()
```
    已过时。
    
    Returns this identity's name.
    
    指定者:
    
    getName 在接口中 Principal
    
    返回:
    
    the name of this identity.
  - getScope
```
public final IdentityScope getScope()
```
    已过时。
    
    Returns this identity's scope.
    
    返回:
    
    the scope of this identity.
  - getPublicKey
```
public PublicKey getPublicKey()
```
    已过时。
    
    Returns this identity's public key.
    
    返回:
    
    the public key for this identity.
    
    另请参阅:
    
    setPublicKey(java.security.PublicKey)
  - setPublicKey
```
public void setPublicKey(PublicKey key)
                  throws KeyManagementException
```
    已过时。
    
    Sets this identity's public key. The old key and all of this identity's certificates are removed by this operation.
    First, if there is a security manager, its checkSecurityAccess method is called with "setIdentityPublicKey" as its argument to see if it's ok to set the public key.
    
    参数:
    
    key - the public key for this identity.
    
    抛出:
    
    KeyManagementException - if another identity in the identity's scope has the same public key, or if another exception occurs.
    
    SecurityException - if a security manager exists and its checkSecurityAccess method doesn't allow setting the public key.
    
    另请参阅:
    
    getPublicKey(), SecurityManager.checkSecurityAccess(java.lang.String)
  - setInfo
```
public void setInfo(String info)
```
    已过时。
    
    Specifies a general information string for this identity.
    First, if there is a security manager, its checkSecurityAccess method is called with "setIdentityInfo" as its argument to see if it's ok to specify the information string.
    
    参数:
    
    info - the information string.
    
    抛出:
    
    SecurityException - if a security manager exists and its checkSecurityAccess method doesn't allow setting the information string.
    
    另请参阅:
    
    getInfo(), SecurityManager.checkSecurityAccess(java.lang.String)
  - getInfo
```
public String getInfo()
```
    已过时。
    
    Returns general information previously specified for this identity.
    
    返回:
    
    general information about this identity.
    
    另请参阅:
    
    setInfo(java.lang.String)
  - addCertificate
```
public void addCertificate(Certificate certificate)
                    throws KeyManagementException
```
    已过时。
    
    Adds a certificate for this identity. If the identity has a public key, the public key in the certificate must be the same, and if the identity does not have a public key, the identity's public key is set to be that specified in the certificate.
    First, if there is a security manager, its checkSecurityAccess method is called with "addIdentityCertificate" as its argument to see if it's ok to add a certificate.
    
    参数:
    
    certificate - the certificate to be added.
    
    抛出:
    
    KeyManagementException - if the certificate is not valid, if the public key in the certificate being added conflicts with this identity's public key, or if another exception occurs.
    
    SecurityException - if a security manager exists and its checkSecurityAccess method doesn't allow adding a certificate.
    
    另请参阅:
    
    SecurityManager.checkSecurityAccess(java.lang.String)
  - removeCertificate
```
public void removeCertificate(Certificate certificate)
                       throws KeyManagementException
```
    已过时。
    
    Removes a certificate from this identity.
    First, if there is a security manager, its checkSecurityAccess method is called with "removeIdentityCertificate" as its argument to see if it's ok to remove a certificate.
    
    参数:
    
    certificate - the certificate to be removed.
    
    抛出:
    
    KeyManagementException - if the certificate is missing, or if another exception occurs.
    
    SecurityException - if a security manager exists and its checkSecurityAccess method doesn't allow removing a certificate.
    
    另请参阅:
    
    SecurityManager.checkSecurityAccess(java.lang.String)
  - certificates
```
public Certificate[] certificates()
```
    已过时。
    
    Returns a copy of all the certificates for this identity.
    
    返回:
    
    a copy of all the certificates for this identity.
  - equals
```
public final boolean equals(Object identity)
```
    已过时。
    
    Tests for equality between the specified object and this identity. This first tests to see if the entities actually refer to the same object, in which case it returns true. Next, it checks to see if the entities have the same name and the same scope. If they do, the method returns true. Otherwise, it calls identityEquals, which subclasses should override.
    
    指定者:
    
    equals 在接口中 Principal
    
    覆盖:
    
    equals 在类中 Object
    
    参数:
    
    identity - the object to test for equality with this identity.
    
    返回:
    
    true if the objects are considered equal, false otherwise.
    
    另请参阅:
    
    identityEquals(java.security.Identity)
  - identityEquals
```
protected boolean identityEquals(Identity identity)
```
    已过时。
    
    Tests for equality between the specified identity and this identity. This method should be overriden by subclasses to test for equality. The default behavior is to return true if the names and public keys are equal.
    
    参数:
    
    identity - the identity to test for equality with this identity.
    
    返回:
    
    true if the identities are considered equal, false otherwise.
    
    另请参阅:
    
    equals(java.lang.Object)
  - toString
```
public String toString()
```
    已过时。
    
    Returns a short string describing this identity, telling its name and its scope (if any).
    First, if there is a security manager, its checkSecurityAccess method is called with "printIdentity" as its argument to see if it's ok to return the string.
    
    指定者:
    
    toString 在接口中 Principal
    
    覆盖:
    
    toString 在类中 Object
    
    返回:
    
    information about this identity, such as its name and the name of its scope (if any).
    
    抛出:
    
    SecurityException - if a security manager exists and its checkSecurityAccess method doesn't allow returning a string describing this identity.
    
    另请参阅:
    
    SecurityManager.checkSecurityAccess(java.lang.String)
  - toString
```
public String toString(boolean detailed)
```
    已过时。
    
    Returns a string representation of this identity, with optionally more details than that provided by the toString method without any arguments.
    First, if there is a security manager, its checkSecurityAccess method is called with "printIdentity" as its argument to see if it's ok to return the string.
    
    参数:
    
    detailed - whether or not to provide detailed information.
    
    返回:
    
    information about this identity. If detailed is true, then this method returns more information than that provided by the toString method without any arguments.
    
    抛出:
    
    SecurityException - if a security manager exists and its checkSecurityAccess method doesn't allow returning a string describing this identity.
    
    另请参阅:
    
    toString(), SecurityManager.checkSecurityAccess(java.lang.String)
  - hashCode
```
public int hashCode()
```
    已过时。
    
    Returns a hashcode for this identity.
    
    指定者:
    
    hashCode 在接口中 Principal
    
    覆盖:
    
    hashCode 在类中 Object
    
    返回:
    
    a hashcode for this identity.
    
    另请参阅:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

类 Identity

构造器概要

方法概要

从类继承的方法 java.lang.Object

从接口继承的方法 java.security.Principal

构造器详细资料

Identity

Identity

Identity

方法详细资料

getName

getScope

getPublicKey

setPublicKey

setInfo

getInfo

addCertificate

removeCertificate

certificates

equals

identityEquals

toString

toString

hashCode