Package org.tmatesoft.svn.core.wc

## Interface ISVNCommitHandler

- All Known Implementing Classes:
    `DefaultSVNCommitHandler`

      public interface ISVNCommitHandler

  The ISVNCommitHandler should be implemented to provide an ability to manage commit log messages for items to be committed in a common transaction.

  The interface defines the only one method which takes the initial log message and an array of items that are intended for a commit. For example, an implementor's code can process those items and add some generated additional comment to that one passed into the method. There could be plenty of scenarios.

  Since:
    1.2
  Version:
    1.3
  Author:
    TMate Software Ltd.
  See Also:
    `DefaultSVNCommitHandler`

- - ### Method Summary

    All Methods Instance Methods Abstract Methods
    Modifier and Type | Method | Description
    --- | --- | ---
    `java.lang.String` | `getCommitMessage​(java.lang.String message, SVNCommitItem[] commitables)` | Handles the incoming initial log message and items intended for a commit and returns a new commit log message.
    `SVNProperties` | `getRevisionProperties​(java.lang.String message, SVNCommitItem[] commitables, SVNProperties revisionProperties)` | Handles the incoming revision properties and returns filtered revision properties given the paths (represented by `commitables`) collected for committing and the commit log message.

- - ### Method Detail

    - #### getCommitMessage

          java.lang.String getCommitMessage​(java.lang.String message,
                                            SVNCommitItem[] commitables)
                                     throws SVNException

      Handles the incoming initial log message and items intended for a commit and returns a new commit log message.
      Parameters:
        `message` - an initial log message
        `commitables` - an array of items to be committed
      Returns:
        a new log message string or NULL to cancel commit operation.
      Throws:
        `SVNException`

    - #### getRevisionProperties

          SVNProperties getRevisionProperties​(java.lang.String message,
                                              SVNCommitItem[] commitables,
                                              SVNProperties revisionProperties)
                                       throws SVNException

      Handles the incoming revision properties and returns filtered revision properties given the paths (represented by `commitables`) collected for committing and the commit log message.

      Only the returned filtered revision properties will be set on a new committed revision.

      Parameters:
        `message` - log message for commit
        `commitables` - paths to commit
        `revisionProperties` - initial revision properties
      Returns:
        filtered revision properties
      Throws:
        `SVNException`