SVNKit Home

## org.tmatesoft.svn.core
Class SVNLogEntry

    java.lang.Object
      org.tmatesoft.svn.core.SVNLogEntry

All Implemented Interfaces:
  Serializable

public class SVNLogEntry
extends Object
implements Serializable

The SVNLogEntry class encapsulates such per revision information as: a revision number, the datestamp when the revision was committed, the author of the revision, a commit log message and all paths changed in that revision.

Since:
  1.2
Version:
  1.3
Author:
  TMate Software Ltd.
See Also:
  `SVNLogEntryPath`, `ISVNLogEntryHandler`, Examples, Serialized Form

Field Summary
`static SVNLogEntry` `EMPTY_ENTRY` This is a log entry children stop marker use by the `SVNKit` internals.

Constructor Summary
`SVNLogEntry(Map changedPaths, long revision, String author, Date date, String message)` Constructs an SVNLogEntry object.
`SVNLogEntry(Map changedPaths, long revision, SVNProperties revisionProperties, boolean hasChildren)` Constructs an SVNLogEntry object.

Method Summary
`boolean` `equals(Object obj)` Compares this object with another one.
`String` `getAuthor()` Returns the author of the revision that this object represents.
`Map` `getChangedPaths()` Gets a map containing all the paths that were changed in the revision that this object represents.
`Date` `getDate()` Gets the datestamp when the revision was committed.
`String` `getMessage()` Gets the log message attached to the revision.
`long` `getRevision()` Gets the number of the revision that this object represents.
`SVNProperties` `getRevisionProperties()` Returns the requested revision properties, which may be null if it would contain no revision properties.
`boolean` `hasChildren()` Tells whether or not this log entry has children.
`int` `hashCode()` Calculates and returns a hash code for this object.
`void` `setHasChildren(boolean hasChildren)` Sets wheteher this log entry has children entries or not.
`String` `toString()` Gives a string representation of this oobject.

Methods inherited from class java.lang.Object
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

Field Detail

### EMPTY_ENTRY

    public static SVNLogEntry EMPTY_ENTRY

  This is a log entry children stop marker use by the `SVNKit` internals. Users should not compare the log entry received in their `ISVNLogEntryHandler` implementations with this one. Instead, to find the end of the log entry children sequence they should check the log entry's revision for validity (i.e. that it is not less than `0`).

  Since:
    1.2.0

Constructor Detail

### SVNLogEntry

    public SVNLogEntry(Map changedPaths,
                       long revision,
                       String author,
                       Date date,
                       String message)

  Constructs an SVNLogEntry object.

Parameters:
  `changedPaths` - a map collection which keys are all the paths that were changed in `revision`, and values are SVNLogEntryPath representation objects
  `revision` - a revision number
  `author` - the author of `revision`
  `date` - the datestamp when the revision was committed
  `message` - an commit log message for `revision`
See Also:
  `SVNLogEntryPath`

### SVNLogEntry

    public SVNLogEntry(Map changedPaths,
                       long revision,
                       SVNProperties revisionProperties,
                       boolean hasChildren)

  Constructs an SVNLogEntry object.

Parameters:
  `changedPaths` - a map collection which keys are all the paths that were changed in `revision`, and values are SVNLogEntryPath representation objects
  `revision` - a revision number
  `revisionProperties` - revision properties
  `hasChildren` - whether this entry has children or not
Since:
  1.2.0

Method Detail

### setHasChildren

    public void setHasChildren(boolean hasChildren)

  Sets wheteher this log entry has children entries or not.

  Note: this method is not intended for API users.

  Parameters:
    `hasChildren` - whether this entry has has children or not
  Since:
    1.2.0
  See Also:
    `hasChildren()`

### getChangedPaths

    public Map getChangedPaths()

  Gets a map containing all the paths that were changed in the revision that this object represents.

  Returns:
    a `String` to `SVNLogEntryPath` map which keys are all the paths that were changed in the revision and values represent information about each changed path

### getAuthor

    public String getAuthor()

  Returns the author of the revision that this object represents.

  Returns:
    the author of the revision

### getDate

    public Date getDate()

  Gets the datestamp when the revision was committed.

  Returns:
    the moment in time when the revision was committed

### getMessage

    public String getMessage()

  Gets the log message attached to the revision.

  Returns:
    the commit log message

### getRevisionProperties

    public SVNProperties getRevisionProperties()

  Returns the requested revision properties, which may be null if it would contain no revision properties.

  Returns:
    revision properties
  Since:
    1.2.0

### getRevision

    public long getRevision()

  Gets the number of the revision that this object represents.

  Returns:
    a revision number

### hashCode

    public int hashCode()

  Calculates and returns a hash code for this object.

  Returns:
    a hash code

### equals

    public boolean equals(Object obj)

  Compares this object with another one.

  Parameters:
    `obj` - an object to compare with
  Returns:
    true if this object is the same as the `obj` argument

### toString

    public String toString()

  Gives a string representation of this oobject.

  Returns:
    a string representing this object

### hasChildren

    public boolean hasChildren()

  Tells whether or not this log entry has children.

  When a log operation requests additional merge information, extra log entries may be returned as a result of this entry. The new entries, are considered children of the original entry, and will follow it. When the HAS_CHILDREN flag is set, the receiver should increment its stack depth, and wait until an entry is provided with `SVNRepository.INVALID_REVISION` which indicates the end of the children.

  For log operations which do not request additional merge information, the HAS_CHILDREN flag is always false.

  Also for more information see: Subversion documentation

  Returns:
    true if this log entry has children entries due to merge-tracking information
  Since:
    1.2.0, new in Subversion 1.5.0

SVNKit Home

Copyright © 2004-2009 TMate Software Ltd. All Rights Reserved.