BaseReceivePack (JGit - Core 5.4.3.201909031940-r API)

java.lang.Object
- org.eclipse.jgit.transport.BaseReceivePack

Direct Known Subclasses:

ReceivePack
```
public abstract class BaseReceivePack
extends Object
```
Base implementation of the side of a push connection that receives objects.
Contains high-level operations for initializing and closing streams, advertising refs, reading commands, and receiving and applying a pack. Subclasses compose these operations into full service implementations.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`BaseReceivePack.FirstLine` Deprecated. Use `FirstCommand` instead.
`protected static class`	`BaseReceivePack.ReceiveConfig` Configuration for receive operations.

Field Summary

Fields
Modifier and Type	Field and Description
`protected OutputStream`	`msgOut` Optional message output stream.
`protected PacketLineIn`	`pckIn` Packet line input stream around `rawIn`.
`protected PacketLineOut`	`pckOut` Packet line output stream around `rawOut`.
`protected InputStream`	`rawIn` Raw input stream.
`protected OutputStream`	`rawOut` Raw output stream.

Constructor Summary

Constructors
Modifier Constructor and Description

protected BaseReceivePack(Repository into)
Create a new pack receive for an open repository.

Constructors
Modifier	Constructor and Description
`protected`	`BaseReceivePack(Repository into)` Create a new pack receive for an open repository.

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`protected boolean`	`anyRejects()` Whether any commands have been rejected so far.
`protected void`	`close()` Close and flush (if necessary) the underlying streams.
`protected void`	`enableCapabilities()` Enable capabilities based on a previously read capabilities line.
`protected void`	`executeCommands()` Execute commands to update references.
`protected void`	`failPendingCommands()` Set the result to fail for any command that was not processed yet.
`protected List<ReceiveCommand>`	`filterCommands(ReceiveCommand.Result want)` Filter the list of commands according to result.
`Set<ObjectId>`	`getAdvertisedObjects()` Get objects advertised to the client.
`protected Map<String,Ref>`	`getAdvertisedOrDefaultRefs()` Get advertised refs, or the default if not explicitly advertised.
`abstract Map<String,Ref>`	`getAdvertisedRefs()` Deprecated. use `ReceivePack.getAdvertisedRefs()`
`AdvertiseRefsHook`	`getAdvertiseRefsHook()` Get the hook used while advertising the refs to the client
`List<ReceiveCommand>`	`getAllCommands()` Get all of the command received by the current request.
`protected Set<ObjectId>`	`getClientShallowCommits()` Get the commits from the client's shallow file.
`protected abstract String`	`getLockMessageProcessName()` Get the process name used for pack lock messages.
`OutputStream`	`getMessageOutputStream()` Get an underlying stream for sending messages to the client.
`long`	`getPackSize()` Get the size of the received pack file including the index size.
`String`	`getPeerUserAgent()` Get the user agent of the client.
`abstract PushCertificate`	`getPushCertificate()` Deprecated. use `ReceivePack.getPushCertificate()`.
`ReceivedPackStatistics`	`getReceivedPackStatistics()` Returns the statistics on the received pack if available.
`RefFilter`	`getRefFilter()` Get the filter used while advertising the refs to the client
`PersonIdent`	`getRefLogIdent()` Get identity of the user making the changes in the reflog.
`abstract Repository`	`getRepository()` Deprecated. use `ReceivePack.getRepository()`
`abstract RevWalk`	`getRevWalk()` Deprecated. use `ReceivePack.getRevWalk()`
`int`	`getTimeout()` Get timeout (in seconds) before aborting an IO operation.
`protected boolean`	`hasCommands()` Whether any commands to be executed have been read.
`protected boolean`	`hasError()` Whether an error occurred that should be advertised.
`protected void`	`init(InputStream input, OutputStream output, OutputStream messages)` Initialize the instance with the given streams.
`boolean`	`isAllowBranchDeletes()` Whether the client can delete from `refs/heads/`.
`boolean`	`isAllowCreates()` Whether the client can request refs to be created.
`boolean`	`isAllowDeletes()` Whether the client can request refs to be deleted.
`boolean`	`isAllowNonFastForwards()` Whether the client can request non-fast-forward updates of a ref, possibly making objects unreachable.
`boolean`	`isAllowPushOptions()` Whether the server supports receiving push options.
`boolean`	`isAllowQuiet()` Whether clients may request avoiding noisy progress messages.
`boolean`	`isAtomic()` Whether the client's commands should be performed as a single atomic transaction.
`boolean`	`isBiDirectionalPipe()` Whether this class expects a bi-directional pipe opened between the client and itself.
`protected boolean`	`isCapabilityEnabled(String name)` Check if the peer requested a capability.
`boolean`	`isCheckReceivedObjects()` Whether this instance will verify received objects are formatted correctly.
`boolean`	`isCheckReferencedObjectsAreReachable()` Whether this instance will validate all referenced, but not supplied by the client, objects are reachable from another reference.
`boolean`	`isExpectDataAfterPackFooter()` Whether there is data expected after the pack footer.
`boolean`	`isQuiet()` True if the client wants less verbose output.
`boolean`	`isSideBand()` Check whether the client expects a side-band stream.
`protected boolean`	`needPack()` Whether a pack is expected based on the list of commands.
`protected void`	`receivePackAndCheckConnectivity()` Receive a pack from the stream and check connectivity if necessary.
`protected void`	`recvCommands()` Receive a list of commands from the input.
`protected void`	`release()` Release any resources used by this object.
`void`	`sendAdvertisedRefs(RefAdvertiser adv)` Generate an advertisement of available refs and capabilities.
`void`	`sendError(String what)` Send an error message to the client.
`void`	`sendMessage(String what)` Send a message to the client, if it supports receiving them.
`protected void`	`sendStatusReport(boolean forClient, Throwable unpackError, org.eclipse.jgit.transport.BaseReceivePack.Reporter out)` Send a status report.
`abstract void`	`setAdvertisedRefs(Map<String,Ref> allRefs, Set<ObjectId> additionalHaves)` Deprecated. use `ReceivePack.setAdvertisedRefs(java.util.Map<java.lang.String, org.eclipse.jgit.lib.Ref>, java.util.Set<org.eclipse.jgit.lib.ObjectId>)`
`void`	`setAdvertiseRefsHook(AdvertiseRefsHook advertiseRefsHook)` Set the hook used while advertising the refs to the client.
`void`	`setAllowBranchDeletes(boolean canDelete)` Configure whether to permit deletion of branches from the `refs/heads/` namespace.
`void`	`setAllowCreates(boolean canCreate)` Whether to permit create ref commands to be processed.
`void`	`setAllowDeletes(boolean canDelete)` Whether to permit delete ref commands to be processed.
`void`	`setAllowNonFastForwards(boolean canRewind)` Configure whether to permit the client to ask for non-fast-forward updates of an existing ref.
`void`	`setAllowPushOptions(boolean allow)` Configure if the server supports receiving push options.
`void`	`setAllowQuiet(boolean allow)` Configure if clients may request the server skip noisy messages.
`void`	`setAtomic(boolean atomic)` Configure whether to perform the client's commands as a single atomic transaction.
`void`	`setBiDirectionalPipe(boolean twoWay)` Whether this class will assume the socket is a fully bidirectional pipe between the two peers and takes advantage of that by first transmitting the known refs, then waiting to read commands.
`void`	`setCheckReceivedObjects(boolean check)` Whether to enable checking received objects
`void`	`setCheckReferencedObjectsAreReachable(boolean b)` Validate all referenced but not supplied objects are reachable.
`void`	`setExpectDataAfterPackFooter(boolean e)` Whether there is additional data in InputStream after pack.
`void`	`setMaxCommandBytes(long limit)` Set the maximum number of command bytes to read from the client.
`void`	`setMaxCommandDiscardBytes(long limit)` Set the maximum number of command bytes to discard from the client.
`void`	`setMaxObjectSizeLimit(long limit)` Set the maximum allowed Git object size.
`void`	`setMaxPackSizeLimit(long limit)` Set the maximum allowed pack size.
`void`	`setObjectChecker(ObjectChecker impl)` Set the object checking instance to verify each received object with
`abstract void`	`setPushCertificate(PushCertificate cert)` Deprecated. use `ReceivePack.setPushCertificate(PushCertificate)`.
`void`	`setRefFilter(RefFilter refFilter)` Set the filter used while advertising the refs to the client.
`void`	`setRefLogIdent(PersonIdent pi)` Set the identity of the user appearing in the affected reflogs.
`void`	`setSignedPushConfig(SignedPushConfig cfg)` Set the configuration for push certificate verification.
`void`	`setTimeout(int seconds)` Set the timeout before willing to abort an IO call.
`protected void`	`unlockPack()` Unlock the pack written by this object.
`protected void`	`validateCommands()` Validate the command list.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - rawIn
```
protected InputStream rawIn
```
    Raw input stream.
  - rawOut
