/*
* Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package java.lang;
import java.lang.StackWalker.Option;
import java.util.EnumSet;
import java.util.Set;
import static java.lang.StackWalker.ExtendedOption.*;
final class LiveStackFrameInfo extends StackFrameInfo implements LiveStackFrame {
private static Object[] EMPTY_ARRAY = new Object[0];
/**
* Gets {@code StackWalker} that can get locals and operands.
*
* @throws SecurityException if the security manager is present and
* denies access to {@code RuntimePermission(""liveStackFrames")}
*/
public static StackWalker getStackWalker() {
return getStackWalker(EnumSet.noneOf(Option.class));
}
/**
* Gets a {@code StackWalker} instance with the given options specifying
* the stack frame information it can access, and which will traverse at most
* the given {@code maxDepth} number of stack frames. If no option is
* specified, this {@code StackWalker} obtains the method name and
* the class name with all
* {@linkplain StackWalker.Option#SHOW_HIDDEN_FRAMES hidden frames} skipped.
* The returned {@code StackWalker} can get locals and operands.
*
*
* If a security manager is present and the given
* {@code options} contains {@link Option#RETAIN_CLASS_REFERENCE}, it will call its
* {@link SecurityManager#checkPermission checkPermission} method for
* {@code StackFramePermission("classReference")}.
*
* @param options stack walk {@link Option options}
*
* @throws IllegalArgumentException if {@code maxDepth <= 0}
* @throws SecurityException if a security manager exists and its
* {@code checkPermission} method denies access.
* @throws SecurityException if the security manager is present and
* denies access to {@code RuntimePermission(""liveStackFrames")}
*/
public static StackWalker getStackWalker(Set