Changeset 32271

Timestamp:

2018-07-13T19:36:50+12:00 (6 years ago)

Author:

ak19

Message:

Some more handy functions to print calling methods and tidied up the method that printed the entire callstack, before I start on committing the PDFPlugin restructuring stuff.

File:

• main/trunk/gli/src/org/greenstone/gatherer/util/Utility.java (modified) (1 diff)

main/trunk/gli/src/org/greenstone/gatherer/util/Utility.java

@@ -101 +101 @@
     static public void printStackTrace() {
     // https://stackoverflow.com/questions/1069066/get-current-stack-trace-in-java
-    //new Exception().printStackTrace();
-    //StackTraceElement[] el = Thread.currentThread().getStackTrace();
-    System.err.println("\n@@@@ stacktrace:\n" + Arrays.toString(Thread.currentThread().getStackTrace()) + "\n");
+    
+    //Thread.dumpStack(); // looks too much like an exception, though the newlines separating each function call is handy
+    //new Exception().printStackTrace(); // outputs in the format of an exception too   
+    //System.err.println("\n@@@@ stacktrace:\n" + Arrays.toString(Thread.currentThread().getStackTrace()) + "\n"); // outputs all in one line
+    
+    System.err.println("\n@@@@ stacktrace:");
+    StackTraceElement[] els = new Throwable().getStackTrace(); // starts at index 1, which is this function
+    //StackTraceElement[] els = Thread.currentThread().getStackTrace(); starts at index 0, "java.lang.Thread.getStackTrace()"
+    for(StackTraceElement ste : els) {
+        System.err.println("   " + ste);
+    }
+    }
+    
+    /** 
+     * Handy function to display the parent of the calling function
+     * (the function that called the function that called printCaller())
+     */
+    static public void printCaller() {
+    int parent = 1;
+    // this function printCaller() itself adds another layer on the callstack since
+    // it calls the overloaded method, so need to add 1 more to parent
+    printCaller(parent++); 
+    }
+    
+    /** 
+     * Handy function to display the nth ancestor of the calling function
+     * where ancestor=0 would be the calling function itself
+     */
+    static public void printCaller(int ancestor) {
+    // https://stackoverflow.com/questions/1069066/get-current-stack-trace-in-java
+    
+    // Thread.currentThread().getStackTrace() starts at index 0: "java.lang.Thread.getStackTrace()"
+    // index 1 will be this method (printCaller) and index 2 will be the calling function itself who wants
+    // to know who called it. So need to at least start at index 3 to get informative caller information
+    
+    StackTraceElement[] callstack = Thread.currentThread().getStackTrace();
+    StackTraceElement requestor = callstack[2]; // the calling function, the function that called this one
+    StackTraceElement caller_requested = callstack[ancestor+3]; // the function requested
+    System.err.println("@@@ Function " + requestor +  " called by:\n    "
+               + caller_requested + " at " + ancestor + " ancestors back");
     }