Class Signer

java.lang.Object

java.security.Identity

java.security.Signer

All Implemented Interfaces:

Serializable, Principal

@Deprecated(since="1.2",
            forRemoval=true)
public abstract class Signer
extends Identity

Deprecated, for removal: This API element is subject to removal in a future version.

This class is deprecated and subject to removal in a future version of Java SE. It has been replaced by java.security.KeyStore, the java.security.cert package, and java.security.Principal.

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.

Since:

1.1

See Also:

• Identity
• Serialized Form

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Signer()	Deprecated, for removal: This API element is subject to removal in a future version. Creates a Signer.
	Signer(String name)	Deprecated, for removal: This API element is subject to removal in a future version. Creates a Signer with the specified identity name.
	Signer(String name, IdentityScope scope)	Deprecated, for removal: This API element is subject to removal in a future version. Creates a Signer with the specified identity name and scope.

Method Summary

Modifier and Type	Method	Description
PrivateKey	getPrivateKey()	Deprecated, for removal: This API element is subject to removal in a future version. Returns this signer's private key.
final void	setKeyPair(KeyPair pair)	Deprecated, for removal: This API element is subject to removal in a future version. Sets the key pair (public key and private key) for this Signer.
String	toString()	Deprecated, for removal: This API element is subject to removal in a future version. Returns a string of information about the Signer.

Methods declared in class Identity

addCertificate, certificates, equals, getInfo, getName, getPublicKey, getScope, hashCode, identityEquals, removeCertificate, setInfo, setPublicKey, toString

Modifier and Type	Method	Description
void	addCertificate(Certificate certificate)	Deprecated, for removal: This API element is subject to removal in a future version. Adds a certificate for this Identity.
Certificate[]	certificates()	Deprecated, for removal: This API element is subject to removal in a future version. Returns a copy of all the certificates for this Identity.
final boolean	equals(Object identity)	Deprecated, for removal: This API element is subject to removal in a future version. Tests for equality between the specified object and this Identity.
String	getInfo()	Deprecated, for removal: This API element is subject to removal in a future version. Returns general information previously specified for this Identity.
final String	getName()	Deprecated, for removal: This API element is subject to removal in a future version. Returns this identity's name.
PublicKey	getPublicKey()	Deprecated, for removal: This API element is subject to removal in a future version. Returns this identity's public key.
final IdentityScope	getScope()	Deprecated, for removal: This API element is subject to removal in a future version. Returns this identity's scope.
int	hashCode()	Deprecated, for removal: This API element is subject to removal in a future version. Returns the hashcode for this Identity.
protected boolean	identityEquals(Identity identity)	Deprecated, for removal: This API element is subject to removal in a future version. Tests for equality between the specified Identity and this Identity.
void	removeCertificate(Certificate certificate)	Deprecated, for removal: This API element is subject to removal in a future version. Removes a certificate from this Identity.
void	setInfo(String info)	Deprecated, for removal: This API element is subject to removal in a future version. Specifies a general information string for this Identity.
void	setPublicKey(PublicKey key)	Deprecated, for removal: This API element is subject to removal in a future version. Sets this identity's public key.
String	toString(boolean detailed)	Deprecated, for removal: This API element is subject to removal in a future version. Returns a string representation of this Identity, with optionally more details than that provided by the toString method without any arguments.

Methods declared in class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Modifier and Type	Method	Description
protected Object	clone()	Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
protected void	finalize()	Deprecated, for removal: This API element is subject to removal in a future version. May cause performance issues, deadlocks and hangs.
final Class<? extends Object>	getClass()	Answers the unique instance of java.lang.Class which represents the class of the receiver.
final void	notify()	Causes one thread which is waiting on the receiver to be made ready to run.
final void	notifyAll()	Causes all threads which are waiting on the receiver to be made ready to run.
final void	wait()	Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
final void	wait(long time)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
final void	wait(long time, int frac)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

Methods declared in interface Principal

implies

Modifier and Type	Method	Description
default boolean	implies(Subject subject)	Returns true if the specified subject is implied by this Principal.

Constructor Details

Signer

protected Signer()

Deprecated, for removal: This API element is subject to removal in a future version.

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

Signer

public Signer(String name)

Deprecated, for removal: This API element is subject to removal in a future version.

Creates a Signer with the specified identity name.

Parameters:

name - the identity name.

Signer

public Signer(String name,
 IdentityScope scope)
       throws KeyManagementException

Deprecated, for removal: This API element is subject to removal in a future version.

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.

Method Details

getPrivateKey

public PrivateKey getPrivateKey()

Deprecated, for removal: This API element is subject to removal in a future version.

Returns this signer's private key.

Returns:

this signer's private key, or null if the private key has not yet been set.

setKeyPair

public final void setKeyPair(KeyPair pair)
                      throws InvalidParameterException,
KeyException

Deprecated, for removal: This API element is subject to removal in a future version.

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

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.

toString

public String toString()

Deprecated, for removal: This API element is subject to removal in a future version.

Returns a string of information about the Signer.

Specified by:

toString in interface Principal

Overrides:

toString in class Identity

Returns:

a string of information about the Signer.