Sort members.
This commit is contained in:
parent
e18ace73ef
commit
789f88eaa2
|
@ -35,241 +35,6 @@
|
||||||
*/
|
*/
|
||||||
public class ThreadUtils {
|
public class ThreadUtils {
|
||||||
|
|
||||||
/**
|
|
||||||
* Finds the active thread with the specified id if it belongs to the specified thread group.
|
|
||||||
*
|
|
||||||
* @param threadId The thread id
|
|
||||||
* @param threadGroup The thread group
|
|
||||||
* @return The thread which belongs to a specified thread group and the thread's id match the specified id.
|
|
||||||
* {@code null} is returned if no such thread exists
|
|
||||||
* @throws IllegalArgumentException if the specified id is zero or negative or the group is null
|
|
||||||
* @throws SecurityException
|
|
||||||
* if the current thread cannot access the system thread group
|
|
||||||
*
|
|
||||||
* @throws SecurityException if the current thread cannot modify
|
|
||||||
* thread groups from this thread's thread group up to the system thread group
|
|
||||||
*/
|
|
||||||
public static Thread findThreadById(final long threadId, final ThreadGroup threadGroup) {
|
|
||||||
Validate.notNull(threadGroup, "threadGroup");
|
|
||||||
final Thread thread = findThreadById(threadId);
|
|
||||||
if (thread != null && threadGroup.equals(thread.getThreadGroup())) {
|
|
||||||
return thread;
|
|
||||||
}
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Finds the active thread with the specified id if it belongs to a thread group with the specified group name.
|
|
||||||
*
|
|
||||||
* @param threadId The thread id
|
|
||||||
* @param threadGroupName The thread group name
|
|
||||||
* @return The threads which belongs to a thread group with the specified group name and the thread's id match the specified id.
|
|
||||||
* {@code null} is returned if no such thread exists
|
|
||||||
* @throws IllegalArgumentException if the specified id is zero or negative or the group name is null
|
|
||||||
* @throws SecurityException
|
|
||||||
* if the current thread cannot access the system thread group
|
|
||||||
*
|
|
||||||
* @throws SecurityException if the current thread cannot modify
|
|
||||||
* thread groups from this thread's thread group up to the system thread group
|
|
||||||
*/
|
|
||||||
public static Thread findThreadById(final long threadId, final String threadGroupName) {
|
|
||||||
Validate.notNull(threadGroupName, "threadGroupName");
|
|
||||||
final Thread thread = findThreadById(threadId);
|
|
||||||
if (thread != null && thread.getThreadGroup() != null && thread.getThreadGroup().getName().equals(threadGroupName)) {
|
|
||||||
return thread;
|
|
||||||
}
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Finds active threads with the specified name if they belong to a specified thread group.
|
|
||||||
*
|
|
||||||
* @param threadName The thread name
|
|
||||||
* @param threadGroup The thread group
|
|
||||||
* @return The threads which belongs to a thread group and the thread's name match the specified name,
|
|
||||||
* An empty collection is returned if no such thread exists. The collection returned is always unmodifiable.
|
|
||||||
* @throws IllegalArgumentException if the specified thread name or group is null
|
|
||||||
* @throws SecurityException
|
|
||||||
* if the current thread cannot access the system thread group
|
|
||||||
*
|
|
||||||
* @throws SecurityException if the current thread cannot modify
|
|
||||||
* thread groups from this thread's thread group up to the system thread group
|
|
||||||
*/
|
|
||||||
public static Collection<Thread> findThreadsByName(final String threadName, final ThreadGroup threadGroup) {
|
|
||||||
return findThreads(threadGroup, false, new NamePredicate(threadName));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Finds active threads with the specified name if they belong to a thread group with the specified group name.
|
|
||||||
*
|
|
||||||
* @param threadName The thread name
|
|
||||||
* @param threadGroupName The thread group name
|
|
||||||
* @return The threads which belongs to a thread group with the specified group name and the thread's name match the specified name,
|
|
||||||
* An empty collection is returned if no such thread exists. The collection returned is always unmodifiable.
|
|
||||||
* @throws IllegalArgumentException if the specified thread name or group name is null
|
|
||||||
* @throws SecurityException
|
|
||||||
* if the current thread cannot access the system thread group
|
|
||||||
*
|
|
||||||
* @throws SecurityException if the current thread cannot modify
|
|
||||||
* thread groups from this thread's thread group up to the system thread group
|
|
||||||
*/
|
|
||||||
public static Collection<Thread> findThreadsByName(final String threadName, final String threadGroupName) {
|
|
||||||
Validate.notNull(threadName, "threadName");
|
|
||||||
Validate.notNull(threadGroupName, "threadGroupName");
|
|
||||||
|
|
||||||
final Collection<ThreadGroup> threadGroups = findThreadGroups(new NamePredicate(threadGroupName));
|
|
||||||
|
|
||||||
if (threadGroups.isEmpty()) {
|
|
||||||
return Collections.emptyList();
|
|
||||||
}
|
|
||||||
|
|
||||||
final Collection<Thread> result = new ArrayList<>();
|
|
||||||
final NamePredicate threadNamePredicate = new NamePredicate(threadName);
|
|
||||||
for (final ThreadGroup group : threadGroups) {
|
|
||||||
result.addAll(findThreads(group, false, threadNamePredicate));
|
|
||||||
}
|
|
||||||
return Collections.unmodifiableCollection(result);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Finds active thread groups with the specified group name.
|
|
||||||
*
|
|
||||||
* @param threadGroupName The thread group name
|
|
||||||
* @return the thread groups with the specified group name or an empty collection if no such thread group exists. The collection returned is always unmodifiable.
|
|
||||||
* @throws IllegalArgumentException if group name is null
|
|
||||||
* @throws SecurityException
|
|
||||||
* if the current thread cannot access the system thread group
|
|
||||||
*
|
|
||||||
* @throws SecurityException if the current thread cannot modify
|
|
||||||
* thread groups from this thread's thread group up to the system thread group
|
|
||||||
*/
|
|
||||||
public static Collection<ThreadGroup> findThreadGroupsByName(final String threadGroupName) {
|
|
||||||
return findThreadGroups(new NamePredicate(threadGroupName));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Gets all active thread groups excluding the system thread group (A thread group is active if it has been not destroyed).
|
|
||||||
*
|
|
||||||
* @return all thread groups excluding the system thread group. The collection returned is always unmodifiable.
|
|
||||||
* @throws SecurityException
|
|
||||||
* if the current thread cannot access the system thread group
|
|
||||||
*
|
|
||||||
* @throws SecurityException if the current thread cannot modify
|
|
||||||
* thread groups from this thread's thread group up to the system thread group
|
|
||||||
*/
|
|
||||||
public static Collection<ThreadGroup> getAllThreadGroups() {
|
|
||||||
return findThreadGroups(ALWAYS_TRUE_PREDICATE);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Gets the system thread group (sometimes also referred as "root thread group").
|
|
||||||
*
|
|
||||||
* @return the system thread group
|
|
||||||
* @throws SecurityException if the current thread cannot modify
|
|
||||||
* thread groups from this thread's thread group up to the system thread group
|
|
||||||
*/
|
|
||||||
public static ThreadGroup getSystemThreadGroup() {
|
|
||||||
ThreadGroup threadGroup = Thread.currentThread().getThreadGroup();
|
|
||||||
while (threadGroup.getParent() != null) {
|
|
||||||
threadGroup = threadGroup.getParent();
|
|
||||||
}
|
|
||||||
return threadGroup;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Gets all active threads (A thread is active if it has been started and has not yet died).
|
|
||||||
*
|
|
||||||
* @return all active threads. The collection returned is always unmodifiable.
|
|
||||||
* @throws SecurityException
|
|
||||||
* if the current thread cannot access the system thread group
|
|
||||||
*
|
|
||||||
* @throws SecurityException if the current thread cannot modify
|
|
||||||
* thread groups from this thread's thread group up to the system thread group
|
|
||||||
*/
|
|
||||||
public static Collection<Thread> getAllThreads() {
|
|
||||||
return findThreads(ALWAYS_TRUE_PREDICATE);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Finds active threads with the specified name.
|
|
||||||
*
|
|
||||||
* @param threadName The thread name
|
|
||||||
* @return The threads with the specified name or an empty collection if no such thread exists. The collection returned is always unmodifiable.
|
|
||||||
* @throws IllegalArgumentException if the specified name is null
|
|
||||||
* @throws SecurityException
|
|
||||||
* if the current thread cannot access the system thread group
|
|
||||||
*
|
|
||||||
* @throws SecurityException if the current thread cannot modify
|
|
||||||
* thread groups from this thread's thread group up to the system thread group
|
|
||||||
*/
|
|
||||||
public static Collection<Thread> findThreadsByName(final String threadName) {
|
|
||||||
return findThreads(new NamePredicate(threadName));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Finds the active thread with the specified id.
|
|
||||||
*
|
|
||||||
* @param threadId The thread id
|
|
||||||
* @return The thread with the specified id or {@code null} if no such thread exists
|
|
||||||
* @throws IllegalArgumentException if the specified id is zero or negative
|
|
||||||
* @throws SecurityException
|
|
||||||
* if the current thread cannot access the system thread group
|
|
||||||
*
|
|
||||||
* @throws SecurityException if the current thread cannot modify
|
|
||||||
* thread groups from this thread's thread group up to the system thread group
|
|
||||||
*/
|
|
||||||
public static Thread findThreadById(final long threadId) {
|
|
||||||
final Collection<Thread> result = findThreads(new ThreadIdPredicate(threadId));
|
|
||||||
return result.isEmpty() ? null : result.iterator().next();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* <p>
|
|
||||||
* ThreadUtils instances should NOT be constructed in standard programming. Instead, the class should be used as
|
|
||||||
* {@code ThreadUtils.getAllThreads()}
|
|
||||||
* </p>
|
|
||||||
* <p>
|
|
||||||
* This constructor is public to permit tools that require a JavaBean instance to operate.
|
|
||||||
* </p>
|
|
||||||
*/
|
|
||||||
public ThreadUtils() {
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* A predicate for selecting threads.
|
|
||||||
*/
|
|
||||||
// When breaking BC, replace this with Predicate<Thread>
|
|
||||||
@FunctionalInterface
|
|
||||||
public interface ThreadPredicate {
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Evaluates this predicate on the given thread.
|
|
||||||
* @param thread the thread
|
|
||||||
* @return {@code true} if the thread matches the predicate, otherwise {@code false}
|
|
||||||
*/
|
|
||||||
boolean test(Thread thread);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* A predicate for selecting threadgroups.
|
|
||||||
*/
|
|
||||||
// When breaking BC, replace this with Predicate<ThreadGroup>
|
|
||||||
@FunctionalInterface
|
|
||||||
public interface ThreadGroupPredicate {
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Evaluates this predicate on the given threadgroup.
|
|
||||||
* @param threadGroup the threadgroup
|
|
||||||
* @return {@code true} if the threadGroup matches the predicate, otherwise {@code false}
|
|
||||||
*/
|
|
||||||
boolean test(ThreadGroup threadGroup);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Predicate which always returns true.
|
|
||||||
*/
|
|
||||||
public static final AlwaysTruePredicate ALWAYS_TRUE_PREDICATE = new AlwaysTruePredicate();
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* A predicate implementation which always returns true.
|
* A predicate implementation which always returns true.
|
||||||
*/
|
*/
|
||||||
|
@ -279,12 +44,12 @@ private AlwaysTruePredicate() {
|
||||||
}
|
}
|
||||||
|
|
||||||
@Override
|
@Override
|
||||||
public boolean test(final ThreadGroup threadGroup) {
|
public boolean test(final Thread thread) {
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
@Override
|
@Override
|
||||||
public boolean test(final Thread thread) {
|
public boolean test(final ThreadGroup threadGroup) {
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@ -307,15 +72,30 @@ public NamePredicate(final String name) {
|
||||||
this.name = name;
|
this.name = name;
|
||||||
}
|
}
|
||||||
|
|
||||||
@Override
|
|
||||||
public boolean test(final ThreadGroup threadGroup) {
|
|
||||||
return threadGroup != null && threadGroup.getName().equals(name);
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
@Override
|
||||||
public boolean test(final Thread thread) {
|
public boolean test(final Thread thread) {
|
||||||
return thread != null && thread.getName().equals(name);
|
return thread != null && thread.getName().equals(name);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public boolean test(final ThreadGroup threadGroup) {
|
||||||
|
return threadGroup != null && threadGroup.getName().equals(name);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A predicate for selecting threadgroups.
|
||||||
|
*/
|
||||||
|
// When breaking BC, replace this with Predicate<ThreadGroup>
|
||||||
|
@FunctionalInterface
|
||||||
|
public interface ThreadGroupPredicate {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Evaluates this predicate on the given threadgroup.
|
||||||
|
* @param threadGroup the threadgroup
|
||||||
|
* @return {@code true} if the threadGroup matches the predicate, otherwise {@code false}
|
||||||
|
*/
|
||||||
|
boolean test(ThreadGroup threadGroup);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
@ -345,19 +125,118 @@ public boolean test(final Thread thread) {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Select all active threads which match the given predicate.
|
* A predicate for selecting threads.
|
||||||
|
*/
|
||||||
|
// When breaking BC, replace this with Predicate<Thread>
|
||||||
|
@FunctionalInterface
|
||||||
|
public interface ThreadPredicate {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Evaluates this predicate on the given thread.
|
||||||
|
* @param thread the thread
|
||||||
|
* @return {@code true} if the thread matches the predicate, otherwise {@code false}
|
||||||
|
*/
|
||||||
|
boolean test(Thread thread);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Predicate which always returns true.
|
||||||
|
*/
|
||||||
|
public static final AlwaysTruePredicate ALWAYS_TRUE_PREDICATE = new AlwaysTruePredicate();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Finds the active thread with the specified id.
|
||||||
*
|
*
|
||||||
* @param predicate the predicate
|
* @param threadId The thread id
|
||||||
* @return An unmodifiable {@code Collection} of active threads matching the given predicate
|
* @return The thread with the specified id or {@code null} if no such thread exists
|
||||||
*
|
* @throws IllegalArgumentException if the specified id is zero or negative
|
||||||
* @throws IllegalArgumentException if the predicate is null
|
|
||||||
* @throws SecurityException
|
* @throws SecurityException
|
||||||
* if the current thread cannot access the system thread group
|
* if the current thread cannot access the system thread group
|
||||||
|
*
|
||||||
* @throws SecurityException if the current thread cannot modify
|
* @throws SecurityException if the current thread cannot modify
|
||||||
* thread groups from this thread's thread group up to the system thread group
|
* thread groups from this thread's thread group up to the system thread group
|
||||||
*/
|
*/
|
||||||
public static Collection<Thread> findThreads(final ThreadPredicate predicate) {
|
public static Thread findThreadById(final long threadId) {
|
||||||
return findThreads(getSystemThreadGroup(), true, predicate);
|
final Collection<Thread> result = findThreads(new ThreadIdPredicate(threadId));
|
||||||
|
return result.isEmpty() ? null : result.iterator().next();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Finds the active thread with the specified id if it belongs to a thread group with the specified group name.
|
||||||
|
*
|
||||||
|
* @param threadId The thread id
|
||||||
|
* @param threadGroupName The thread group name
|
||||||
|
* @return The threads which belongs to a thread group with the specified group name and the thread's id match the specified id.
|
||||||
|
* {@code null} is returned if no such thread exists
|
||||||
|
* @throws IllegalArgumentException if the specified id is zero or negative or the group name is null
|
||||||
|
* @throws SecurityException
|
||||||
|
* if the current thread cannot access the system thread group
|
||||||
|
*
|
||||||
|
* @throws SecurityException if the current thread cannot modify
|
||||||
|
* thread groups from this thread's thread group up to the system thread group
|
||||||
|
*/
|
||||||
|
public static Thread findThreadById(final long threadId, final String threadGroupName) {
|
||||||
|
Validate.notNull(threadGroupName, "threadGroupName");
|
||||||
|
final Thread thread = findThreadById(threadId);
|
||||||
|
if (thread != null && thread.getThreadGroup() != null && thread.getThreadGroup().getName().equals(threadGroupName)) {
|
||||||
|
return thread;
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Finds the active thread with the specified id if it belongs to the specified thread group.
|
||||||
|
*
|
||||||
|
* @param threadId The thread id
|
||||||
|
* @param threadGroup The thread group
|
||||||
|
* @return The thread which belongs to a specified thread group and the thread's id match the specified id.
|
||||||
|
* {@code null} is returned if no such thread exists
|
||||||
|
* @throws IllegalArgumentException if the specified id is zero or negative or the group is null
|
||||||
|
* @throws SecurityException
|
||||||
|
* if the current thread cannot access the system thread group
|
||||||
|
*
|
||||||
|
* @throws SecurityException if the current thread cannot modify
|
||||||
|
* thread groups from this thread's thread group up to the system thread group
|
||||||
|
*/
|
||||||
|
public static Thread findThreadById(final long threadId, final ThreadGroup threadGroup) {
|
||||||
|
Validate.notNull(threadGroup, "threadGroup");
|
||||||
|
final Thread thread = findThreadById(threadId);
|
||||||
|
if (thread != null && threadGroup.equals(thread.getThreadGroup())) {
|
||||||
|
return thread;
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Select all active threadgroups which match the given predicate and which is a subgroup of the given thread group (or one of its subgroups).
|
||||||
|
*
|
||||||
|
* @param group the thread group
|
||||||
|
* @param recurse if {@code true} then evaluate the predicate recursively on all threadgroups in all subgroups of the given group
|
||||||
|
* @param predicate the predicate
|
||||||
|
* @return An unmodifiable {@code Collection} of active threadgroups which match the given predicate and which is a subgroup of the given thread group
|
||||||
|
* @throws IllegalArgumentException if the given group or predicate is null
|
||||||
|
* @throws SecurityException if the current thread cannot modify
|
||||||
|
* thread groups from this thread's thread group up to the system thread group
|
||||||
|
*/
|
||||||
|
public static Collection<ThreadGroup> findThreadGroups(final ThreadGroup group, final boolean recurse, final ThreadGroupPredicate predicate) {
|
||||||
|
Validate.notNull(group, "group");
|
||||||
|
Validate.notNull(predicate, "predicate");
|
||||||
|
|
||||||
|
int count = group.activeGroupCount();
|
||||||
|
ThreadGroup[] threadGroups;
|
||||||
|
do {
|
||||||
|
threadGroups = new ThreadGroup[count + (count / 2) + 1]; //slightly grow the array size
|
||||||
|
count = group.enumerate(threadGroups, recurse);
|
||||||
|
//return value of enumerate() must be strictly less than the array size according to javadoc
|
||||||
|
} while (count >= threadGroups.length);
|
||||||
|
|
||||||
|
final List<ThreadGroup> result = new ArrayList<>(count);
|
||||||
|
for (int i = 0; i < count; ++i) {
|
||||||
|
if (predicate.test(threadGroups[i])) {
|
||||||
|
result.add(threadGroups[i]);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return Collections.unmodifiableCollection(result);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
@ -375,6 +254,22 @@ public static Collection<ThreadGroup> findThreadGroups(final ThreadGroupPredicat
|
||||||
return findThreadGroups(getSystemThreadGroup(), true, predicate);
|
return findThreadGroups(getSystemThreadGroup(), true, predicate);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Finds active thread groups with the specified group name.
|
||||||
|
*
|
||||||
|
* @param threadGroupName The thread group name
|
||||||
|
* @return the thread groups with the specified group name or an empty collection if no such thread group exists. The collection returned is always unmodifiable.
|
||||||
|
* @throws IllegalArgumentException if group name is null
|
||||||
|
* @throws SecurityException
|
||||||
|
* if the current thread cannot access the system thread group
|
||||||
|
*
|
||||||
|
* @throws SecurityException if the current thread cannot modify
|
||||||
|
* thread groups from this thread's thread group up to the system thread group
|
||||||
|
*/
|
||||||
|
public static Collection<ThreadGroup> findThreadGroupsByName(final String threadGroupName) {
|
||||||
|
return findThreadGroups(new NamePredicate(threadGroupName));
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Select all active threads which match the given predicate and which belongs to the given thread group (or one of its subgroups).
|
* Select all active threads which match the given predicate and which belongs to the given thread group (or one of its subgroups).
|
||||||
*
|
*
|
||||||
|
@ -408,34 +303,139 @@ public static Collection<Thread> findThreads(final ThreadGroup group, final bool
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Select all active threadgroups which match the given predicate and which is a subgroup of the given thread group (or one of its subgroups).
|
* Select all active threads which match the given predicate.
|
||||||
*
|
*
|
||||||
* @param group the thread group
|
|
||||||
* @param recurse if {@code true} then evaluate the predicate recursively on all threadgroups in all subgroups of the given group
|
|
||||||
* @param predicate the predicate
|
* @param predicate the predicate
|
||||||
* @return An unmodifiable {@code Collection} of active threadgroups which match the given predicate and which is a subgroup of the given thread group
|
* @return An unmodifiable {@code Collection} of active threads matching the given predicate
|
||||||
* @throws IllegalArgumentException if the given group or predicate is null
|
*
|
||||||
|
* @throws IllegalArgumentException if the predicate is null
|
||||||
|
* @throws SecurityException
|
||||||
|
* if the current thread cannot access the system thread group
|
||||||
* @throws SecurityException if the current thread cannot modify
|
* @throws SecurityException if the current thread cannot modify
|
||||||
* thread groups from this thread's thread group up to the system thread group
|
* thread groups from this thread's thread group up to the system thread group
|
||||||
*/
|
*/
|
||||||
public static Collection<ThreadGroup> findThreadGroups(final ThreadGroup group, final boolean recurse, final ThreadGroupPredicate predicate) {
|
public static Collection<Thread> findThreads(final ThreadPredicate predicate) {
|
||||||
Validate.notNull(group, "group");
|
return findThreads(getSystemThreadGroup(), true, predicate);
|
||||||
Validate.notNull(predicate, "predicate");
|
|
||||||
|
|
||||||
int count = group.activeGroupCount();
|
|
||||||
ThreadGroup[] threadGroups;
|
|
||||||
do {
|
|
||||||
threadGroups = new ThreadGroup[count + (count / 2) + 1]; //slightly grow the array size
|
|
||||||
count = group.enumerate(threadGroups, recurse);
|
|
||||||
//return value of enumerate() must be strictly less than the array size according to javadoc
|
|
||||||
} while (count >= threadGroups.length);
|
|
||||||
|
|
||||||
final List<ThreadGroup> result = new ArrayList<>(count);
|
|
||||||
for (int i = 0; i < count; ++i) {
|
|
||||||
if (predicate.test(threadGroups[i])) {
|
|
||||||
result.add(threadGroups[i]);
|
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Finds active threads with the specified name.
|
||||||
|
*
|
||||||
|
* @param threadName The thread name
|
||||||
|
* @return The threads with the specified name or an empty collection if no such thread exists. The collection returned is always unmodifiable.
|
||||||
|
* @throws IllegalArgumentException if the specified name is null
|
||||||
|
* @throws SecurityException
|
||||||
|
* if the current thread cannot access the system thread group
|
||||||
|
*
|
||||||
|
* @throws SecurityException if the current thread cannot modify
|
||||||
|
* thread groups from this thread's thread group up to the system thread group
|
||||||
|
*/
|
||||||
|
public static Collection<Thread> findThreadsByName(final String threadName) {
|
||||||
|
return findThreads(new NamePredicate(threadName));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Finds active threads with the specified name if they belong to a thread group with the specified group name.
|
||||||
|
*
|
||||||
|
* @param threadName The thread name
|
||||||
|
* @param threadGroupName The thread group name
|
||||||
|
* @return The threads which belongs to a thread group with the specified group name and the thread's name match the specified name,
|
||||||
|
* An empty collection is returned if no such thread exists. The collection returned is always unmodifiable.
|
||||||
|
* @throws IllegalArgumentException if the specified thread name or group name is null
|
||||||
|
* @throws SecurityException
|
||||||
|
* if the current thread cannot access the system thread group
|
||||||
|
*
|
||||||
|
* @throws SecurityException if the current thread cannot modify
|
||||||
|
* thread groups from this thread's thread group up to the system thread group
|
||||||
|
*/
|
||||||
|
public static Collection<Thread> findThreadsByName(final String threadName, final String threadGroupName) {
|
||||||
|
Validate.notNull(threadName, "threadName");
|
||||||
|
Validate.notNull(threadGroupName, "threadGroupName");
|
||||||
|
|
||||||
|
final Collection<ThreadGroup> threadGroups = findThreadGroups(new NamePredicate(threadGroupName));
|
||||||
|
|
||||||
|
if (threadGroups.isEmpty()) {
|
||||||
|
return Collections.emptyList();
|
||||||
|
}
|
||||||
|
|
||||||
|
final Collection<Thread> result = new ArrayList<>();
|
||||||
|
final NamePredicate threadNamePredicate = new NamePredicate(threadName);
|
||||||
|
for (final ThreadGroup group : threadGroups) {
|
||||||
|
result.addAll(findThreads(group, false, threadNamePredicate));
|
||||||
}
|
}
|
||||||
return Collections.unmodifiableCollection(result);
|
return Collections.unmodifiableCollection(result);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Finds active threads with the specified name if they belong to a specified thread group.
|
||||||
|
*
|
||||||
|
* @param threadName The thread name
|
||||||
|
* @param threadGroup The thread group
|
||||||
|
* @return The threads which belongs to a thread group and the thread's name match the specified name,
|
||||||
|
* An empty collection is returned if no such thread exists. The collection returned is always unmodifiable.
|
||||||
|
* @throws IllegalArgumentException if the specified thread name or group is null
|
||||||
|
* @throws SecurityException
|
||||||
|
* if the current thread cannot access the system thread group
|
||||||
|
*
|
||||||
|
* @throws SecurityException if the current thread cannot modify
|
||||||
|
* thread groups from this thread's thread group up to the system thread group
|
||||||
|
*/
|
||||||
|
public static Collection<Thread> findThreadsByName(final String threadName, final ThreadGroup threadGroup) {
|
||||||
|
return findThreads(threadGroup, false, new NamePredicate(threadName));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Gets all active thread groups excluding the system thread group (A thread group is active if it has been not destroyed).
|
||||||
|
*
|
||||||
|
* @return all thread groups excluding the system thread group. The collection returned is always unmodifiable.
|
||||||
|
* @throws SecurityException
|
||||||
|
* if the current thread cannot access the system thread group
|
||||||
|
*
|
||||||
|
* @throws SecurityException if the current thread cannot modify
|
||||||
|
* thread groups from this thread's thread group up to the system thread group
|
||||||
|
*/
|
||||||
|
public static Collection<ThreadGroup> getAllThreadGroups() {
|
||||||
|
return findThreadGroups(ALWAYS_TRUE_PREDICATE);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Gets all active threads (A thread is active if it has been started and has not yet died).
|
||||||
|
*
|
||||||
|
* @return all active threads. The collection returned is always unmodifiable.
|
||||||
|
* @throws SecurityException
|
||||||
|
* if the current thread cannot access the system thread group
|
||||||
|
*
|
||||||
|
* @throws SecurityException if the current thread cannot modify
|
||||||
|
* thread groups from this thread's thread group up to the system thread group
|
||||||
|
*/
|
||||||
|
public static Collection<Thread> getAllThreads() {
|
||||||
|
return findThreads(ALWAYS_TRUE_PREDICATE);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Gets the system thread group (sometimes also referred as "root thread group").
|
||||||
|
*
|
||||||
|
* @return the system thread group
|
||||||
|
* @throws SecurityException if the current thread cannot modify
|
||||||
|
* thread groups from this thread's thread group up to the system thread group
|
||||||
|
*/
|
||||||
|
public static ThreadGroup getSystemThreadGroup() {
|
||||||
|
ThreadGroup threadGroup = Thread.currentThread().getThreadGroup();
|
||||||
|
while (threadGroup.getParent() != null) {
|
||||||
|
threadGroup = threadGroup.getParent();
|
||||||
|
}
|
||||||
|
return threadGroup;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* <p>
|
||||||
|
* ThreadUtils instances should NOT be constructed in standard programming. Instead, the class should be used as
|
||||||
|
* {@code ThreadUtils.getAllThreads()}
|
||||||
|
* </p>
|
||||||
|
* <p>
|
||||||
|
* This constructor is public to permit tools that require a JavaBean instance to operate.
|
||||||
|
* </p>
|
||||||
|
*/
|
||||||
|
public ThreadUtils() {
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
Loading…
Reference in New Issue