Package jetbrains.buildServer.vcs

Interface VcsRootBasedMappingProvider

All Superinterfaces:

VcsClientMappingProvider, VcsExtension

public interface VcsRootBasedMappingProvider
extends VcsClientMappingProvider

THIS IS AN INTERNAL API, AND IT IS SUBJECT TO CHANGE!

Author:

kir

Method Summary

Modifier and Type	Method	Description
Collection<VcsClientMapping>	getClientMapping(VcsRoot vcsRoot)	This method provides a mapping information from given VcsRoot and a path within it to actual possible VCS paths.

Method Detail

getClientMapping

Collection<VcsClientMapping> getClientMapping(@NotNull
                                              VcsRoot vcsRoot)
                                       throws VcsException

This method provides a mapping information from given VcsRoot and a path within it to actual possible VCS paths. There may be several target paths (for instance, when externals are used in Subversion and multiline client mapping is used for Perforce) This method generates a collection of possible VCS path prefixes, which can be used to create fullPath variable passed to the VcsPersonalSupport.mapFullPath(jetbrains.buildServer.vcs.VcsRootEntry, java.lang.String). In general, this is an identity of the VCS server + path within this server.

Parameters:

vcsRoot - VCS root, whose mapping should be retrieved

Returns:

Mappings in the requested VCS root. Each mapping represents two path-like values. 1: VCS path prefix, 2: target path (relative to VCS root) Note: only UNIX-like slashes are allowed in returning paths

Throws:

VcsException - when there is a problem accessing VCS

Since:

5.0