Module org.eclipse.jgit

Package org.eclipse.jgit.api

Class VerifySignatureCommand

java.lang.Object

org.eclipse.jgit.api.GitCommand<Map<String,VerificationResult>>

org.eclipse.jgit.api.VerifySignatureCommand

All Implemented Interfaces:

Callable<Map<String,VerificationResult>>

public class VerifySignatureCommand
extends GitCommand<Map<String,VerificationResult>>

A command to verify GPG signatures on tags or commits.

Since:

5.11

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	VerifySignatureCommand.VerifyMode	Describes what kind of objects shall be handled by a VerifySignatureCommand.

Field Summary

Fields inherited from class org.eclipse.jgit.api.GitCommand

repo

Constructor Summary

Constructors

Constructor	Description
VerifySignatureCommand(Repository repo)	Creates a new VerifySignatureCommand for the given Repository.

Method Summary

Modifier and Type	Method	Description
VerifySignatureCommand	addName(String name)	Add a name of an object (SHA-1, ref name; anything that can be resolved) to the command to have its signature verified.
VerifySignatureCommand	addNames(String... names)	Add names of objects (SHA-1, ref name; anything that can be resolved) to the command to have their signatures verified.
VerifySignatureCommand	addNames(Collection<String> names)	Add names of objects (SHA-1, ref name; anything that can be resolved) to the command to have their signatures verified.
Map<String,VerificationResult>	call()	Resolves all names added to the command to git objects and verifies their signature.
VerifySignatureCommand	setGpgConfig(GpgConfig config)	Sets an external GpgConfig to use.
VerifySignatureCommand	setMode(VerifySignatureCommand.VerifyMode mode)	Sets the mode of operation for this command.

Methods inherited from class org.eclipse.jgit.api.GitCommand

checkCallable, getRepository, setCallable

Methods inherited from class java.lang.Object

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

Constructor Details

VerifySignatureCommand

public VerifySignatureCommand(Repository repo)

Creates a new VerifySignatureCommand for the given Repository.

Parameters:

repo - to operate on

Method Details

addName

public VerifySignatureCommand addName(String name)

Add a name of an object (SHA-1, ref name; anything that can be resolved) to the command to have its signature verified.

Parameters:

name - to add

Returns:

this

addNames

public VerifySignatureCommand addNames(String... names)

Add names of objects (SHA-1, ref name; anything that can be resolved) to the command to have their signatures verified.

Parameters:

names - to add; duplicates will be ignored

Returns:

this

addNames

public VerifySignatureCommand addNames(Collection<String> names)

Add names of objects (SHA-1, ref name; anything that can be resolved) to the command to have their signatures verified.

Parameters:

names - to add; duplicates will be ignored

Returns:

this

setMode

public VerifySignatureCommand setMode(@NonNull
 VerifySignatureCommand.VerifyMode mode)

Sets the mode of operation for this command.

Parameters:

mode - the VerifySignatureCommand.VerifyMode to set

Returns:

this

setGpgConfig

public VerifySignatureCommand setGpgConfig(GpgConfig config)

Sets an external GpgConfig to use.

Parameters:

config - to set; if null, the config will be loaded from the git config of the repository

Returns:

this

Since:

5.11

call

@NonNull
public Map<String,VerificationResult> call()
                                    throws ServiceUnavailableException,
WrongObjectTypeException

Resolves all names added to the command to git objects and verifies their signature. Non-existing objects are ignored.

Depending on the setMode(VerifyMode), only tags or commits or any kind of objects are allowed.

Unsigned objects are silently skipped.

Specified by:

call in interface Callable<Map<String,VerificationResult>>

Specified by:

call in class GitCommand<Map<String,VerificationResult>>

Returns:

a map of the given names to the corresponding VerificationResult, excluding ignored or skipped objects.

Throws:

WrongObjectTypeException - if a name resolves to an object of a type not allowed by the setMode(VerifyMode) mode

ServiceUnavailableException