Interface LPCObjectLoadObserver

public interface LPCObjectLoadObserver
Observes host-side LPC object load and compile attempts for diagnostics.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final LPCObjectLoadObserver
    NONE
    Observer that ignores all diagnostic events.

  • Method Summary

    Modifier and Type
    Method
    Description
    default void
    objectCompileFailed(String objectId, Path sourcePath, Throwable failure)
    Called when a source compilation attempt fails with an exception.
    default void
    objectCompileFinished(String objectId, Path sourcePath, boolean compiled, long elapsedNanos)
    Called after the runtime finishes a source compilation attempt.
    default void
    objectCompileStarted(String objectId, Path sourcePath)
    Called before the runtime compiles a source file through LPCRuntime.compile(Path).
    default void
    objectLoadFailed(String objectId, Path sourcePath, int depth, Throwable failure)
    Called when a shared LPC object load fails with an exception.
    default void
    objectLoadFinished(String objectId, Path sourcePath, int depth, boolean loaded, long elapsedNanos)
    Called after the runtime finishes a shared LPC object load attempt.
    default void
    objectLoadStarted(String objectId, Path sourcePath, int depth)
    Called before the runtime starts loading a shared LPC object.

  • Field Details

  • Method Details

    • objectLoadStarted

      default void objectLoadStarted(String objectId, Path sourcePath, int depth)
      Called before the runtime starts loading a shared LPC object.
      Parameters:
      objectId - canonical mudlib object id
      sourcePath - resolved source path
      depth - current nested load depth

    • objectLoadFinished

      default void objectLoadFinished(String objectId, Path sourcePath, int depth, boolean loaded, long elapsedNanos)
      Called after the runtime finishes a shared LPC object load attempt.
      Parameters:
      objectId - canonical mudlib object id
      sourcePath - resolved source path
      depth - nested load depth reported at start
      loaded - whether the object was loaded or supplied successfully
      elapsedNanos - elapsed load time in nanoseconds

    • objectLoadFailed

      default void objectLoadFailed(String objectId, Path sourcePath, int depth, Throwable failure)
      Called when a shared LPC object load fails with an exception.
      Parameters:
      objectId - canonical mudlib object id
      sourcePath - resolved source path
      depth - nested load depth reported at start
      failure - exception or error that prevented the load

    • objectCompileStarted

      default void objectCompileStarted(String objectId, Path sourcePath)
      Called before the runtime compiles a source file through LPCRuntime.compile(Path).
      Parameters:
      objectId - canonical mudlib object id
      sourcePath - resolved source path

    • objectCompileFinished

      default void objectCompileFinished(String objectId, Path sourcePath, boolean compiled, long elapsedNanos)
      Called after the runtime finishes a source compilation attempt.
      Parameters:
      objectId - canonical mudlib object id
      sourcePath - resolved source path
      compiled - whether compilation completed without reported problems
      elapsedNanos - elapsed compile time in nanoseconds

    • objectCompileFailed

      default void objectCompileFailed(String objectId, Path sourcePath, Throwable failure)
      Called when a source compilation attempt fails with an exception.
      Parameters:
      objectId - canonical mudlib object id
      sourcePath - resolved source path
      failure - exception or error that prevented compilation