```
protected OutputStream rawOut
```
    Raw output stream.
  - msgOut
```
protected OutputStream msgOut
```
    Optional message output stream.
  - pckIn
```
protected PacketLineIn pckIn
```
    Packet line input stream around rawIn.
  - pckOut
```
protected PacketLineOut pckOut
```
    Packet line output stream around rawOut.
- Constructor Detail
  - BaseReceivePack
```
protected BaseReceivePack(Repository into)
```
    Create a new pack receive for an open repository.
    
    Parameters:
    
    into - the destination repository.
- Method Detail
  - getPushCertificate
```
@Deprecated
public abstract PushCertificate getPushCertificate()
```
    Deprecated. use ReceivePack.getPushCertificate().
    
    Get the push certificate used to verify the pusher's identity.
    Only valid after commands are read from the wire.
    
    Returns:
    
    the parsed certificate, or null if push certificates are disabled or no cert was presented by the client.
    
    Since:
    
    4.1
  - setPushCertificate
```
@Deprecated
public abstract void setPushCertificate(PushCertificate cert)
```
    Deprecated. use ReceivePack.setPushCertificate(PushCertificate).
    
    Set the push certificate used to verify the pusher's identity.
    Should only be called if reconstructing an instance without going through the normal recvCommands() flow.
    
    Parameters:
    
    cert - the push certificate to set.
    
    Since:
    
    4.1
  - getLockMessageProcessName
