org.eclipse.jgit.transport

Class ReceiveCommand

java.lang.Object

org.eclipse.jgit.transport.ReceiveCommand

public class ReceiveCommand
extends Object

A command being processed by BaseReceivePack.

This command instance roughly translates to the server side representation of the RemoteRefUpdate created by the client.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ReceiveCommand.Result Result of the update command.
static class	ReceiveCommand.Type Type of operation requested.

Constructor Summary

Constructors

Constructor and Description
ReceiveCommand(ObjectId oldId, ObjectId newId, String name) Create a new command for BaseReceivePack.
ReceiveCommand(ObjectId oldId, ObjectId newId, String name, ReceiveCommand.Type type) Create a new command for BaseReceivePack.

Method Summary

Modifier and Type	Method and Description
static void	abort(Iterable<ReceiveCommand> commands) Set unprocessed commands as failed due to transaction aborted.
void	disableRefLog() Don't record this update in the ref's associated reflog.
void	execute(BaseReceivePack rp) Execute this command during a receive-pack session.
static List<ReceiveCommand>	filter(Iterable<ReceiveCommand> in, ReceiveCommand.Result want) Filter a collection of commands according to result.
static List<ReceiveCommand>	filter(List<ReceiveCommand> commands, ReceiveCommand.Result want) Filter a list of commands according to result.
String	getMessage()
ObjectId	getNewId()
ObjectId	getOldId()
Ref	getRef()
String	getRefLogMessage() Get the message to include in the reflog.
String	getRefName()
ReceiveCommand.Result	getResult()
ReceiveCommand.Type	getType()
boolean	hasCustomRefLog() Check whether this command has a custom reflog message setting that should override defaults in any containing BatchRefUpdate.
Boolean	isForceRefLog() Check whether the reflog should be written regardless of repo defaults.
boolean	isRefLogDisabled() Check whether log has been disabled by disableRefLog().
boolean	isRefLogIncludingResult() Check whether the reflog message should include the result of the update, such as fast-forward or force-update.
static boolean	isTransactionAborted(ReceiveCommand cmd) Check whether a command failed due to transaction aborted.
void	setForceRefLog(boolean force) Force writing a reflog for the updated ref.
void	setRefLogMessage(String msg, boolean appendStatus) Set the message to include in the reflog.
void	setResult(ReceiveCommand.Result s) Set the status of this command.
void	setResult(ReceiveCommand.Result s, String m) Set the status of this command.
void	setResult(RefUpdate.Result r) Set the result of this command.
String	toString()
void	updateType(RevWalk walk) Update the type of this command by checking for fast-forward.

Methods inherited from class java.lang.Object

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

Constructor Detail

ReceiveCommand

public ReceiveCommand(ObjectId oldId,
                      ObjectId newId,
                      String name)

Create a new command for BaseReceivePack.

Parameters:

oldId - the expected old object id; must not be null. Use ObjectId.zeroId() to indicate a ref creation.

newId - the new object id; must not be null. Use ObjectId.zeroId() to indicate a ref deletion.

name - name of the ref being affected.

ReceiveCommand

public ReceiveCommand(ObjectId oldId,
                      ObjectId newId,
                      String name,
                      ReceiveCommand.Type type)

Create a new command for BaseReceivePack.

Parameters:

oldId - the old object id; must not be null. Use ObjectId.zeroId() to indicate a ref creation.

newId - the new object id; must not be null. Use ObjectId.zeroId() to indicate a ref deletion.

name - name of the ref being affected.

type - type of the command. Must be ReceiveCommand.Type.CREATE if oldId is zero, or ReceiveCommand.Type.DELETE if newId is zero.

Since:

2.0

Method Detail

filter

public static List<ReceiveCommand> filter(Iterable<ReceiveCommand> in,
                                          ReceiveCommand.Result want)

Filter a collection of commands according to result.

Parameters:

in - commands to filter.

want - desired status to filter by.

Returns:

a copy of the command list containing only those commands with the desired status.

Since:

4.2

filter

public static List<ReceiveCommand> filter(List<ReceiveCommand> commands,
                                          ReceiveCommand.Result want)

Filter a list of commands according to result.

Parameters:

commands - commands to filter.

want - desired status to filter by.

Returns:

a copy of the command list containing only those commands with the desired status.

Since:

