Method Detail

• attachMessage

  public static <E extends java.lang.Throwable> E attachMessage​(E e,
                                                                java.lang.String msg)

  Attaches additional message to given exception. This message will be visible when one does e.printStackTrace().

  Parameters:

  e - exception to annotate

  msg - the message to add to the exception

  Returns:

  the exception e

• attachLocalizedMessage

  public static <E extends java.lang.Throwable> E attachLocalizedMessage​(E e,
                                                                         java.lang.String localizedMessage)

  Attaches additional localized message to given exception. This message can be extracted later by using findLocalizedMessage(java.lang.Throwable).

  Parameters:

  e - exception to annotate

  localizedMessage - the localized message to add to the exception

  Returns:

  the exception e

• attachSeverity

  public static <E extends java.lang.Throwable> E attachSeverity​(E e,
                                                                 java.util.logging.Level severity)

  Attaches a given severity to the exception. When the exception is later passed to printStackTrace(java.lang.Throwable) method, the level is then used as a level for reported LogRecord. This allows those who report exceptions to annotate them as unimportant, expected.

  Parameters:

  e - exception to assign severity to

  severity - the severity

  Since:

  8.8

• findLocalizedMessage

  public static java.lang.String findLocalizedMessage​(java.lang.Throwable t)

  Extracts previously attached localized message for a given throwable. Complements attachLocalizedMessage(E, java.lang.String).

  Parameters:

  t - the exception to search for a message in

  Returns:

  localized message attached to provided exception or null if no such message has been attached

• printStackTrace

  public static void printStackTrace​(java.lang.Throwable t)

  Notifies an exception with a severe level. Such exception is going to be printed to log file and possibly also notified to alarm the user somehow.

  Since version 8.29 the default implementation of this method inside a NetBeans Platform based application understands UserQuestionException. If the exception is thrown and later reported via this method, it is properly shown to the user as a dialog with approve/reject buttons. If approved, the infrastructure calls UserQuestionException.confirmed() method.

  Parameters:

  t - the exception to notify