17c478bd9Sstevel@tonic-gate /* 27c478bd9Sstevel@tonic-gate * CDDL HEADER START 37c478bd9Sstevel@tonic-gate * 47c478bd9Sstevel@tonic-gate * The contents of this file are subject to the terms of the 57c478bd9Sstevel@tonic-gate * Common Development and Distribution License, Version 1.0 only 67c478bd9Sstevel@tonic-gate * (the "License"). You may not use this file except in compliance 77c478bd9Sstevel@tonic-gate * with the License. 87c478bd9Sstevel@tonic-gate * 97c478bd9Sstevel@tonic-gate * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 107c478bd9Sstevel@tonic-gate * or http://www.opensolaris.org/os/licensing. 117c478bd9Sstevel@tonic-gate * See the License for the specific language governing permissions 127c478bd9Sstevel@tonic-gate * and limitations under the License. 137c478bd9Sstevel@tonic-gate * 147c478bd9Sstevel@tonic-gate * When distributing Covered Code, include this CDDL HEADER in each 157c478bd9Sstevel@tonic-gate * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 167c478bd9Sstevel@tonic-gate * If applicable, add the following below this CDDL HEADER, with the 177c478bd9Sstevel@tonic-gate * fields enclosed by brackets "[]" replaced with your own identifying 187c478bd9Sstevel@tonic-gate * information: Portions Copyright [yyyy] [name of copyright owner] 197c478bd9Sstevel@tonic-gate * 207c478bd9Sstevel@tonic-gate * CDDL HEADER END 217c478bd9Sstevel@tonic-gate */ 227c478bd9Sstevel@tonic-gate /* 237c478bd9Sstevel@tonic-gate * Copyright 2003 Sun Microsystems, Inc. All rights reserved. 247c478bd9Sstevel@tonic-gate * Use is subject to license terms. 257c478bd9Sstevel@tonic-gate */ 267c478bd9Sstevel@tonic-gate 277c478bd9Sstevel@tonic-gate /* ident "%Z%%M% %I% %E% SMI" */ 287c478bd9Sstevel@tonic-gate 297c478bd9Sstevel@tonic-gate package com.sun.solaris.service.exception; 307c478bd9Sstevel@tonic-gate 317c478bd9Sstevel@tonic-gate import java.io.*; 327c478bd9Sstevel@tonic-gate 337c478bd9Sstevel@tonic-gate /** 347c478bd9Sstevel@tonic-gate * Formats a stack trace in a single line. The format is meant to 357c478bd9Sstevel@tonic-gate * convey the stack trace as a sequence of class names and line numbers, 367c478bd9Sstevel@tonic-gate * with the topmost frame first, suitable for logging. Beware, the 377c478bd9Sstevel@tonic-gate * format may evolve. 387c478bd9Sstevel@tonic-gate */ 397c478bd9Sstevel@tonic-gate public class SuccinctStackTraceFormatter { 407c478bd9Sstevel@tonic-gate /** 41*55fea89dSDan Cross * Formats a Throwable and adds an optional description string. 427c478bd9Sstevel@tonic-gate * The string should be suitable to precede the top stack 437c478bd9Sstevel@tonic-gate * element, and include any punctuation that should 447c478bd9Sstevel@tonic-gate * differentiate it from the element. 457c478bd9Sstevel@tonic-gate */ formatWithDescription(Throwable t, String description)467c478bd9Sstevel@tonic-gate public static String formatWithDescription(Throwable t, 477c478bd9Sstevel@tonic-gate String description) 487c478bd9Sstevel@tonic-gate { 497c478bd9Sstevel@tonic-gate StringBuffer s = new StringBuffer(); 507c478bd9Sstevel@tonic-gate 517c478bd9Sstevel@tonic-gate s.append("("); 527c478bd9Sstevel@tonic-gate 537c478bd9Sstevel@tonic-gate if (description != null) 547c478bd9Sstevel@tonic-gate s.append(description); 557c478bd9Sstevel@tonic-gate 567c478bd9Sstevel@tonic-gate s.append(t.getClass().getName()); 577c478bd9Sstevel@tonic-gate s.append(", "); 587c478bd9Sstevel@tonic-gate StackTraceElement[] trace = t.getStackTrace(); 597c478bd9Sstevel@tonic-gate for (int i = 0; i < trace.length; i++) { 607c478bd9Sstevel@tonic-gate appendStackTraceElement(i > 0 ? trace[i - 1] : null, 617c478bd9Sstevel@tonic-gate trace[i], s); 627c478bd9Sstevel@tonic-gate if (i != trace.length - 1) 637c478bd9Sstevel@tonic-gate s.append(", "); 647c478bd9Sstevel@tonic-gate } 657c478bd9Sstevel@tonic-gate s.append(")"); 667c478bd9Sstevel@tonic-gate 677c478bd9Sstevel@tonic-gate if (t.getCause() != null) { 687c478bd9Sstevel@tonic-gate s.append(" caused by "); 697c478bd9Sstevel@tonic-gate s.append(format(t.getCause())); 707c478bd9Sstevel@tonic-gate } 717c478bd9Sstevel@tonic-gate 727c478bd9Sstevel@tonic-gate return (s.toString()); 737c478bd9Sstevel@tonic-gate } 747c478bd9Sstevel@tonic-gate 757c478bd9Sstevel@tonic-gate /** 767c478bd9Sstevel@tonic-gate * Formats a Throwable's stack trace. The format is meant to be 777c478bd9Sstevel@tonic-gate * a single line of output, conveying the stack trace as a 787c478bd9Sstevel@tonic-gate * sequence of class names and line numbers, with the topmost 797c478bd9Sstevel@tonic-gate * frame first, suitable for logging. If two adjacent stack 807c478bd9Sstevel@tonic-gate * trace elements share some portion of a class name, the 817c478bd9Sstevel@tonic-gate * bottommost element may have the common part replaced with an 827c478bd9Sstevel@tonic-gate * ampersand. 837c478bd9Sstevel@tonic-gate */ format(Throwable t)847c478bd9Sstevel@tonic-gate public static String format(Throwable t) 857c478bd9Sstevel@tonic-gate { 867c478bd9Sstevel@tonic-gate return (formatWithDescription(t, null)); 877c478bd9Sstevel@tonic-gate } 887c478bd9Sstevel@tonic-gate 897c478bd9Sstevel@tonic-gate /** 907c478bd9Sstevel@tonic-gate * Formats a stack trace element as per <code>format()</code>. 917c478bd9Sstevel@tonic-gate */ appendStackTraceElement(StackTraceElement last, StackTraceElement e, StringBuffer s)927c478bd9Sstevel@tonic-gate private static void appendStackTraceElement(StackTraceElement last, 937c478bd9Sstevel@tonic-gate StackTraceElement e, StringBuffer s) 947c478bd9Sstevel@tonic-gate { 957c478bd9Sstevel@tonic-gate /* 967c478bd9Sstevel@tonic-gate * This could grab more of a common class name. (See 977c478bd9Sstevel@tonic-gate * SuccinctStackTraceFormatter.format()) 987c478bd9Sstevel@tonic-gate */ 997c478bd9Sstevel@tonic-gate if (last == null || !last.getClassName().equals( 1007c478bd9Sstevel@tonic-gate e.getClassName())) { 1017c478bd9Sstevel@tonic-gate s.append(e.getClassName()); 1027c478bd9Sstevel@tonic-gate s.append("."); 1037c478bd9Sstevel@tonic-gate } else 1047c478bd9Sstevel@tonic-gate s.append("&."); 1057c478bd9Sstevel@tonic-gate 1067c478bd9Sstevel@tonic-gate s.append(e.getMethodName()); 1077c478bd9Sstevel@tonic-gate if (e.getLineNumber() > 0) { 1087c478bd9Sstevel@tonic-gate s.append(":"); 1097c478bd9Sstevel@tonic-gate s.append(e.getLineNumber()); 1107c478bd9Sstevel@tonic-gate } 1117c478bd9Sstevel@tonic-gate if (e.isNativeMethod()) { 1127c478bd9Sstevel@tonic-gate s.append(":"); 1137c478bd9Sstevel@tonic-gate s.append("native"); 1147c478bd9Sstevel@tonic-gate } 1157c478bd9Sstevel@tonic-gate } 1167c478bd9Sstevel@tonic-gate printStackTrace(Throwable t)1177c478bd9Sstevel@tonic-gate public static void printStackTrace(Throwable t) 1187c478bd9Sstevel@tonic-gate { 1197c478bd9Sstevel@tonic-gate printStackTrace(t, System.err); 1207c478bd9Sstevel@tonic-gate } 1217c478bd9Sstevel@tonic-gate printStackTrace(Throwable t, PrintStream out)1227c478bd9Sstevel@tonic-gate public static void printStackTrace(Throwable t, PrintStream out) 1237c478bd9Sstevel@tonic-gate { 1247c478bd9Sstevel@tonic-gate out.print(t); 1257c478bd9Sstevel@tonic-gate out.print(" at "); 1267c478bd9Sstevel@tonic-gate out.print(format(t)); 1277c478bd9Sstevel@tonic-gate } 1287c478bd9Sstevel@tonic-gate main(String args[])1297c478bd9Sstevel@tonic-gate public static final void main(String args[]) 1307c478bd9Sstevel@tonic-gate { 1317c478bd9Sstevel@tonic-gate SuccinctStackTraceFormatter.printStackTrace(big()); 1327c478bd9Sstevel@tonic-gate } 1337c478bd9Sstevel@tonic-gate big()1347c478bd9Sstevel@tonic-gate public static final Throwable big() { 1357c478bd9Sstevel@tonic-gate return new Throwable().initCause(little()); 1367c478bd9Sstevel@tonic-gate } 137*55fea89dSDan Cross little()1387c478bd9Sstevel@tonic-gate public static final Throwable little() { 1397c478bd9Sstevel@tonic-gate return new Throwable(); 1407c478bd9Sstevel@tonic-gate } 1417c478bd9Sstevel@tonic-gate 1427c478bd9Sstevel@tonic-gate } 143