1
0
Fork 0
mirror of https://github.com/pgpainless/pgpainless.git synced 2024-12-23 03:17:58 +01:00

Rename KeyRingUtil.removeSecretKey() to stripSecretKey()

This commit is contained in:
Paul Schaub 2022-04-02 17:03:38 +02:00
parent 50bcb6a135
commit 8ec86e6464
Signed by: vanitasvitae
GPG key ID: 62BEE9264BF17311

View file

@ -430,11 +430,35 @@ public final class KeyRingUtils {
* *
* @throws IOException * @throws IOException
* @throws PGPException * @throws PGPException
*
* @deprecated use {@link #stripSecretKey(PGPSecretKeyRing, long)} instead.
* TODO: Remove in 1.2.X
*/ */
@Nonnull @Nonnull
@Deprecated
public static PGPSecretKeyRing removeSecretKey(@Nonnull PGPSecretKeyRing secretKeys, public static PGPSecretKeyRing removeSecretKey(@Nonnull PGPSecretKeyRing secretKeys,
long secretKeyId) long secretKeyId)
throws IOException, PGPException { throws IOException, PGPException {
return stripSecretKey(secretKeys, secretKeyId);
}
/**
* Remove the secret key of the subkey identified by the given secret key id from the key ring.
* The public part stays attached to the key ring, so that it can still be used for encryption / verification of signatures.
*
* This method is intended to be used to remove secret primary keys from live keys when those are kept in offline storage.
*
* @param secretKeys secret key ring
* @param secretKeyId id of the secret key to remove
* @return secret key ring with removed secret key
*
* @throws IOException
* @throws PGPException
*/
@Nonnull
public static PGPSecretKeyRing stripSecretKey(@Nonnull PGPSecretKeyRing secretKeys,
long secretKeyId)
throws IOException, PGPException {
if (secretKeys.getSecretKey(secretKeyId) == null) { if (secretKeys.getSecretKey(secretKeyId) == null) {
throw new NoSuchElementException("PGPSecretKeyRing does not contain secret key " + Long.toHexString(secretKeyId)); throw new NoSuchElementException("PGPSecretKeyRing does not contain secret key " + Long.toHexString(secretKeyId));
} }