```
protected abstract String getLockMessageProcessName()
```
    Get the process name used for pack lock messages.
    
    Returns:
    
    the process name used for pack lock messages.
  - getRepository
```
@Deprecated
public abstract Repository getRepository()
```
    Deprecated. use ReceivePack.getRepository()
    
    Get the repository this receive completes into.
    
    Returns:
    
    the repository this receive completes into.
  - getRevWalk
```
@Deprecated
public abstract RevWalk getRevWalk()
```
    Deprecated. use ReceivePack.getRevWalk()
    
    Get the RevWalk instance used by this connection.
    
    Returns:
    
    the RevWalk instance used by this connection.
  - getAdvertisedRefs
```
@Deprecated
public abstract Map<String,Ref> getAdvertisedRefs()
```
    Deprecated. use ReceivePack.getAdvertisedRefs()
    
    Get refs which were advertised to the client.
    
    Returns:
    
    all refs which were advertised to the client, or null if setAdvertisedRefs(Map, Set) has not been called yet.
  - setAdvertisedRefs
```
@Deprecated
public abstract void setAdvertisedRefs(Map<String,Ref> allRefs,
                                                   Set<ObjectId> additionalHaves)
```
    Deprecated. use ReceivePack.setAdvertisedRefs(java.util.Map<java.lang.String, org.eclipse.jgit.lib.Ref>, java.util.Set<org.eclipse.jgit.lib.ObjectId>)
    
    Set the refs advertised by this ReceivePack.
    Intended to be called from a PreReceiveHook.
    
    Parameters:
    
    allRefs - explicit set of references to claim as advertised by this ReceivePack instance. This overrides any references that may exist in the source repository. The map is passed to the configured getRefFilter(). If null, assumes all refs were advertised.
    
    additionalHaves - explicit set of additional haves to claim as advertised. If null, assumes the default set of additional haves from the repository.
  - getAdvertisedObjects
