|
Eclipse JDT 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
A IJavaSearchResultCollector
collects search results from a search
query to a SearchEngine
. Clients must implement this interface and pass
an instance to the search(...)
methods. When a search starts, the aboutToStart()
method is called, then 0 or more call to accept(...)
are done, finally the
done()
method is called.
Results provided to this collector may be accurate - in this case they have an EXACT_MATCH
accuracy -
or they might be potential matches only - they have a POTENTIAL_MATCH
accuracy. This last
case can occur when a problem prevented the SearchEngine
from resolving the match.
The order of the results is unspecified. Clients must not rely on this order to display results, but they should sort these results (e.g. in a syntactical order).
The IJavaSearchResultCollector
is also used to provide a progress monitor to the
SearchEngine
.
Clients may implement this interface.
SearchEngine.search(org.eclipse.core.resources.IWorkspace, java.lang.String, int, int, org.eclipse.jdt.core.search.IJavaSearchScope, org.eclipse.jdt.core.search.IJavaSearchResultCollector)
Field Summary | |
static int |
EXACT_MATCH
The search result corresponds exactly to the search pattern. |
static int |
POTENTIAL_MATCH
The search result is potentially a match for the search pattern, but a problem prevented the search engine from being more accurate (typically because of the classpath was not correctly set). |
Method Summary | |
void |
aboutToStart()
Called before the actual search starts. |
void |
accept(IResource resource,
int start,
int end,
IJavaElement enclosingElement,
int accuracy)
Accepts the given search result. |
void |
done()
Called when the search has ended. |
IProgressMonitor |
getProgressMonitor()
Returns the progress monitor used to report progress. |
Field Detail |
public static final int EXACT_MATCH
public static final int POTENTIAL_MATCH
Method Detail |
public void aboutToStart()
public void accept(IResource resource, int start, int end, IJavaElement enclosingElement, int accuracy) throws CoreException
resource
- the resource in which the match has been foundstart
- the start position of the match, -1 if it is unknownend
- the end position of the match, -1 if it is unknown;
the ending offset is exclusive, meaning that the actual range of characters
covered is [start, end]
enclosingElement
- the Java element that contains the character range
[start, end]
; the value can be null
indicating that
no enclosing Java element has been foundaccuracy
- the level of accuracy the search result has; either
EXACT_MATCH
or POTENTIAL_MATCH
CoreException
- if this collector had a problem accepting the search resultpublic void done()
public IProgressMonitor getProgressMonitor()
|
Eclipse JDT 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |