Method Detail

• public static java.lang.Throwable deepSanitize(java.lang.Throwable t)

  Sanitize the exception and ALL nested causes

  This will MODIFY the stacktrace of the exception instance and all its causes irreversibly

  Parameters:

  t

  Returns:

  The root cause exception instances, with stack trace modified to filter out grails runtime classes

• public static void deprecated(java.lang.Class<?> clazz, java.lang.String methodOrPropName)

  Logs warning message about deprecation of specified property or method of some class.

  Parameters:

  clazz - A class

  methodOrPropName - Name of deprecated property or method

• public static void deprecated(java.lang.Class<?> clazz, java.lang.String methodOrPropName, java.lang.String version)

  Logs warning message about deprecation of specified property or method of some class.

  Parameters:

  clazz - A class

  methodOrPropName - Name of deprecated property or method

  version - Version of Grails release in which property or method were deprecated

• public static void deprecated(java.lang.String message)

  Logs warning message about some deprecation and code style related hints.

  Parameters:

  message - Message to display

• public static java.lang.Throwable extractRootCause(java.lang.Throwable t)

  Extracts the root cause of the exception, no matter how nested it is

  Parameters:

  t

  Returns:

  The deepest cause of the exception that can be found

• public static java.lang.String getGrailsVersion()

• public static void initializeStackFilterer(StackTraceFilterer filterer)

  Installs the given StackTraceFilterer, replacing the default fallback, so that request-time callers of the static sanitize/deepSanitize methods see the configured instance. Called by GrailsBootstrapRegistryInitializer once the config-resolved filterer is available — before the ApplicationContext refreshes, so every app type (web or not) is covered, not just apps that wire a GrailsExceptionResolver bean.

  GrailsUtil intentionally has no dependency on GrailsApplication or Spring's Environment here — the caller is responsible for resolving the configured class and logFullStackTraceOnFilter flag and handing over a ready-to-use instance.

  No-ops when filterer is null. Safe to call more than once — the last call wins. The installed filterer is JVM-global rather than per-context, so in a JVM hosting more than one application context the last one booted supplies the filterer for all of them.

  Since:

  8.0

• public static boolean isDevelopmentEnv()

  Retrieves whether the current execution environment is the development one.

  Returns:

  true if it is the development environment

• public static void printSanitizedStackTrace(java.lang.Throwable t, java.io.PrintWriter p)

• public static void printSanitizedStackTrace(java.lang.Throwable t, java.io.PrintWriter p, StackTraceFilterer stackTraceFilterer)

• public static void printSanitizedStackTrace(java.lang.Throwable t)

• public static java.lang.Throwable sanitizeRootCause(java.lang.Throwable t)

  Get the root cause of an exception and sanitize it for display to the user

  This will MODIFY the stacktrace of the root cause exception object and return it

  Parameters:

  t

  Returns:

  The root cause exception instance, with its stace trace modified to filter out grails runtime classes

• public static void warn(java.lang.String message)

  Logs warning message to grails.util.GrailsUtil logger which is turned on in development mode.

  Parameters:

  message - Message to display