DebugUtils: add more thread dump utility methods

Sometimes we have a Thread and want to format its current call stack as
a string. Sometimes we have a Thread and snapshot of an earlier call
stack as a StackTraceElement[], and want to format that as a string.

Author: ctrueden

pom.xml

@@ -10,7 +10,7 @@
 	</parent>
 
 	<artifactId>scijava-common</artifactId>
-	<version>2.74.4-SNAPSHOT</version>
+	<version>2.75.0-SNAPSHOT</version>
 
 	<name>SciJava Common</name>
 	<description>SciJava Common is a shared library for SciJava software. It provides a plugin framework, with an extensible mechanism for service discovery, backed by its own annotation processor, so that plugins can be loaded dynamically. It is used by downstream projects in the SciJava ecosystem, such as ImageJ and SCIFIO.</description>

src/main/java/org/scijava/util/DebugUtils.java

@@ -67,6 +67,32 @@ public static String getStackTrace(final Throwable t) {
 		}
 	}
 
+	/**
+	 * Provides a stack dump of the given thread.
+	 * <p>
+	 * The output is similar to a subset of that given when Ctrl+\ (or Ctrl+Pause
+	 * on Windows) is pressed from the console.
+	 * </p>
+	 */
+	public static String getStackDump(final Thread thread) {
+		return getStackDump(thread, thread.getStackTrace());
+	}
+
+	/**
+	 * Provides a stack dump of the given thread + call stack.
+	 * <p>
+	 * The output is similar to a subset of that given when Ctrl+\ (or Ctrl+Pause
+	 * on Windows) is pressed from the console.
+	 * </p>
+	 */
+	public static String getStackDump(final Thread thread,
+		final StackTraceElement[] stackTrace)
+	{
+		final StringBuilder sb = new StringBuilder();
+		dumpThread(thread, stackTrace, sb);
+		return sb.toString();
+	}
+
 	/**
 	 * Provides a complete stack dump of all threads.
 	 * <p>