Class ClassSpecificLogger<T>

java.lang.Object
org.wpilib.epilogue.logging.ClassSpecificLogger<T>
Type Parameters:
T - the type of data supported by the logger
public abstract class ClassSpecificLogger<T> extends Object
Base class for class-specific generated loggers. Loggers are generated at compile time by the Epilogue annotation processor and are used at runtime for zero-overhead data logging. Users may also declare custom loggers, annotated with @CustomLoggerFor, for Epilogue to pull in during compile time to use for logging third party types.

  • Constructor Details

    • ClassSpecificLogger

      protected ClassSpecificLogger(Class<T> clazz)
      Instantiates the logger.
      Parameters:
      clazz - the Java class of objects that can be logged

  • Method Details

    • update

      protected abstract void update(TelemetryTable table, T object)
      Updates an object's fields in telemetry.
      Parameters:
      table - the telemetry table to update
      object - the object to update in the log

    • tryUpdate

      public final void tryUpdate(TelemetryTable table, T object, ErrorHandler errorHandler)
      Attempts to update telemetry. Will do nothing if the logger is disabled.
      Parameters:
      table - the telemetry table to log data to
      object - the data object to log
      errorHandler - the handler to use if logging raised an exception

    • isDisabled

      public final boolean isDisabled()
      Checks if this logger has been disabled.
      Returns:
      true if this logger has been disabled by disable(), false if not

    • disable

      public final void disable()
      Disables this logger. Any log calls made while disabled will be ignored.

    • reenable

      public final void reenable()
      Reenables this logger after being disabled. Has no effect if the logger is already enabled.

    • getLoggedType

      public final Class<T> getLoggedType()
      Gets the type of the data this logger accepts.
      Returns:
      the logged data type