| /******************************************************************************* |
| * Copyright (c) 2000, 2004 IBM Corporation and others. |
| * All rights reserved. This program and the accompanying materials |
| * are made available under the terms of the Common Public License v1.0 |
| * which accompanies this distribution, and is available at |
| * http://www.eclipse.org/legal/cpl-v10.html |
| * |
| * Contributors: |
| * IBM Corporation - initial API and implementation |
| *******************************************************************************/ |
| package org.eclipse.jdt.core.search; |
| |
| import java.util.*; |
| |
| import org.eclipse.core.resources.*; |
| import org.eclipse.core.runtime.*; |
| |
| import org.eclipse.jdt.core.*; |
| import org.eclipse.jdt.core.compiler.CharOperation; |
| import org.eclipse.jdt.internal.compiler.*; |
| import org.eclipse.jdt.internal.compiler.ast.*; |
| import org.eclipse.jdt.internal.compiler.impl.CompilerOptions; |
| import org.eclipse.jdt.internal.compiler.lookup.*; |
| import org.eclipse.jdt.internal.compiler.parser.Parser; |
| import org.eclipse.jdt.internal.compiler.problem.DefaultProblemFactory; |
| import org.eclipse.jdt.internal.compiler.problem.ProblemReporter; |
| import org.eclipse.jdt.internal.core.*; |
| import org.eclipse.jdt.internal.core.search.*; |
| import org.eclipse.jdt.internal.core.search.indexing.*; |
| import org.eclipse.jdt.internal.core.search.matching.*; |
| import org.eclipse.jdt.internal.core.util.Util; |
| |
| /** |
| * A <code>SearchEngine</code> searches for Java elements following a search pattern. |
| * The search can be limited to a search scope. |
| * <p> |
| * Various search patterns can be created using the factory methods |
| * <code>createSearchPattern(String, int, int, boolean)</code>, <code>createSearchPattern(IJavaElement, int)</code>, |
| * <code>createOrSearchPattern(ISearchPattern, ISearchPattern)</code>. |
| * </p> |
| * <p>For example, one can search for references to a method in the hierarchy of a type, |
| * or one can search for the declarations of types starting with "Abstract" in a project. |
| * </p> |
| * <p> |
| * This class may be instantiated; it is not intended to be subclassed. |
| * </p> |
| */ |
| public class SearchEngine { |
| |
| /** |
| * Internal adapter class. |
| * @deprecated marking deprecated as it uses deprecated ISearchPattern |
| */ |
| static class SearchPatternAdapter implements ISearchPattern { |
| SearchPattern pattern; |
| SearchPatternAdapter(SearchPattern pattern) { |
| this.pattern = pattern; |
| } |
| } |
| /** |
| * Internal adapter class. |
| * @deprecated marking deprecated as it uses deprecated IJavaSearchResultCollector |
| */ |
| class ResultCollectorAdapter extends SearchRequestor { |
| IJavaSearchResultCollector resultCollector; |
| ResultCollectorAdapter(IJavaSearchResultCollector resultCollector) { |
| this.resultCollector = resultCollector; |
| } |
| /** |
| * @see org.eclipse.jdt.core.search.SearchRequestor#acceptSearchMatch(org.eclipse.jdt.core.search.SearchMatch) |
| */ |
| public void acceptSearchMatch(SearchMatch match) throws CoreException { |
| this.resultCollector.accept( |
| match.getResource(), |
| match.getOffset(), |
| match.getOffset() + match.getLength(), |
| (IJavaElement) match.getElement(), |
| match.getAccuracy() |
| ); |
| } |
| /** |
| * @see org.eclipse.jdt.core.search.SearchRequestor#beginReporting() |
| */ |
| public void beginReporting() { |
| this.resultCollector.aboutToStart(); |
| } |
| /** |
| * @see org.eclipse.jdt.core.search.SearchRequestor#endReporting() |
| */ |
| public void endReporting() { |
| this.resultCollector.done(); |
| } |
| } |
| |
| /* |
| * A default parser to parse non-reconciled working copies |
| */ |
| private Parser parser; |
| private CompilerOptions compilerOptions; |
| |
| /* |
| * A list of working copies that take precedence over their original |
| * compilation units. |
| */ |
| private ICompilationUnit[] workingCopies; |
| |
| /* |
| * A working copy owner whose working copies will take precedent over |
| * their original compilation units. |
| */ |
| private WorkingCopyOwner workingCopyOwner; |
| |
| /** |
| * For tracing purpose. |
| */ |
| public static boolean VERBOSE = false; |
| |
| /** |
| * Creates a new search engine. |
| */ |
| public SearchEngine() { |
| // will use working copies of PRIMARY owner |
| } |
| |
| /** |
| * Creates a new search engine with a list of working copies that will take precedence over |
| * their original compilation units in the subsequent search operations. |
| * <p> |
| * Note that passing an empty working copy will be as if the original compilation |
| * unit had been deleted.</p> |
| * <p> |
| * Since 3.0 the given working copies take precedence over primary working copies (if any). |
| * |
| * @param workingCopies the working copies that take precedence over their original compilation units |
| * @since 3.0 |
| */ |
| public SearchEngine(ICompilationUnit[] workingCopies) { |
| this.workingCopies = workingCopies; |
| } |
| /** |
| * Creates a new search engine with a list of working copies that will take precedence over |
| * their original compilation units in the subsequent search operations. |
| * <p> |
| * Note that passing an empty working copy will be as if the original compilation |
| * unit had been deleted.</p> |
| * <p> |
| * Since 3.0 the given working copies take precedence over primary working copies (if any). |
| * |
| * @param workingCopies the working copies that take precedence over their original compilation units |
| * @since 2.0 |
| * @deprecated Use {@link #SearchEngine(ICompilationUnit[])} instead. |
| */ |
| public SearchEngine(IWorkingCopy[] workingCopies) { |
| int length = workingCopies.length; |
| System.arraycopy(workingCopies, 0, this.workingCopies = new ICompilationUnit[length], 0, length); |
| } |
| |
| /** |
| * Creates a new search engine with the given working copy owner. |
| * The working copies owned by this owner will take precedence over |
| * the primary compilation units in the subsequent search operations. |
| * |
| * @param workingCopyOwner the owner of the working copies that take precedence over their original compilation units |
| * @since 3.0 |
| */ |
| public SearchEngine(WorkingCopyOwner workingCopyOwner) { |
| this.workingCopyOwner = workingCopyOwner; |
| } |
| |
| /** |
| * Returns a Java search scope limited to the hierarchy of the given type. |
| * The Java elements resulting from a search with this scope will |
| * be types in this hierarchy, or members of the types in this hierarchy. |
| * |
| * @param type the focus of the hierarchy scope |
| * @return a new hierarchy scope |
| * @exception JavaModelException if the hierarchy could not be computed on the given type |
| */ |
| public static IJavaSearchScope createHierarchyScope(IType type) throws JavaModelException { |
| return createHierarchyScope(type, DefaultWorkingCopyOwner.PRIMARY); |
| } |
| |
| /** |
| * Returns a Java search scope limited to the hierarchy of the given type. |
| * When the hierarchy is computed, the types defined in the working copies owned |
| * by the given owner take precedence over the original compilation units. |
| * The Java elements resulting from a search with this scope will |
| * be types in this hierarchy, or members of the types in this hierarchy. |
| * |
| * @param type the focus of the hierarchy scope |
| * @param owner the owner of working copies that take precedence over original compilation units |
| * @return a new hierarchy scope |
| * @exception JavaModelException if the hierarchy could not be computed on the given type |
| * @since 3.0 |
| */ |
| public static IJavaSearchScope createHierarchyScope(IType type, WorkingCopyOwner owner) throws JavaModelException { |
| return new HierarchyScope(type, owner); |
| } |
| |
| /** |
| * Returns a Java search scope limited to the given resources. |
| * The Java elements resulting from a search with this scope will |
| * have their underlying resource included in or equals to one of the given |
| * resources. |
| * <p> |
| * Resources must not overlap, for example, one cannot include a folder and its children. |
| * </p> |
| * |
| * @param resources the resources the scope is limited to |
| * @return a new Java search scope |
| * @deprecated Use {@link #createJavaSearchScope(IJavaElement[])} instead. |
| */ |
| public static IJavaSearchScope createJavaSearchScope(IResource[] resources) { |
| int length = resources.length; |
| IJavaElement[] elements = new IJavaElement[length]; |
| for (int i = 0; i < length; i++) { |
| elements[i] = JavaCore.create(resources[i]); |
| } |
| return createJavaSearchScope(elements); |
| } |
| |
| /** |
| * Returns a Java search scope limited to the given Java elements. |
| * The Java elements resulting from a search with this scope will |
| * be children of the given elements. |
| * <p> |
| * If an element is an IJavaProject, then the project's source folders, |
| * its jars (external and internal) and its referenced projects (with their source |
| * folders and jars, recursively) will be included. |
| * If an element is an IPackageFragmentRoot, then only the package fragments of |
| * this package fragment root will be included. |
| * If an element is an IPackageFragment, then only the compilation unit and class |
| * files of this package fragment will be included. Subpackages will NOT be |
| * included.</p> |
| * <p> |
| * In other words, this is equivalent to using SearchEngine.createJavaSearchScope(elements, true).</p> |
| * |
| * @param elements the Java elements the scope is limited to |
| * @return a new Java search scope |
| * @since 2.0 |
| */ |
| public static IJavaSearchScope createJavaSearchScope(IJavaElement[] elements) { |
| return createJavaSearchScope(elements, true); |
| } |
| |
| /** |
| * Returns a Java search scope limited to the given Java elements. |
| * The Java elements resulting from a search with this scope will |
| * be children of the given elements. |
| * |
| * If an element is an IJavaProject, then the project's source folders, |
| * its jars (external and internal) and - if specified - its referenced projects |
| * (with their source folders and jars, recursively) will be included. |
| * If an element is an IPackageFragmentRoot, then only the package fragments of |
| * this package fragment root will be included. |
| * If an element is an IPackageFragment, then only the compilation unit and class |
| * files of this package fragment will be included. Subpackages will NOT be |
| * included. |
| * |
| * @param elements the Java elements the scope is limited to |
| * @param includeReferencedProjects a flag indicating if referenced projects must be |
| * recursively included |
| * @return a new Java search scope |
| * @since 2.0 |
| */ |
| public static IJavaSearchScope createJavaSearchScope(IJavaElement[] elements, boolean includeReferencedProjects) { |
| int includeMask = IJavaSearchScope.SOURCES | IJavaSearchScope.APPLICATION_LIBRARIES | IJavaSearchScope.SYSTEM_LIBRARIES; |
| if (includeReferencedProjects) { |
| includeMask |= IJavaSearchScope.REFERENCED_PROJECTS; |
| } |
| return createJavaSearchScope(elements, includeMask); |
| } |
| |
| /** |
| * Returns a Java search scope limited to the given Java elements. |
| * The Java elements resulting from a search with this scope will |
| * be children of the given elements. |
| * |
| * If an element is an IJavaProject, then it includes: |
| * - its source folders if IJavaSearchScope.SOURCES is specified, |
| * - its application libraries (internal and external jars, class folders that are on the raw classpath, |
| * or the ones that are coming from a classpath path variable, |
| * or the ones that are coming from a classpath container with the K_APPLICATION kind) |
| * if IJavaSearchScope.APPLICATION_LIBRARIES is specified |
| * - its system libraries (internal and external jars, class folders that are coming from an |
| * IClasspathContainer with the K_SYSTEM kind) |
| * if IJavaSearchScope.APPLICATION_LIBRARIES is specified |
| * - its referenced projects (with their source folders and jars, recursively) |
| * if IJavaSearchScope.REFERENCED_PROJECTS is specified. |
| * If an element is an IPackageFragmentRoot, then only the package fragments of |
| * this package fragment root will be included. |
| * If an element is an IPackageFragment, then only the compilation unit and class |
| * files of this package fragment will be included. Subpackages will NOT be |
| * included. |
| * |
| * @param elements the Java elements the scope is limited to |
| * @param includeMask the bit-wise OR of all include types of interest |
| * @return a new Java search scope |
| * @see IJavaSearchScope#SOURCES |
| * @see IJavaSearchScope#APPLICATION_LIBRARIES |
| * @see IJavaSearchScope#SYSTEM_LIBRARIES |
| * @see IJavaSearchScope#REFERENCED_PROJECTS |
| * @since 3.0 |
| */ |
| public static IJavaSearchScope createJavaSearchScope(IJavaElement[] elements, int includeMask) { |
| JavaSearchScope scope = new JavaSearchScope(); |
| HashSet visitedProjects = new HashSet(2); |
| for (int i = 0, length = elements.length; i < length; i++) { |
| IJavaElement element = elements[i]; |
| if (element != null) { |
| try { |
| if (element instanceof IJavaProject) { |
| scope.add((IJavaProject)element, includeMask, visitedProjects); |
| } else { |
| scope.add(element); |
| } |
| } catch (JavaModelException e) { |
| // ignore |
| } |
| } |
| } |
| return scope; |
| } |
| |
| /** |
| * Returns a search pattern that combines the given two patterns into a "or" pattern. |
| * The search result will match either the left pattern or the right pattern. |
| * |
| * @param leftPattern the left pattern |
| * @param rightPattern the right pattern |
| * @return a "or" pattern |
| * @deprecated Use {@link SearchPattern#createOrPattern(SearchPattern, SearchPattern)} instead. |
| */ |
| public static ISearchPattern createOrSearchPattern(ISearchPattern leftPattern, ISearchPattern rightPattern) { |
| SearchPattern left = ((SearchPatternAdapter) leftPattern).pattern; |
| SearchPattern right = ((SearchPatternAdapter) rightPattern).pattern; |
| SearchPattern pattern = SearchPattern.createOrPattern(left, right); |
| return new SearchPatternAdapter(pattern); |
| } |
| |
| /** |
| * Returns a search pattern based on a given string pattern. The string patterns support '*' wild-cards. |
| * The remaining parameters are used to narrow down the type of expected results. |
| * |
| * <br> |
| * Examples: |
| * <ul> |
| * <li>search for case insensitive references to <code>Object</code>: |
| * <code>createSearchPattern("Object", TYPE, REFERENCES, false);</code></li> |
| * <li>search for case sensitive references to exact <code>Object()</code> constructor: |
| * <code>createSearchPattern("java.lang.Object()", CONSTRUCTOR, REFERENCES, true);</code></li> |
| * <li>search for implementers of <code>java.lang.Runnable</code>: |
| * <code>createSearchPattern("java.lang.Runnable", TYPE, IMPLEMENTORS, true);</code></li> |
| * </ul> |
| * @param stringPattern the given pattern |
| * @param searchFor determines the nature of the searched elements |
| * <ul> |
| * <li><code>IJavaSearchConstants.CLASS</code>: only look for classes</li> |
| * <li><code>IJavaSearchConstants.INTERFACE</code>: only look for interfaces</li> |
| * <li><code>IJavaSearchConstants.TYPE</code>: look for both classes and interfaces</li> |
| * <li><code>IJavaSearchConstants.FIELD</code>: look for fields</li> |
| * <li><code>IJavaSearchConstants.METHOD</code>: look for methods</li> |
| * <li><code>IJavaSearchConstants.CONSTRUCTOR</code>: look for constructors</li> |
| * <li><code>IJavaSearchConstants.PACKAGE</code>: look for packages</li> |
| * </ul> |
| * @param limitTo determines the nature of the expected matches |
| * <ul> |
| * <li><code>IJavaSearchConstants.DECLARATIONS</code>: will search declarations matching with the corresponding |
| * element. In case the element is a method, declarations of matching methods in subtypes will also |
| * be found, allowing to find declarations of abstract methods, etc.</li> |
| * |
| * <li><code>IJavaSearchConstants.REFERENCES</code>: will search references to the given element.</li> |
| * |
| * <li><code>IJavaSearchConstants.ALL_OCCURRENCES</code>: will search for either declarations or references as specified |
| * above.</li> |
| * |
| * <li><code>IJavaSearchConstants.IMPLEMENTORS</code>: for interface, will find all types which implements a given interface.</li> |
| * </ul> |
| * |
| * @param isCaseSensitive indicates whether the search is case sensitive or not. |
| * @return a search pattern on the given string pattern, or <code>null</code> if the string pattern is ill-formed. |
| * @deprecated Use {@link SearchPattern#createPattern(String, int, int, int, boolean)} instead. |
| */ |
| public static ISearchPattern createSearchPattern(String stringPattern, int searchFor, int limitTo, boolean isCaseSensitive) { |
| int matchMode = stringPattern.indexOf('*') != -1 || stringPattern.indexOf('?') != -1 |
| ? SearchPattern.R_PATTERN_MATCH |
| : SearchPattern.R_EXACT_MATCH; |
| return new SearchPatternAdapter(SearchPattern.createPattern(stringPattern, searchFor, limitTo, matchMode, isCaseSensitive)); |
| } |
| |
| /** |
| * Returns a search pattern based on a given Java element. |
| * The pattern is used to trigger the appropriate search, and can be parameterized as follows: |
| * |
| * @param element the Java element the search pattern is based on |
| * @param limitTo determines the nature of the expected matches |
| * <ul> |
| * <li><code>IJavaSearchConstants.DECLARATIONS</code>: will search declarations matching with the corresponding |
| * element. In case the element is a method, declarations of matching methods in subtypes will also |
| * be found, allowing to find declarations of abstract methods, etc.</li> |
| * |
| * <li><code>IJavaSearchConstants.REFERENCES</code>: will search references to the given element.</li> |
| * |
| * <li><code>IJavaSearchConstants.ALL_OCCURRENCES</code>: will search for either declarations or references as specified |
| * above.</li> |
| * |
| * <li><code>IJavaSearchConstants.IMPLEMENTORS</code>: for interface, will find all types which implements a given interface.</li> |
| * </ul> |
| * @return a search pattern for a Java element or <code>null</code> if the given element is ill-formed |
| * @deprecated use SearchPattern.createPattern(IJavaElement, int) instead |
| * @deprecated Use {@link SearchPattern#createPattern(IJavaElement, int)} instead. |
| */ |
| public static ISearchPattern createSearchPattern(IJavaElement element, int limitTo) { |
| return new SearchPatternAdapter(SearchPattern.createPattern(element, limitTo)); |
| } |
| |
| /** |
| * Returns a Java search scope with the workspace as the only limit. |
| * |
| * @return a new workspace scope |
| */ |
| public static IJavaSearchScope createWorkspaceScope() { |
| return new JavaWorkspaceScope(); |
| } |
| |
| /** |
| * Searches for matches to a given query. Search queries can be created using helper |
| * methods (from a String pattern or a Java element) and encapsulate the description of what is |
| * being searched (for example, search method declarations in a case sensitive way). |
| * |
| * @param scope the search result has to be limited to the given scope |
| * @param resultCollector a callback object to which each match is reported |
| */ |
| private void findMatches(SearchPattern pattern, SearchParticipant[] participants, IJavaSearchScope scope, SearchRequestor requestor, IProgressMonitor monitor) throws CoreException { |
| if (monitor != null && monitor.isCanceled()) throw new OperationCanceledException(); |
| |
| /* initialize progress monitor */ |
| if (monitor != null) |
| monitor.beginTask(Util.bind("engine.searching"), 100); //$NON-NLS-1$ |
| if (SearchEngine.VERBOSE) |
| System.out.println("Searching for " + this + " in " + scope); //$NON-NLS-1$//$NON-NLS-2$ |
| |
| IndexManager indexManager = JavaModelManager.getJavaModelManager().getIndexManager(); |
| try { |
| requestor.beginReporting(); |
| for (int i = 0, l = participants == null ? 0 : participants.length; i < l; i++) { |
| if (monitor != null && monitor.isCanceled()) throw new OperationCanceledException(); |
| |
| SearchParticipant participant = participants[i]; |
| try { |
| participant.beginSearching(); |
| requestor.enterParticipant(participant); |
| PathCollector pathCollector = new PathCollector(); |
| indexManager.performConcurrentJob( |
| new PatternSearchJob(pattern, participant, scope, pathCollector), |
| IJavaSearchConstants.WAIT_UNTIL_READY_TO_SEARCH, |
| monitor); |
| if (monitor != null && monitor.isCanceled()) throw new OperationCanceledException(); |
| |
| // locate index matches if any (note that all search matches could have been issued during index querying) |
| String[] indexMatchPaths = pathCollector.getPaths(); |
| pathCollector = null; // release |
| int indexMatchLength = indexMatchPaths == null ? 0 : indexMatchPaths.length; |
| SearchDocument[] indexMatches = new SearchDocument[indexMatchLength]; |
| for (int j = 0; j < indexMatchLength; j++) |
| indexMatches[j] = participant.getDocument(indexMatchPaths[j]); |
| SearchDocument[] matches = MatchLocator.addWorkingCopies(pattern, indexMatches, getWorkingCopies(), participant); |
| participant.locateMatches(matches, pattern, scope, requestor, monitor); |
| } finally { |
| requestor.exitParticipant(participant); |
| participant.doneSearching(); |
| } |
| } |
| } finally { |
| requestor.endReporting(); |
| if (monitor != null) |
| monitor.done(); |
| } |
| } |
| /** |
| * Returns a new default Java search participant. |
| * |
| * @return a new default Java search participant |
| * @since 3.0 |
| */ |
| public static SearchParticipant getDefaultSearchParticipant() { |
| return new JavaSearchParticipant(); |
| } |
| |
| private Parser getParser() { |
| if (this.parser == null) { |
| this.compilerOptions = new CompilerOptions(JavaCore.getOptions()); |
| ProblemReporter problemReporter = |
| new ProblemReporter( |
| DefaultErrorHandlingPolicies.proceedWithAllProblems(), |
| this.compilerOptions, |
| new DefaultProblemFactory()); |
| this.parser = new Parser(problemReporter, true); |
| } |
| return this.parser; |
| } |
| |
| /** |
| * Returns the underlying resource of the given element. |
| * @param element an IJavaElement |
| * @return an IResource |
| */ |
| private IResource getResource(IJavaElement element) { |
| if (element instanceof IMember) { |
| ICompilationUnit cu = ((IMember)element).getCompilationUnit(); |
| if (cu != null) { |
| return cu.getResource(); |
| } |
| } |
| return element.getResource(); |
| } |
| |
| /* |
| * Returns the list of working copies used by this search engine. |
| * Returns null if none. |
| */ |
| private ICompilationUnit[] getWorkingCopies() { |
| ICompilationUnit[] copies; |
| if (this.workingCopies != null) { |
| if (this.workingCopyOwner == null) { |
| copies = JavaModelManager.getJavaModelManager().getWorkingCopies(DefaultWorkingCopyOwner.PRIMARY, false/*don't add primary WCs a second time*/); |
| if (copies == null) { |
| copies = this.workingCopies; |
| } else { |
| HashMap pathToCUs = new HashMap(); |
| for (int i = 0, length = copies.length; i < length; i++) { |
| ICompilationUnit unit = copies[i]; |
| pathToCUs.put(unit.getPath(), unit); |
| } |
| for (int i = 0, length = this.workingCopies.length; i < length; i++) { |
| ICompilationUnit unit = this.workingCopies[i]; |
| pathToCUs.put(unit.getPath(), unit); |
| } |
| int length = pathToCUs.size(); |
| copies = new ICompilationUnit[length]; |
| pathToCUs.values().toArray(copies); |
| } |
| } else { |
| copies = this.workingCopies; |
| } |
| } else if (this.workingCopyOwner != null) { |
| copies = JavaModelManager.getJavaModelManager().getWorkingCopies(this.workingCopyOwner, true/*add primary WCs*/); |
| } else { |
| copies = JavaModelManager.getJavaModelManager().getWorkingCopies(DefaultWorkingCopyOwner.PRIMARY, false/*don't add primary WCs a second time*/); |
| } |
| if (copies == null) return null; |
| |
| // filter out primary working copies that are saved |
| ICompilationUnit[] result = null; |
| int length = copies.length; |
| int index = 0; |
| for (int i = 0; i < length; i++) { |
| CompilationUnit copy = (CompilationUnit)copies[i]; |
| try { |
| if (!copy.isPrimary() |
| || copy.hasUnsavedChanges() |
| || copy.hasResourceChanged()) { |
| if (result == null) { |
| result = new ICompilationUnit[length]; |
| } |
| result[index++] = copy; |
| } |
| } catch (JavaModelException e) { |
| // copy doesn't exist: ignore |
| } |
| } |
| if (index != length && result != null) { |
| System.arraycopy(result, 0, result = new ICompilationUnit[index], 0, index); |
| } |
| return result; |
| } |
| |
| /** |
| * Returns the list of working copies used to do the search on the given Java element. |
| * @param element an IJavaElement |
| * @return an array of ICompilationUnit |
| */ |
| private ICompilationUnit[] getWorkingCopies(IJavaElement element) { |
| if (element instanceof IMember) { |
| ICompilationUnit cu = ((IMember)element).getCompilationUnit(); |
| if (cu != null && cu.isWorkingCopy()) { |
| ICompilationUnit[] copies = getWorkingCopies(); |
| int length = copies == null ? 0 : copies.length; |
| if (length > 0) { |
| ICompilationUnit[] newWorkingCopies = new ICompilationUnit[length+1]; |
| System.arraycopy(copies, 0, newWorkingCopies, 0, length); |
| newWorkingCopies[length] = cu; |
| return newWorkingCopies; |
| } else { |
| return new ICompilationUnit[] {cu}; |
| } |
| } |
| } |
| return getWorkingCopies(); |
| } |
| |
| boolean match(char classOrInterface, char[] patternPkg, char[] patternTypeName, int matchMode, boolean isCaseSensitive, boolean isClass, char[] pkg, char[] typeName) { |
| switch(classOrInterface) { |
| case IIndexConstants.CLASS_SUFFIX : |
| if (!isClass) return false; |
| case IIndexConstants.INTERFACE_SUFFIX : |
| if (isClass) return false; |
| case IIndexConstants.TYPE_SUFFIX : // nothing |
| } |
| |
| if (patternPkg != null && !CharOperation.equals(patternPkg, pkg, isCaseSensitive)) |
| return false; |
| |
| if (patternTypeName != null) { |
| switch(matchMode) { |
| case SearchPattern.R_EXACT_MATCH : |
| return CharOperation.equals(patternTypeName, typeName, isCaseSensitive); |
| case SearchPattern.R_PREFIX_MATCH : |
| return CharOperation.prefixEquals(patternTypeName, typeName, isCaseSensitive); |
| case SearchPattern.R_PATTERN_MATCH : |
| return CharOperation.match(patternTypeName, typeName, isCaseSensitive); |
| } |
| } |
| return true; |
| |
| } |
| |
| /** |
| * Searches for the Java element determined by the given signature. The signature |
| * can be incomplete. For example, a call like |
| * <code>search(ws, "run()", METHOD,REFERENCES, col)</code> |
| * searches for all references to the method <code>run</code>. |
| * |
| * Note that by default the pattern will be case insensitive. For specifying case s |
| * sensitive search, use <code>search(workspace, createSearchPattern(patternString, searchFor, limitTo, true), scope, resultCollector);</code> |
| * |
| * @param workspace the workspace |
| * @param patternString the pattern to be searched for |
| * @param searchFor a hint what kind of Java element the string pattern represents. |
| * Look into <code>IJavaSearchConstants</code> for valid values |
| * @param limitTo one of the following values: |
| * <ul> |
| * <li><code>IJavaSearchConstants.DECLARATIONS</code>: search |
| * for declarations only </li> |
| * <li><code>IJavaSearchConstants.REFERENCES</code>: search |
| * for all references </li> |
| * <li><code>IJavaSearchConstants.ALL_OCCURENCES</code>: search |
| * for both declarations and all references </li> |
| * <li><code>IJavaSearchConstants.IMPLEMENTORS</code>: search for |
| * all implementors of an interface; the value is only valid if |
| * the Java element represents an interface</li> |
| * </ul> |
| * @param scope the search result has to be limited to the given scope |
| * @param resultCollector a callback object to which each match is reported |
| * @exception JavaModelException if the search failed. Reasons include: |
| * <ul> |
| * <li>the classpath is incorrectly set</li> |
| * </ul> |
| * @deprecated Use {@link #search(SearchPattern, SearchParticipant[], IJavaSearchScope, SearchRequestor, IProgressMonitor)} instead. |
| */ |
| public void search(IWorkspace workspace, String patternString, int searchFor, int limitTo, IJavaSearchScope scope, IJavaSearchResultCollector resultCollector) throws JavaModelException { |
| try { |
| int matchMode = patternString.indexOf('*') != -1 || patternString.indexOf('?') != -1 |
| ? SearchPattern.R_PATTERN_MATCH |
| : SearchPattern.R_EXACT_MATCH; |
| search( |
| SearchPattern.createPattern(patternString, searchFor, limitTo, matchMode, true), |
| new SearchParticipant[] {getDefaultSearchParticipant()}, |
| scope, |
| new ResultCollectorAdapter(resultCollector), |
| resultCollector.getProgressMonitor()); |
| } catch (CoreException e) { |
| if (e instanceof JavaModelException) { |
| throw (JavaModelException) e; |
| } else { |
| throw new JavaModelException(e); |
| } |
| } |
| } |
| |
| /** |
| * Searches for the given Java element. |
| * |
| * @param workspace the workspace |
| * @param element the Java element to be searched for |
| * @param limitTo one of the following values: |
| * <ul> |
| * <li><code>IJavaSearchConstants.DECLARATIONS</code>: search |
| * for declarations only </li> |
| * <li><code>IJavaSearchConstants.REFERENCES</code>: search |
| * for all references </li> |
| * <li><code>IJavaSearchConstants.ALL_OCCURENCES</code>: search |
| * for both declarations and all references </li> |
| * <li><code>IJavaSearchConstants.IMPLEMENTORS</code>: search for |
| * all implementors of an interface; the value is only valid if |
| * the Java element represents an interface</li> |
| * </ul> |
| * @param scope the search result has to be limited to the given scope |
| * @param resultCollector a callback object to which each match is reported |
| * @exception JavaModelException if the search failed. Reasons include: |
| * <ul> |
| * <li>the element doesn't exist</li> |
| * <li>the classpath is incorrectly set</li> |
| * </ul> |
| * @deprecated Use {@link #search(SearchPattern, SearchParticipant[], IJavaSearchScope, SearchRequestor, IProgressMonitor)} instead. |
| */ |
| public void search(IWorkspace workspace, IJavaElement element, int limitTo, IJavaSearchScope scope, IJavaSearchResultCollector resultCollector) throws JavaModelException { |
| search(workspace, createSearchPattern(element, limitTo), scope, resultCollector); |
| } |
| |
| /** |
| * Searches for matches of a given search pattern. Search patterns can be created using helper |
| * methods (from a String pattern or a Java element) and encapsulate the description of what is |
| * being searched (for example, search method declarations in a case sensitive way). |
| * |
| * @param workspace the workspace |
| * @param searchPattern the pattern to be searched for |
| * @param scope the search result has to be limited to the given scope |
| * @param resultCollector a callback object to which each match is reported |
| * @exception JavaModelException if the search failed. Reasons include: |
| * <ul> |
| * <li>the classpath is incorrectly set</li> |
| * </ul> |
| * @deprecated Use {@link #search(SearchPattern, SearchParticipant[], IJavaSearchScope, SearchRequestor, IProgressMonitor)} instead. |
| */ |
| public void search(IWorkspace workspace, ISearchPattern searchPattern, IJavaSearchScope scope, IJavaSearchResultCollector resultCollector) throws JavaModelException { |
| try { |
| search( |
| ((SearchPatternAdapter)searchPattern).pattern, |
| new SearchParticipant[] {getDefaultSearchParticipant()}, |
| scope, |
| new ResultCollectorAdapter(resultCollector), |
| resultCollector.getProgressMonitor()); |
| } catch (CoreException e) { |
| if (e instanceof JavaModelException) { |
| throw (JavaModelException) e; |
| } else { |
| throw new JavaModelException(e); |
| } |
| } |
| } |
| |
| /** |
| * Searches for matches of a given search pattern. Search patterns can be created using helper |
| * methods (from a String pattern or a Java element) and encapsulate the description of what is |
| * being searched (for example, search method declarations in a case sensitive way). |
| * |
| * @param pattern the pattern to search |
| * @param participants the particpants in the search |
| * @param scope the search scope |
| * @param requestor the requestor to report the matches to |
| * @param monitor the progress monitor used to report progress |
| * @exception CoreException if the search failed. Reasons include: |
| * <ul> |
| * <li>the classpath is incorrectly set</li> |
| * </ul> |
| *@since 3.0 |
| */ |
| public void search(SearchPattern pattern, SearchParticipant[] participants, IJavaSearchScope scope, SearchRequestor requestor, IProgressMonitor monitor) throws CoreException { |
| findMatches(pattern, participants, scope, requestor, monitor); |
| } |
| |
| /** |
| * Searches for all top-level types and member types in the given scope. |
| * The search can be selecting specific types (given a package or a type name |
| * prefix and match modes). |
| * |
| * @param workspace the workspace to search in |
| * @param packageName the full name of the package of the searched types, or a prefix for this |
| * package, or a wild-carded string for this package. |
| * @param typeName the dot-separated qualified name of the searched type (the qualification include |
| * the enclosing types if the searched type is a member type), or a prefix |
| * for this type, or a wild-carded string for this type. |
| * @param matchMode one of |
| * <ul> |
| * <li><code>IJavaSearchConstants.EXACT_MATCH</code> if the package name and type name are the full names |
| * of the searched types.</li> |
| * <li><code>IJavaSearchConstants.PREFIX_MATCH</code> if the package name and type name are prefixes of the names |
| * of the searched types.</li> |
| * <li><code>IJavaSearchConstants.PATTERN_MATCH</code> if the package name and type name contain wild-cards.</li> |
| * </ul> |
| * @param isCaseSensitive whether the search should be case sensitive |
| * @param searchFor one of |
| * <ul> |
| * <li><code>IJavaSearchConstants.CLASS</code> if searching for classes only</li> |
| * <li><code>IJavaSearchConstants.INTERFACE</code> if searching for interfaces only</li> |
| * <li><code>IJavaSearchConstants.TYPE</code> if searching for both classes and interfaces</li> |
| * </ul> |
| * @param scope the scope to search in |
| * @param nameRequestor the requestor that collects the results of the search |
| * @param waitingPolicy one of |
| * <ul> |
| * <li><code>IJavaSearchConstants.FORCE_IMMEDIATE_SEARCH</code> if the search should start immediately</li> |
| * <li><code>IJavaSearchConstants.CANCEL_IF_NOT_READY_TO_SEARCH</code> if the search should be cancelled if the |
| * underlying indexer has not finished indexing the workspace</li> |
| * <li><code>IJavaSearchConstants.WAIT_UNTIL_READY_TO_SEARCH</code> if the search should wait for the |
| * underlying indexer to finish indexing the workspace</li> |
| * </ul> |
| * @param progressMonitor the progress monitor to report progress to, or <code>null</code> if no progress |
| * monitor is provided |
| * @exception JavaModelException if the search failed. Reasons include: |
| * <ul> |
| * <li>the classpath is incorrectly set</li> |
| * </ul> |
| */ |
| public void searchAllTypeNames( |
| IWorkspace workspace, |
| final char[] packageName, |
| final char[] typeName, |
| final int matchMode, |
| final boolean isCaseSensitive, |
| int searchFor, |
| IJavaSearchScope scope, |
| final ITypeNameRequestor nameRequestor, |
| int waitingPolicy, |
| IProgressMonitor progressMonitor) throws JavaModelException { |
| |
| IndexManager indexManager = JavaModelManager.getJavaModelManager().getIndexManager(); |
| |
| final char classOrInterface; |
| switch(searchFor){ |
| case IJavaSearchConstants.CLASS : |
| classOrInterface = IIndexConstants.CLASS_SUFFIX; |
| break; |
| case IJavaSearchConstants.INTERFACE : |
| classOrInterface = IIndexConstants.INTERFACE_SUFFIX; |
| break; |
| default : |
| classOrInterface = IIndexConstants.TYPE_SUFFIX; |
| break; |
| } |
| final TypeDeclarationPattern pattern = new TypeDeclarationPattern( |
| packageName, |
| null, // do find member types |
| typeName, |
| classOrInterface, |
| isCaseSensitive ? matchMode | SearchPattern.R_CASE_SENSITIVE : matchMode); |
| |
| final HashSet workingCopyPaths = new HashSet(); |
| ICompilationUnit[] copies = getWorkingCopies(); |
| if (copies != null) { |
| for (int i = 0, length = copies.length; i < length; i++) { |
| ICompilationUnit workingCopy = copies[i]; |
| workingCopyPaths.add(workingCopy.getPath().toString()); |
| } |
| } |
| |
| IndexQueryRequestor searchRequestor = new IndexQueryRequestor(){ |
| public boolean acceptIndexMatch(String documentPath, SearchPattern indexRecord, SearchParticipant participant) { |
| TypeDeclarationPattern record = (TypeDeclarationPattern)indexRecord; |
| if (record.enclosingTypeNames != IIndexConstants.ONE_ZERO_CHAR // filter out local and anonymous classes |
| && !workingCopyPaths.contains(documentPath)) { // filter out working copies |
| boolean isClass = record.classOrInterface != IIndexConstants.INTERFACE_SUFFIX; |
| if (isClass) { |
| nameRequestor.acceptClass(record.pkg, record.simpleName, record.enclosingTypeNames, documentPath); |
| } else { |
| nameRequestor.acceptInterface(record.pkg, record.simpleName, record.enclosingTypeNames, documentPath); |
| } |
| } |
| return true; |
| } |
| }; |
| |
| try { |
| if (progressMonitor != null) { |
| progressMonitor.beginTask(Util.bind("engine.searching"), 100); //$NON-NLS-1$ |
| } |
| // add type names from indexes |
| indexManager.performConcurrentJob( |
| new PatternSearchJob( |
| pattern, |
| getDefaultSearchParticipant(), // Java search only |
| scope, |
| searchRequestor), |
| waitingPolicy, |
| progressMonitor == null ? null : new SubProgressMonitor(progressMonitor, 100)); |
| |
| // add type names from working copies |
| if (copies != null) { |
| for (int i = 0, length = copies.length; i < length; i++) { |
| ICompilationUnit workingCopy = copies[i]; |
| final String path = workingCopy.getPath().toString(); |
| if (workingCopy.isConsistent()) { |
| IPackageDeclaration[] packageDeclarations = workingCopy.getPackageDeclarations(); |
| char[] packageDeclaration = packageDeclarations.length == 0 ? CharOperation.NO_CHAR : packageDeclarations[0].getElementName().toCharArray(); |
| IType[] allTypes = workingCopy.getAllTypes(); |
| for (int j = 0, allTypesLength = allTypes.length; j < allTypesLength; j++) { |
| IType type = allTypes[j]; |
| IJavaElement parent = type.getParent(); |
| char[][] enclosingTypeNames; |
| if (parent instanceof IType) { |
| char[] parentQualifiedName = ((IType)parent).getTypeQualifiedName('.').toCharArray(); |
| enclosingTypeNames = CharOperation.splitOn('.', parentQualifiedName); |
| } else { |
| enclosingTypeNames = CharOperation.NO_CHAR_CHAR; |
| } |
| char[] simpleName = type.getElementName().toCharArray(); |
| if (match(classOrInterface, packageName, typeName, matchMode, isCaseSensitive, type.isClass(), packageDeclaration, simpleName)) { |
| if (type.isClass()) { |
| nameRequestor.acceptClass(packageDeclaration, simpleName, enclosingTypeNames, path); |
| } else { |
| nameRequestor.acceptInterface(packageDeclaration, simpleName, enclosingTypeNames, path); |
| } |
| } |
| } |
| } else { |
| Parser basicParser = getParser(); |
| final char[] contents = workingCopy.getBuffer().getCharacters(); |
| org.eclipse.jdt.internal.compiler.env.ICompilationUnit unit = new org.eclipse.jdt.internal.compiler.env.ICompilationUnit() { |
| public char[] getContents() { |
| return contents; |
| } |
| public char[] getMainTypeName() { |
| return null; |
| } |
| public char[][] getPackageName() { |
| return null; |
| } |
| public char[] getFileName() { |
| return null; |
| } |
| }; |
| CompilationResult compilationUnitResult = new CompilationResult(unit, 0, 0, this.compilerOptions.maxProblemsPerUnit); |
| CompilationUnitDeclaration parsedUnit = basicParser.dietParse(unit, compilationUnitResult); |
| if (parsedUnit != null) { |
| final char[] packageDeclaration = parsedUnit.currentPackage == null ? CharOperation.NO_CHAR : CharOperation.concatWith(parsedUnit.currentPackage.getImportName(), '.'); |
| class AllTypeDeclarationsVisitor extends ASTVisitor { |
| public boolean visit(TypeDeclaration typeDeclaration, BlockScope blockScope) { |
| return false; // no local/anonymous type |
| } |
| public boolean visit(TypeDeclaration typeDeclaration, CompilationUnitScope compilationUnitScope) { |
| if (match(classOrInterface, packageName, typeName, matchMode, isCaseSensitive, !typeDeclaration.isInterface(), packageDeclaration, typeDeclaration.name)) { |
| if (!typeDeclaration.isInterface()) { |
| nameRequestor.acceptClass(packageDeclaration, typeDeclaration.name, CharOperation.NO_CHAR_CHAR, path); |
| } else { |
| nameRequestor.acceptInterface(packageDeclaration, typeDeclaration.name, CharOperation.NO_CHAR_CHAR, path); |
| } |
| } |
| return true; |
| } |
| public boolean visit(TypeDeclaration memberTypeDeclaration, ClassScope classScope) { |
| if (match(classOrInterface, packageName, typeName, matchMode, isCaseSensitive, !memberTypeDeclaration.isInterface(), packageDeclaration, memberTypeDeclaration.name)) { |
| // compute encloising type names |
| TypeDeclaration enclosing = memberTypeDeclaration.enclosingType; |
| char[][] enclosingTypeNames = CharOperation.NO_CHAR_CHAR; |
| while (enclosing != null) { |
| enclosingTypeNames = CharOperation.arrayConcat(new char[][] {enclosing.name}, enclosingTypeNames); |
| if ((enclosing.bits & ASTNode.IsMemberTypeMASK) != 0) { |
| enclosing = enclosing.enclosingType; |
| } else { |
| enclosing = null; |
| } |
| } |
| // report |
| if (!memberTypeDeclaration.isInterface()) { |
| nameRequestor.acceptClass(packageDeclaration, memberTypeDeclaration.name, enclosingTypeNames, path); |
| } else { |
| nameRequestor.acceptInterface(packageDeclaration, memberTypeDeclaration.name, enclosingTypeNames, path); |
| } |
| } |
| return true; |
| } |
| } |
| parsedUnit.traverse(new AllTypeDeclarationsVisitor(), parsedUnit.scope); |
| } |
| } |
| } |
| } |
| } finally { |
| if (progressMonitor != null) { |
| progressMonitor.done(); |
| } |
| } |
| } |
| |
| /** |
| * @deprecated mark deprecated as it uses deprecated code |
| */ |
| private void searchDeclarations(IJavaElement enclosingElement, IJavaSearchResultCollector resultCollector, SearchPattern pattern) throws JavaModelException { |
| searchDeclarations(enclosingElement, new ResultCollectorAdapter(resultCollector), pattern, resultCollector.getProgressMonitor()); |
| } |
| |
| private void searchDeclarations(IJavaElement enclosingElement, SearchRequestor requestor, SearchPattern pattern, IProgressMonitor monitor) throws JavaModelException { |
| IJavaSearchScope scope = createJavaSearchScope(new IJavaElement[] {enclosingElement}); |
| IResource resource = this.getResource(enclosingElement); |
| try { |
| if (resource instanceof IFile) { |
| if (VERBOSE) { |
| System.out.println("Searching for " + pattern + " in " + resource.getFullPath()); //$NON-NLS-1$//$NON-NLS-2$ |
| } |
| SearchParticipant participant = getDefaultSearchParticipant(); |
| SearchDocument[] documents = MatchLocator.addWorkingCopies( |
| pattern, |
| new SearchDocument[] {new JavaSearchDocument(enclosingElement.getPath().toString(), participant)}, |
| getWorkingCopies(enclosingElement), |
| participant); |
| participant.locateMatches( |
| documents, |
| pattern, |
| scope, |
| requestor, |
| monitor); |
| } else { |
| search( |
| pattern, |
| new SearchParticipant[] {getDefaultSearchParticipant()}, |
| scope, |
| requestor, |
| monitor); |
| } |
| } catch (CoreException e) { |
| if (e instanceof JavaModelException) { |
| throw (JavaModelException) e; |
| } else { |
| throw new JavaModelException(e); |
| } |
| } |
| } |
| |
| /** |
| * Searches for all declarations of the fields accessed in the given element. |
| * The element can be a compilation unit, a source type, or a source method. |
| * Reports the field declarations using the given requestor. |
| * <p> |
| * Consider the following code: |
| * <code> |
| * <pre> |
| * class A { |
| * int field1; |
| * } |
| * class B extends A { |
| * String value; |
| * } |
| * class X { |
| * void test() { |
| * B b = new B(); |
| * System.out.println(b.value + b.field1); |
| * }; |
| * } |
| * </pre> |
| * </code> |
| * then searching for declarations of accessed fields in method |
| * <code>X.test()</code> would collect the fields |
| * <code>B.value</code> and <code>A.field1</code>. |
| * </p> |
| * |
| * @param enclosingElement the method, type, or compilation unit to be searched in |
| * @param requestor a callback object to which each match is reported |
| * @param monitor the progress monitor used to report progress |
| * @exception JavaModelException if the search failed. Reasons include: |
| * <ul> |
| * <li>the element doesn't exist</li> |
| * <li>the classpath is incorrectly set</li> |
| * </ul> |
| * @since 3.0 |
| */ |
| public void searchDeclarationsOfAccessedFields(IJavaElement enclosingElement, SearchRequestor requestor, IProgressMonitor monitor) throws JavaModelException { |
| SearchPattern pattern = new DeclarationOfAccessedFieldsPattern(enclosingElement); |
| searchDeclarations(enclosingElement, requestor, pattern, monitor); |
| } |
| |
| /** |
| * Searches for all declarations of the fields accessed in the given element. |
| * The element can be a compilation unit, a source type, or a source method. |
| * Reports the field declarations using the given collector. |
| * <p> |
| * Consider the following code: |
| * <code> |
| * <pre> |
| * class A { |
| * int field1; |
| * } |
| * class B extends A { |
| * String value; |
| * } |
| * class X { |
| * void test() { |
| * B b = new B(); |
| * System.out.println(b.value + b.field1); |
| * }; |
| * } |
| * </pre> |
| * </code> |
| * then searching for declarations of accessed fields in method |
| * <code>X.test()</code> would collect the fields |
| * <code>B.value</code> and <code>A.field1</code>. |
| * </p> |
| * |
| * @param workspace the workspace |
| * @param enclosingElement the method, type, or compilation unit to be searched in |
| * @param resultCollector a callback object to which each match is reported |
| * @exception JavaModelException if the search failed. Reasons include: |
| * <ul> |
| * <li>the element doesn't exist</li> |
| * <li>the classpath is incorrectly set</li> |
| * </ul> |
| * @deprecated Use {@link #searchDeclarationsOfAccessedFields(IJavaElement, SearchRequestor, IProgressMonitor)} instead. |
| */ |
| public void searchDeclarationsOfAccessedFields(IWorkspace workspace, IJavaElement enclosingElement, IJavaSearchResultCollector resultCollector) throws JavaModelException { |
| SearchPattern pattern = new DeclarationOfAccessedFieldsPattern(enclosingElement); |
| searchDeclarations(enclosingElement, resultCollector, pattern); |
| } |
| |
| /** |
| * Searches for all declarations of the types referenced in the given element. |
| * The element can be a compilation unit, a source type, or a source method. |
| * Reports the type declarations using the given requestor. |
| * <p> |
| * Consider the following code: |
| * <code> |
| * <pre> |
| * class A { |
| * } |
| * class B extends A { |
| * } |
| * interface I { |
| * int VALUE = 0; |
| * } |
| * class X { |
| * void test() { |
| * B b = new B(); |
| * this.foo(b, I.VALUE); |
| * }; |
| * } |
| * </pre> |
| * </code> |
| * then searching for declarations of referenced types in method <code>X.test()</code> |
| * would collect the class <code>B</code> and the interface <code>I</code>. |
| * </p> |
| * |
| * @param enclosingElement the method, type, or compilation unit to be searched in |
| * @param requestor a callback object to which each match is reported |
| * @param monitor the progress monitor used to report progress |
| * @exception JavaModelException if the search failed. Reasons include: |
| * <ul> |
| * <li>the element doesn't exist</li> |
| * <li>the classpath is incorrectly set</li> |
| * </ul> |
| * @since 3.0 |
| */ |
| public void searchDeclarationsOfReferencedTypes(IJavaElement enclosingElement, SearchRequestor requestor, IProgressMonitor monitor) throws JavaModelException { |
| SearchPattern pattern = new DeclarationOfReferencedTypesPattern(enclosingElement); |
| searchDeclarations(enclosingElement, requestor, pattern, monitor); |
| } |
| |
| /** |
| * Searches for all declarations of the types referenced in the given element. |
| * The element can be a compilation unit, a source type, or a source method. |
| * Reports the type declarations using the given collector. |
| * <p> |
| * Consider the following code: |
| * <code> |
| * <pre> |
| * class A { |
| * } |
| * class B extends A { |
| * } |
| * interface I { |
| * int VALUE = 0; |
| * } |
| * class X { |
| * void test() { |
| * B b = new B(); |
| * this.foo(b, I.VALUE); |
| * }; |
| * } |
| * </pre> |
| * </code> |
| * then searching for declarations of referenced types in method <code>X.test()</code> |
| * would collect the class <code>B</code> and the interface <code>I</code>. |
| * </p> |
| * |
| * @param workspace the workspace |
| * @param enclosingElement the method, type, or compilation unit to be searched in |
| * @param resultCollector a callback object to which each match is reported |
| * @exception JavaModelException if the search failed. Reasons include: |
| * <ul> |
| * <li>the element doesn't exist</li> |
| * <li>the classpath is incorrectly set</li> |
| * </ul> |
| * @deprecated Use {@link #searchDeclarationsOfReferencedTypes(IJavaElement, SearchRequestor, IProgressMonitor)} instead. |
| */ |
| public void searchDeclarationsOfReferencedTypes(IWorkspace workspace, IJavaElement enclosingElement, IJavaSearchResultCollector resultCollector) throws JavaModelException { |
| SearchPattern pattern = new DeclarationOfReferencedTypesPattern(enclosingElement); |
| searchDeclarations(enclosingElement, resultCollector, pattern); |
| } |
| |
| /** |
| * Searches for all declarations of the methods invoked in the given element. |
| * The element can be a compilation unit, a source type, or a source method. |
| * Reports the method declarations using the given requestor. |
| * <p> |
| * Consider the following code: |
| * <code> |
| * <pre> |
| * class A { |
| * void foo() {}; |
| * void bar() {}; |
| * } |
| * class B extends A { |
| * void foo() {}; |
| * } |
| * class X { |
| * void test() { |
| * A a = new B(); |
| * a.foo(); |
| * B b = (B)a; |
| * b.bar(); |
| * }; |
| * } |
| * </pre> |
| * </code> |
| * then searching for declarations of sent messages in method |
| * <code>X.test()</code> would collect the methods |
| * <code>A.foo()</code>, <code>B.foo()</code>, and <code>A.bar()</code>. |
| * </p> |
| * |
| * @param enclosingElement the method, type, or compilation unit to be searched in |
| * @param requestor a callback object to which each match is reported |
| * @param monitor the progress monitor used to report progress |
| * @exception JavaModelException if the search failed. Reasons include: |
| * <ul> |
| * <li>the element doesn't exist</li> |
| * <li>the classpath is incorrectly set</li> |
| * </ul> |
| * @since 3.0 |
| */ |
| public void searchDeclarationsOfSentMessages(IJavaElement enclosingElement, SearchRequestor requestor, IProgressMonitor monitor) throws JavaModelException { |
| SearchPattern pattern = new DeclarationOfReferencedMethodsPattern(enclosingElement); |
| searchDeclarations(enclosingElement, requestor, pattern, monitor); |
| } |
| |
| /** |
| * Searches for all declarations of the methods invoked in the given element. |
| * The element can be a compilation unit, a source type, or a source method. |
| * Reports the method declarations using the given collector. |
| * <p> |
| * Consider the following code: |
| * <code> |
| * <pre> |
| * class A { |
| * void foo() {}; |
| * void bar() {}; |
| * } |
| * class B extends A { |
| * void foo() {}; |
| * } |
| * class X { |
| * void test() { |
| * A a = new B(); |
| * a.foo(); |
| * B b = (B)a; |
| * b.bar(); |
| * }; |
| * } |
| * </pre> |
| * </code> |
| * then searching for declarations of sent messages in method |
| * <code>X.test()</code> would collect the methods |
| * <code>A.foo()</code>, <code>B.foo()</code>, and <code>A.bar()</code>. |
| * </p> |
| * |
| * @param workspace the workspace |
| * @param enclosingElement the method, type, or compilation unit to be searched in |
| * @param resultCollector a callback object to which each match is reported |
| * @exception JavaModelException if the search failed. Reasons include: |
| * <ul> |
| * <li>the element doesn't exist</li> |
| * <li>the classpath is incorrectly set</li> |
| * </ul> |
| * @deprecated Use {@link #searchDeclarationsOfSentMessages(IJavaElement, SearchRequestor, IProgressMonitor)} instead. |
| */ |
| public void searchDeclarationsOfSentMessages(IWorkspace workspace, IJavaElement enclosingElement, IJavaSearchResultCollector resultCollector) throws JavaModelException { |
| SearchPattern pattern = new DeclarationOfReferencedMethodsPattern(enclosingElement); |
| searchDeclarations(enclosingElement, resultCollector, pattern); |
| } |
| } |