```
public final Set<ObjectId> getAdvertisedObjects()
```
    Get objects advertised to the client.
    
    Returns:
    
    the set of objects advertised to the as present in this repository, or null if setAdvertisedRefs(Map, Set) has not been called yet.
  - isCheckReferencedObjectsAreReachable
```
public boolean isCheckReferencedObjectsAreReachable()
```
    Whether this instance will validate all referenced, but not supplied by the client, objects are reachable from another reference.
    
    Returns:
    
    true if this instance will validate all referenced, but not supplied by the client, objects are reachable from another reference.
  - setCheckReferencedObjectsAreReachable
```
public void setCheckReferencedObjectsAreReachable(boolean b)
```
    Validate all referenced but not supplied objects are reachable.
    If enabled, this instance will verify that references to objects not contained within the received pack are already reachable through at least one other reference displayed as part of getAdvertisedRefs().
    This feature is useful when the application doesn't trust the client to not provide a forged SHA-1 reference to an object, in an attempt to access parts of the DAG that they aren't allowed to see and which have been hidden from them via the configured AdvertiseRefsHook or RefFilter.
    Enabling this feature may imply at least some, if not all, of the same functionality performed by setCheckReceivedObjects(boolean). Applications are encouraged to enable both features, if desired.
    
    Parameters:
    
    b - true to enable the additional check.
  - isBiDirectionalPipe
```
public boolean isBiDirectionalPipe()
```
    Whether this class expects a bi-directional pipe opened between the client and itself.
    
    Returns:
    
    true if this class expects a bi-directional pipe opened between the client and itself. The default is true.
  - setBiDirectionalPipe
```
public void setBiDirectionalPipe(boolean twoWay)
```
    Whether this class will assume the socket is a fully bidirectional pipe between the two peers and takes advantage of that by first transmitting the known refs, then waiting to read commands.
    
    Parameters:
    
    twoWay - if true, this class will assume the socket is a fully bidirectional pipe between the two peers and takes advantage of that by first transmitting the known refs, then waiting to read commands. If false, this class assumes it must read the commands before writing output and does not perform the initial advertising.
  - isExpectDataAfterPackFooter
```
public boolean isExpectDataAfterPackFooter()
```
    Whether there is data expected after the pack footer.
    
    Returns:
    
    true if there is data expected after the pack footer.
  - setExpectDataAfterPackFooter
```
public void setExpectDataAfterPackFooter(boolean e)
```
    Whether there is additional data in InputStream after pack.
    
    Parameters:
    
    e - true if there is additional data in InputStream after pack.
  - isCheckReceivedObjects
```
public boolean isCheckReceivedObjects()
```
    Whether this instance will verify received objects are formatted correctly.
    
    Returns:
    
    true if this instance will verify received objects are formatted correctly. Validating objects requires more CPU time on this side of the connection.
  - setCheckReceivedObjects
```
public void setCheckReceivedObjects(boolean check)
```
    Whether to enable checking received objects
    
    Parameters:
    
    check - true to enable checking received objects; false to assume all received objects are valid.
    
    See Also:
    
    setObjectChecker(ObjectChecker)
  - setObjectChecker
```
public void setObjectChecker(ObjectChecker impl)
```
    Set the object checking instance to verify each received object with
    
    Parameters:
    
    impl - if non-null the object checking instance to verify each received object with; null to disable object checking.
    
    Since:
    
    3.4
  - isAllowCreates
```
public boolean isAllowCreates()
```
    Whether the client can request refs to be created.
    
    Returns:
    
    true if the client can request refs to be created.
  - setAllowCreates
```
public void setAllowCreates(boolean canCreate)
```
    Whether to permit create ref commands to be processed.
    
    Parameters:
    
    canCreate - true to permit create ref commands to be processed.
  - isAllowDeletes
```
public boolean isAllowDeletes()
```
    Whether the client can request refs to be deleted.
    
    Returns:
    
    true if the client can request refs to be deleted.
  - setAllowDeletes
```
public void setAllowDeletes(boolean canDelete)
```
    Whether to permit delete ref commands to be processed.
    
    Parameters:
    
    canDelete - true to permit delete ref commands to be processed.
  - isAllowBranchDeletes
