File	Doc	Category	Size	Date	Package
Signature.java	API Doc	phoneME MR2 API (J2ME)	9641	Wed May 02 18:00:24 BST 2007	com.sun.midp.crypto

Signature

• java.lang.Object

Fields Summary

Constructors Summary
protected Signature() Protected constructor.

Methods Summary
public abstract java.lang.String	getAlgorithm() Gets the signature algorithm. return the algorithm code defined above
public static com.sun.midp.crypto.Signature	getInstance(java.lang.String algorithm) Generates a Signature object that implements the specified digest algorithm. param algorithm the standard name of the algorithm requested. See Appendix A in the Java Cryptography Architecture API Specification & Reference for information about standard algorithm names. return the new Signature object. exception NoSuchAlgorithmException if the algorithm is not available in the environment. if (algorithm == null) { throw new NoSuchAlgorithmException(); } algorithm = algorithm.toUpperCase(); try { Class sigClass; if (algorithm.equals("MD5WITHRSA")) { sigClass = Class.forName("com.sun.midp.crypto.RsaMd5Sig"); } else if (algorithm.equals("SHA1WITHRSA")) { sigClass = Class.forName("com.sun.midp.crypto.RsaShaSig"); } else { throw new NoSuchAlgorithmException(); } return (Signature)sigClass.newInstance(); } catch (Throwable e) { throw new NoSuchAlgorithmException("Provider not found"); }
public abstract int	getLength() Gets the byte length of the signature data. return the byte length of signature data
public abstract void	initSign(PrivateKey theKey) Initializes the Signature object with the appropriate Key for signature creation. param theKey the key object to use for signing exception InvalidKeyException if the key type is inconsistent with the mode or signature implementation.
public abstract void	initVerify(PublicKey theKey) Initializes the Signature object with the appropriate Key for signature verification. param theKey the key object to use for verification exception InvalidKeyException if the key type is inconsistent with the mode or signature implementation.
public int	sign(byte[] outbuf) Generates the signature of all/last input data. A call to this method also resets this signature object to the state it was in when previously initialized via a call to initSign() and the message to sign given via a call to update(). That is, the object is reset and available to sign another message. param outbuf the output buffer to store signature data return number of bytes of signature output in sigBuf exception SignatureException if this signature object is not initialized properly, or outbuf.length is less than the actual signature return sign(outbuf, 0, outbuf.length);
public abstract int	sign(byte[] outbuf, int offset, int len) Generates the signature of all/last input data. A call to this method also resets this signature object to the state it was in when previously initialized via a call to initSign() and the message to sign given via a call to update(). That is, the object is reset and available to sign another message. param outbuf the output buffer to store signature data param offset starting offset within the output buffer at which to begin signature data param len max byte to write to the buffer return number of bytes of signature output in sigBuf exception SignatureException if this signature object is not initialized properly, or len is less than the actual signature
public abstract void	update(byte[] inBuf, int inOff, int inLen) Accumulates a signature of the input data. When this method is used, temporary storage of intermediate results is required. This method should only be used if all the input data required for the signature is not available in one byte array. The sign() or verify() method is recommended whenever possible. param inBuf the input buffer of data to be signed param inOff starting offset within the input buffer for data to be signed param inLen the byte length of data to be signed exception SignatureException if this signature object is not initialized properly.
public boolean	verify(byte[] signature) Verifies the passed-in signature. A call to this method resets this signature object to the state it was in when previously initialized for verification via a call to initVerify(PublicKey). That is, the object is reset and available to verify another signature from the identity whose public key was specified in the call to initVerify. param signature the signature bytes to be verified. return true if the signature was verified, false if not. exception SignatureException if this signature object is not initialized properly, or the passed-in signature is improperly encoded or of the wrong type, etc. return verify(signature, 0, signature.length);
public abstract boolean	verify(byte[] signature, int offset, int length) Verifies the passed-in signature. A call to this method resets this signature object to the state it was in when previously initialized for verification via a call to initVerify(PublicKey). That is, the object is reset and available to verify another signature from the identity whose public key was specified in the call to initVerify. param signature the input buffer containing signature data param offset starting offset within the sigBuf where signature data begins param length byte length of signature data return true if signature verifies, false otherwise exception SignatureException if this signature object is not initialized properly, or the passed-in signature is improperly encoded or of the wrong type, etc.