Class PGPPublicKeyRingCollection

    • Method Detail

      • size

        public int size()
        Return the number of rings in this collection.
        Returns:
        size of the collection
      • getKeyRings

        public Iterator<PGPPublicKeyRing> getKeyRings​(String userID)
                                               throws PGPException
        Return an iterator of the key rings associated with the passed in userID.
        Parameters:
        userID - the user ID to be matched.
        Returns:
        an iterator (possibly empty) of key rings which matched.
        Throws:
        PGPException
      • getKeyRings

        public Iterator<PGPPublicKeyRing> getKeyRings​(String userID,
                                                      boolean matchPartial)
                                               throws PGPException
        Return an iterator of the key rings associated with the passed in userID.

        Parameters:
        userID - the user ID to be matched.
        matchPartial - if true userID need only be a substring of an actual ID string to match.
        Returns:
        an iterator (possibly empty) of key rings which matched.
        Throws:
        PGPException
      • getKeyRings

        public Iterator<PGPPublicKeyRing> getKeyRings​(String userID,
                                                      boolean matchPartial,
                                                      boolean ignoreCase)
                                               throws PGPException
        Return an iterator of the key rings associated with the passed in userID.

        Parameters:
        userID - the user ID to be matched.
        matchPartial - if true userID need only be a substring of an actual ID string to match.
        ignoreCase - if true case is ignored in user ID comparisons.
        Returns:
        an iterator (possibly empty) of key rings which matched.
        Throws:
        PGPException
      • getPublicKey

        public PGPPublicKey getPublicKey​(long keyID)
                                  throws PGPException
        Return the PGP public key associated with the given key id.
        Parameters:
        keyID -
        Returns:
        the PGP public key
        Throws:
        PGPException
      • getPublicKeyRing

        public PGPPublicKeyRing getPublicKeyRing​(long keyID)
                                          throws PGPException
        Return the public key ring which contains the key referred to by keyID.
        Parameters:
        keyID - key ID to match against
        Returns:
        the public key ring
        Throws:
        PGPException
      • getPublicKey

        public PGPPublicKey getPublicKey​(byte[] fingerprint)
                                  throws PGPException
        Return the PGP public key associated with the given key fingerprint.
        Parameters:
        fingerprint - the public key fingerprint to match against.
        Returns:
        the PGP public key matching fingerprint.
        Throws:
        PGPException
      • getPublicKeyRing

        public PGPPublicKeyRing getPublicKeyRing​(byte[] fingerprint)
                                          throws PGPException
        Return the PGP public key associated with the given key fingerprint.
        Parameters:
        fingerprint - the public key fingerprint to match against.
        Returns:
        the PGP public key ring containing the PGP public key matching fingerprint.
        Throws:
        PGPException
      • getKeysWithSignaturesBy

        public Iterator<PGPPublicKey> getKeysWithSignaturesBy​(long keyID)
        Return any keys carrying a signature issued by the key represented by keyID.
        Parameters:
        keyID - the key id to be matched against.
        Returns:
        an iterator (possibly empty) of PGPPublicKey objects carrying signatures from keyID.
      • contains

        public boolean contains​(long keyID)
                         throws PGPException
        Return true if a key matching the passed in key ID is present, false otherwise.
        Parameters:
        keyID - key ID to look for.
        Returns:
        true if keyID present, false otherwise.
        Throws:
        PGPException
      • contains

        public boolean contains​(byte[] fingerprint)
                         throws PGPException
        Return true if a key matching the passed in fingerprint is present, false otherwise.
        Parameters:
        fingerprint - hte key fingerprint to look for.
        Returns:
        true if keyID present, false otherwise.
        Throws:
        PGPException
      • addPublicKeyRing

        public static PGPPublicKeyRingCollection addPublicKeyRing​(PGPPublicKeyRingCollection ringCollection,
                                                                  PGPPublicKeyRing publicKeyRing)
        Return a new collection object containing the contents of the passed in collection and the passed in public key ring.
        Parameters:
        ringCollection - the collection the ring to be added to.
        publicKeyRing - the key ring to be added.
        Returns:
        a new collection merging the current one with the passed in ring.
        Throws:
        IllegalArgumentException - if the keyID for the passed in ring is already present.
      • removePublicKeyRing

        public static PGPPublicKeyRingCollection removePublicKeyRing​(PGPPublicKeyRingCollection ringCollection,
                                                                     PGPPublicKeyRing publicKeyRing)
        Return a new collection object containing the contents of this collection with the passed in public key ring removed.
        Parameters:
        ringCollection - the collection the ring to be removed from.
        publicKeyRing - the key ring to be removed.
        Returns:
        a new collection not containing the passed in ring.
        Throws:
        IllegalArgumentException - if the keyID for the passed in ring not present.