Class SvnAnnotate

All Implemented Interfaces:
ISvnObjectReceiver<SvnAnnotateItem>, ISvnOperationOptionsProvider

public class SvnAnnotate extends SvnReceivingOperation<SvnAnnotateItem>
Represents annotate operation. Obtains and reports annotation information for each line-blame item associated with revision endRevision of target, using startRevision as the default source of all blame. Passes annotation information to a annotation handler if provided.

Target can represent URL or working copy path (used to get corresponding URLs).

Target's pegRevision indicates in which revision target is valid. If pegRevision is SVNRevision.UNDEFINED, then it defaults to SVNRevision.HEAD.

  • If working copy is SVN 1.7 working copy:

    If endRevision is SVNRevision.UNDEFINED, then it defaults to SVNRevision.HEAD if target is URL or SVNRevision.WORKING if target is working copy path.

  • If working copy is SVN 1.6 working copy:

    If startRevision is null or invalid, then it defaults to revision 1. If endRevision is null or invalid, then it defaults to target's pegRevision.

Note: this operation requires repository access.

SvnOperation.run() method returns SvnAnnotateItem information reported by the operation. SvnOperation.run() throws SVNException in the following cases:

Version:
1.7
  • Field Details

    • useMergeHistory

      private boolean useMergeHistory
    • ignoreMimeType

      private boolean ignoreMimeType
    • handler

      private ISVNAnnotateHandler handler
    • startRevision

      private SVNRevision startRevision
    • endRevision

      private SVNRevision endRevision
    • inputEncoding

      private String inputEncoding
    • diffOptions

      private SVNDiffOptions diffOptions
  • Constructor Details

  • Method Details

    • getHandler

      public ISVNAnnotateHandler getHandler()
      Gets the caller's handler to process annotation information.
      Returns:
      handler to process annotation information if set
    • setHandler

      public void setHandler(ISVNAnnotateHandler handler)
      Sets the caller's handler to process annotation information.
      Parameters:
      handler - handler to process annotation information
    • isUseMergeHistory

      public boolean isUseMergeHistory()
      Gets whether or not data based upon revisions which have been merged to targets also should be returned.
      Returns:
      true if merged history should be used, otherwise false
    • setUseMergeHistory

      public void setUseMergeHistory(boolean useMergeHistory)
      Sets whether or not data based upon revisions which have been merged to targets also should be returned.
      Parameters:
      useMergeHistory - true if merged history should be use, otherwise false
    • isIgnoreMimeType

      public boolean isIgnoreMimeType()
      Gets whether or not operation should be run on all files treated as text, no matter what SVNKit has inferred from the mime-type property.
      Returns:
      true if mime types should be ignored, otherwise false
    • setIgnoreMimeType

      public void setIgnoreMimeType(boolean ignoreMimeType)
      Sets whether or not operation should be run on all files treated as text, no matter what SVNKit has inferred from the mime-type property.
      Parameters:
      ignoreMimeType - true if mime types should be ignored, otherwise false
    • getStartRevision

      public SVNRevision getStartRevision()
      Gets the revision of the operation to start from.
      Returns:
      revision to start from
    • setStartRevision

      public void setStartRevision(SVNRevision startRevision)
      Sets the revision of the operation to start from.
      Parameters:
      startRevision - revision to start from
    • getEndRevision

      public SVNRevision getEndRevision()
      Gets the revision of the operation to end with.
      Returns:
      revision to end with
    • setEndRevision

      public void setEndRevision(SVNRevision endRevision)
      Sets the revision of the operation to end with.
      Parameters:
      endRevision - revision to end with
    • getInputEncoding

      public String getInputEncoding()
      Gets the name of character set to decode input bytes.
      Returns:
      name of character set
    • setInputEncoding

      public void setInputEncoding(String inputEncoding)
      Sets the name of character set to decode input bytes.
      Parameters:
      inputEncoding - name of character set
    • getDiffOptions

      public SVNDiffOptions getDiffOptions()
      Gets diff options for the operation.
      Returns:
      diff options
    • setDiffOptions

      public void setDiffOptions(SVNDiffOptions diffOptions)
      Sets diff options for the operation.
      Parameters:
      diffOptions - diff options
    • isChangesWorkingCopy

      public boolean isChangesWorkingCopy()
      Gets whether the operation changes working copy
      Overrides:
      isChangesWorkingCopy in class SvnOperation<SvnAnnotateItem>
      Returns:
      true if the operation changes the working copy, otherwise false