```
public boolean isAllowBranchDeletes()
```
    Whether the client can delete from refs/heads/.
    
    Returns:
    
    true if the client can delete from refs/heads/.
    
    Since:
    
    3.6
  - setAllowBranchDeletes
```
public void setAllowBranchDeletes(boolean canDelete)
```
    Configure whether to permit deletion of branches from the refs/heads/ namespace.
    
    Parameters:
    
    canDelete - true to permit deletion of branches from the refs/heads/ namespace.
    
    Since:
    
    3.6
  - isAllowNonFastForwards
```
public boolean isAllowNonFastForwards()
```
    Whether the client can request non-fast-forward updates of a ref, possibly making objects unreachable.
    
    Returns:
    
    true if the client can request non-fast-forward updates of a ref, possibly making objects unreachable.
  - setAllowNonFastForwards
```
public void setAllowNonFastForwards(boolean canRewind)
```
    Configure whether to permit the client to ask for non-fast-forward updates of an existing ref.
    
    Parameters:
    
    canRewind - true to permit the client to ask for non-fast-forward updates of an existing ref.
  - isAtomic
```
public boolean isAtomic()
```
    Whether the client's commands should be performed as a single atomic transaction.
    
    Returns:
    
    true if the client's commands should be performed as a single atomic transaction.
    
    Since:
    
    4.4
  - setAtomic
```
public void setAtomic(boolean atomic)
```
    Configure whether to perform the client's commands as a single atomic transaction.
    
    Parameters:
    
    atomic - true to perform the client's commands as a single atomic transaction.
    
    Since:
    
    4.4
  - getRefLogIdent
```
public PersonIdent getRefLogIdent()
```
    Get identity of the user making the changes in the reflog.
    
    Returns:
    
    identity of the user making the changes in the reflog.
  - setRefLogIdent
```
public void setRefLogIdent(PersonIdent pi)
```
    Set the identity of the user appearing in the affected reflogs.
    The timestamp portion of the identity is ignored. A new identity with the current timestamp will be created automatically when the updates occur and the log records are written.
    
    Parameters:
    
    pi - identity of the user. If null the identity will be automatically determined based on the repository configuration.
  - getAdvertiseRefsHook
```
public AdvertiseRefsHook getAdvertiseRefsHook()
```
    Get the hook used while advertising the refs to the client
    
    Returns:
    
    the hook used while advertising the refs to the client
  - getRefFilter
```
public RefFilter getRefFilter()
```
    Get the filter used while advertising the refs to the client
    
    Returns:
    
    the filter used while advertising the refs to the client
  - setAdvertiseRefsHook
```
public void setAdvertiseRefsHook(AdvertiseRefsHook advertiseRefsHook)
```
    Set the hook used while advertising the refs to the client.
    If the AdvertiseRefsHook chooses to call setAdvertisedRefs(Map,Set), only refs set by this hook and selected by the RefFilter will be shown to the client. Clients may still attempt to create or update a reference not advertised by the configured AdvertiseRefsHook. These attempts should be rejected by a matching PreReceiveHook.
    
    Parameters:
    
    advertiseRefsHook - the hook; may be null to show all refs.
  - setRefFilter
```
public void setRefFilter(RefFilter refFilter)
```
    Set the filter used while advertising the refs to the client.
    Only refs allowed by this filter will be shown to the client. The filter is run against the refs specified by the AdvertiseRefsHook (if applicable).
    
    Parameters:
    
    refFilter - the filter; may be null to show all refs.
  - getTimeout
```
public int getTimeout()
```
    Get timeout (in seconds) before aborting an IO operation.
    
    Returns:
    
    timeout (in seconds) before aborting an IO operation.
  - setTimeout
```
public void setTimeout(int seconds)
```
    Set the timeout before willing to abort an IO call.
    
    Parameters:
    
    seconds - number of seconds to wait (with no data transfer occurring) before aborting an IO read or write operation with the connected client.
  - setMaxCommandBytes
```
public void setMaxCommandBytes(long limit)
```
    Set the maximum number of command bytes to read from the client.
    
    Parameters:
    
    limit - command limit in bytes; if 0 there is no limit.
    
    Since:
    
    4.7
  - setMaxCommandDiscardBytes
