Adds a certificate for this identity.

  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.
Parameters:
- certificate - the certificate to be added.
Throws:
- 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.
See Also: SecurityManager.checkSecurityAccess(java.lang.String),

  Returns a copy of all the certificates for this identity.

  Returns a copy of all the certificates for this identity.
Returns: a copy of all the certificates for this identity.

  Tests for equality between the specified object and this 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.
Returns: true if the objects are considered equal, false otherwise.
Parameters:
- identity - the object to test for equality with this identity.
See Also: Identity.identityEquals(java.security.Identity),

Returns a parsable name for identity: identityName.scopeName

  Returns general information previously specified for this identity.

  Returns general information previously specified for this identity.
Returns: general information about this identity.
See Also: Identity.setInfo(java.lang.String),

  Returns this identity's name.

  Returns this identity's name.
Returns: the name of this identity.

  Returns this identity's public key.

  Returns this identity's public key.
Returns: the public key for this identity.
See Also: Identity.setPublicKey(java.security.PublicKey),

  Returns this identity's scope.

  Returns this identity's scope.
Returns: the scope of this identity.

  Returns a hashcode for this identity.

  Returns a hashcode for this identity.
Returns: a hashcode for this identity.

  Tests for equality between the specified identity and this 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.
Returns: true if the identities are considered equal, false otherwise.
Parameters:
- identity - the identity to test for equality with this identity.
See Also: Identity.equals(java.lang.Object),

  Removes a certificate from this identity.

  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.
Parameters:
- certificate - the certificate to be removed.
Throws:
- 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.
See Also: SecurityManager.checkSecurityAccess(java.lang.String),

  Specifies a general information string for this identity.

  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.
Parameters:
- info - the information string.
Throws:
- SecurityException - if a security manager exists and its checkSecurityAccess method doesn't allow setting the information string.
See Also: Identity.getInfo(), SecurityManager.checkSecurityAccess(java.lang.String),

  Sets this identity's public key.

  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.
Parameters:
- key - the public key for this identity.
Throws:
- 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.
See Also: Identity.getPublicKey(), SecurityManager.checkSecurityAccess(java.lang.String),

  Returns a short string describing this identity, telling its name and its scope (if any).

  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.
Returns: information about this identity, such as its name and the name of its scope (if any).
Throws:
- SecurityException - if a security manager exists and its checkSecurityAccess method doesn't allow returning a string describing this identity.
See Also: SecurityManager.checkSecurityAccess(java.lang.String),

  Returns a string representation of this identity, with optionally more details than that provided by the toString method without any arguments.

  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.
Returns: information about this identity. If detailed is true, then this method returns more information than that provided by the toString method without any arguments.
Parameters:
- detailed - whether or not to provide detailed information.
Throws:
- SecurityException - if a security manager exists and its checkSecurityAccess method doesn't allow returning a string describing this identity.
See Also: Identity.toString(), SecurityManager.checkSecurityAccess(java.lang.String),