Team Repository Provider

Identifier:

org.eclipse.team.core.repository

Since:

2.0

Description:

The Team plugin contains the notion of Repositories. The job of a repository is to provide support for sharing resources between Team members. Repositories are configured on a per-project basis. Only one repository can be mapped to a project at a time.

Repositories that extend this extension point can provide implementations for common repository specific rules for resource modifications, moving and deleting. See the following interfaces for more details IFileModificationValidator and MoveDeleteHook.

A Repository type can also be specified in order to provide non-project specific funtionality such as a org.eclipse.team.core.ProjectSetCapability.

Optionally, a repository provider type can designate that it can import projects from a second provider, in the case where the second provider's plugin is not available in the current install. This is provided as a means to support the migration from one provider implementation to another where the resuse of the same id for the two providers was not possible.

A repository provider type can also specify one or more meta-file paths (delimited by comas) that are relative to a parent container. If an unshared project or folder contains files that match all the meta-file paths associated with a repository definition, the method RepositoryProviderType#metaFilesDetected will be invoked with the parent container as an argument. This is done to give the repository type a chance to mark the files team-private and potentially share the project as well. see the javadoc of the above mentioned method for more details.

Configuration Markup:

<!ELEMENT extension (repository)>

<!ATTLIST extension

point CDATA #REQUIRED>

<!ELEMENT repository EMPTY>

<!ATTLIST repository

id CDATA #IMPLIED

class CDATA #REQUIRED

typeClass CDATA #IMPLIED

canImportId IDREF #IMPLIED

metaFilePaths CDATA #IMPLIED

fileSystemScheme IDREF #IMPLIED>

id - an optional identifier of the extension instance
class - the fully-qualified name of a subclass of org.eclipse.team.core.RepositoryProvider.
typeClass - the fully-qualified name of a subclass of org.eclipse.team.core.RepositoryProviderType.
canImportId - ID of another team provider this provider can import from
metaFilePaths - Comma separated list of file paths that are considered to be version control metadata. If any of these files are detected in a newly imported project the provider's Repository Provider Type will be notified so the project can be mapped to the provider.
fileSystemScheme - This field identifies the scheme of a filesystem registered with the org.eclipse.core.filesystem.filesystems extension point

Examples:


<extension point="org.eclipse.team.core.repository">
  <repository
    class="org.eclipse.myprovider.MyRepositoryProvider"
    typeClass="org.eclipse.myprovider.MyRepositoryProviderType"
    id="org.eclipse.myprovider.myProviderID"
    canImportId="org.eclipse.myprovider.myOldProviderID"
    metaFilePaths=".meta/files,.meta/version">
  </repository>
</extension>

API Information:

The value of the class attribute must represent a subclass of org.eclipse.team.core.RepositoryProvider and the value of the typeClass attribute must represent a subclass of org.eclipse.team.core.RepositoryProviderType

Supplied Implementation:

The provided implementation of RepositoryProvider provides helper methods and common code for mapping and unmapping providers to projects. The optional RepositoryProviderType provides project set import and export through a ProjectSetCapability.

Copyright (c) 2005, 2008 IBM Corporation and others. This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-v20.html/ SPDX-License-Identifier: EPL-2.0