org.eclipse.jgit.lib

Class GpgSigner

java.lang.Object

org.eclipse.jgit.lib.GpgSigner

Direct Known Subclasses:

BouncyCastleGpgSigner

public abstract class GpgSigner
extends Object

Creates GPG signatures for Git objects.

Since:

5.3

Constructor Summary

Constructors

Constructor and Description
GpgSigner()

Method Summary

Modifier and Type	Method and Description
static GpgSigner	getDefault() Get the default signer, or null.
static void	setDefault(GpgSigner signer) Set the default signer.
abstract void	sign(CommitBuilder commit, String gpgSigningKey, PersonIdent committer, CredentialsProvider credentialsProvider) Signs the specified commit.

Methods inherited from class java.lang.Object

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

Constructor Detail

GpgSigner

public GpgSigner()

Method Detail

getDefault

public static GpgSigner getDefault()

Get the default signer, or null.

Returns:

the default signer, or null.

setDefault

public static void setDefault(GpgSigner signer)

Set the default signer.

Parameters:

signer - the new default signer, may be null to select no default.

sign

public abstract void sign(@NonNull
                          CommitBuilder commit,
                          String gpgSigningKey,
                          @NonNull
                          PersonIdent committer,
                          CredentialsProvider credentialsProvider)
                   throws CanceledException

Signs the specified commit.

Implementors should obtain the payload for signing from the specified commit via CommitBuilder.build() and create a proper GpgSignature. The generated signature must be set on the specified commit (see CommitBuilder.setGpgSignature(GpgSignature)).

Any existing signature on the commit must be discarded prior obtaining the payload via CommitBuilder.build().

Parameters:

commit - the commit to sign (must not be null and must be complete to allow proper calculation of payload)

gpgSigningKey - the signing key (passed as is to the GPG signing tool)

committer - the signing identity (to help with key lookup)

credentialsProvider - provider to use when querying for signing key credentials (eg. passphrase)

Throws:

CanceledException - when signing was canceled (eg., user aborted when entering passphrase)