general class to handle a PGP public key object.
addCertification
public static PGPPublicKey addCertification(PGPPublicKey key,
String id,
PGPSignature certification)
Add a certification for an id to the given public key.
key
- the key the certification is to be added to.id
- the id the certification is associated with.certification
- the new certification.
addCertification
public static PGPPublicKey addCertification(PGPPublicKey key,
PGPSignature certification)
Add a revocation or some other key certification to a key.
key
- the key the revocation is to be added to.certification
- the key signature to be added.
- the new changed public key object.
addCertification
public static PGPPublicKey addCertification(PGPPublicKey key,
PGPUserAttributeSubpacketVector userAttributes,
PGPSignature certification)
Add a certification for the given UserAttributeSubpackets to the given public key.
key
- the key the certification is to be added to.userAttributes
- the attributes the certification is associated with.certification
- the new certification.
encode
public void encode(OutputStream outStream)
throws IOException
getAlgorithm
public int getAlgorithm()
Return the algorithm code associated with the public key.
getBitStrength
public int getBitStrength()
Return the strength of the key in bits.
getCreationTime
public Date getCreationTime()
getEncoded
public byte[] getEncoded()
throws IOException
getFingerprint
public byte[] getFingerprint()
Return the fingerprint of the key.
getKey
public PublicKey getKey(String provider)
throws PGPException,
NoSuchProviderException
Return the public key contained in the object.
provider
- provider to construct the key for.
getKeyID
public long getKeyID()
Return the keyID associated with the public key.
getSignatures
public Iterator getSignatures()
Return all signatures/certifications associated with this key.
- an iterator (possibly empty) with all signatures/certifications.
getSignaturesForID
public Iterator getSignaturesForID(String id)
Return any signatures associated with the passed in id.
id
- the id to be matched.
- an iterator of PGPSignature objects.
getSignaturesForUserAttribute
public Iterator getSignaturesForUserAttribute(PGPUserAttributeSubpacketVector userAttributes)
Return an iterator of signatures associated with the passed in user attributes.
userAttributes
- the vector of user attributes to be matched.
- an iterator of PGPSignature objects.
getSignaturesOfType
public Iterator getSignaturesOfType(int signatureType)
Return signatures of the passed in type that are on this key.
signatureType
- the type of the signature to be returned.
- an iterator (possibly empty) of signatures of the given type.
getTrustData
public byte[] getTrustData()
Return the trust data associated with the public key, if present.
- a byte array with trust data, null otherwise.
getUserAttributes
public Iterator getUserAttributes()
Return any user attribute vectors associated with the key.
- an iterator of PGPUserAttributeSubpacketVector objects.
getUserIDs
public Iterator getUserIDs()
Return any userIDs associated with the key.
getValidDays
public int getValidDays()
- number of valid days from creation time - zero means no
expiry.
getValidSeconds
public long getValidSeconds()
- number of valid seconds from creation time - zero means no
expiry.
getVersion
public int getVersion()
isEncryptionKey
public boolean isEncryptionKey()
Return true if this key is marked as suitable for using for encryption.
- true if this key is marked as suitable for using for encryption.
isMasterKey
public boolean isMasterKey()
Return true if this is a master key.
isRevoked
public boolean isRevoked()
Check whether this (sub)key has a revocation signature on it.
- boolean indicating whether this (sub)key has been revoked.
removeCertification
public static PGPPublicKey removeCertification(PGPPublicKey key,
String id)
Remove any certifications associated with a given id on a key.
key
- the key the certifications are to be removed from.id
- the id that is to be removed.
- the re-certified key, null if the id was not found on the key.
removeCertification
public static PGPPublicKey removeCertification(PGPPublicKey key,
String id,
PGPSignature certification)
Remove any certifications associated with a given id on a key.
key
- the key the certifications are to be removed from.id
- the id that the certfication is to be removed from.certification
- the certfication to be removed.
- the re-certified key, null if the certification was not found.
removeCertification
public static PGPPublicKey removeCertification(PGPPublicKey key,
PGPUserAttributeSubpacketVector userAttributes)
Remove any certifications associated with a given user attribute subpacket
on a key.
key
- the key the certifications are to be removed from.userAttributes
- the attributes to be removed.
- the re-certified key, null if the user attribute subpacket was not found on the key.