# HG changeset patch
# Parent 6dba2e7ed14de308d832c63e88ce26c522eb6888
# User Ralph Benjamin Ruijs <ralphbenjamin@netbeans.org>
[no commit message]

diff --git a/java.source/apichanges.xml b/java.source/apichanges.xml
--- a/java.source/apichanges.xml
+++ b/java.source/apichanges.xml
@@ -108,6 +108,20 @@
     <!-- ACTUAL CHANGES BEGIN HERE: -->
 
     <changes>
+         <change id="SourceUtils-getDependentRoots">
+             <api name="general"/>
+             <summary>Added overloaded method <code>SourceUtils.getDependentRoots</code>.</summary>
+             <version major="0" minor="110"/>
+             <date day="24" month="12" year="2012"/>
+             <author login="ralphbenjamin"/>
+            <compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>
+             <description>
+                 Added a new overloaded method <code>getDependentRoots</code> to class <code>SourceUtils</code>,
+                 that adds an option to filter non opened projects.
+             </description>
+             <class package="org.netbeans.api.java.source" name="SourceUtils"/>
+             <issue number="223917"/>
+        </change>
         <change id="WorkingCopy-resolveRewriteTarget">
              <api name="general"/>
              <summary>Added <code>WorkingCopy.resolveRewriteTarget</code>.</summary>
diff --git a/java.source/nbproject/project.properties b/java.source/nbproject/project.properties
--- a/java.source/nbproject/project.properties
+++ b/java.source/nbproject/project.properties
@@ -46,7 +46,7 @@
 javadoc.title=Java Source
 javadoc.arch=${basedir}/arch.xml
 javadoc.apichanges=${basedir}/apichanges.xml
-spec.version.base=0.109.0
+spec.version.base=0.110.0
 test.qa-functional.cp.extra=${refactoring.java.dir}/modules/ext/nb-javac-api.jar
 test.unit.run.cp.extra=${o.n.core.dir}/core/core.jar:\
     ${o.n.core.dir}/lib/boot.jar:\
diff --git a/java.source/src/org/netbeans/api/java/source/SourceUtils.java b/java.source/src/org/netbeans/api/java/source/SourceUtils.java
--- a/java.source/src/org/netbeans/api/java/source/SourceUtils.java
+++ b/java.source/src/org/netbeans/api/java/source/SourceUtils.java
@@ -96,6 +96,7 @@
 import org.netbeans.api.java.queries.SourceForBinaryQuery;
 import org.netbeans.api.java.source.ClasspathInfo.PathKind;
 import org.netbeans.api.java.source.JavaSource.Phase;
+import static org.netbeans.api.java.source.SourceUtils.getDependentRootsImpl;
 import org.netbeans.api.java.source.matching.Matcher;
 import org.netbeans.api.java.source.matching.Occurrence;
 import org.netbeans.api.java.source.matching.Pattern;
@@ -675,12 +676,30 @@
     public static Set<URL> getDependentRoots (final URL root) {
         final Map<URL, List<URL>> sourceDeps = IndexingController.getDefault().getRootDependencies();
         final Map<URL, List<URL>> binaryDeps = IndexingController.getDefault().getBinaryRootDependencies();
-        return getDependentRootsImpl (root, sourceDeps, binaryDeps);
+        return getDependentRootsImpl (root, sourceDeps, binaryDeps, true);
     }
     
+    /**
+     * Returns the dependent source path roots for given source root. It returns
+     * all the source roots which have either direct or transitive dependency on
+     * the given source root.
+     *
+     * @param root to find the dependent roots for
+     * @param filterNonOpenedProjects true if the results should only contain roots for
+     * opened projects
+     * @return {@link Set} of {@link URL}s containing at least the incoming
+     * root, never returns null.
+     * @since 0.110
+     */
+    @org.netbeans.api.annotations.common.SuppressWarnings(value = {"DMI_COLLECTION_OF_URLS"}/*,justification="URLs have never host part"*/)    //NOI18N
+    public static Set<URL> getDependentRoots(final URL root, boolean filterNonOpenedProjects) {
+        final Map<URL, List<URL>> sourceDeps = IndexingController.getDefault().getRootDependencies();
+        final Map<URL, List<URL>> binaryDeps = IndexingController.getDefault().getBinaryRootDependencies();
+        return getDependentRootsImpl(root, sourceDeps, binaryDeps, filterNonOpenedProjects);
+    }
 
     @org.netbeans.api.annotations.common.SuppressWarnings(value={"DMI_COLLECTION_OF_URLS"}/*,justification="URLs have never host part"*/)    //NOI18N
