Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/**
* Copyright (C) 2006-2015 phloc systems
* http://www.phloc.com
* office[at]phloc[dot]com
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.phloc.commons.lang;
import java.util.ArrayList;
import java.util.List;
import javax.annotation.Nonnegative;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import javax.annotation.concurrent.Immutable;
import com.phloc.commons.annotations.PresentForCodeCoverage;
import com.phloc.commons.string.StringHelper;
/**
* This class contains utility methods for handling stack traces.
*
* @author Philip Helger
*/
@Immutable
public final class StackTraceHelper
{
/** the separator used to separate different lines of a stack */
private static final char STACKELEMENT_LINESEP = '\n';
/** elements to omit in stack traces */
private static final List STACKTRACE_OMIT_UNITTEST = new ArrayList ();
private static final List STACKTRACE_OMIT_APPSRV = new ArrayList ();
static
{
// Unit test frameworks
STACKTRACE_OMIT_UNITTEST.add ("org.testng");
STACKTRACE_OMIT_UNITTEST.add ("org.junit.");
STACKTRACE_OMIT_UNITTEST.add ("junit.framework.");
// Application servers
STACKTRACE_OMIT_APPSRV.add ("org.apache.catalina.core");
STACKTRACE_OMIT_APPSRV.add ("org.mortbay.jetty.");
STACKTRACE_OMIT_APPSRV.add ("org.eclipse.jetty.");
}
@PresentForCodeCoverage
@SuppressWarnings ("unused")
private static final StackTraceHelper s_aInstance = new StackTraceHelper ();
private StackTraceHelper ()
{}
private static boolean _stopStackTraceListing (@Nonnull final String sStackTraceLine)
{
for (final String sOmit : STACKTRACE_OMIT_UNITTEST)
if (sStackTraceLine.startsWith (sOmit))
return true;
for (final String sOmit : STACKTRACE_OMIT_APPSRV)
if (sStackTraceLine.startsWith (sOmit))
return true;
return false;
}
private static boolean _matchesParentStackTrace (@Nonnull final StackTraceElement aElement,
@Nullable final StackTraceElement [] aParentElements)
{
if (aParentElements != null)
for (final StackTraceElement aParentElement : aParentElements)
if (aParentElement.equals (aElement))
return true;
return false;
}
private static void _appendSingleStackTraceToString (@Nonnull final StringBuilder aSB,
@Nonnull final StackTraceElement [] aStackTraceElements,
@Nullable final StackTraceElement [] aParentStackTraceElements,
final boolean bOmitCommonStackTraceElements)
{
// add main call stack
for (int i = 0; i < aStackTraceElements.length; ++i)
{
final StackTraceElement aStackTraceElement = aStackTraceElements[i];
final String sStackTraceElement = aStackTraceElement.toString ();
// stop if some Catalina line occurs here (Apache Tomcat)
// -> would lead to very long stack traces
// -> also try to filter stack trace elements that are already contained
// in a parent stack trace
if ((bOmitCommonStackTraceElements && _stopStackTraceListing (sStackTraceElement)) ||
_matchesParentStackTrace (aStackTraceElement, aParentStackTraceElements))
{
// write number of omitted elements
aSB.append (" [")
.append (aStackTraceElements.length - i)
.append (" elements omitted -- ")
.append (sStackTraceElement)
.append (']')
.append (STACKELEMENT_LINESEP);
break;
}
aSB.append (i + 1).append (".: ").append (sStackTraceElement).append (STACKELEMENT_LINESEP);
}
}
public static void appendStackToString (@Nonnull final StringBuilder aSB,
@Nonnull final StackTraceElement [] aStackTraceElements)
{
_appendSingleStackTraceToString (aSB, aStackTraceElements, null, true);
}
@Nonnull
public static String getStackAsString (@Nonnull final StackTraceElement [] aStackTraceElements,
final boolean bOmitCommonStackTraceElements)
{
final StringBuilder aSB = new StringBuilder ();
_appendSingleStackTraceToString (aSB, aStackTraceElements, null, bOmitCommonStackTraceElements);
return aSB.toString ();
}
@Nonnull
public static String getStackAsString (@Nonnull final StackTraceElement [] aStackTraceElements)
{
return getStackAsString (aStackTraceElements, true);
}
@Nonnull
public static String getStackAsString (@Nonnull final Thread aThread)
{
return getStackAsString (aThread.getStackTrace (), true);
}
@Nonnull
public static String getStackAsString (@Nonnull final Thread aThread, final boolean bOmitCommonStackTraceElements)
{
return getStackAsString (aThread.getStackTrace (), bOmitCommonStackTraceElements);
}
@Nonnull
public static String getCurrentThreadStackAsString ()
{
return getStackAsString (Thread.currentThread ().getStackTrace (), true);
}
private static StringBuilder _getRecursiveStackAsStringBuilder (@Nonnull final Throwable aThrowable,
@Nullable final Throwable aParentThrowable,
@Nullable final StringBuilder aInitialSB,
@Nonnegative final int nLevel,
final boolean bOmitCommonStackTraceElements)
{
// init string buffer with estimated size (very rough guess)
final StringBuilder aSB = aInitialSB == null ? new StringBuilder () : aInitialSB;
// add exception name (+ exception message)
aSB.append (aThrowable.toString ()).append (STACKELEMENT_LINESEP);
// add main call stack
_appendSingleStackTraceToString (aSB,
aThrowable.getStackTrace (),
aParentThrowable == null ? null : aParentThrowable.getStackTrace (),
bOmitCommonStackTraceElements);
// recursively print all causing stacks - reuse StringBuilder
if (aThrowable.getCause () != null)
{
aSB.append ("==> [").append (nLevel).append ("] caused by ");
_getRecursiveStackAsStringBuilder (aThrowable.getCause (),
aThrowable,
aSB,
nLevel + 1,
bOmitCommonStackTraceElements);
}
return aSB;
}
/**
* Get the stack trace of a throwable as string.
*
* @param t
* The throwable to be converted. May be null.
* @return the stack trace as newline separated string. If the passed
* Throwable is null an empty string is returned.
*/
@Nonnull
public static String getStackAsString (@Nullable final Throwable t)
{
return getStackAsString (t, true);
}
/**
* Get the stack trace of a throwable as string.
*
* @param t
* The throwable to be converted. May be null.
* @param bOmitCommonStackTraceElements
* If true the stack trace is cut after certain class
* names occurring. If false the complete stack trace is
* returned.
* @return the stack trace as newline separated string. If the passed
* Throwable is null an empty string is returned.
*/
@Nonnull
public static String getStackAsString (@Nullable final Throwable t, final boolean bOmitCommonStackTraceElements)
{
if (t == null)
return "";
// convert call stack to string
final StringBuilder aCallStack = _getRecursiveStackAsStringBuilder (t, null, null, 1, bOmitCommonStackTraceElements);
// avoid having a separator at the end -> remove the last char
if (StringHelper.getLastChar (aCallStack) == STACKELEMENT_LINESEP)
aCallStack.deleteCharAt (aCallStack.length () - 1);
// no changes
return aCallStack.toString ();
}
/**
* Check if the passed stack trace array contains a unit test element. Known
* unit test frameworks are JUnit and TestNG.
*
* @param t
* The {@link Throwable} whose stack trace should be scanned for unit
* test classes. May be null.
* @return true if at least one stack trace element is from a
* known unit test framework.
*/
public static boolean containsUnitTestElement (@Nullable final Throwable t)
{
return t != null && containsUnitTestElement (t.getStackTrace ());
}
/**
* Check if the passed stack trace array contains a unit test element. Known
* unit test frameworks are JUnit and TestNG.
*
* @param aStackTrace
* The stack trace array to be scanned. May be null.
* @return true if at least one stack trace element is from a
* known unit test framework.
*/
public static boolean containsUnitTestElement (@Nullable final StackTraceElement [] aStackTrace)
{
if (aStackTrace != null)
for (final StackTraceElement aStackTraceElement : aStackTrace)
{
final String sStackTraceLine = aStackTraceElement.toString ();
for (final String sUnitTestPackage : STACKTRACE_OMIT_UNITTEST)
if (sStackTraceLine.startsWith (sUnitTestPackage))
return true;
}
return false;
}
}
