Java example source code file (RequestScoper.java)

This example Java source code file (RequestScoper.java) is included in the alvinalexander.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" ^TM.

Learn more about this Java project at its project page.

Java - Java tags/keywords

closeable, closeablescope, override, requestscoper, threading, threads

The RequestScoper.java Java example source code

package com.google.inject.servlet;

import java.io.Closeable;
import java.util.concurrent.Callable;

/** Object that can be used to apply a request scope to a block of code. */
public interface RequestScoper {
  /**
   * Opens up the request scope until the returned object is closed.
   * Implementations should ensure (e.g. by blocking) that multiple threads
   * cannot open the same request scope concurrently. It is allowable to open
   * the same request scope on the same thread, as long as open/close calls are
   * correctly nested.
   */
  CloseableScope open();

  /** Closeable subclass that does not throw any exceptions from close. */
  public interface CloseableScope extends Closeable {
    @Override void close();
  }
}