org.eclipse.xtext.findReferences

Interface IReferenceFinder

All Known Implementing Classes:

ReferenceFinder

public interface IReferenceFinder

Finds cross-references to elements specified by their URIs. References can be from other resources or local. To be referrable from another resource, an element usually has to be indexed. By default, the index keeps track of cross resource references. See DefaultResourceDescriptionStrategy for details on the indexing process. Local references are usually not indexed, and they don't have to be as the scope provider usually takes local elements into account. This is why the reference finder needs an IReferenceFinder.IResourceAccess if such local references should be found, too.

Since:

2.7

Author:

Jan Koehnlein - Initial contribution and API in xtext.ui, Sebastian Zarnekow - Extracted headless API

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	IReferenceFinder.Acceptor Used to collect the results.
static interface	IReferenceFinder.IResourceAccess Provides safe read access to a resource set for searching local references or references in a demand-created or shared resource set.

Method Summary

Methods

Modifier and Type	Method and Description
void	findAllReferences(TargetURIs targetURIs, IReferenceFinder.IResourceAccess resourceAccess, IResourceDescriptions indexData, IReferenceFinder.Acceptor acceptor, org.eclipse.core.runtime.IProgressMonitor monitor) Finds all references to the given targetURIs.
void	findReferences(TargetURIs targetURIs, IResourceDescription resourceDescription, IReferenceFinder.IResourceAccess resourceAccess, IReferenceFinder.Acceptor acceptor, org.eclipse.core.runtime.IProgressMonitor monitor) Finds the references from the given source resource to the given targetURIs.
void	findReferences(TargetURIs targetURIs, org.eclipse.emf.ecore.resource.Resource resource, IReferenceFinder.Acceptor acceptor, org.eclipse.core.runtime.IProgressMonitor monitor) Finds the references from the given source resource to the given targetURIs.
void	findReferences(TargetURIs targetURIs, Set<org.eclipse.emf.common.util.URI> candidates, IReferenceFinder.IResourceAccess resourceAccess, IResourceDescriptions indexData, IReferenceFinder.Acceptor acceptor, org.eclipse.core.runtime.IProgressMonitor monitor) Finds all references from a set of source resources to the given targetURIs.

Method Detail

findReferences

void findReferences(TargetURIs targetURIs,
                  Set<org.eclipse.emf.common.util.URI> candidates,
                  IReferenceFinder.IResourceAccess resourceAccess,
                  IResourceDescriptions indexData,
                  IReferenceFinder.Acceptor acceptor,
                  org.eclipse.core.runtime.IProgressMonitor monitor)

Finds all references from a set of source resources to the given targetURIs.

Parameters:

targetURIs - the URIs of the target elements of the references. Should be normalized.

candidates - the search scope for the resources containing the sources of the references.

resourceAccess - used to find local references. If null, only indexed references are returned.

acceptor - accepts the matches.

monitor - the progress monitor. Can be null.

findReferences

void findReferences(TargetURIs targetURIs,
                  IResourceDescription resourceDescription,
                  IReferenceFinder.IResourceAccess resourceAccess,
                  IReferenceFinder.Acceptor acceptor,
                  org.eclipse.core.runtime.IProgressMonitor monitor)

Finds the references from the given source resource to the given targetURIs.

Parameters:

targetURIs - the URIs of the target elements of the references. Should be normalized.

resourceDescription - the search scope for the resources containing the sources of the references.

resourceAccess - used to find local references. If null, only indexed references are returned.

acceptor - accepts the matches.

monitor - the progress monitor. Can be null.

findReferences

void findReferences(TargetURIs targetURIs,
                  org.eclipse.emf.ecore.resource.Resource resource,
                  IReferenceFinder.Acceptor acceptor,
                  org.eclipse.core.runtime.IProgressMonitor monitor)

Finds the references from the given source resource to the given targetURIs.

Parameters:

targetURIs - the URIs of the target elements of the references. Should be normalized.

resource - the search scope for the resources containing the sources of the references.

acceptor - accepts the matches.

monitor - the progress monitor. Can be null.

findAllReferences

void findAllReferences(TargetURIs targetURIs,
                     IReferenceFinder.IResourceAccess resourceAccess,
                     IResourceDescriptions indexData,
                     IReferenceFinder.Acceptor acceptor,
                     org.eclipse.core.runtime.IProgressMonitor monitor)

Finds all references to the given targetURIs.

Parameters:

targetURIs - the URIs of the target elements of the references. Should be normalized.

resourceAccess - used to find local references. If null, only indexed references are returned.

acceptor - accepts the matches.

monitor - the progress monitor. Can be null.