org.tmatesoft.svn.core.wc

Class SVNCommitItem

public class SVNCommitItem extends Object

The SVNCommitItem represents a versioned item that is to be committed to a repository.

Used to wrap information about a versioned item into a single object. A commit item can represent either a Working Copy item (speaking of committing local changes in WC files and directories) or one that is located in a repository (for example, when deleting a file/directory right from a repository).

When you call SVNCommitClient's (File[], boolean, boolean, boolean) doCollectCommitItems() this methods processes the specified paths and collects information on items to be committed in SVNCommitItem objects which are packed into a single SVNCommitPacket object. This object is returned by the method to the caller.

Version: 1.1.1

Author: TMate Software Ltd.

See Also:

Constructor Summary
SVNCommitItem(File file, SVNURL URL, SVNURL copyFromURL, SVNNodeKind kind, SVNRevision revision, SVNRevision copyFromRevision, boolean isAdded, boolean isDeleted, boolean isPropertiesModified, boolean isContentsModified, boolean isCopied, boolean locked)
Constructs and initializes an SVNCommitItem object.
Method Summary
SVNRevisiongetCopyFromRevision()
Gets the revision of the versioned item's ancestor from which the item was copied.
SVNURLgetCopyFromURL()
Gets the repository location of the versioned item's ancestor from which the item was copied.
FilegetFile()
Gets the location of the Working Copy item.
SVNNodeKindgetKind()
Gets the node kind of the versioned item.
StringgetPath()
Gets the item's relevant path.
SVNRevisiongetRevision()
Gets the revision of the versioned item .
SVNURLgetURL()
Gets the versioned item's repository location.
SVNWCAccessgetWCAccess()
This method is not intended for users (from an API point of view).
booleanisAdded()
Determines if the item is to be added to version control.
booleanisContentsModified()
Determines if the Working Copy item has local edits to its contents.
booleanisCopied()
Determines if the item is to be added to version control with history.
booleanisDeleted()
Determines if the item is to be deleted from version control.
booleanisLocked()
Determines whether the item needs to be locked.
booleanisPropertiesModified()
Determines if the Working Copy item has local edits to properties.
voidsetPath(String path)
Sets the item's relevant path.

Constructor Detail

SVNCommitItem

public SVNCommitItem(File file, SVNURL URL, SVNURL copyFromURL, SVNNodeKind kind, SVNRevision revision, SVNRevision copyFromRevision, boolean isAdded, boolean isDeleted, boolean isPropertiesModified, boolean isContentsModified, boolean isCopied, boolean locked)
Constructs and initializes an SVNCommitItem object.

Parameters: file a WC item's location URL the item's repository location copyFromURL the repository location of the item's ancestor (if the item was or to be copied) kind the item's node kind revision the item's revision copyFromRevision the revision of the item's ancestor it's copied from isAdded true if the item is to be added to version control, otherwise false isDeleted true if the item is to be deleted from version control, otherwise false isPropertiesModified true if the item's properties have local changes, otherwise false isContentsModified true if the item's contents (file contents or directory entries) have local changes, otherwise false isCopied true if the item is to be added to version control with history, otherwise false locked true if the item is to be locked, otherwise false

Method Detail

getCopyFromRevision

public SVNRevision getCopyFromRevision()
Gets the revision of the versioned item's ancestor from which the item was copied.

Returns: the revision the item was copied from

getCopyFromURL

public SVNURL getCopyFromURL()
Gets the repository location of the versioned item's ancestor from which the item was copied.

Returns: the URL of the copy source in an SVNURL representation

getFile

public File getFile()
Gets the location of the Working Copy item.

Returns: the item's local path

getKind

public SVNNodeKind getKind()
Gets the node kind of the versioned item.

Returns: the item's node kind

getPath

public String getPath()
Gets the item's relevant path. The path is relevant to the Working Copy root.

Returns: the item's relevant path

getRevision

public SVNRevision getRevision()
Gets the revision of the versioned item . For a WC item it is the current working revision.

Returns: the revision of the item to be committed

getURL

public SVNURL getURL()
Gets the versioned item's repository location.

Returns: the item's URL pointing to its repository location

getWCAccess

public SVNWCAccess getWCAccess()
This method is not intended for users (from an API point of view).

Returns: wc access object

isAdded

public boolean isAdded()
Determines if the item is to be added to version control.

Returns: true if added, otherwise false

isContentsModified

public boolean isContentsModified()
Determines if the Working Copy item has local edits to its contents. If the item is a file - that is the file contents, a directory - the directory contents (meaning entries).

Returns: true if the contents have local changes, otherwise false

isCopied

public boolean isCopied()
Determines if the item is to be added to version control with history.

Returns: true if added with history (copied in other words), otherwise false

isDeleted

public boolean isDeleted()
Determines if the item is to be deleted from version control.

Returns: true if deleted, otherwise false

isLocked

public boolean isLocked()
Determines whether the item needs to be locked.

Returns: true if locked, otherwise false

isPropertiesModified

public boolean isPropertiesModified()
Determines if the Working Copy item has local edits to properties.

Returns: true if the properties have local changes, otherwise false

setPath

public void setPath(String path)
Sets the item's relevant path.

Parameters: path the item's path relevant to the Working Copy root

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