A resource mapping supports the transformation of an application model object into its underlying file system resources. It provides the bridge between a logical element and the physical resource(s) into which it is stored but does not provide more comprehensive model access or manipulations.

Mappings provide two means of model traversal. The accept(ResourceMappingContext, IResourceVisitor, IProgressMonitor) method can be used to visit the resources that constitute the model object. Alternatively, a set or traversals can be obtained by calling getTraversals(ResourceMappingContext, IProgressMonitor) . A traversal contains a set of resources and a depth. This allows clients (such a repository providers) to do optimal traversals of the resources w.r.t. the operation that is being performed on the model object.

This class may be subclassed by clients.