-    static Set<URL> getDependentRootsImpl (final URL root, final Map<URL, List<URL>> sourceDeps, Map<URL, List<URL>> binaryDeps) {
+    static Set<URL> getDependentRootsImpl (final URL root, final Map<URL, List<URL>> sourceDeps, Map<URL, List<URL>> binaryDeps, boolean filterNonOpenedProjects) {
         Set<URL> urls;
 
         if (sourceDeps.containsKey(root)) {
@@ -703,15 +722,16 @@
             }
         }
 
-        //Filter non opened projects
-        Set<ClassPath> cps = GlobalPathRegistry.getDefault().getPaths(ClassPath.SOURCE);
-        Set<URL> toRetain = new HashSet<URL>();
-        for (ClassPath cp : cps) {
-            for (ClassPath.Entry e : cp.entries()) {
-                toRetain.add(e.getURL());
+        if(filterNonOpenedProjects) {
+            Set<ClassPath> cps = GlobalPathRegistry.getDefault().getPaths(ClassPath.SOURCE);
+            Set<URL> toRetain = new HashSet<URL>();
+            for (ClassPath cp : cps) {
+                for (ClassPath.Entry e : cp.entries()) {
+                    toRetain.add(e.getURL());
+                }
             }
+            urls.retainAll(toRetain);
         }
-        urls.retainAll(toRetain);
         return urls;
     }    
     
diff --git a/java.source/test/unit/src/org/netbeans/api/java/source/SourceUtilsTest.java b/java.source/test/unit/src/org/netbeans/api/java/source/SourceUtilsTest.java
--- a/java.source/test/unit/src/org/netbeans/api/java/source/SourceUtilsTest.java
+++ b/java.source/test/unit/src/org/netbeans/api/java/source/SourceUtilsTest.java
@@ -268,20 +268,20 @@
         deps.put (url4,deps2);
         deps.put (url5,deps3);
         
-        Set<URL> result = SourceUtils.getDependentRootsImpl(url5, deps, Collections.<URL, List<URL>>emptyMap());
+        Set<URL> result = SourceUtils.getDependentRootsImpl(url5, deps, Collections.<URL, List<URL>>emptyMap(), true);
         assertEquals (1, result.size());
         assertEquals (url5,result.iterator().next());
         
-        result = SourceUtils.getDependentRootsImpl(url4, deps, Collections.<URL, List<URL>>emptyMap());
+        result = SourceUtils.getDependentRootsImpl(url4, deps, Collections.<URL, List<URL>>emptyMap(), true);
         assertEquals (new URL[] {url4, url5}, result);
         
-        result = SourceUtils.getDependentRootsImpl(url3, deps, Collections.<URL, List<URL>>emptyMap());
+        result = SourceUtils.getDependentRootsImpl(url3, deps, Collections.<URL, List<URL>>emptyMap(), true);
         assertEquals (new URL[] {url3, url5}, result);
         
-        result = SourceUtils.getDependentRootsImpl(url2, deps, Collections.<URL, List<URL>>emptyMap());
+        result = SourceUtils.getDependentRootsImpl(url2, deps, Collections.<URL, List<URL>>emptyMap(), true);
         assertEquals (new URL[] {url2, url3, url4, url5}, result);
         
-        result = SourceUtils.getDependentRootsImpl(url1, deps, Collections.<URL, List<URL>>emptyMap());
+        result = SourceUtils.getDependentRootsImpl(url1, deps, Collections.<URL, List<URL>>emptyMap(), true);
         assertEquals (new URL[] {url1, url3, url5}, result);
     }