org.bouncycastle.openpgp
Class PGPPublicKeyRing

java.lang.Object
  org.bouncycastle.openpgp.PGPKeyRing
      org.bouncycastle.openpgp.PGPPublicKeyRing

public class PGPPublicKeyRing
extends PGPKeyRing

Class to hold a single master public key and its subkeys.

Often PGP keyring files consist of multiple master keys, if you are trying to process or construct one of these you should use the PGPPublicKeyRingCollection class.

Constructor Summary

PGPPublicKeyRing(byte[] encoding)

PGPPublicKeyRing(java.io.InputStream in)

Method Summary

void	encode(java.io.OutputStream outStream)
byte[]	getEncoded()
PGPPublicKey	getPublicKey() Return the first public key in the ring.
PGPPublicKey	getPublicKey(long keyID) Return the public key referred to by the passed in keyID if it is present.
java.util.Iterator	getPublicKeys() Return an iterator containing all the public keys.
static PGPPublicKeyRing	insertPublicKey(PGPPublicKeyRing pubRing, PGPPublicKey pubKey) Returns a new key ring with the public key passed in either added or replacing an existing one.
static PGPPublicKeyRing	removePublicKey(PGPPublicKeyRing pubRing, PGPPublicKey pubKey) Returns a new key ring with the public key passed in removed from the key ring.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PGPPublicKeyRing

public PGPPublicKeyRing(byte[] encoding)
                 throws java.io.IOException

Throws:

java.io.IOException

PGPPublicKeyRing

public PGPPublicKeyRing(java.io.InputStream in)
                 throws java.io.IOException

Throws:

java.io.IOException

Method Detail

getPublicKey

public PGPPublicKey getPublicKey()

Return the first public key in the ring.

Returns:

PGPPublicKey

getPublicKey

public PGPPublicKey getPublicKey(long keyID)

Return the public key referred to by the passed in keyID if it is present.

Parameters:

keyID -

Returns:

PGPPublicKey

getPublicKeys

public java.util.Iterator getPublicKeys()

Return an iterator containing all the public keys.

Returns:

Iterator

getEncoded

public byte[] getEncoded()
                  throws java.io.IOException

Throws:

java.io.IOException

encode

public void encode(java.io.OutputStream outStream)
            throws java.io.IOException

Throws:

java.io.IOException

insertPublicKey

public static PGPPublicKeyRing insertPublicKey(PGPPublicKeyRing pubRing,
                                               PGPPublicKey pubKey)

Returns a new key ring with the public key passed in either added or replacing an existing one.

Parameters:

pubRing - the public key ring to be modified

pubKey - the public key to be inserted.

Returns:

a new keyRing

removePublicKey

public static PGPPublicKeyRing removePublicKey(PGPPublicKeyRing pubRing,
                                               PGPPublicKey pubKey)

Returns a new key ring with the public key passed in removed from the key ring.

Parameters:

pubRing - the public key ring to be modified

pubKey - the public key to be removed.

Returns:

a new keyRing, null if pubKey is not found.