

PREV CLASS NEXT CLASS  FRAMES NO FRAMES  
SUMMARY: NESTED  FIELD  CONSTR  METHOD  DETAIL: FIELD  CONSTR  METHOD 
java.lang.Object net.rim.device.api.crypto.ECPrivateKey
public final class ECPrivateKey
Represents a private key in an Elliptic Curve (EC) system.
Elliptic Curve cryptography is defined in various standards including P1363 and ANSI X9.62.
ECCryptoSystem
,
ECPublicKey
Constructor Summary  


ECPrivateKey(ECCryptoSystem cryptoSystem,
byte[] data)
Constructs an ECPrivateKey object, representing an Elliptic Curve private key, under the given crypto system
using the specifed data as the private key's mathematical representation. 


ECPrivateKey(ECCryptoSystem cryptoSystem,
CryptoTokenPrivateKeyData cryptoTokenData)
Constructs an ECPrivateKey object under the given crypto system associated with the given crypto token. 
Method Summary  


boolean 
equals(Object obj)
Indicates whether some other object is "equal to" this one. 

String 
getAlgorithm()
Returns the name of the algorithm associated with this key ("EC"). 

CryptoSystem 
getCryptoSystem()
Returns the crypto system associated with the key. 

CryptoTokenPrivateKeyData 
getCryptoTokenData()
Returns the data associated with the crypto token. 

ECCryptoSystem 
getECCryptoSystem()
Returns a reference to EC the crypto system being used with this instance of the private key class. 

ECCryptoToken 
getECCryptoToken()
Returns the EC crypto token associated with the key. 

byte[] 
getPrivateKeyData()
Returns a copy of the private key data. 

byte[] 
getPublicKeyData()
Returns a copy of the public key data which is encoded as an ANSI X9.62 ECPoint object. 

int 
hashCode()
Returns a hash code value for the object. 

void 
verify()
Performs certain integrity checks on the private key parameters. 
Methods inherited from class java.lang.Object 

getClass, notify, notifyAll, toString, wait, wait, wait 
Constructor Detail 

public ECPrivateKey(ECCryptoSystem cryptoSystem, byte[] data) throws InvalidKeyException, CryptoTokenException, CryptoUnsupportedOperationException
ECPrivateKey
object, representing an Elliptic Curve private key, under the given crypto system
using the specifed data as the private key's mathematical representation.
cryptoSystem
 A ECCryptoSystem
object that contains parameters for the ECC computations.data
 The keying material that is to be used for all private key operations. Note that this is an element of the finite field
that the elliptic curve is defined over.
InvalidKeyException
 Thrown if the key data is invalid.
CryptoTokenException
 Thrown if an error occurs with the crypto
token or the crypto token is invalid.
CryptoUnsupportedOperationException
 Thrown if a call is made to
an unsupported operation.public ECPrivateKey(ECCryptoSystem cryptoSystem, CryptoTokenPrivateKeyData cryptoTokenData)
ECPrivateKey
object under the given crypto system associated with the given crypto token.
cryptoSystem
 A ECCryptoSystem
object that contains parameters for the EC computations.cryptoTokenData
 The data associated with the crypto token.Method Detail 

public String getAlgorithm()
This method will always return the String "EC".
getAlgorithm
in interface Key
public ECCryptoSystem getECCryptoSystem()
getECCryptoSystem
in interface ECKey
public CryptoSystem getCryptoSystem()
getCryptoSystem
in interface PrivateKey
CyptoSystem
object.public void verify() throws InvalidKeyException
PrivateKey
verify
in interface PrivateKey
InvalidKeyException
 Thrown if the specified key is improperly
formatted or invalid.public byte[] getPrivateKeyData() throws CryptoTokenException, CryptoUnsupportedOperationException
CryptoTokenException
 Thrown if an error occurs with the crypto
token or the crypto token is invalid.
CryptoUnsupportedOperationException
 Thrown if a call is made to
an unsupported operation.public byte[] getPublicKeyData() throws CryptoTokenException, CryptoUnsupportedOperationException
CryptoTokenException
 Thrown if an error occurs with the crypto
token or the crypto token is invalid.
CryptoUnsupportedOperationException
 Thrown if a call is made to
an unsupported operation.public ECCryptoToken getECCryptoToken()
ECCryptoToken
object.public CryptoTokenPrivateKeyData getCryptoTokenData()
CryptoTokenPrivateKeyData
object.public int hashCode()
Object
java.util.Hashtable
.
The general contract of hashCode
is:
hashCode
method on each of
the two objects must produce the same integer result.
Object.equals(java.lang.Object)
method, then calling the hashCode method on each of the
two objects must produce distinct integer results. However, the
programmer should be aware that producing distinct integer results
for unequal objects may improve the performance of hashtables.
As much as is reasonably practical, the hashCode method defined by class Object does return distinct integers for distinct objects. (This is typically implemented by converting the internal address of the object into an integer, but this implementation technique is not required by the Java^{TM} programming language.)
hashCode
in class Object
Object.equals(java.lang.Object)
,
Hashtable
public boolean equals(Object obj)
Object
The equals
method implements an equivalence relation:
x
,
x.equals(x)
should return true
.
x
and
y
, x.equals(y)
should return
true
if and only if y.equals(x)
returns
true
.
x
,
y
, and z
, if x.equals(y)
returns true
and y.equals(z)
returns
true
, then x.equals(z)
should return
true
.
x
and y
, multiple invocations of x.equals(y)
consistently return true
or consistently return
false
, provided no information used in
equals
comparisons on the object is modified.
x
,
x.equals(null)
should return false
.
The equals method for class Object
implements
the most discriminating possible equivalence relation on objects;
that is, for any reference values x
and y
,
this method returns true
if and only if x
and
y
refer to the same object (x==y
has the
value true
).
equals
in class Object
obj
 the reference object with which to compare.
true
if this object is the same as the obj
argument; false
otherwise.Boolean.hashCode()
,
Hashtable


PREV CLASS NEXT CLASS  FRAMES NO FRAMES  
SUMMARY: NESTED  FIELD  CONSTR  METHOD  DETAIL: FIELD  CONSTR  METHOD 
Copyright 19992011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal