public abstract class

Signer

extends Identity
java.lang.Object
   ↳ java.security.Identity
     ↳ java.security.Signer
Known Direct Subclasses

This class is deprecated.
This class is no longer used. Its functionality has been replaced by java.security.KeyStore, the java.security.cert package, and java.security.Principal.

Class Overview

This class is used to represent an Identity that can also digitally sign data.

The management of a signer's private keys is an important and sensitive issue that should be handled by subclasses as appropriate to their intended use.

See Also

Summary

Public Constructors
Signer(String name)
Creates a signer with the specified identity name.
Signer(String name, IdentityScope scope)
Creates a signer with the specified identity name and scope.
Protected Constructors
Signer()
Creates a signer.
Public Methods
PrivateKey getPrivateKey()
Returns this signer's private key.
final void setKeyPair(KeyPair pair)
Sets the key pair (public key and private key) for this signer.
String toString()
Returns a string of information about the signer.
[Expand]
Inherited Methods
From class java.security.Identity
From class java.lang.Object
From interface java.security.Principal

Public Constructors

public Signer (String name)

Creates a signer with the specified identity name.

Parameters
name the identity name.

public Signer (String name, IdentityScope scope)

Creates a signer with the specified identity name and scope.

Parameters
name the identity name.
scope the scope of the identity.
Throws
KeyManagementException if there is already an identity with the same name in the scope.

Protected Constructors

protected Signer ()

Creates a signer. This constructor should only be used for serialization.

Public Methods

public PrivateKey getPrivateKey ()

Returns this signer's private key.

First, if there is a security manager, its checkSecurityAccess method is called with "getSignerPrivateKey" as its argument to see if it's ok to return the private key.

Returns
  • this signer's private key, or null if the private key has not yet been set.
Throws
SecurityException if a security manager exists and its checkSecurityAccess method doesn't allow returning the private key.

public final void setKeyPair (KeyPair pair)

Sets the key pair (public key and private key) for this signer.

First, if there is a security manager, its checkSecurityAccess method is called with "setSignerKeyPair" as its argument to see if it's ok to set the key pair.

Parameters
pair an initialized key pair.
Throws
InvalidParameterException if the key pair is not properly initialized.
KeyException if the key pair cannot be set for any other reason.
SecurityException if a security manager exists and its checkSecurityAccess method doesn't allow setting the key pair.

public String toString ()

Returns a string of information about the signer.

Returns
  • a string of information about the signer.