1 /* 2 * Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package jdk.jfr.consumer; 27 28 import java.util.Arrays; 29 import java.util.Collections; 30 import java.util.List; 31 32 import jdk.jfr.ValueDescriptor; 33 import jdk.jfr.internal.Type; 34 35 /** 36 * A recorded stack trace. 37 * 38 * @since 8 39 */ 40 public final class RecordedStackTrace extends RecordedObject { 41 42 static ObjectFactory<RecordedStackTrace> createFactory(Type type, TimeConverter timeConverter) { 43 return new ObjectFactory<RecordedStackTrace>(type) { 44 @Override 45 RecordedStackTrace createTyped(List<ValueDescriptor> desc, long id, Object[] object) { 46 return new RecordedStackTrace(desc, object, timeConverter); 47 } 48 }; 49 } 50 51 private RecordedStackTrace(List<ValueDescriptor> desc, Object[] values, TimeConverter timeConverter) { 52 super(desc, values, timeConverter); 53 } 54 55 /** 56 * Returns the frames in the stack trace. 57 * 58 * @return a list of Java stack frames, not {@code null} 59 */ 60 @SuppressWarnings("unchecked") 61 public List<RecordedFrame> getFrames() { 62 Object[] array = getTyped("frames", Object[].class, null); 63 if (array == null) { 64 return Collections.EMPTY_LIST; 65 } 66 List<?> list = Arrays.asList(array); 67 return (List<RecordedFrame>) list; 68 } 69 70 /** 71 * Returns {@code true} if the stack trace is truncated due to its size, 72 * {@code false} otherwise. 73 * 74 * @return {@code true} if the stack trace is truncated, {@code false} 75 * otherwise 76 */ 77 public boolean isTruncated() { 78 return getTyped("truncated", Boolean.class, true); 79 } 80 }