2.0

abort

public static void abort(Iterable<ReceiveCommand> commands)

Set unprocessed commands as failed due to transaction aborted.

If a command is still ReceiveCommand.Result.NOT_ATTEMPTED it will be set to ReceiveCommand.Result.REJECTED_OTHER_REASON.

Parameters:

commands - commands to mark as failed.

Since:

4.2

isTransactionAborted

public static boolean isTransactionAborted(ReceiveCommand cmd)

Check whether a command failed due to transaction aborted.

Parameters:

cmd - command.

Returns:

whether the command failed due to transaction aborted, as in abort(Iterable).

Since:

4.9

getOldId

public ObjectId getOldId()

Returns:

the old value the client thinks the ref has.

getNewId

public ObjectId getNewId()

Returns:

the requested new value for this ref.

getRefName

public String getRefName()

Returns:

the name of the ref being updated.

getType

public ReceiveCommand.Type getType()

Returns:

the type of this command; see ReceiveCommand.Type.

getRef

public Ref getRef()

Returns:

the ref, if this was advertised by the connection.

getResult

public ReceiveCommand.Result getResult()

Returns:

the current status code of this command.

getMessage

public String getMessage()

Returns:

the message associated with a failure status.

setRefLogMessage

public void setRefLogMessage(String msg,
                             boolean appendStatus)

Set the message to include in the reflog.

Overrides the default set by setRefLogMessage on any containing BatchRefUpdate.

Parameters:

msg - the message to describe this change. If null and appendStatus is false, the reflog will not be updated.

appendStatus - true if the status of the ref change (fast-forward or forced-update) should be appended to the user supplied message.

Since:

4.9

disableRefLog

public void disableRefLog()

Don't record this update in the ref's associated reflog.

Equivalent to setRefLogMessage(null, false).

Since:

4.9

setForceRefLog

public void setForceRefLog(boolean force)

Force writing a reflog for the updated ref.

Parameters:

force - whether to force.

Since:

4.9

hasCustomRefLog

public boolean hasCustomRefLog()

Check whether this command has a custom reflog message setting that should override defaults in any containing BatchRefUpdate.

Does not take into account whether #setForceRefLog(boolean) has been called.

Returns:

whether a custom reflog is set.

Since:

4.9

isRefLogDisabled

public boolean isRefLogDisabled()

Check whether log has been disabled by disableRefLog().

Returns:

true if disabled.

Since:

4.9

getRefLogMessage

@Nullable
public String getRefLogMessage()

Get the message to include in the reflog.

Returns:

message the caller wants to include in the reflog; null if the update should not be logged.

Since:

4.9

isRefLogIncludingResult

public boolean isRefLogIncludingResult()

Check whether the reflog message should include the result of the update, such as fast-forward or force-update.

Returns:

true if the message should include the result.

Since:

4.9

isForceRefLog

@Nullable
public Boolean isForceRefLog()

Check whether the reflog should be written regardless of repo defaults.

Returns:

whether force writing is enabled; null if #setForceRefLog(boolean) was never called.

Since:

4.9

setResult

public void setResult(ReceiveCommand.Result s)

Set the status of this command.

Parameters:

s - the new status code for this command.

setResult

public void setResult(ReceiveCommand.Result s,
                      String m)

Set the status of this command.

Parameters:

s - new status code for this command.

m - optional message explaining the new status.

updateType

public void updateType(RevWalk walk)
                throws IOException

Update the type of this command by checking for fast-forward.

If the command's current type is UPDATE, a merge test will be performed using the supplied RevWalk to determine if getOldId() is fully merged into getNewId(). If some commits are not merged the update type is changed to ReceiveCommand.Type.UPDATE_NONFASTFORWARD.

Parameters:

walk - an instance to perform the merge test with. The caller must allocate and release this object.

Throws:

IOException - either oldId or newId is not accessible in the repository used by the RevWalk. This usually indicates data corruption, and the command cannot be processed.

execute

public void execute(BaseReceivePack rp)

Execute this command during a receive-pack session.

Sets the status of the command as a side effect.

Parameters:

rp - receive-pack session.

Since:

2.0

setResult

public void setResult(RefUpdate.Result r)

Set the result of this command.

Parameters:

r - the new result code for this command.

toString

public String toString()

Overrides:

toString in class Object