```
public void setMaxCommandDiscardBytes(long limit)
```
    Set the maximum number of command bytes to discard from the client.
    Discarding remaining bytes allows this instance to consume the rest of the command block and send a human readable over-limit error via the side-band channel. If the client sends an excessive number of bytes this limit kicks in and the instance disconnects, resulting in a non-specific 'pipe closed', 'end of stream', or similar generic error at the client.
    When the limit is set to -1 the implementation will default to the larger of 3 * maxCommandBytes or 3 MiB.
    
    Parameters:
    
    limit - discard limit in bytes; if 0 there is no limit; if -1 the implementation tries to set a reasonable default.
    
    Since:
    
    4.7
  - setMaxObjectSizeLimit
```
public void setMaxObjectSizeLimit(long limit)
```
    Set the maximum allowed Git object size.
    If an object is larger than the given size the pack-parsing will throw an exception aborting the receive-pack operation.
    
    Parameters:
    
    limit - the Git object size limit. If zero then there is not limit.
  - setMaxPackSizeLimit
```
public void setMaxPackSizeLimit(long limit)
```
    Set the maximum allowed pack size.
    A pack exceeding this size will be rejected.
    
    Parameters:
    
    limit - the pack size limit, in bytes
    
    Since:
    
    3.3
  - isSideBand
```
public boolean isSideBand()
                   throws RequestNotYetReadException
```
    Check whether the client expects a side-band stream.
    
    Returns:
    
    true if the client has advertised a side-band capability, false otherwise.
    
    Throws:
    
    RequestNotYetReadException - if the client's request has not yet been read from the wire, so we do not know if they expect side-band. Note that the client may have already written the request, it just has not been read.
  - isAllowQuiet
```
public boolean isAllowQuiet()
```
    Whether clients may request avoiding noisy progress messages.
    
    Returns:
    
    true if clients may request avoiding noisy progress messages.
    
    Since:
    
    4.0
  - setAllowQuiet
```
public void setAllowQuiet(boolean allow)
```
    Configure if clients may request the server skip noisy messages.
    
    Parameters:
    
    allow - true to allow clients to request quiet behavior; false to refuse quiet behavior and send messages anyway. This may be necessary if processing is slow and the client-server network connection can timeout.
    
    Since:
    
    4.0
  - isAllowPushOptions
```
public boolean isAllowPushOptions()
```
    Whether the server supports receiving push options.
    
    Returns:
    
    true if the server supports receiving push options.
    
    Since:
    
    4.5
  - setAllowPushOptions
```
public void setAllowPushOptions(boolean allow)
```
    Configure if the server supports receiving push options.
    
    Parameters:
    
    allow - true to optionally accept option strings from the client.
    
    Since:
    
    4.5
  - isQuiet
```
public boolean isQuiet()
                throws RequestNotYetReadException
```
    True if the client wants less verbose output.
    
    Returns:
    
    true if the client has requested the server to be less verbose.
    
    Throws:
    
    RequestNotYetReadException - if the client's request has not yet been read from the wire, so we do not know if they expect side-band. Note that the client may have already written the request, it just has not been read.
    
    Since:
    
    4.0
  - setSignedPushConfig
```
public void setSignedPushConfig(SignedPushConfig cfg)
```
    Set the configuration for push certificate verification.
    
    Parameters:
    
    cfg - new configuration; if this object is null or its SignedPushConfig.getCertNonceSeed() is null, push certificate verification will be disabled.
    
    Since:
    
    4.1
  - getPeerUserAgent
```
public String getPeerUserAgent()
```
    Get the user agent of the client.
    If the client is new enough to use agent= capability that value will be returned. Older HTTP clients may also supply their version using the HTTP User-Agent header. The capability overrides the HTTP header if both are available.
    When an HTTP request has been received this method returns the HTTP User-Agent header value until capabilities have been parsed.
    
    Returns:
    
    user agent supplied by the client. Available only if the client is new enough to advertise its user agent.
    
    Since:
    
    4.0
  - getAllCommands
```
public List<ReceiveCommand> getAllCommands()
```
    Get all of the command received by the current request.
    
    Returns:
    
    all of the command received by the current request.
  - sendError
