# Package org.eclipse.core.resources.mapping

Provides APIs for integrating application models with the workspace

## Package Specification

This package specifies the APIs in the Resources plug-in that are used to integrate application models with the workspace. This API introduces the notion of a `ResourceMapping` that defines the relationship between an application model object and a set of underlying resources, and a `ResourceTraversal` that describes the exact resources corresponding to a given application model object. The relationship between an application model and underlying resources can vary depending a context. This notion is captured by `ResourceMappingContext` and its subclasses.

Since:
  3.2

Interface Summary
IModelProviderDescriptor: A model provider descriptor contains information about a model provider obtained from the plug-in manifest (`plugin.xml`) file.
IResourceChangeDescriptionFactory: This factory is used to build a resource delta that represents a proposed change that can then be passed to the `ResourceChangeValidator.validateChange(IResourceDelta, IProgressMonitor)` method in order to validate the change with any model providers stored in those resources.

Class Summary
CompositeResourceMapping: A resource mapping that obtains the traversals for its model object from a set of child mappings.
ModelProvider: Represents the provider of a logical model.
ModelStatus: A status returned by a model from the resource operation validator.
RemoteResourceMappingContext: A remote mapping context provides a model element with a view of the remote state of local resources as they relate to a repository operation that is in progress.
ResourceChangeValidator: The resource change validator is used to validate that changes made to resources will not adversely affect the models stored in those resources.
ResourceMapping: A resource mapping supports the transformation of an application model object into its underlying file system resources.
ResourceMappingContext: A resource mapping context is provided to a resource mapping when traversing the resources of the mapping.
ResourceTraversal: A resource traversal is simply a set of resources and the depth to which each is to be traversed.