Package org.openhab.core.common

Interface SafeCaller

@NonNullByDefault public interface SafeCaller
OSGi service to obtain a SafeCallerBuilder. Safe-calls are used within the framework in order to protect it from hanging/blocking binding code and log meaningful messages to detect and identify such hanging code.
Author:
Simon Kaufmann - Initial contribution

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final long
    DEFAULT_TIMEOUT
    Default timeout for actions in milliseconds.

  • Method Summary

    Modifier and Type
    Method
    Description
    <T> SafeCallerBuilder<@NonNull T>
    create(T target, Class<T> interfaceType)
    Create a safe call builder for the given object.

  • Field Details

    • DEFAULT_TIMEOUT

      static final long DEFAULT_TIMEOUT
      Default timeout for actions in milliseconds.

  • Method Details

    • create

      <T> SafeCallerBuilder<@NonNull T> create(T target, Class<T> interfaceType)
      Create a safe call builder for the given object.
      Parameters:
      target - the object on which calls should be protected by the safe caller
      interfaceType - the interface which defines the relevant methods
      Returns:
      a safe call builder instance.