```
public void sendError(String what)
```
    Send an error message to the client.
    If any error messages are sent before the references are advertised to the client, the errors will be sent instead of the advertisement and the receive operation will be aborted. All clients should receive and display such early stage errors.
    If the reference advertisements have already been sent, messages are sent in a side channel. If the client doesn't support receiving messages, the message will be discarded, with no other indication to the caller or to the client.
    PreReceiveHooks should always try to use ReceiveCommand.setResult(Result, String) with a result status of ReceiveCommand.Result.REJECTED_OTHER_REASON to indicate any reasons for rejecting an update. Messages attached to a command are much more likely to be returned to the client.
    
    Parameters:
    
    what - string describing the problem identified by the hook. The string must not end with an LF, and must not contain an LF.
  - sendMessage
```
public void sendMessage(String what)
```
    Send a message to the client, if it supports receiving them.
    If the client doesn't support receiving messages, the message will be discarded, with no other indication to the caller or to the client.
    
    Parameters:
    
    what - string describing the problem identified by the hook. The string must not end with an LF, and must not contain an LF.
  - getMessageOutputStream
```
public OutputStream getMessageOutputStream()
```
    Get an underlying stream for sending messages to the client.
    
    Returns:
    
    an underlying stream for sending messages to the client.
  - getPackSize
```
public long getPackSize()
```
    Get the size of the received pack file including the index size. This can only be called if the pack is already received.
    
    Returns:
    
    the size of the received pack including index size
    
    Throws:
    
    IllegalStateException - if called before the pack has been received
    
    Since:
    
    3.3
  - getClientShallowCommits
```
protected Set<ObjectId> getClientShallowCommits()
```
    Get the commits from the client's shallow file.
    
    Returns:
    
    if the client is a shallow repository, the list of edge commits that define the client's shallow boundary. Empty set if the client is earlier than Git 1.9, or is a full clone.
    
    Since:
    
    3.5
  - hasCommands
```
protected boolean hasCommands()
```
    Whether any commands to be executed have been read.
    
    Returns:
    
    true if any commands to be executed have been read.
  - hasError
```
protected boolean hasError()
```
    Whether an error occurred that should be advertised.
    
    Returns:
    
    true if an error occurred that should be advertised.
  - init
```
protected void init(InputStream input,
                    OutputStream output,
                    OutputStream messages)
```
    Initialize the instance with the given streams.
    
    Parameters:
    
    input - raw input to read client commands and pack data from. Caller must ensure the input is buffered, otherwise read performance may suffer.
    
    output - response back to the Git network client. Caller must ensure the output is buffered, otherwise write performance may suffer.
    
    messages - secondary "notice" channel to send additional messages out through. When run over SSH this should be tied back to the standard error channel of the command execution. For most other network connections this should be null.
  - getAdvertisedOrDefaultRefs
```
protected Map<String,Ref> getAdvertisedOrDefaultRefs()
```
    Get advertised refs, or the default if not explicitly advertised.
    
    Returns:
    
    advertised refs, or the default if not explicitly advertised.
  - receivePackAndCheckConnectivity
```
protected void receivePackAndCheckConnectivity()
                                        throws IOException
```
    Receive a pack from the stream and check connectivity if necessary.
    
    Throws:
    
    IOException - an error occurred during unpacking or connectivity checking.
  - unlockPack
```
protected void unlockPack()
                   throws IOException
```
    Unlock the pack written by this object.
    
    Throws:
    
    IOException - the pack could not be unlocked.
  - sendAdvertisedRefs
```
public void sendAdvertisedRefs(RefAdvertiser adv)
                        throws IOException,
                               ServiceMayNotContinueException
```
    Generate an advertisement of available refs and capabilities.
    
    Parameters:
    
    adv - the advertisement formatter.
    
    Throws:
    
    IOException - the formatter failed to write an advertisement.
    
    ServiceMayNotContinueException - the hook denied advertisement.
  - getReceivedPackStatistics
