Interface ISVNEditor
- All Superinterfaces:
ISVNDeltaConsumer
- All Known Subinterfaces:
ISVNReusableEditor
,ISVNUpdateEditor
- All Known Implementing Classes:
DAVCommitEditor
,FSCommitEditor
,SVNAmbientDepthFilterEditor
,SVNAmbientDepthFilterEditor17
,SVNCancellableEditor
,SVNCommitEditor
,SVNDepthFilterEditor
,SvnDiffEditor
,SVNDiffEditor
,SVNDiffEditor17
,SVNDiffStatusEditor
,SVNDumpEditor
,SVNExportEditor
,SvnExternalUpdateEditor
,SVNFileCheckoutEditor
,SVNMergeInfoUtil.ElideMergeInfoEditor
,SvnNgRemoteDiffEditor
,SvnNgRemoteDiffEditor2
,SvnNgRemoteMergeEditor
,SvnNgReposToWcCopy.SVNCopyForeignEditor
,SVNNodeEditor
,SVNRemoteDiffEditor
,SVNRemoteStatusEditor
,SVNRemoteStatusEditor17
,SVNReplicationEditor
,SVNSynchronizeEditor
,SVNUpdateEditor
,SVNUpdateEditor15
,SVNUpdateEditor17
When used for updating (checking out, getting differences or status), an implementor should provide its own appropriate implementation of the ISVNEditor interface along with a reporter baton (ISVNReposrterBaton) to a corresponding method of an SVNRepository driver. Reporter baton will be used to describe the state of local dirs/files - their current revisions, whether a file/dir is deleted or switched. An editor is invoked after the reporter baton finishes its work. It is used to "edit" the state of files/dirs, where "edit" may mean anything: applying changes in updating, switching, checking out (what really changes the state), or handling changes in getting status or differences (what is only used to inform about, show, separately store changes, and so on). The concrete behaviour of the editor is implemented by the provider of that editor.
The other kind of using ISVNEditor is committing changes to a repository.
Here an editor is given to a caller, and the caller himself describes the changes
of local files/dirs. All that collected info is then committed in a single transaction
when a caller invokes the closeEdit()
method of the editor.
For more information on using editors, please, read these on-line articles:
- Since:
- 1.2
- Version:
- 1.3
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionvoid
Aborts the current running editor due to errors occured.void
Indicates that a path is present as a subdirectory in the edit source, but can not be conveyed to the edit consumer (perhaps because of authorization restrictions).void
absentFile
(String path) Indicates that a path is present as a file in the edit source, but can not be conveyed to the edit consumer (perhaps because of authorization restrictions).void
Adds a directory.void
Adds a file.void
changeDirProperty
(String name, SVNPropertyValue value) Changes the value of a property of the currently opened/added directory.void
changeFileProperty
(String path, String propertyName, SVNPropertyValue propertyValue) Changes the value of a property of the currently opened/added file.void
closeDir()
Closes the currently opened directory fixing all changes of its properties and/or entries.Closes this editor finalizing the whole operation the editor was used for.void
Closes the opened file fixing all properties and/or contents changes.void
deleteEntry
(String path, long revision) Deletes an entry.void
Opens a directory.void
Opens a file.void
openRoot
(long revision) Opens the root directory on which the operation was invoked.void
targetRevision
(long revision) Sets the target revision the operation is running for.Methods inherited from interface org.tmatesoft.svn.core.io.ISVNDeltaConsumer
applyTextDelta, textDeltaChunk, textDeltaEnd
-
Method Details
-
targetRevision
Sets the target revision the operation is running for. For example, the target revision to which an update is running.- Parameters:
revision
- a revision number- Throws:
SVNException
-
openRoot
Opens the root directory on which the operation was invoked. All property changes as well as entries adding/deletion will be applied to this root directory. When coming back up to this root (after traversing the entire tree) you should close the root by callingcloseDir()
.- Parameters:
revision
- the revision number of the root directory- Throws:
SVNException
-
deleteEntry
Deletes an entry.In a commit - deletes an entry from a repository. In an update - deletes an entry locally (since it has been deleted in the repository). In a status - informs that an entry has been deleted.
- Parameters:
path
- an entry path relative to the root directory opened byopenRoot()
revision
- the revision number ofpath
- Throws:
SVNException
-
absentDir
Indicates that a path is present as a subdirectory in the edit source, but can not be conveyed to the edit consumer (perhaps because of authorization restrictions).- Parameters:
path
- a dir path relative to the root directory opened byopenRoot()
- Throws:
SVNException
-
absentFile
Indicates that a path is present as a file in the edit source, but can not be conveyed to the edit consumer (perhaps because of authorization restrictions).- Parameters:
path
- a file path relative to the root directory opened byopenRoot()
- Throws:
SVNException
-
addDir
Adds a directory.In a commit - adds a new directory to a repository. In an update - locally adds a directory that was added in the repository. In a status - informs about a new directory scheduled for addition.
If
copyFromPath
is not null then it says thatpath
is copied fromcopyFromPath
located incopyFromRevision
.- Parameters:
path
- a directory path relative to the root directory opened byopenRoot()
copyFromPath
- an ancestor of the added directorycopyFromRevision
- the revision of the ancestor- Throws:
SVNException
-
openDir
Opens a directory. All property changes as well as entries adding/deletion can be applied to this directory.- Parameters:
path
- a directory path relative to the root directory opened byopenRoot()
revision
- the revision of the directory- Throws:
SVNException
-
changeDirProperty
Changes the value of a property of the currently opened/added directory.- Parameters:
name
- the name of a property to be changedvalue
- new property value- Throws:
SVNException
- Since:
- 1.2.0
- See Also:
-
closeDir
Closes the currently opened directory fixing all changes of its properties and/or entries. Closing a directory picks up an editor to a parent directory.- Throws:
SVNException
-
addFile
Adds a file.In a commit - adds a new file to a repository. In an update - locally adds a file that was added in the repository. In a status - informs about a new file scheduled for addition.
If
copyFromPath
is not null then it says thatpath
is copied fromcopyFromPath
located incopyFromRevision
.- Parameters:
path
- a file path relative to the root directory opened byopenRoot()
copyFromPath
- an ancestor of the added filecopyFromRevision
- the revision of the ancestor- Throws:
SVNException
-
openFile
Opens a file. After it's opened, apply delta to its contents or change the file properties.- Parameters:
path
- a file path relative to the root directory opened byopenRoot()
revision
- the revision of the file- Throws:
SVNException
-
changeFileProperty
void changeFileProperty(String path, String propertyName, SVNPropertyValue propertyValue) throws SVNException Changes the value of a property of the currently opened/added file.- Parameters:
path
- file path relative to the root of this editorpropertyName
- property namepropertyValue
- property value- Throws:
SVNException
- Since:
- 1.2.0
-
closeFile
Closes the opened file fixing all properties and/or contents changes.- Parameters:
path
- a file path relative to the root directory opened byopenRoot()
textChecksum
- an MD5 checksum for the modified file- Throws:
SVNException
- if the calculated upon the actual changed contents checksum does not match the expectedtextChecksum
-
closeEdit
Closes this editor finalizing the whole operation the editor was used for. In a commit - sends collected data to commit a transaction.- Returns:
- a committed revision information
- Throws:
SVNException
-
abortEdit
Aborts the current running editor due to errors occured.If an exception is thrown from an editor's method, call this method to abort the editor.
- Throws:
SVNException
-