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>
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.
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
https://www.eclipse.org/legal/epl-v10.html