```
@Nullable
public ReceivedPackStatistics getReceivedPackStatistics()
```
    Returns the statistics on the received pack if available. This should be called after receivePack() is called.
    
    Returns:
    
    ReceivedPackStatistics
    
    Since:
    
    4.6
  - recvCommands
```
protected void recvCommands()
                     throws IOException
```
    Receive a list of commands from the input.
    
    Throws:
    
    IOException
  - enableCapabilities
```
protected void enableCapabilities()
```
    Enable capabilities based on a previously read capabilities line.
  - isCapabilityEnabled
```
protected boolean isCapabilityEnabled(String name)
```
    Check if the peer requested a capability.
    
    Parameters:
    
    name - protocol name identifying the capability.
    
    Returns:
    
    true if the peer requested the capability to be enabled.
  - needPack
```
protected boolean needPack()
```
    Whether a pack is expected based on the list of commands.
    
    Returns:
    
    true if a pack is expected based on the list of commands.
  - validateCommands
```
protected void validateCommands()
```
    Validate the command list.
  - anyRejects
```
protected boolean anyRejects()
```
    Whether any commands have been rejected so far.
    
    Returns:
    
    if any commands have been rejected so far.
    
    Since:
    
    3.6
  - failPendingCommands
```
protected void failPendingCommands()
```
    Set the result to fail for any command that was not processed yet.
    
    Since:
    
    3.6
  - filterCommands
```
protected List<ReceiveCommand> filterCommands(ReceiveCommand.Result want)
```
    Filter the list of commands according to result.
    
    Parameters:
    
    want - desired status to filter by.
    
    Returns:
    
    a copy of the command list containing only those commands with the desired status.
  - executeCommands
```
protected void executeCommands()
```
    Execute commands to update references.
  - sendStatusReport
```
protected void sendStatusReport(boolean forClient,
                                Throwable unpackError,
                                org.eclipse.jgit.transport.BaseReceivePack.Reporter out)
                         throws IOException
```
    Send a status report.
    
    Parameters:
    
    forClient - true if this report is for a Git client, false if it is for an end-user.
    
    unpackError - an error that occurred during unpacking, or null
    
    out - the reporter for sending the status strings.
    
    Throws:
    
    IOException - an error occurred writing the status report.
  - close
```
protected void close()
              throws IOException
```
    Close and flush (if necessary) the underlying streams.
    
    Throws:
    
    IOException
  - release
```
protected void release()
                throws IOException
```
    Release any resources used by this object.
    
    Throws:
    
    IOException - the pack could not be unlocked.

Class BaseReceivePack

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

rawIn

rawOut

msgOut

pckIn

pckOut

Constructor Detail

BaseReceivePack

Method Detail

getPushCertificate

setPushCertificate

getLockMessageProcessName

getRepository

getRevWalk

getAdvertisedRefs

setAdvertisedRefs

getAdvertisedObjects

isCheckReferencedObjectsAreReachable

setCheckReferencedObjectsAreReachable

isBiDirectionalPipe

setBiDirectionalPipe

isExpectDataAfterPackFooter

setExpectDataAfterPackFooter

isCheckReceivedObjects

setCheckReceivedObjects

setObjectChecker

isAllowCreates

setAllowCreates

isAllowDeletes

setAllowDeletes

isAllowBranchDeletes

setAllowBranchDeletes

isAllowNonFastForwards

setAllowNonFastForwards

isAtomic

setAtomic

getRefLogIdent

setRefLogIdent

getAdvertiseRefsHook

getRefFilter

setAdvertiseRefsHook

setRefFilter

getTimeout

setTimeout

setMaxCommandBytes

setMaxCommandDiscardBytes

setMaxObjectSizeLimit

setMaxPackSizeLimit

isSideBand

isAllowQuiet

setAllowQuiet

isAllowPushOptions

setAllowPushOptions

isQuiet

setSignedPushConfig

getPeerUserAgent

getAllCommands

sendError

sendMessage

getMessageOutputStream

getPackSize

getClientShallowCommits

hasCommands

hasError

init

getAdvertisedOrDefaultRefs

receivePackAndCheckConnectivity

unlockPack

sendAdvertisedRefs

getReceivedPackStatistics

recvCommands

enableCapabilities

isCapabilityEnabled

needPack