Package limn.backend

Enum Class CrashPhase

java.lang.Object
java.lang.Enum<CrashPhase>
limn.backend.CrashPhase
All Implemented Interfaces:
Serializable, Comparable<CrashPhase>, Constable

public enum CrashPhase extends Enum<CrashPhase>
Where application code was executing when a contained crash was caught.

A 1.x minor release may add constants to this enum: a switch over it needs a default branch.

  • Nested Class Summary

    Nested classes/interfaces inherited from class java.lang.Enum

    Enum.EnumDesc<E extends Enum<E>>
  • Enum Constant Summary

    Enum Constants
    Enum Constant
    Description
    A describe pass for the accessible tree.
    A media decode thread: one that is not the UI thread, not owned by the event loop, and therefore reachable by none of the other phases.
    Native event polling: application code resident in window callbacks (live-resize repaint, close-request veto, content-scale listener) whose exception surfaces when the native poll returns.
    Scene frame production: pending disposals, tick, layout, paint.
    Input event dispatch to widget/application handlers.
    A watcher on the change channel: a binding, an inspector, a bridge, or anything else observing a widget rather than responding to a gesture.
    A task posted to the UI thread (drained between frames).
    An animation ticker.
    Window teardown callbacks (focus-lost handlers, close observers).
  • Method Summary

    Modifier and Type
    Method
    Description
    static CrashPhase
    Returns the enum constant of this class with the specified name.
    static CrashPhase[]
    Returns an array containing the constants of this enum class, in the order they are declared.

    Methods inherited from class java.lang.Object

    getClass, notify, notifyAll, wait, wait, wait
  • Enum Constant Details

    • FRAME

      public static final CrashPhase FRAME
      Scene frame production: pending disposals, tick, layout, paint.
    • INPUT

      public static final CrashPhase INPUT
      Input event dispatch to widget/application handlers.
    • TASK

      public static final CrashPhase TASK
      A task posted to the UI thread (drained between frames).
    • TICKER

      public static final CrashPhase TICKER
      An animation ticker.
    • DECODE

      public static final CrashPhase DECODE
      A media decode thread: one that is not the UI thread, not owned by the event loop, and therefore reachable by none of the other phases. An exception here stops that stream and nothing else; the player also keeps it, so a widget can show the failure rather than only logging it.
    • EVENT_POLL

      public static final CrashPhase EVENT_POLL
      Native event polling: application code resident in window callbacks (live-resize repaint, close-request veto, content-scale listener) whose exception surfaces when the native poll returns.
    • WINDOW_CLOSE

      public static final CrashPhase WINDOW_CLOSE
      Window teardown callbacks (focus-lost handlers, close observers).
    • ACCESSIBILITY

      public static final CrashPhase ACCESSIBILITY
      A describe pass for the accessible tree. Application code the moment a widget subclass overrides its describe hook, and on one platform it runs inside a native callback the window system made, where an escaping exception unwinds into code with no Java frame to report it and the symptom is a process that dies saying nothing.
    • OBSERVER

      public static final CrashPhase OBSERVER
      A watcher on the change channel: a binding, an inspector, a bridge, or anything else observing a widget rather than responding to a gesture. Contained per watcher, so the remaining watchers still run and the application's own handler still runs — an observer must never be able to stop the application from answering the user.
  • Method Details

    • values

      public static CrashPhase[] values()
      Returns an array containing the constants of this enum class, in the order they are declared.
      Returns:
      an array containing the constants of this enum class, in the order they are declared
    • valueOf

      public static CrashPhase valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum class has no constant with the specified name
      NullPointerException - if the argument is null