VMStack.java revision adc854b798c1cfe3bfd4c27d68d5cee38ca617da
1adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/* 2adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 3adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 4adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 5adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * you may not use this file except in compliance with the License. 6adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * You may obtain a copy of the License at 7adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 8adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 9adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 10adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Unless required by applicable law or agreed to in writing, software 11adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 12adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * See the License for the specific language governing permissions and 14adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * limitations under the License. 15adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 16adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 17adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpackage dalvik.system; 18adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 19adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/** 20adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Provides a limited interface to the Dalvik VM stack. This class is mostly 21adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * used for implementing security checks. 22adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 23adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @since Android 1.0 24adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 25adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpublic final class VMStack { 26adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 27adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns the defining class loader of the caller's caller. 28adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 29adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the requested class loader, or {@code null} if this is the 30adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * bootstrap class loader. 31adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 32adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project native public static ClassLoader getCallingClassLoader(); 33adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 34adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 35adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns the defining class loader of the caller's caller's caller. 36adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 37adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the requested class loader, or {@code null} if this is the 38adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * bootstrap class loader. 39adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 40adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project native public static ClassLoader getCallingClassLoader2(); 41adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 42adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 43adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Creates an array of classes from the methods at the top of the stack. 44adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * We continue until we reach the bottom of the stack or exceed the 45adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * specified maximum depth. If stopAtPrivileged is set, the last 46adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * element of the array will be the caller of the most-recent privileged 47adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * method. 48adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * <p> 49adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The topmost stack frame (this method) and the one above that (the 50adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * caller) are excluded from the array. Frames with java.lang.reflect 51adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * classes are skipped over. 52adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * <p> 53adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The classes in the array are the defining classes of the methods. 54adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * <p> 55adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * This is expected to be identical to Harmony's VMStack.getClasses. 56adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 57adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param maxDepth 58adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * maximum number of classes to return, or -1 for all 59adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param stopAtPrivileged 60adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * stop when a privileged frame is reached 61adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return an array with classes for the most-recent methods on the stack 62adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 63adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project native public static Class<?>[] getClasses(int maxDepth, 64adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project boolean stopAtPrivileged); 65adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 66adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 67adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Retrieves the stack trace from the specified thread. 68adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 69adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param t 70adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * thread of interest 71adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return an array of stack trace elements, or null if the thread 72adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * doesn't have a stack trace (e.g. because it exited) 73adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 74adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project native public static StackTraceElement[] getThreadStackTrace(Thread t); 75adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project} 76adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 77