You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@commons.apache.org by ch...@apache.org on 2018/09/22 23:12:34 UTC
svn commit: r1035574 [12/47] - in
/websites/production/commons/content/proper/commons-lang: ./ apidocs/
apidocs/org/apache/commons/lang3/ apidocs/org/apache/commons/lang3/arch/
apidocs/org/apache/commons/lang3/arch/class-use/
apidocs/org/apache/commons...
Modified: websites/production/commons/content/proper/commons-lang/apidocs/src-html/org/apache/commons/lang3/ThreadUtils.NamePredicate.html
==============================================================================
--- websites/production/commons/content/proper/commons-lang/apidocs/src-html/org/apache/commons/lang3/ThreadUtils.NamePredicate.html (original)
+++ websites/production/commons/content/proper/commons-lang/apidocs/src-html/org/apache/commons/lang3/ThreadUtils.NamePredicate.html Sat Sep 22 23:12:29 2018
@@ -247,207 +247,209 @@
<span class="sourceLineNo">239</span> /**<a name="line.239"></a>
<span class="sourceLineNo">240</span> * A predicate for selecting threads.<a name="line.240"></a>
<span class="sourceLineNo">241</span> */<a name="line.241"></a>
-<span class="sourceLineNo">242</span> //if java minimal version for lang becomes 1.8 extend this interface from java.util.function.Predicate<a name="line.242"></a>
-<span class="sourceLineNo">243</span> public interface ThreadPredicate /*extends java.util.function.Predicate<Thread>*/{<a name="line.243"></a>
-<span class="sourceLineNo">244</span><a name="line.244"></a>
-<span class="sourceLineNo">245</span> /**<a name="line.245"></a>
-<span class="sourceLineNo">246</span> * Evaluates this predicate on the given thread.<a name="line.246"></a>
-<span class="sourceLineNo">247</span> * @param thread the thread<a name="line.247"></a>
-<span class="sourceLineNo">248</span> * @return {@code true} if the thread matches the predicate, otherwise {@code false}<a name="line.248"></a>
-<span class="sourceLineNo">249</span> */<a name="line.249"></a>
-<span class="sourceLineNo">250</span> boolean test(Thread thread);<a name="line.250"></a>
-<span class="sourceLineNo">251</span> }<a name="line.251"></a>
-<span class="sourceLineNo">252</span><a name="line.252"></a>
-<span class="sourceLineNo">253</span> /**<a name="line.253"></a>
-<span class="sourceLineNo">254</span> * A predicate for selecting threadgroups.<a name="line.254"></a>
-<span class="sourceLineNo">255</span> */<a name="line.255"></a>
-<span class="sourceLineNo">256</span> //if java minimal version for lang becomes 1.8 extend this interface from java.util.function.Predicate<a name="line.256"></a>
-<span class="sourceLineNo">257</span> public interface ThreadGroupPredicate /*extends java.util.function.Predicate<ThreadGroup>*/{<a name="line.257"></a>
-<span class="sourceLineNo">258</span><a name="line.258"></a>
-<span class="sourceLineNo">259</span> /**<a name="line.259"></a>
-<span class="sourceLineNo">260</span> * Evaluates this predicate on the given threadgroup.<a name="line.260"></a>
-<span class="sourceLineNo">261</span> * @param threadGroup the threadgroup<a name="line.261"></a>
-<span class="sourceLineNo">262</span> * @return {@code true} if the threadGroup matches the predicate, otherwise {@code false}<a name="line.262"></a>
-<span class="sourceLineNo">263</span> */<a name="line.263"></a>
-<span class="sourceLineNo">264</span> boolean test(ThreadGroup threadGroup);<a name="line.264"></a>
-<span class="sourceLineNo">265</span> }<a name="line.265"></a>
-<span class="sourceLineNo">266</span><a name="line.266"></a>
-<span class="sourceLineNo">267</span> /**<a name="line.267"></a>
-<span class="sourceLineNo">268</span> * Predicate which always returns true.<a name="line.268"></a>
-<span class="sourceLineNo">269</span> */<a name="line.269"></a>
-<span class="sourceLineNo">270</span> public static final AlwaysTruePredicate ALWAYS_TRUE_PREDICATE = new AlwaysTruePredicate();<a name="line.270"></a>
-<span class="sourceLineNo">271</span><a name="line.271"></a>
-<span class="sourceLineNo">272</span> /**<a name="line.272"></a>
-<span class="sourceLineNo">273</span> * A predicate implementation which always returns true.<a name="line.273"></a>
-<span class="sourceLineNo">274</span> */<a name="line.274"></a>
-<span class="sourceLineNo">275</span> private static final class AlwaysTruePredicate implements ThreadPredicate, ThreadGroupPredicate{<a name="line.275"></a>
-<span class="sourceLineNo">276</span><a name="line.276"></a>
-<span class="sourceLineNo">277</span> private AlwaysTruePredicate() {<a name="line.277"></a>
-<span class="sourceLineNo">278</span> }<a name="line.278"></a>
-<span class="sourceLineNo">279</span><a name="line.279"></a>
-<span class="sourceLineNo">280</span> @Override<a name="line.280"></a>
-<span class="sourceLineNo">281</span> public boolean test(final ThreadGroup threadGroup) {<a name="line.281"></a>
-<span class="sourceLineNo">282</span> return true;<a name="line.282"></a>
-<span class="sourceLineNo">283</span> }<a name="line.283"></a>
-<span class="sourceLineNo">284</span><a name="line.284"></a>
-<span class="sourceLineNo">285</span> @Override<a name="line.285"></a>
-<span class="sourceLineNo">286</span> public boolean test(final Thread thread) {<a name="line.286"></a>
-<span class="sourceLineNo">287</span> return true;<a name="line.287"></a>
-<span class="sourceLineNo">288</span> }<a name="line.288"></a>
-<span class="sourceLineNo">289</span> }<a name="line.289"></a>
-<span class="sourceLineNo">290</span><a name="line.290"></a>
-<span class="sourceLineNo">291</span> /**<a name="line.291"></a>
-<span class="sourceLineNo">292</span> * A predicate implementation which matches a thread or threadgroup name.<a name="line.292"></a>
-<span class="sourceLineNo">293</span> */<a name="line.293"></a>
-<span class="sourceLineNo">294</span> public static class NamePredicate implements ThreadPredicate, ThreadGroupPredicate {<a name="line.294"></a>
-<span class="sourceLineNo">295</span><a name="line.295"></a>
-<span class="sourceLineNo">296</span> private final String name;<a name="line.296"></a>
+<span class="sourceLineNo">242</span> // When breaking BC, replace this with Predicate<Thread><a name="line.242"></a>
+<span class="sourceLineNo">243</span> @FunctionalInterface<a name="line.243"></a>
+<span class="sourceLineNo">244</span> public interface ThreadPredicate {<a name="line.244"></a>
+<span class="sourceLineNo">245</span><a name="line.245"></a>
+<span class="sourceLineNo">246</span> /**<a name="line.246"></a>
+<span class="sourceLineNo">247</span> * Evaluates this predicate on the given thread.<a name="line.247"></a>
+<span class="sourceLineNo">248</span> * @param thread the thread<a name="line.248"></a>
+<span class="sourceLineNo">249</span> * @return {@code true} if the thread matches the predicate, otherwise {@code false}<a name="line.249"></a>
+<span class="sourceLineNo">250</span> */<a name="line.250"></a>
+<span class="sourceLineNo">251</span> boolean test(Thread thread);<a name="line.251"></a>
+<span class="sourceLineNo">252</span> }<a name="line.252"></a>
+<span class="sourceLineNo">253</span><a name="line.253"></a>
+<span class="sourceLineNo">254</span> /**<a name="line.254"></a>
+<span class="sourceLineNo">255</span> * A predicate for selecting threadgroups.<a name="line.255"></a>
+<span class="sourceLineNo">256</span> */<a name="line.256"></a>
+<span class="sourceLineNo">257</span> // When breaking BC, replace this with Predicate<ThreadGroup><a name="line.257"></a>
+<span class="sourceLineNo">258</span> @FunctionalInterface<a name="line.258"></a>
+<span class="sourceLineNo">259</span> public interface ThreadGroupPredicate {<a name="line.259"></a>
+<span class="sourceLineNo">260</span><a name="line.260"></a>
+<span class="sourceLineNo">261</span> /**<a name="line.261"></a>
+<span class="sourceLineNo">262</span> * Evaluates this predicate on the given threadgroup.<a name="line.262"></a>
+<span class="sourceLineNo">263</span> * @param threadGroup the threadgroup<a name="line.263"></a>
+<span class="sourceLineNo">264</span> * @return {@code true} if the threadGroup matches the predicate, otherwise {@code false}<a name="line.264"></a>
+<span class="sourceLineNo">265</span> */<a name="line.265"></a>
+<span class="sourceLineNo">266</span> boolean test(ThreadGroup threadGroup);<a name="line.266"></a>
+<span class="sourceLineNo">267</span> }<a name="line.267"></a>
+<span class="sourceLineNo">268</span><a name="line.268"></a>
+<span class="sourceLineNo">269</span> /**<a name="line.269"></a>
+<span class="sourceLineNo">270</span> * Predicate which always returns true.<a name="line.270"></a>
+<span class="sourceLineNo">271</span> */<a name="line.271"></a>
+<span class="sourceLineNo">272</span> public static final AlwaysTruePredicate ALWAYS_TRUE_PREDICATE = new AlwaysTruePredicate();<a name="line.272"></a>
+<span class="sourceLineNo">273</span><a name="line.273"></a>
+<span class="sourceLineNo">274</span> /**<a name="line.274"></a>
+<span class="sourceLineNo">275</span> * A predicate implementation which always returns true.<a name="line.275"></a>
+<span class="sourceLineNo">276</span> */<a name="line.276"></a>
+<span class="sourceLineNo">277</span> private static final class AlwaysTruePredicate implements ThreadPredicate, ThreadGroupPredicate {<a name="line.277"></a>
+<span class="sourceLineNo">278</span><a name="line.278"></a>
+<span class="sourceLineNo">279</span> private AlwaysTruePredicate() {<a name="line.279"></a>
+<span class="sourceLineNo">280</span> }<a name="line.280"></a>
+<span class="sourceLineNo">281</span><a name="line.281"></a>
+<span class="sourceLineNo">282</span> @Override<a name="line.282"></a>
+<span class="sourceLineNo">283</span> public boolean test(final ThreadGroup threadGroup) {<a name="line.283"></a>
+<span class="sourceLineNo">284</span> return true;<a name="line.284"></a>
+<span class="sourceLineNo">285</span> }<a name="line.285"></a>
+<span class="sourceLineNo">286</span><a name="line.286"></a>
+<span class="sourceLineNo">287</span> @Override<a name="line.287"></a>
+<span class="sourceLineNo">288</span> public boolean test(final Thread thread) {<a name="line.288"></a>
+<span class="sourceLineNo">289</span> return true;<a name="line.289"></a>
+<span class="sourceLineNo">290</span> }<a name="line.290"></a>
+<span class="sourceLineNo">291</span> }<a name="line.291"></a>
+<span class="sourceLineNo">292</span><a name="line.292"></a>
+<span class="sourceLineNo">293</span> /**<a name="line.293"></a>
+<span class="sourceLineNo">294</span> * A predicate implementation which matches a thread or threadgroup name.<a name="line.294"></a>
+<span class="sourceLineNo">295</span> */<a name="line.295"></a>
+<span class="sourceLineNo">296</span> public static class NamePredicate implements ThreadPredicate, ThreadGroupPredicate {<a name="line.296"></a>
<span class="sourceLineNo">297</span><a name="line.297"></a>
-<span class="sourceLineNo">298</span> /**<a name="line.298"></a>
-<span class="sourceLineNo">299</span> * Predicate constructor<a name="line.299"></a>
-<span class="sourceLineNo">300</span> *<a name="line.300"></a>
-<span class="sourceLineNo">301</span> * @param name thread or threadgroup name<a name="line.301"></a>
-<span class="sourceLineNo">302</span> * @throws IllegalArgumentException if the name is {@code null}<a name="line.302"></a>
-<span class="sourceLineNo">303</span> */<a name="line.303"></a>
-<span class="sourceLineNo">304</span> public NamePredicate(final String name) {<a name="line.304"></a>
-<span class="sourceLineNo">305</span> super();<a name="line.305"></a>
-<span class="sourceLineNo">306</span> Validate.isTrue(name != null, "The name must not be null");<a name="line.306"></a>
-<span class="sourceLineNo">307</span> this.name = name;<a name="line.307"></a>
-<span class="sourceLineNo">308</span> }<a name="line.308"></a>
-<span class="sourceLineNo">309</span><a name="line.309"></a>
-<span class="sourceLineNo">310</span> @Override<a name="line.310"></a>
-<span class="sourceLineNo">311</span> public boolean test(final ThreadGroup threadGroup) {<a name="line.311"></a>
-<span class="sourceLineNo">312</span> return threadGroup != null && threadGroup.getName().equals(name);<a name="line.312"></a>
-<span class="sourceLineNo">313</span> }<a name="line.313"></a>
-<span class="sourceLineNo">314</span><a name="line.314"></a>
-<span class="sourceLineNo">315</span> @Override<a name="line.315"></a>
-<span class="sourceLineNo">316</span> public boolean test(final Thread thread) {<a name="line.316"></a>
-<span class="sourceLineNo">317</span> return thread != null && thread.getName().equals(name);<a name="line.317"></a>
-<span class="sourceLineNo">318</span> }<a name="line.318"></a>
-<span class="sourceLineNo">319</span> }<a name="line.319"></a>
-<span class="sourceLineNo">320</span><a name="line.320"></a>
-<span class="sourceLineNo">321</span> /**<a name="line.321"></a>
-<span class="sourceLineNo">322</span> * A predicate implementation which matches a thread id.<a name="line.322"></a>
-<span class="sourceLineNo">323</span> */<a name="line.323"></a>
-<span class="sourceLineNo">324</span> public static class ThreadIdPredicate implements ThreadPredicate {<a name="line.324"></a>
-<span class="sourceLineNo">325</span><a name="line.325"></a>
-<span class="sourceLineNo">326</span> private final long threadId;<a name="line.326"></a>
+<span class="sourceLineNo">298</span> private final String name;<a name="line.298"></a>
+<span class="sourceLineNo">299</span><a name="line.299"></a>
+<span class="sourceLineNo">300</span> /**<a name="line.300"></a>
+<span class="sourceLineNo">301</span> * Predicate constructor<a name="line.301"></a>
+<span class="sourceLineNo">302</span> *<a name="line.302"></a>
+<span class="sourceLineNo">303</span> * @param name thread or threadgroup name<a name="line.303"></a>
+<span class="sourceLineNo">304</span> * @throws IllegalArgumentException if the name is {@code null}<a name="line.304"></a>
+<span class="sourceLineNo">305</span> */<a name="line.305"></a>
+<span class="sourceLineNo">306</span> public NamePredicate(final String name) {<a name="line.306"></a>
+<span class="sourceLineNo">307</span> super();<a name="line.307"></a>
+<span class="sourceLineNo">308</span> Validate.isTrue(name != null, "The name must not be null");<a name="line.308"></a>
+<span class="sourceLineNo">309</span> this.name = name;<a name="line.309"></a>
+<span class="sourceLineNo">310</span> }<a name="line.310"></a>
+<span class="sourceLineNo">311</span><a name="line.311"></a>
+<span class="sourceLineNo">312</span> @Override<a name="line.312"></a>
+<span class="sourceLineNo">313</span> public boolean test(final ThreadGroup threadGroup) {<a name="line.313"></a>
+<span class="sourceLineNo">314</span> return threadGroup != null && threadGroup.getName().equals(name);<a name="line.314"></a>
+<span class="sourceLineNo">315</span> }<a name="line.315"></a>
+<span class="sourceLineNo">316</span><a name="line.316"></a>
+<span class="sourceLineNo">317</span> @Override<a name="line.317"></a>
+<span class="sourceLineNo">318</span> public boolean test(final Thread thread) {<a name="line.318"></a>
+<span class="sourceLineNo">319</span> return thread != null && thread.getName().equals(name);<a name="line.319"></a>
+<span class="sourceLineNo">320</span> }<a name="line.320"></a>
+<span class="sourceLineNo">321</span> }<a name="line.321"></a>
+<span class="sourceLineNo">322</span><a name="line.322"></a>
+<span class="sourceLineNo">323</span> /**<a name="line.323"></a>
+<span class="sourceLineNo">324</span> * A predicate implementation which matches a thread id.<a name="line.324"></a>
+<span class="sourceLineNo">325</span> */<a name="line.325"></a>
+<span class="sourceLineNo">326</span> public static class ThreadIdPredicate implements ThreadPredicate {<a name="line.326"></a>
<span class="sourceLineNo">327</span><a name="line.327"></a>
-<span class="sourceLineNo">328</span> /**<a name="line.328"></a>
-<span class="sourceLineNo">329</span> * Predicate constructor<a name="line.329"></a>
-<span class="sourceLineNo">330</span> *<a name="line.330"></a>
-<span class="sourceLineNo">331</span> * @param threadId the threadId to match<a name="line.331"></a>
-<span class="sourceLineNo">332</span> * @throws IllegalArgumentException if the threadId is zero or negative<a name="line.332"></a>
-<span class="sourceLineNo">333</span> */<a name="line.333"></a>
-<span class="sourceLineNo">334</span> public ThreadIdPredicate(final long threadId) {<a name="line.334"></a>
-<span class="sourceLineNo">335</span> super();<a name="line.335"></a>
-<span class="sourceLineNo">336</span> if (threadId <= 0) {<a name="line.336"></a>
-<span class="sourceLineNo">337</span> throw new IllegalArgumentException("The thread id must be greater than zero");<a name="line.337"></a>
-<span class="sourceLineNo">338</span> }<a name="line.338"></a>
-<span class="sourceLineNo">339</span> this.threadId = threadId;<a name="line.339"></a>
-<span class="sourceLineNo">340</span> }<a name="line.340"></a>
-<span class="sourceLineNo">341</span><a name="line.341"></a>
-<span class="sourceLineNo">342</span> @Override<a name="line.342"></a>
-<span class="sourceLineNo">343</span> public boolean test(final Thread thread) {<a name="line.343"></a>
-<span class="sourceLineNo">344</span> return thread != null && thread.getId() == threadId;<a name="line.344"></a>
-<span class="sourceLineNo">345</span> }<a name="line.345"></a>
-<span class="sourceLineNo">346</span> }<a name="line.346"></a>
-<span class="sourceLineNo">347</span><a name="line.347"></a>
-<span class="sourceLineNo">348</span> /**<a name="line.348"></a>
-<span class="sourceLineNo">349</span> * Select all active threads which match the given predicate.<a name="line.349"></a>
-<span class="sourceLineNo">350</span> *<a name="line.350"></a>
-<span class="sourceLineNo">351</span> * @param predicate the predicate<a name="line.351"></a>
-<span class="sourceLineNo">352</span> * @return An unmodifiable {@code Collection} of active threads matching the given predicate<a name="line.352"></a>
-<span class="sourceLineNo">353</span> *<a name="line.353"></a>
-<span class="sourceLineNo">354</span> * @throws IllegalArgumentException if the predicate is null<a name="line.354"></a>
-<span class="sourceLineNo">355</span> * @throws SecurityException<a name="line.355"></a>
-<span class="sourceLineNo">356</span> * if the current thread cannot access the system thread group<a name="line.356"></a>
-<span class="sourceLineNo">357</span> * @throws SecurityException if the current thread cannot modify<a name="line.357"></a>
-<span class="sourceLineNo">358</span> * thread groups from this thread's thread group up to the system thread group<a name="line.358"></a>
-<span class="sourceLineNo">359</span> */<a name="line.359"></a>
-<span class="sourceLineNo">360</span> public static Collection<Thread> findThreads(final ThreadPredicate predicate){<a name="line.360"></a>
-<span class="sourceLineNo">361</span> return findThreads(getSystemThreadGroup(), true, predicate);<a name="line.361"></a>
-<span class="sourceLineNo">362</span> }<a name="line.362"></a>
-<span class="sourceLineNo">363</span><a name="line.363"></a>
-<span class="sourceLineNo">364</span> /**<a name="line.364"></a>
-<span class="sourceLineNo">365</span> * Select all active threadgroups which match the given predicate.<a name="line.365"></a>
-<span class="sourceLineNo">366</span> *<a name="line.366"></a>
-<span class="sourceLineNo">367</span> * @param predicate the predicate<a name="line.367"></a>
-<span class="sourceLineNo">368</span> * @return An unmodifiable {@code Collection} of active threadgroups matching the given predicate<a name="line.368"></a>
-<span class="sourceLineNo">369</span> * @throws IllegalArgumentException if the predicate is null<a name="line.369"></a>
-<span class="sourceLineNo">370</span> * @throws SecurityException<a name="line.370"></a>
-<span class="sourceLineNo">371</span> * if the current thread cannot access the system thread group<a name="line.371"></a>
-<span class="sourceLineNo">372</span> * @throws SecurityException if the current thread cannot modify<a name="line.372"></a>
-<span class="sourceLineNo">373</span> * thread groups from this thread's thread group up to the system thread group<a name="line.373"></a>
-<span class="sourceLineNo">374</span> */<a name="line.374"></a>
-<span class="sourceLineNo">375</span> public static Collection<ThreadGroup> findThreadGroups(final ThreadGroupPredicate predicate){<a name="line.375"></a>
-<span class="sourceLineNo">376</span> return findThreadGroups(getSystemThreadGroup(), true, predicate);<a name="line.376"></a>
-<span class="sourceLineNo">377</span> }<a name="line.377"></a>
-<span class="sourceLineNo">378</span><a name="line.378"></a>
-<span class="sourceLineNo">379</span> /**<a name="line.379"></a>
-<span class="sourceLineNo">380</span> * Select all active threads which match the given predicate and which belongs to the given thread group (or one of its subgroups).<a name="line.380"></a>
-<span class="sourceLineNo">381</span> *<a name="line.381"></a>
-<span class="sourceLineNo">382</span> * @param group the thread group<a name="line.382"></a>
-<span class="sourceLineNo">383</span> * @param recurse if {@code true} then evaluate the predicate recursively on all threads in all subgroups of the given group<a name="line.383"></a>
-<span class="sourceLineNo">384</span> * @param predicate the predicate<a name="line.384"></a>
-<span class="sourceLineNo">385</span> * @return An unmodifiable {@code Collection} of active threads which match the given predicate and which belongs to the given thread group<a name="line.385"></a>
-<span class="sourceLineNo">386</span> * @throws IllegalArgumentException if the given group or predicate is null<a name="line.386"></a>
-<span class="sourceLineNo">387</span> * @throws SecurityException if the current thread cannot modify<a name="line.387"></a>
-<span class="sourceLineNo">388</span> * thread groups from this thread's thread group up to the system thread group<a name="line.388"></a>
-<span class="sourceLineNo">389</span> */<a name="line.389"></a>
-<span class="sourceLineNo">390</span> public static Collection<Thread> findThreads(final ThreadGroup group, final boolean recurse, final ThreadPredicate predicate) {<a name="line.390"></a>
-<span class="sourceLineNo">391</span> Validate.isTrue(group != null, "The group must not be null");<a name="line.391"></a>
-<span class="sourceLineNo">392</span> Validate.isTrue(predicate != null, "The predicate must not be null");<a name="line.392"></a>
-<span class="sourceLineNo">393</span><a name="line.393"></a>
-<span class="sourceLineNo">394</span> int count = group.activeCount();<a name="line.394"></a>
-<span class="sourceLineNo">395</span> Thread[] threads;<a name="line.395"></a>
-<span class="sourceLineNo">396</span> do {<a name="line.396"></a>
-<span class="sourceLineNo">397</span> threads = new Thread[count + (count / 2) + 1]; //slightly grow the array size<a name="line.397"></a>
-<span class="sourceLineNo">398</span> count = group.enumerate(threads, recurse);<a name="line.398"></a>
-<span class="sourceLineNo">399</span> //return value of enumerate() must be strictly less than the array size according to javadoc<a name="line.399"></a>
-<span class="sourceLineNo">400</span> } while (count >= threads.length);<a name="line.400"></a>
-<span class="sourceLineNo">401</span><a name="line.401"></a>
-<span class="sourceLineNo">402</span> final List<Thread> result = new ArrayList<>(count);<a name="line.402"></a>
-<span class="sourceLineNo">403</span> for (int i = 0; i < count; ++i) {<a name="line.403"></a>
-<span class="sourceLineNo">404</span> if (predicate.test(threads[i])) {<a name="line.404"></a>
-<span class="sourceLineNo">405</span> result.add(threads[i]);<a name="line.405"></a>
-<span class="sourceLineNo">406</span> }<a name="line.406"></a>
-<span class="sourceLineNo">407</span> }<a name="line.407"></a>
-<span class="sourceLineNo">408</span> return Collections.unmodifiableCollection(result);<a name="line.408"></a>
-<span class="sourceLineNo">409</span> }<a name="line.409"></a>
-<span class="sourceLineNo">410</span><a name="line.410"></a>
-<span class="sourceLineNo">411</span> /**<a name="line.411"></a>
-<span class="sourceLineNo">412</span> * Select all active threadgroups which match the given predicate and which is a subgroup of the given thread group (or one of its subgroups).<a name="line.412"></a>
-<span class="sourceLineNo">413</span> *<a name="line.413"></a>
-<span class="sourceLineNo">414</span> * @param group the thread group<a name="line.414"></a>
-<span class="sourceLineNo">415</span> * @param recurse if {@code true} then evaluate the predicate recursively on all threadgroups in all subgroups of the given group<a name="line.415"></a>
-<span class="sourceLineNo">416</span> * @param predicate the predicate<a name="line.416"></a>
-<span class="sourceLineNo">417</span> * @return An unmodifiable {@code Collection} of active threadgroups which match the given predicate and which is a subgroup of the given thread group<a name="line.417"></a>
-<span class="sourceLineNo">418</span> * @throws IllegalArgumentException if the given group or predicate is null<a name="line.418"></a>
-<span class="sourceLineNo">419</span> * @throws SecurityException if the current thread cannot modify<a name="line.419"></a>
-<span class="sourceLineNo">420</span> * thread groups from this thread's thread group up to the system thread group<a name="line.420"></a>
-<span class="sourceLineNo">421</span> */<a name="line.421"></a>
-<span class="sourceLineNo">422</span> public static Collection<ThreadGroup> findThreadGroups(final ThreadGroup group, final boolean recurse, final ThreadGroupPredicate predicate){<a name="line.422"></a>
-<span class="sourceLineNo">423</span> Validate.isTrue(group != null, "The group must not be null");<a name="line.423"></a>
-<span class="sourceLineNo">424</span> Validate.isTrue(predicate != null, "The predicate must not be null");<a name="line.424"></a>
-<span class="sourceLineNo">425</span><a name="line.425"></a>
-<span class="sourceLineNo">426</span> int count = group.activeGroupCount();<a name="line.426"></a>
-<span class="sourceLineNo">427</span> ThreadGroup[] threadGroups;<a name="line.427"></a>
-<span class="sourceLineNo">428</span> do {<a name="line.428"></a>
-<span class="sourceLineNo">429</span> threadGroups = new ThreadGroup[count + (count / 2) + 1]; //slightly grow the array size<a name="line.429"></a>
-<span class="sourceLineNo">430</span> count = group.enumerate(threadGroups, recurse);<a name="line.430"></a>
-<span class="sourceLineNo">431</span> //return value of enumerate() must be strictly less than the array size according to javadoc<a name="line.431"></a>
-<span class="sourceLineNo">432</span> } while(count >= threadGroups.length);<a name="line.432"></a>
-<span class="sourceLineNo">433</span><a name="line.433"></a>
-<span class="sourceLineNo">434</span> final List<ThreadGroup> result = new ArrayList<>(count);<a name="line.434"></a>
-<span class="sourceLineNo">435</span> for(int i = 0; i < count; ++i) {<a name="line.435"></a>
-<span class="sourceLineNo">436</span> if(predicate.test(threadGroups[i])) {<a name="line.436"></a>
-<span class="sourceLineNo">437</span> result.add(threadGroups[i]);<a name="line.437"></a>
-<span class="sourceLineNo">438</span> }<a name="line.438"></a>
-<span class="sourceLineNo">439</span> }<a name="line.439"></a>
-<span class="sourceLineNo">440</span> return Collections.unmodifiableCollection(result);<a name="line.440"></a>
-<span class="sourceLineNo">441</span> }<a name="line.441"></a>
-<span class="sourceLineNo">442</span>}<a name="line.442"></a>
+<span class="sourceLineNo">328</span> private final long threadId;<a name="line.328"></a>
+<span class="sourceLineNo">329</span><a name="line.329"></a>
+<span class="sourceLineNo">330</span> /**<a name="line.330"></a>
+<span class="sourceLineNo">331</span> * Predicate constructor<a name="line.331"></a>
+<span class="sourceLineNo">332</span> *<a name="line.332"></a>
+<span class="sourceLineNo">333</span> * @param threadId the threadId to match<a name="line.333"></a>
+<span class="sourceLineNo">334</span> * @throws IllegalArgumentException if the threadId is zero or negative<a name="line.334"></a>
+<span class="sourceLineNo">335</span> */<a name="line.335"></a>
+<span class="sourceLineNo">336</span> public ThreadIdPredicate(final long threadId) {<a name="line.336"></a>
+<span class="sourceLineNo">337</span> super();<a name="line.337"></a>
+<span class="sourceLineNo">338</span> if (threadId <= 0) {<a name="line.338"></a>
+<span class="sourceLineNo">339</span> throw new IllegalArgumentException("The thread id must be greater than zero");<a name="line.339"></a>
+<span class="sourceLineNo">340</span> }<a name="line.340"></a>
+<span class="sourceLineNo">341</span> this.threadId = threadId;<a name="line.341"></a>
+<span class="sourceLineNo">342</span> }<a name="line.342"></a>
+<span class="sourceLineNo">343</span><a name="line.343"></a>
+<span class="sourceLineNo">344</span> @Override<a name="line.344"></a>
+<span class="sourceLineNo">345</span> public boolean test(final Thread thread) {<a name="line.345"></a>
+<span class="sourceLineNo">346</span> return thread != null && thread.getId() == threadId;<a name="line.346"></a>
+<span class="sourceLineNo">347</span> }<a name="line.347"></a>
+<span class="sourceLineNo">348</span> }<a name="line.348"></a>
+<span class="sourceLineNo">349</span><a name="line.349"></a>
+<span class="sourceLineNo">350</span> /**<a name="line.350"></a>
+<span class="sourceLineNo">351</span> * Select all active threads which match the given predicate.<a name="line.351"></a>
+<span class="sourceLineNo">352</span> *<a name="line.352"></a>
+<span class="sourceLineNo">353</span> * @param predicate the predicate<a name="line.353"></a>
+<span class="sourceLineNo">354</span> * @return An unmodifiable {@code Collection} of active threads matching the given predicate<a name="line.354"></a>
+<span class="sourceLineNo">355</span> *<a name="line.355"></a>
+<span class="sourceLineNo">356</span> * @throws IllegalArgumentException if the predicate is null<a name="line.356"></a>
+<span class="sourceLineNo">357</span> * @throws SecurityException<a name="line.357"></a>
+<span class="sourceLineNo">358</span> * if the current thread cannot access the system thread group<a name="line.358"></a>
+<span class="sourceLineNo">359</span> * @throws SecurityException if the current thread cannot modify<a name="line.359"></a>
+<span class="sourceLineNo">360</span> * thread groups from this thread's thread group up to the system thread group<a name="line.360"></a>
+<span class="sourceLineNo">361</span> */<a name="line.361"></a>
+<span class="sourceLineNo">362</span> public static Collection<Thread> findThreads(final ThreadPredicate predicate) {<a name="line.362"></a>
+<span class="sourceLineNo">363</span> return findThreads(getSystemThreadGroup(), true, predicate);<a name="line.363"></a>
+<span class="sourceLineNo">364</span> }<a name="line.364"></a>
+<span class="sourceLineNo">365</span><a name="line.365"></a>
+<span class="sourceLineNo">366</span> /**<a name="line.366"></a>
+<span class="sourceLineNo">367</span> * Select all active threadgroups which match the given predicate.<a name="line.367"></a>
+<span class="sourceLineNo">368</span> *<a name="line.368"></a>
+<span class="sourceLineNo">369</span> * @param predicate the predicate<a name="line.369"></a>
+<span class="sourceLineNo">370</span> * @return An unmodifiable {@code Collection} of active threadgroups matching the given predicate<a name="line.370"></a>
+<span class="sourceLineNo">371</span> * @throws IllegalArgumentException if the predicate is null<a name="line.371"></a>
+<span class="sourceLineNo">372</span> * @throws SecurityException<a name="line.372"></a>
+<span class="sourceLineNo">373</span> * if the current thread cannot access the system thread group<a name="line.373"></a>
+<span class="sourceLineNo">374</span> * @throws SecurityException if the current thread cannot modify<a name="line.374"></a>
+<span class="sourceLineNo">375</span> * thread groups from this thread's thread group up to the system thread group<a name="line.375"></a>
+<span class="sourceLineNo">376</span> */<a name="line.376"></a>
+<span class="sourceLineNo">377</span> public static Collection<ThreadGroup> findThreadGroups(final ThreadGroupPredicate predicate) {<a name="line.377"></a>
+<span class="sourceLineNo">378</span> return findThreadGroups(getSystemThreadGroup(), true, predicate);<a name="line.378"></a>
+<span class="sourceLineNo">379</span> }<a name="line.379"></a>
+<span class="sourceLineNo">380</span><a name="line.380"></a>
+<span class="sourceLineNo">381</span> /**<a name="line.381"></a>
+<span class="sourceLineNo">382</span> * Select all active threads which match the given predicate and which belongs to the given thread group (or one of its subgroups).<a name="line.382"></a>
+<span class="sourceLineNo">383</span> *<a name="line.383"></a>
+<span class="sourceLineNo">384</span> * @param group the thread group<a name="line.384"></a>
+<span class="sourceLineNo">385</span> * @param recurse if {@code true} then evaluate the predicate recursively on all threads in all subgroups of the given group<a name="line.385"></a>
+<span class="sourceLineNo">386</span> * @param predicate the predicate<a name="line.386"></a>
+<span class="sourceLineNo">387</span> * @return An unmodifiable {@code Collection} of active threads which match the given predicate and which belongs to the given thread group<a name="line.387"></a>
+<span class="sourceLineNo">388</span> * @throws IllegalArgumentException if the given group or predicate is null<a name="line.388"></a>
+<span class="sourceLineNo">389</span> * @throws SecurityException if the current thread cannot modify<a name="line.389"></a>
+<span class="sourceLineNo">390</span> * thread groups from this thread's thread group up to the system thread group<a name="line.390"></a>
+<span class="sourceLineNo">391</span> */<a name="line.391"></a>
+<span class="sourceLineNo">392</span> public static Collection<Thread> findThreads(final ThreadGroup group, final boolean recurse, final ThreadPredicate predicate) {<a name="line.392"></a>
+<span class="sourceLineNo">393</span> Validate.isTrue(group != null, "The group must not be null");<a name="line.393"></a>
+<span class="sourceLineNo">394</span> Validate.isTrue(predicate != null, "The predicate must not be null");<a name="line.394"></a>
+<span class="sourceLineNo">395</span><a name="line.395"></a>
+<span class="sourceLineNo">396</span> int count = group.activeCount();<a name="line.396"></a>
+<span class="sourceLineNo">397</span> Thread[] threads;<a name="line.397"></a>
+<span class="sourceLineNo">398</span> do {<a name="line.398"></a>
+<span class="sourceLineNo">399</span> threads = new Thread[count + (count / 2) + 1]; //slightly grow the array size<a name="line.399"></a>
+<span class="sourceLineNo">400</span> count = group.enumerate(threads, recurse);<a name="line.400"></a>
+<span class="sourceLineNo">401</span> //return value of enumerate() must be strictly less than the array size according to javadoc<a name="line.401"></a>
+<span class="sourceLineNo">402</span> } while (count >= threads.length);<a name="line.402"></a>
+<span class="sourceLineNo">403</span><a name="line.403"></a>
+<span class="sourceLineNo">404</span> final List<Thread> result = new ArrayList<>(count);<a name="line.404"></a>
+<span class="sourceLineNo">405</span> for (int i = 0; i < count; ++i) {<a name="line.405"></a>
+<span class="sourceLineNo">406</span> if (predicate.test(threads[i])) {<a name="line.406"></a>
+<span class="sourceLineNo">407</span> result.add(threads[i]);<a name="line.407"></a>
+<span class="sourceLineNo">408</span> }<a name="line.408"></a>
+<span class="sourceLineNo">409</span> }<a name="line.409"></a>
+<span class="sourceLineNo">410</span> return Collections.unmodifiableCollection(result);<a name="line.410"></a>
+<span class="sourceLineNo">411</span> }<a name="line.411"></a>
+<span class="sourceLineNo">412</span><a name="line.412"></a>
+<span class="sourceLineNo">413</span> /**<a name="line.413"></a>
+<span class="sourceLineNo">414</span> * Select all active threadgroups which match the given predicate and which is a subgroup of the given thread group (or one of its subgroups).<a name="line.414"></a>
+<span class="sourceLineNo">415</span> *<a name="line.415"></a>
+<span class="sourceLineNo">416</span> * @param group the thread group<a name="line.416"></a>
+<span class="sourceLineNo">417</span> * @param recurse if {@code true} then evaluate the predicate recursively on all threadgroups in all subgroups of the given group<a name="line.417"></a>
+<span class="sourceLineNo">418</span> * @param predicate the predicate<a name="line.418"></a>
+<span class="sourceLineNo">419</span> * @return An unmodifiable {@code Collection} of active threadgroups which match the given predicate and which is a subgroup of the given thread group<a name="line.419"></a>
+<span class="sourceLineNo">420</span> * @throws IllegalArgumentException if the given group or predicate is null<a name="line.420"></a>
+<span class="sourceLineNo">421</span> * @throws SecurityException if the current thread cannot modify<a name="line.421"></a>
+<span class="sourceLineNo">422</span> * thread groups from this thread's thread group up to the system thread group<a name="line.422"></a>
+<span class="sourceLineNo">423</span> */<a name="line.423"></a>
+<span class="sourceLineNo">424</span> public static Collection<ThreadGroup> findThreadGroups(final ThreadGroup group, final boolean recurse, final ThreadGroupPredicate predicate) {<a name="line.424"></a>
+<span class="sourceLineNo">425</span> Validate.isTrue(group != null, "The group must not be null");<a name="line.425"></a>
+<span class="sourceLineNo">426</span> Validate.isTrue(predicate != null, "The predicate must not be null");<a name="line.426"></a>
+<span class="sourceLineNo">427</span><a name="line.427"></a>
+<span class="sourceLineNo">428</span> int count = group.activeGroupCount();<a name="line.428"></a>
+<span class="sourceLineNo">429</span> ThreadGroup[] threadGroups;<a name="line.429"></a>
+<span class="sourceLineNo">430</span> do {<a name="line.430"></a>
+<span class="sourceLineNo">431</span> threadGroups = new ThreadGroup[count + (count / 2) + 1]; //slightly grow the array size<a name="line.431"></a>
+<span class="sourceLineNo">432</span> count = group.enumerate(threadGroups, recurse);<a name="line.432"></a>
+<span class="sourceLineNo">433</span> //return value of enumerate() must be strictly less than the array size according to javadoc<a name="line.433"></a>
+<span class="sourceLineNo">434</span> } while(count >= threadGroups.length);<a name="line.434"></a>
+<span class="sourceLineNo">435</span><a name="line.435"></a>
+<span class="sourceLineNo">436</span> final List<ThreadGroup> result = new ArrayList<>(count);<a name="line.436"></a>
+<span class="sourceLineNo">437</span> for(int i = 0; i < count; ++i) {<a name="line.437"></a>
+<span class="sourceLineNo">438</span> if(predicate.test(threadGroups[i])) {<a name="line.438"></a>
+<span class="sourceLineNo">439</span> result.add(threadGroups[i]);<a name="line.439"></a>
+<span class="sourceLineNo">440</span> }<a name="line.440"></a>
+<span class="sourceLineNo">441</span> }<a name="line.441"></a>
+<span class="sourceLineNo">442</span> return Collections.unmodifiableCollection(result);<a name="line.442"></a>
+<span class="sourceLineNo">443</span> }<a name="line.443"></a>
+<span class="sourceLineNo">444</span>}<a name="line.444"></a>
Modified: websites/production/commons/content/proper/commons-lang/apidocs/src-html/org/apache/commons/lang3/ThreadUtils.ThreadGroupPredicate.html
==============================================================================
--- websites/production/commons/content/proper/commons-lang/apidocs/src-html/org/apache/commons/lang3/ThreadUtils.ThreadGroupPredicate.html (original)
+++ websites/production/commons/content/proper/commons-lang/apidocs/src-html/org/apache/commons/lang3/ThreadUtils.ThreadGroupPredicate.html Sat Sep 22 23:12:29 2018
@@ -247,207 +247,209 @@
<span class="sourceLineNo">239</span> /**<a name="line.239"></a>
<span class="sourceLineNo">240</span> * A predicate for selecting threads.<a name="line.240"></a>
<span class="sourceLineNo">241</span> */<a name="line.241"></a>
-<span class="sourceLineNo">242</span> //if java minimal version for lang becomes 1.8 extend this interface from java.util.function.Predicate<a name="line.242"></a>
-<span class="sourceLineNo">243</span> public interface ThreadPredicate /*extends java.util.function.Predicate<Thread>*/{<a name="line.243"></a>
-<span class="sourceLineNo">244</span><a name="line.244"></a>
-<span class="sourceLineNo">245</span> /**<a name="line.245"></a>
-<span class="sourceLineNo">246</span> * Evaluates this predicate on the given thread.<a name="line.246"></a>
-<span class="sourceLineNo">247</span> * @param thread the thread<a name="line.247"></a>
-<span class="sourceLineNo">248</span> * @return {@code true} if the thread matches the predicate, otherwise {@code false}<a name="line.248"></a>
-<span class="sourceLineNo">249</span> */<a name="line.249"></a>
-<span class="sourceLineNo">250</span> boolean test(Thread thread);<a name="line.250"></a>
-<span class="sourceLineNo">251</span> }<a name="line.251"></a>
-<span class="sourceLineNo">252</span><a name="line.252"></a>
-<span class="sourceLineNo">253</span> /**<a name="line.253"></a>
-<span class="sourceLineNo">254</span> * A predicate for selecting threadgroups.<a name="line.254"></a>
-<span class="sourceLineNo">255</span> */<a name="line.255"></a>
-<span class="sourceLineNo">256</span> //if java minimal version for lang becomes 1.8 extend this interface from java.util.function.Predicate<a name="line.256"></a>
-<span class="sourceLineNo">257</span> public interface ThreadGroupPredicate /*extends java.util.function.Predicate<ThreadGroup>*/{<a name="line.257"></a>
-<span class="sourceLineNo">258</span><a name="line.258"></a>
-<span class="sourceLineNo">259</span> /**<a name="line.259"></a>
-<span class="sourceLineNo">260</span> * Evaluates this predicate on the given threadgroup.<a name="line.260"></a>
-<span class="sourceLineNo">261</span> * @param threadGroup the threadgroup<a name="line.261"></a>
-<span class="sourceLineNo">262</span> * @return {@code true} if the threadGroup matches the predicate, otherwise {@code false}<a name="line.262"></a>
-<span class="sourceLineNo">263</span> */<a name="line.263"></a>
-<span class="sourceLineNo">264</span> boolean test(ThreadGroup threadGroup);<a name="line.264"></a>
-<span class="sourceLineNo">265</span> }<a name="line.265"></a>
-<span class="sourceLineNo">266</span><a name="line.266"></a>
-<span class="sourceLineNo">267</span> /**<a name="line.267"></a>
-<span class="sourceLineNo">268</span> * Predicate which always returns true.<a name="line.268"></a>
-<span class="sourceLineNo">269</span> */<a name="line.269"></a>
-<span class="sourceLineNo">270</span> public static final AlwaysTruePredicate ALWAYS_TRUE_PREDICATE = new AlwaysTruePredicate();<a name="line.270"></a>
-<span class="sourceLineNo">271</span><a name="line.271"></a>
-<span class="sourceLineNo">272</span> /**<a name="line.272"></a>
-<span class="sourceLineNo">273</span> * A predicate implementation which always returns true.<a name="line.273"></a>
-<span class="sourceLineNo">274</span> */<a name="line.274"></a>
-<span class="sourceLineNo">275</span> private static final class AlwaysTruePredicate implements ThreadPredicate, ThreadGroupPredicate{<a name="line.275"></a>
-<span class="sourceLineNo">276</span><a name="line.276"></a>
-<span class="sourceLineNo">277</span> private AlwaysTruePredicate() {<a name="line.277"></a>
-<span class="sourceLineNo">278</span> }<a name="line.278"></a>
-<span class="sourceLineNo">279</span><a name="line.279"></a>
-<span class="sourceLineNo">280</span> @Override<a name="line.280"></a>
-<span class="sourceLineNo">281</span> public boolean test(final ThreadGroup threadGroup) {<a name="line.281"></a>
-<span class="sourceLineNo">282</span> return true;<a name="line.282"></a>
-<span class="sourceLineNo">283</span> }<a name="line.283"></a>
-<span class="sourceLineNo">284</span><a name="line.284"></a>
-<span class="sourceLineNo">285</span> @Override<a name="line.285"></a>
-<span class="sourceLineNo">286</span> public boolean test(final Thread thread) {<a name="line.286"></a>
-<span class="sourceLineNo">287</span> return true;<a name="line.287"></a>
-<span class="sourceLineNo">288</span> }<a name="line.288"></a>
-<span class="sourceLineNo">289</span> }<a name="line.289"></a>
-<span class="sourceLineNo">290</span><a name="line.290"></a>
-<span class="sourceLineNo">291</span> /**<a name="line.291"></a>
-<span class="sourceLineNo">292</span> * A predicate implementation which matches a thread or threadgroup name.<a name="line.292"></a>
-<span class="sourceLineNo">293</span> */<a name="line.293"></a>
-<span class="sourceLineNo">294</span> public static class NamePredicate implements ThreadPredicate, ThreadGroupPredicate {<a name="line.294"></a>
-<span class="sourceLineNo">295</span><a name="line.295"></a>
-<span class="sourceLineNo">296</span> private final String name;<a name="line.296"></a>
+<span class="sourceLineNo">242</span> // When breaking BC, replace this with Predicate<Thread><a name="line.242"></a>
+<span class="sourceLineNo">243</span> @FunctionalInterface<a name="line.243"></a>
+<span class="sourceLineNo">244</span> public interface ThreadPredicate {<a name="line.244"></a>
+<span class="sourceLineNo">245</span><a name="line.245"></a>
+<span class="sourceLineNo">246</span> /**<a name="line.246"></a>
+<span class="sourceLineNo">247</span> * Evaluates this predicate on the given thread.<a name="line.247"></a>
+<span class="sourceLineNo">248</span> * @param thread the thread<a name="line.248"></a>
+<span class="sourceLineNo">249</span> * @return {@code true} if the thread matches the predicate, otherwise {@code false}<a name="line.249"></a>
+<span class="sourceLineNo">250</span> */<a name="line.250"></a>
+<span class="sourceLineNo">251</span> boolean test(Thread thread);<a name="line.251"></a>
+<span class="sourceLineNo">252</span> }<a name="line.252"></a>
+<span class="sourceLineNo">253</span><a name="line.253"></a>
+<span class="sourceLineNo">254</span> /**<a name="line.254"></a>
+<span class="sourceLineNo">255</span> * A predicate for selecting threadgroups.<a name="line.255"></a>
+<span class="sourceLineNo">256</span> */<a name="line.256"></a>
+<span class="sourceLineNo">257</span> // When breaking BC, replace this with Predicate<ThreadGroup><a name="line.257"></a>
+<span class="sourceLineNo">258</span> @FunctionalInterface<a name="line.258"></a>
+<span class="sourceLineNo">259</span> public interface ThreadGroupPredicate {<a name="line.259"></a>
+<span class="sourceLineNo">260</span><a name="line.260"></a>
+<span class="sourceLineNo">261</span> /**<a name="line.261"></a>
+<span class="sourceLineNo">262</span> * Evaluates this predicate on the given threadgroup.<a name="line.262"></a>
+<span class="sourceLineNo">263</span> * @param threadGroup the threadgroup<a name="line.263"></a>
+<span class="sourceLineNo">264</span> * @return {@code true} if the threadGroup matches the predicate, otherwise {@code false}<a name="line.264"></a>
+<span class="sourceLineNo">265</span> */<a name="line.265"></a>
+<span class="sourceLineNo">266</span> boolean test(ThreadGroup threadGroup);<a name="line.266"></a>
+<span class="sourceLineNo">267</span> }<a name="line.267"></a>
+<span class="sourceLineNo">268</span><a name="line.268"></a>
+<span class="sourceLineNo">269</span> /**<a name="line.269"></a>
+<span class="sourceLineNo">270</span> * Predicate which always returns true.<a name="line.270"></a>
+<span class="sourceLineNo">271</span> */<a name="line.271"></a>
+<span class="sourceLineNo">272</span> public static final AlwaysTruePredicate ALWAYS_TRUE_PREDICATE = new AlwaysTruePredicate();<a name="line.272"></a>
+<span class="sourceLineNo">273</span><a name="line.273"></a>
+<span class="sourceLineNo">274</span> /**<a name="line.274"></a>
+<span class="sourceLineNo">275</span> * A predicate implementation which always returns true.<a name="line.275"></a>
+<span class="sourceLineNo">276</span> */<a name="line.276"></a>
+<span class="sourceLineNo">277</span> private static final class AlwaysTruePredicate implements ThreadPredicate, ThreadGroupPredicate {<a name="line.277"></a>
+<span class="sourceLineNo">278</span><a name="line.278"></a>
+<span class="sourceLineNo">279</span> private AlwaysTruePredicate() {<a name="line.279"></a>
+<span class="sourceLineNo">280</span> }<a name="line.280"></a>
+<span class="sourceLineNo">281</span><a name="line.281"></a>
+<span class="sourceLineNo">282</span> @Override<a name="line.282"></a>
+<span class="sourceLineNo">283</span> public boolean test(final ThreadGroup threadGroup) {<a name="line.283"></a>
+<span class="sourceLineNo">284</span> return true;<a name="line.284"></a>
+<span class="sourceLineNo">285</span> }<a name="line.285"></a>
+<span class="sourceLineNo">286</span><a name="line.286"></a>
+<span class="sourceLineNo">287</span> @Override<a name="line.287"></a>
+<span class="sourceLineNo">288</span> public boolean test(final Thread thread) {<a name="line.288"></a>
+<span class="sourceLineNo">289</span> return true;<a name="line.289"></a>
+<span class="sourceLineNo">290</span> }<a name="line.290"></a>
+<span class="sourceLineNo">291</span> }<a name="line.291"></a>
+<span class="sourceLineNo">292</span><a name="line.292"></a>
+<span class="sourceLineNo">293</span> /**<a name="line.293"></a>
+<span class="sourceLineNo">294</span> * A predicate implementation which matches a thread or threadgroup name.<a name="line.294"></a>
+<span class="sourceLineNo">295</span> */<a name="line.295"></a>
+<span class="sourceLineNo">296</span> public static class NamePredicate implements ThreadPredicate, ThreadGroupPredicate {<a name="line.296"></a>
<span class="sourceLineNo">297</span><a name="line.297"></a>
-<span class="sourceLineNo">298</span> /**<a name="line.298"></a>
-<span class="sourceLineNo">299</span> * Predicate constructor<a name="line.299"></a>
-<span class="sourceLineNo">300</span> *<a name="line.300"></a>
-<span class="sourceLineNo">301</span> * @param name thread or threadgroup name<a name="line.301"></a>
-<span class="sourceLineNo">302</span> * @throws IllegalArgumentException if the name is {@code null}<a name="line.302"></a>
-<span class="sourceLineNo">303</span> */<a name="line.303"></a>
-<span class="sourceLineNo">304</span> public NamePredicate(final String name) {<a name="line.304"></a>
-<span class="sourceLineNo">305</span> super();<a name="line.305"></a>
-<span class="sourceLineNo">306</span> Validate.isTrue(name != null, "The name must not be null");<a name="line.306"></a>
-<span class="sourceLineNo">307</span> this.name = name;<a name="line.307"></a>
-<span class="sourceLineNo">308</span> }<a name="line.308"></a>
-<span class="sourceLineNo">309</span><a name="line.309"></a>
-<span class="sourceLineNo">310</span> @Override<a name="line.310"></a>
-<span class="sourceLineNo">311</span> public boolean test(final ThreadGroup threadGroup) {<a name="line.311"></a>
-<span class="sourceLineNo">312</span> return threadGroup != null && threadGroup.getName().equals(name);<a name="line.312"></a>
-<span class="sourceLineNo">313</span> }<a name="line.313"></a>
-<span class="sourceLineNo">314</span><a name="line.314"></a>
-<span class="sourceLineNo">315</span> @Override<a name="line.315"></a>
-<span class="sourceLineNo">316</span> public boolean test(final Thread thread) {<a name="line.316"></a>
-<span class="sourceLineNo">317</span> return thread != null && thread.getName().equals(name);<a name="line.317"></a>
-<span class="sourceLineNo">318</span> }<a name="line.318"></a>
-<span class="sourceLineNo">319</span> }<a name="line.319"></a>
-<span class="sourceLineNo">320</span><a name="line.320"></a>
-<span class="sourceLineNo">321</span> /**<a name="line.321"></a>
-<span class="sourceLineNo">322</span> * A predicate implementation which matches a thread id.<a name="line.322"></a>
-<span class="sourceLineNo">323</span> */<a name="line.323"></a>
-<span class="sourceLineNo">324</span> public static class ThreadIdPredicate implements ThreadPredicate {<a name="line.324"></a>
-<span class="sourceLineNo">325</span><a name="line.325"></a>
-<span class="sourceLineNo">326</span> private final long threadId;<a name="line.326"></a>
+<span class="sourceLineNo">298</span> private final String name;<a name="line.298"></a>
+<span class="sourceLineNo">299</span><a name="line.299"></a>
+<span class="sourceLineNo">300</span> /**<a name="line.300"></a>
+<span class="sourceLineNo">301</span> * Predicate constructor<a name="line.301"></a>
+<span class="sourceLineNo">302</span> *<a name="line.302"></a>
+<span class="sourceLineNo">303</span> * @param name thread or threadgroup name<a name="line.303"></a>
+<span class="sourceLineNo">304</span> * @throws IllegalArgumentException if the name is {@code null}<a name="line.304"></a>
+<span class="sourceLineNo">305</span> */<a name="line.305"></a>
+<span class="sourceLineNo">306</span> public NamePredicate(final String name) {<a name="line.306"></a>
+<span class="sourceLineNo">307</span> super();<a name="line.307"></a>
+<span class="sourceLineNo">308</span> Validate.isTrue(name != null, "The name must not be null");<a name="line.308"></a>
+<span class="sourceLineNo">309</span> this.name = name;<a name="line.309"></a>
+<span class="sourceLineNo">310</span> }<a name="line.310"></a>
+<span class="sourceLineNo">311</span><a name="line.311"></a>
+<span class="sourceLineNo">312</span> @Override<a name="line.312"></a>
+<span class="sourceLineNo">313</span> public boolean test(final ThreadGroup threadGroup) {<a name="line.313"></a>
+<span class="sourceLineNo">314</span> return threadGroup != null && threadGroup.getName().equals(name);<a name="line.314"></a>
+<span class="sourceLineNo">315</span> }<a name="line.315"></a>
+<span class="sourceLineNo">316</span><a name="line.316"></a>
+<span class="sourceLineNo">317</span> @Override<a name="line.317"></a>
+<span class="sourceLineNo">318</span> public boolean test(final Thread thread) {<a name="line.318"></a>
+<span class="sourceLineNo">319</span> return thread != null && thread.getName().equals(name);<a name="line.319"></a>
+<span class="sourceLineNo">320</span> }<a name="line.320"></a>
+<span class="sourceLineNo">321</span> }<a name="line.321"></a>
+<span class="sourceLineNo">322</span><a name="line.322"></a>
+<span class="sourceLineNo">323</span> /**<a name="line.323"></a>
+<span class="sourceLineNo">324</span> * A predicate implementation which matches a thread id.<a name="line.324"></a>
+<span class="sourceLineNo">325</span> */<a name="line.325"></a>
+<span class="sourceLineNo">326</span> public static class ThreadIdPredicate implements ThreadPredicate {<a name="line.326"></a>
<span class="sourceLineNo">327</span><a name="line.327"></a>
-<span class="sourceLineNo">328</span> /**<a name="line.328"></a>
-<span class="sourceLineNo">329</span> * Predicate constructor<a name="line.329"></a>
-<span class="sourceLineNo">330</span> *<a name="line.330"></a>
-<span class="sourceLineNo">331</span> * @param threadId the threadId to match<a name="line.331"></a>
-<span class="sourceLineNo">332</span> * @throws IllegalArgumentException if the threadId is zero or negative<a name="line.332"></a>
-<span class="sourceLineNo">333</span> */<a name="line.333"></a>
-<span class="sourceLineNo">334</span> public ThreadIdPredicate(final long threadId) {<a name="line.334"></a>
-<span class="sourceLineNo">335</span> super();<a name="line.335"></a>
-<span class="sourceLineNo">336</span> if (threadId <= 0) {<a name="line.336"></a>
-<span class="sourceLineNo">337</span> throw new IllegalArgumentException("The thread id must be greater than zero");<a name="line.337"></a>
-<span class="sourceLineNo">338</span> }<a name="line.338"></a>
-<span class="sourceLineNo">339</span> this.threadId = threadId;<a name="line.339"></a>
-<span class="sourceLineNo">340</span> }<a name="line.340"></a>
-<span class="sourceLineNo">341</span><a name="line.341"></a>
-<span class="sourceLineNo">342</span> @Override<a name="line.342"></a>
-<span class="sourceLineNo">343</span> public boolean test(final Thread thread) {<a name="line.343"></a>
-<span class="sourceLineNo">344</span> return thread != null && thread.getId() == threadId;<a name="line.344"></a>
-<span class="sourceLineNo">345</span> }<a name="line.345"></a>
-<span class="sourceLineNo">346</span> }<a name="line.346"></a>
-<span class="sourceLineNo">347</span><a name="line.347"></a>
-<span class="sourceLineNo">348</span> /**<a name="line.348"></a>
-<span class="sourceLineNo">349</span> * Select all active threads which match the given predicate.<a name="line.349"></a>
-<span class="sourceLineNo">350</span> *<a name="line.350"></a>
-<span class="sourceLineNo">351</span> * @param predicate the predicate<a name="line.351"></a>
-<span class="sourceLineNo">352</span> * @return An unmodifiable {@code Collection} of active threads matching the given predicate<a name="line.352"></a>
-<span class="sourceLineNo">353</span> *<a name="line.353"></a>
-<span class="sourceLineNo">354</span> * @throws IllegalArgumentException if the predicate is null<a name="line.354"></a>
-<span class="sourceLineNo">355</span> * @throws SecurityException<a name="line.355"></a>
-<span class="sourceLineNo">356</span> * if the current thread cannot access the system thread group<a name="line.356"></a>
-<span class="sourceLineNo">357</span> * @throws SecurityException if the current thread cannot modify<a name="line.357"></a>
-<span class="sourceLineNo">358</span> * thread groups from this thread's thread group up to the system thread group<a name="line.358"></a>
-<span class="sourceLineNo">359</span> */<a name="line.359"></a>
-<span class="sourceLineNo">360</span> public static Collection<Thread> findThreads(final ThreadPredicate predicate){<a name="line.360"></a>
-<span class="sourceLineNo">361</span> return findThreads(getSystemThreadGroup(), true, predicate);<a name="line.361"></a>
-<span class="sourceLineNo">362</span> }<a name="line.362"></a>
-<span class="sourceLineNo">363</span><a name="line.363"></a>
-<span class="sourceLineNo">364</span> /**<a name="line.364"></a>
-<span class="sourceLineNo">365</span> * Select all active threadgroups which match the given predicate.<a name="line.365"></a>
-<span class="sourceLineNo">366</span> *<a name="line.366"></a>
-<span class="sourceLineNo">367</span> * @param predicate the predicate<a name="line.367"></a>
-<span class="sourceLineNo">368</span> * @return An unmodifiable {@code Collection} of active threadgroups matching the given predicate<a name="line.368"></a>
-<span class="sourceLineNo">369</span> * @throws IllegalArgumentException if the predicate is null<a name="line.369"></a>
-<span class="sourceLineNo">370</span> * @throws SecurityException<a name="line.370"></a>
-<span class="sourceLineNo">371</span> * if the current thread cannot access the system thread group<a name="line.371"></a>
-<span class="sourceLineNo">372</span> * @throws SecurityException if the current thread cannot modify<a name="line.372"></a>
-<span class="sourceLineNo">373</span> * thread groups from this thread's thread group up to the system thread group<a name="line.373"></a>
-<span class="sourceLineNo">374</span> */<a name="line.374"></a>
-<span class="sourceLineNo">375</span> public static Collection<ThreadGroup> findThreadGroups(final ThreadGroupPredicate predicate){<a name="line.375"></a>
-<span class="sourceLineNo">376</span> return findThreadGroups(getSystemThreadGroup(), true, predicate);<a name="line.376"></a>
-<span class="sourceLineNo">377</span> }<a name="line.377"></a>
-<span class="sourceLineNo">378</span><a name="line.378"></a>
-<span class="sourceLineNo">379</span> /**<a name="line.379"></a>
-<span class="sourceLineNo">380</span> * Select all active threads which match the given predicate and which belongs to the given thread group (or one of its subgroups).<a name="line.380"></a>
-<span class="sourceLineNo">381</span> *<a name="line.381"></a>
-<span class="sourceLineNo">382</span> * @param group the thread group<a name="line.382"></a>
-<span class="sourceLineNo">383</span> * @param recurse if {@code true} then evaluate the predicate recursively on all threads in all subgroups of the given group<a name="line.383"></a>
-<span class="sourceLineNo">384</span> * @param predicate the predicate<a name="line.384"></a>
-<span class="sourceLineNo">385</span> * @return An unmodifiable {@code Collection} of active threads which match the given predicate and which belongs to the given thread group<a name="line.385"></a>
-<span class="sourceLineNo">386</span> * @throws IllegalArgumentException if the given group or predicate is null<a name="line.386"></a>
-<span class="sourceLineNo">387</span> * @throws SecurityException if the current thread cannot modify<a name="line.387"></a>
-<span class="sourceLineNo">388</span> * thread groups from this thread's thread group up to the system thread group<a name="line.388"></a>
-<span class="sourceLineNo">389</span> */<a name="line.389"></a>
-<span class="sourceLineNo">390</span> public static Collection<Thread> findThreads(final ThreadGroup group, final boolean recurse, final ThreadPredicate predicate) {<a name="line.390"></a>
-<span class="sourceLineNo">391</span> Validate.isTrue(group != null, "The group must not be null");<a name="line.391"></a>
-<span class="sourceLineNo">392</span> Validate.isTrue(predicate != null, "The predicate must not be null");<a name="line.392"></a>
-<span class="sourceLineNo">393</span><a name="line.393"></a>
-<span class="sourceLineNo">394</span> int count = group.activeCount();<a name="line.394"></a>
-<span class="sourceLineNo">395</span> Thread[] threads;<a name="line.395"></a>
-<span class="sourceLineNo">396</span> do {<a name="line.396"></a>
-<span class="sourceLineNo">397</span> threads = new Thread[count + (count / 2) + 1]; //slightly grow the array size<a name="line.397"></a>
-<span class="sourceLineNo">398</span> count = group.enumerate(threads, recurse);<a name="line.398"></a>
-<span class="sourceLineNo">399</span> //return value of enumerate() must be strictly less than the array size according to javadoc<a name="line.399"></a>
-<span class="sourceLineNo">400</span> } while (count >= threads.length);<a name="line.400"></a>
-<span class="sourceLineNo">401</span><a name="line.401"></a>
-<span class="sourceLineNo">402</span> final List<Thread> result = new ArrayList<>(count);<a name="line.402"></a>
-<span class="sourceLineNo">403</span> for (int i = 0; i < count; ++i) {<a name="line.403"></a>
-<span class="sourceLineNo">404</span> if (predicate.test(threads[i])) {<a name="line.404"></a>
-<span class="sourceLineNo">405</span> result.add(threads[i]);<a name="line.405"></a>
-<span class="sourceLineNo">406</span> }<a name="line.406"></a>
-<span class="sourceLineNo">407</span> }<a name="line.407"></a>
-<span class="sourceLineNo">408</span> return Collections.unmodifiableCollection(result);<a name="line.408"></a>
-<span class="sourceLineNo">409</span> }<a name="line.409"></a>
-<span class="sourceLineNo">410</span><a name="line.410"></a>
-<span class="sourceLineNo">411</span> /**<a name="line.411"></a>
-<span class="sourceLineNo">412</span> * Select all active threadgroups which match the given predicate and which is a subgroup of the given thread group (or one of its subgroups).<a name="line.412"></a>
-<span class="sourceLineNo">413</span> *<a name="line.413"></a>
-<span class="sourceLineNo">414</span> * @param group the thread group<a name="line.414"></a>
-<span class="sourceLineNo">415</span> * @param recurse if {@code true} then evaluate the predicate recursively on all threadgroups in all subgroups of the given group<a name="line.415"></a>
-<span class="sourceLineNo">416</span> * @param predicate the predicate<a name="line.416"></a>
-<span class="sourceLineNo">417</span> * @return An unmodifiable {@code Collection} of active threadgroups which match the given predicate and which is a subgroup of the given thread group<a name="line.417"></a>
-<span class="sourceLineNo">418</span> * @throws IllegalArgumentException if the given group or predicate is null<a name="line.418"></a>
-<span class="sourceLineNo">419</span> * @throws SecurityException if the current thread cannot modify<a name="line.419"></a>
-<span class="sourceLineNo">420</span> * thread groups from this thread's thread group up to the system thread group<a name="line.420"></a>
-<span class="sourceLineNo">421</span> */<a name="line.421"></a>
-<span class="sourceLineNo">422</span> public static Collection<ThreadGroup> findThreadGroups(final ThreadGroup group, final boolean recurse, final ThreadGroupPredicate predicate){<a name="line.422"></a>
-<span class="sourceLineNo">423</span> Validate.isTrue(group != null, "The group must not be null");<a name="line.423"></a>
-<span class="sourceLineNo">424</span> Validate.isTrue(predicate != null, "The predicate must not be null");<a name="line.424"></a>
-<span class="sourceLineNo">425</span><a name="line.425"></a>
-<span class="sourceLineNo">426</span> int count = group.activeGroupCount();<a name="line.426"></a>
-<span class="sourceLineNo">427</span> ThreadGroup[] threadGroups;<a name="line.427"></a>
-<span class="sourceLineNo">428</span> do {<a name="line.428"></a>
-<span class="sourceLineNo">429</span> threadGroups = new ThreadGroup[count + (count / 2) + 1]; //slightly grow the array size<a name="line.429"></a>
-<span class="sourceLineNo">430</span> count = group.enumerate(threadGroups, recurse);<a name="line.430"></a>
-<span class="sourceLineNo">431</span> //return value of enumerate() must be strictly less than the array size according to javadoc<a name="line.431"></a>
-<span class="sourceLineNo">432</span> } while(count >= threadGroups.length);<a name="line.432"></a>
-<span class="sourceLineNo">433</span><a name="line.433"></a>
-<span class="sourceLineNo">434</span> final List<ThreadGroup> result = new ArrayList<>(count);<a name="line.434"></a>
-<span class="sourceLineNo">435</span> for(int i = 0; i < count; ++i) {<a name="line.435"></a>
-<span class="sourceLineNo">436</span> if(predicate.test(threadGroups[i])) {<a name="line.436"></a>
-<span class="sourceLineNo">437</span> result.add(threadGroups[i]);<a name="line.437"></a>
-<span class="sourceLineNo">438</span> }<a name="line.438"></a>
-<span class="sourceLineNo">439</span> }<a name="line.439"></a>
-<span class="sourceLineNo">440</span> return Collections.unmodifiableCollection(result);<a name="line.440"></a>
-<span class="sourceLineNo">441</span> }<a name="line.441"></a>
-<span class="sourceLineNo">442</span>}<a name="line.442"></a>
+<span class="sourceLineNo">328</span> private final long threadId;<a name="line.328"></a>
+<span class="sourceLineNo">329</span><a name="line.329"></a>
+<span class="sourceLineNo">330</span> /**<a name="line.330"></a>
+<span class="sourceLineNo">331</span> * Predicate constructor<a name="line.331"></a>
+<span class="sourceLineNo">332</span> *<a name="line.332"></a>
+<span class="sourceLineNo">333</span> * @param threadId the threadId to match<a name="line.333"></a>
+<span class="sourceLineNo">334</span> * @throws IllegalArgumentException if the threadId is zero or negative<a name="line.334"></a>
+<span class="sourceLineNo">335</span> */<a name="line.335"></a>
+<span class="sourceLineNo">336</span> public ThreadIdPredicate(final long threadId) {<a name="line.336"></a>
+<span class="sourceLineNo">337</span> super();<a name="line.337"></a>
+<span class="sourceLineNo">338</span> if (threadId <= 0) {<a name="line.338"></a>
+<span class="sourceLineNo">339</span> throw new IllegalArgumentException("The thread id must be greater than zero");<a name="line.339"></a>
+<span class="sourceLineNo">340</span> }<a name="line.340"></a>
+<span class="sourceLineNo">341</span> this.threadId = threadId;<a name="line.341"></a>
+<span class="sourceLineNo">342</span> }<a name="line.342"></a>
+<span class="sourceLineNo">343</span><a name="line.343"></a>
+<span class="sourceLineNo">344</span> @Override<a name="line.344"></a>
+<span class="sourceLineNo">345</span> public boolean test(final Thread thread) {<a name="line.345"></a>
+<span class="sourceLineNo">346</span> return thread != null && thread.getId() == threadId;<a name="line.346"></a>
+<span class="sourceLineNo">347</span> }<a name="line.347"></a>
+<span class="sourceLineNo">348</span> }<a name="line.348"></a>
+<span class="sourceLineNo">349</span><a name="line.349"></a>
+<span class="sourceLineNo">350</span> /**<a name="line.350"></a>
+<span class="sourceLineNo">351</span> * Select all active threads which match the given predicate.<a name="line.351"></a>
+<span class="sourceLineNo">352</span> *<a name="line.352"></a>
+<span class="sourceLineNo">353</span> * @param predicate the predicate<a name="line.353"></a>
+<span class="sourceLineNo">354</span> * @return An unmodifiable {@code Collection} of active threads matching the given predicate<a name="line.354"></a>
+<span class="sourceLineNo">355</span> *<a name="line.355"></a>
+<span class="sourceLineNo">356</span> * @throws IllegalArgumentException if the predicate is null<a name="line.356"></a>
+<span class="sourceLineNo">357</span> * @throws SecurityException<a name="line.357"></a>
+<span class="sourceLineNo">358</span> * if the current thread cannot access the system thread group<a name="line.358"></a>
+<span class="sourceLineNo">359</span> * @throws SecurityException if the current thread cannot modify<a name="line.359"></a>
+<span class="sourceLineNo">360</span> * thread groups from this thread's thread group up to the system thread group<a name="line.360"></a>
+<span class="sourceLineNo">361</span> */<a name="line.361"></a>
+<span class="sourceLineNo">362</span> public static Collection<Thread> findThreads(final ThreadPredicate predicate) {<a name="line.362"></a>
+<span class="sourceLineNo">363</span> return findThreads(getSystemThreadGroup(), true, predicate);<a name="line.363"></a>
+<span class="sourceLineNo">364</span> }<a name="line.364"></a>
+<span class="sourceLineNo">365</span><a name="line.365"></a>
+<span class="sourceLineNo">366</span> /**<a name="line.366"></a>
+<span class="sourceLineNo">367</span> * Select all active threadgroups which match the given predicate.<a name="line.367"></a>
+<span class="sourceLineNo">368</span> *<a name="line.368"></a>
+<span class="sourceLineNo">369</span> * @param predicate the predicate<a name="line.369"></a>
+<span class="sourceLineNo">370</span> * @return An unmodifiable {@code Collection} of active threadgroups matching the given predicate<a name="line.370"></a>
+<span class="sourceLineNo">371</span> * @throws IllegalArgumentException if the predicate is null<a name="line.371"></a>
+<span class="sourceLineNo">372</span> * @throws SecurityException<a name="line.372"></a>
+<span class="sourceLineNo">373</span> * if the current thread cannot access the system thread group<a name="line.373"></a>
+<span class="sourceLineNo">374</span> * @throws SecurityException if the current thread cannot modify<a name="line.374"></a>
+<span class="sourceLineNo">375</span> * thread groups from this thread's thread group up to the system thread group<a name="line.375"></a>
+<span class="sourceLineNo">376</span> */<a name="line.376"></a>
+<span class="sourceLineNo">377</span> public static Collection<ThreadGroup> findThreadGroups(final ThreadGroupPredicate predicate) {<a name="line.377"></a>
+<span class="sourceLineNo">378</span> return findThreadGroups(getSystemThreadGroup(), true, predicate);<a name="line.378"></a>
+<span class="sourceLineNo">379</span> }<a name="line.379"></a>
+<span class="sourceLineNo">380</span><a name="line.380"></a>
+<span class="sourceLineNo">381</span> /**<a name="line.381"></a>
+<span class="sourceLineNo">382</span> * Select all active threads which match the given predicate and which belongs to the given thread group (or one of its subgroups).<a name="line.382"></a>
+<span class="sourceLineNo">383</span> *<a name="line.383"></a>
+<span class="sourceLineNo">384</span> * @param group the thread group<a name="line.384"></a>
+<span class="sourceLineNo">385</span> * @param recurse if {@code true} then evaluate the predicate recursively on all threads in all subgroups of the given group<a name="line.385"></a>
+<span class="sourceLineNo">386</span> * @param predicate the predicate<a name="line.386"></a>
+<span class="sourceLineNo">387</span> * @return An unmodifiable {@code Collection} of active threads which match the given predicate and which belongs to the given thread group<a name="line.387"></a>
+<span class="sourceLineNo">388</span> * @throws IllegalArgumentException if the given group or predicate is null<a name="line.388"></a>
+<span class="sourceLineNo">389</span> * @throws SecurityException if the current thread cannot modify<a name="line.389"></a>
+<span class="sourceLineNo">390</span> * thread groups from this thread's thread group up to the system thread group<a name="line.390"></a>
+<span class="sourceLineNo">391</span> */<a name="line.391"></a>
+<span class="sourceLineNo">392</span> public static Collection<Thread> findThreads(final ThreadGroup group, final boolean recurse, final ThreadPredicate predicate) {<a name="line.392"></a>
+<span class="sourceLineNo">393</span> Validate.isTrue(group != null, "The group must not be null");<a name="line.393"></a>
+<span class="sourceLineNo">394</span> Validate.isTrue(predicate != null, "The predicate must not be null");<a name="line.394"></a>
+<span class="sourceLineNo">395</span><a name="line.395"></a>
+<span class="sourceLineNo">396</span> int count = group.activeCount();<a name="line.396"></a>
+<span class="sourceLineNo">397</span> Thread[] threads;<a name="line.397"></a>
+<span class="sourceLineNo">398</span> do {<a name="line.398"></a>
+<span class="sourceLineNo">399</span> threads = new Thread[count + (count / 2) + 1]; //slightly grow the array size<a name="line.399"></a>
+<span class="sourceLineNo">400</span> count = group.enumerate(threads, recurse);<a name="line.400"></a>
+<span class="sourceLineNo">401</span> //return value of enumerate() must be strictly less than the array size according to javadoc<a name="line.401"></a>
+<span class="sourceLineNo">402</span> } while (count >= threads.length);<a name="line.402"></a>
+<span class="sourceLineNo">403</span><a name="line.403"></a>
+<span class="sourceLineNo">404</span> final List<Thread> result = new ArrayList<>(count);<a name="line.404"></a>
+<span class="sourceLineNo">405</span> for (int i = 0; i < count; ++i) {<a name="line.405"></a>
+<span class="sourceLineNo">406</span> if (predicate.test(threads[i])) {<a name="line.406"></a>
+<span class="sourceLineNo">407</span> result.add(threads[i]);<a name="line.407"></a>
+<span class="sourceLineNo">408</span> }<a name="line.408"></a>
+<span class="sourceLineNo">409</span> }<a name="line.409"></a>
+<span class="sourceLineNo">410</span> return Collections.unmodifiableCollection(result);<a name="line.410"></a>
+<span class="sourceLineNo">411</span> }<a name="line.411"></a>
+<span class="sourceLineNo">412</span><a name="line.412"></a>
+<span class="sourceLineNo">413</span> /**<a name="line.413"></a>
+<span class="sourceLineNo">414</span> * Select all active threadgroups which match the given predicate and which is a subgroup of the given thread group (or one of its subgroups).<a name="line.414"></a>
+<span class="sourceLineNo">415</span> *<a name="line.415"></a>
+<span class="sourceLineNo">416</span> * @param group the thread group<a name="line.416"></a>
+<span class="sourceLineNo">417</span> * @param recurse if {@code true} then evaluate the predicate recursively on all threadgroups in all subgroups of the given group<a name="line.417"></a>
+<span class="sourceLineNo">418</span> * @param predicate the predicate<a name="line.418"></a>
+<span class="sourceLineNo">419</span> * @return An unmodifiable {@code Collection} of active threadgroups which match the given predicate and which is a subgroup of the given thread group<a name="line.419"></a>
+<span class="sourceLineNo">420</span> * @throws IllegalArgumentException if the given group or predicate is null<a name="line.420"></a>
+<span class="sourceLineNo">421</span> * @throws SecurityException if the current thread cannot modify<a name="line.421"></a>
+<span class="sourceLineNo">422</span> * thread groups from this thread's thread group up to the system thread group<a name="line.422"></a>
+<span class="sourceLineNo">423</span> */<a name="line.423"></a>
+<span class="sourceLineNo">424</span> public static Collection<ThreadGroup> findThreadGroups(final ThreadGroup group, final boolean recurse, final ThreadGroupPredicate predicate) {<a name="line.424"></a>
+<span class="sourceLineNo">425</span> Validate.isTrue(group != null, "The group must not be null");<a name="line.425"></a>
+<span class="sourceLineNo">426</span> Validate.isTrue(predicate != null, "The predicate must not be null");<a name="line.426"></a>
+<span class="sourceLineNo">427</span><a name="line.427"></a>
+<span class="sourceLineNo">428</span> int count = group.activeGroupCount();<a name="line.428"></a>
+<span class="sourceLineNo">429</span> ThreadGroup[] threadGroups;<a name="line.429"></a>
+<span class="sourceLineNo">430</span> do {<a name="line.430"></a>
+<span class="sourceLineNo">431</span> threadGroups = new ThreadGroup[count + (count / 2) + 1]; //slightly grow the array size<a name="line.431"></a>
+<span class="sourceLineNo">432</span> count = group.enumerate(threadGroups, recurse);<a name="line.432"></a>
+<span class="sourceLineNo">433</span> //return value of enumerate() must be strictly less than the array size according to javadoc<a name="line.433"></a>
+<span class="sourceLineNo">434</span> } while(count >= threadGroups.length);<a name="line.434"></a>
+<span class="sourceLineNo">435</span><a name="line.435"></a>
+<span class="sourceLineNo">436</span> final List<ThreadGroup> result = new ArrayList<>(count);<a name="line.436"></a>
+<span class="sourceLineNo">437</span> for(int i = 0; i < count; ++i) {<a name="line.437"></a>
+<span class="sourceLineNo">438</span> if(predicate.test(threadGroups[i])) {<a name="line.438"></a>
+<span class="sourceLineNo">439</span> result.add(threadGroups[i]);<a name="line.439"></a>
+<span class="sourceLineNo">440</span> }<a name="line.440"></a>
+<span class="sourceLineNo">441</span> }<a name="line.441"></a>
+<span class="sourceLineNo">442</span> return Collections.unmodifiableCollection(result);<a name="line.442"></a>
+<span class="sourceLineNo">443</span> }<a name="line.443"></a>
+<span class="sourceLineNo">444</span>}<a name="line.444"></a>