#
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 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 unsghared 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 CDATA #IMPLIED

metaFilePaths CDATA #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 -
- metaFilePaths -

###### Examples:

    <extension point="org.eclipse.team.core.repository">
      <repository
        class="org.eclipse.myprovider.MyRepositoryProvider"
        typeClass="org.eclipse.myprovider.MyRepositoryProvider"
        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) 2004 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html