io.ebean.config.BackgroundExecutorWrapper Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ebean-api Show documentation

ebean api

There is a newer version: 15.8.0

package io.ebean.config;

import java.util.concurrent.Callable;

/**
 * BackgroundExecutorWrapper that can be used to wrap tasks that are sent to background (i.e. another thread).
 * It should copy all necessary thread-local variables. See {@link MdcBackgroundExecutorWrapper} for implementation details.
 *
 * Note: only tasks that are executed immediately (submit, execute) are wrapped. Periodic or scheduled tasks are not wrapped,
 * as these may keep copied variables in memory either forever or until the scheduled task is finished.
 * The caller is responsible to handle these cases.
 *
 * @author Roland Praml, FOCONIS AG
 */
public interface BackgroundExecutorWrapper {

  /**
   * Wrap the task with MDC context if defined.
   */
   Callable wrap(Callable task);

  /**
   * Wrap the task with MDC context if defined.
   */
  Runnable wrap(Runnable task);

  /**
   * Combines two wrappers by nesting them.
   */
  default BackgroundExecutorWrapper with(BackgroundExecutorWrapper inner) {
    return new BackgroundExecutorWrapper() {

      @Override
      public Runnable wrap(Runnable task) {
        return BackgroundExecutorWrapper.this.wrap(inner.wrap(task));
      }

      @Override
      public  Callable wrap(Callable task) {
        return BackgroundExecutorWrapper.this.wrap(inner.wrap(task));
      }
    };

  }

}