Class SvnLog

All Implemented Interfaces:
ISvnObjectReceiver<SVNLogEntry>, ISvnOperationOptionsProvider

public class SvnLog extends SvnReceivingOperation<SVNLogEntry>
Represents log operation. Gets commit log messages with other revision specific information for target' paths(targetPaths) from a repository and returns them as list of SVNLogEntry items. Useful for observing the history of affected paths, author, date and log comments information per revision. Target can represent one repository URL with list of relative paths - targetPaths or many targets representing working copy paths can be provided, and targetPaths should not be set. Operation finds root URL of the working copy paths, and calculates relativetargetPaths for them. Operation creates SVNLogEntry item on each log message from startRevision to endRevision in turn, inclusive (but never creates item on a given log message more than once).

Log entries are created only on messages whose revisions involved a change to some path in targetPaths. Targets' pegRevisions indicates in which revision targetPaths' paths are valid. If target's pegRevision is invalid, it defaults to SVNRevision.WORKING if target is working copy path, or SVNRevision.HEAD if target is URL.

If limit is non-zero, only creates first limit log entries.

If discoverChangedPaths is set, then the changed paths Map argument will be passed to a constructor of SVNLogEntry on each invocation of handler.

If stopOnCopy is set, copy history (if any exists) will not be traversed while harvesting revision logs for each targetPath.

If useMergedHistory is set, log information for revisions which have been merged to targetPaths will also be returned.

Refer to SVNLogEntry.hasChildren() for additional information on how to handle mergeinfo information during a log operation.

If revisionProperties is null, retrieves all revision properties; else, retrieves only the revision properties named in the array (i.e. retrieves none if the array is empty).

For every SvnRevisionRange in revisionRanges: If startRevision is valid but endRevision is not, then endRevision defaults to startRevision. If both startRevision and endRevision are invalid, then endRevision defaults to revision 0, and startRevision defaults either to target's pegRevision in case the latter one is valid, or to SVNRevision.BASE, if it is not.

Important: to avoid an exception with the SVNErrorCode.FS_NO_SUCH_REVISION error code when invoked against an empty repository (i.e. one not containing a revision 1), callers should specify the range SVNRevision.HEAD:0.

If the caller has provided a non-null ISVNEventHandler, it will be called with the SVNEventAction.SKIP event action on any unversioned paths.

Note: this routine requires repository access. SvnOperation.run() method throws SVNException in if one of the following is true:

  • a path is not under version control
  • can not obtain a URL of a working copy path
  • paths contain entries that belong to different repositories
See Also:
  • Field Details

    • limit

      private long limit
    • useMergeHistory

      private boolean useMergeHistory
    • stopOnCopy

      private boolean stopOnCopy
    • discoverChangedPaths

      private boolean discoverChangedPaths
    • targetPaths

      private String[] targetPaths
    • revisionProperties

      private String[] revisionProperties
    • revisionRanges

      private Collection<SvnRevisionRange> revisionRanges
  • Constructor Details

  • Method Details

    • getLimit

      public long getLimit()
      Returns a maximum number of log entries to be processed
      Returns:
      maximum number of entries
    • setLimit

      public void setLimit(long limit)
      Sets a maximum number of log entries to be processed
      Parameters:
      limit - maximum number of entries
    • isUseMergeHistory

      public boolean isUseMergeHistory()
      Returns whether the log information for revisions which have been merged to targetPaths will also be returned.
      Returns:
      true if merged revisions should be also reported, otherwise false
    • setUseMergeHistory

      public void setUseMergeHistory(boolean useMergeHistory)
      Sets whether the log information for revisions which have been merged to targetPaths will also be returned.
      Parameters:
      useMergeHistory - true if merged revisions should be also reported, otherwise false
    • isDiscoverChangedPaths

      public boolean isDiscoverChangedPaths()
      Returns whether to report of all changed paths for every revision being processed If true then the changed paths Map argument will be passed to a constructor of SVNLogEntry.
      Returns:
      true if all changed paths for every revision being processed should be reported, otherwise false
    • setDiscoverChangedPaths

      public void setDiscoverChangedPaths(boolean discoverChangedPaths)
      Sets whether to report of all changed paths for every revision being processed If true then the changed paths Map argument will be passed to a constructor of SVNLogEntry.
      Parameters:
      discoverChangedPaths - true if all changed paths for every revision being processed should be reported, otherwise false
    • isStopOnCopy

      public boolean isStopOnCopy()
      Returns whether to copy history (if any exists) should be traversed while harvesting revision logs for each targetPath.
      Returns:
      true if not to cross copies while traversing history, otherwise copies history will be also included into processing
    • setStopOnCopy

      public void setStopOnCopy(boolean stopOnCopy)
      Sets whether to copy history (if any exists) should be traversed while harvesting revision logs for each targetPath.
      Parameters:
      stopOnCopy - true if not to cross copies while traversing history, otherwise copies history will be also included into processing
    • getRevisionRanges

      public Collection<SvnRevisionRange> getRevisionRanges()
      Returns all revision ranges for those log should be reported.
      Returns:
      collection of SVNRevisionRange objects
    • setRevisionRanges

      public void setRevisionRanges(Collection<SvnRevisionRange> revisionRanges)
      Sets all revision ranges for those log should be reported.
      Parameters:
      revisionRanges - collection of SVNRevisionRange objects
    • getTargetPaths

      public String[] getTargetPaths()
      Returns all relative paths what should be reported for each target.
      Returns:
      relative paths of the target
    • setTargetPaths

      public void setTargetPaths(String[] targetPaths)
      Sets all relative paths what should be reported for each target.
      Parameters:
      targetPaths - relative paths of the target
    • getRevisionProperties

      public String[] getRevisionProperties()
      Returns what properties should be retrieved. If revisionProperties is null, retrieves all revision properties; else retrieves only the revision properties named in the array (i.e. retrieves none if the array is empty).
      Returns:
      array of names of the properties
    • setRevisionProperties

      public void setRevisionProperties(String[] revisionProperties)
      Sets what properties should be retrieved. If revisionProperties is null, retrieves all revision properties; else retrieves only the revision properties named in the array (i.e. retrieves none if the array is empty).
      Parameters:
      revisionProperties - array of names of the properties
    • ensureArgumentsAreValid

      protected void ensureArgumentsAreValid() throws SVNException
      Overrides:
      ensureArgumentsAreValid in class SvnOperation<SVNLogEntry>
      Throws:
      SVNException
    • addRange

      public void addRange(SvnRevisionRange range)
      Adds the revision range to the operation's revision ranges.
      Parameters:
      range - revision range
    • getMaximumTargetsCount

      protected int getMaximumTargetsCount()
      Overrides:
      getMaximumTargetsCount in class SvnOperation<SVNLogEntry>
    • isChangesWorkingCopy

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