Class AbstractListenableFutureTest

java.lang.Object
junit.framework.Assert
junit.framework.TestCase
com.google.common.util.concurrent.testing.AbstractListenableFutureTest
All Implemented Interfaces:
junit.framework.Test
@GwtIncompatible public abstract class AbstractListenableFutureTest extends junit.framework.TestCase
Abstract test case parent for anything implementing ListenableFuture. Tests the two get methods and the addListener method.
Since:
10.0
Author:
Sven Mawson

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    protected com.google.common.util.concurrent.ListenableFuture<Boolean>
    future
     
    protected CountDownLatch
    latch
     

  • Constructor Summary

    Constructors
    Constructor
    Description
    AbstractListenableFutureTest()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    protected abstract <V> com.google.common.util.concurrent.ListenableFuture<V>
    createListenableFuture(V value, @Nullable Exception except, CountDownLatch waitOn)
    Constructs a listenable future with a value available after the latch has counted down.
    protected void
    setUp()
     
    protected void
    tearDown()
     
    void
    testAllListenersCompleteSuccessfully()
    Tests that all listeners complete, even if they were added before or after the future was finishing.
    void
    testCanceledFutureThrowsCancellation()
    Tests that a canceled future throws a cancellation exception.
    void
    testGetBlocksUntilValueAvailable()
    Tests that the Future.get() method blocks until a value is available.
    void
    testListenersNotifiedOnError()
     
    void
    testTimeoutOnGetWorksCorrectly()
    Tests that the Future.get(long, TimeUnit) method times out correctly.

    Methods inherited from class junit.framework.TestCase

    assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertTrue, assertTrue, countTestCases, createResult, fail, fail, failNotEquals, failNotSame, failSame, format, getName, run, run, runBare, runTest, setName, toString

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

  • Field Details

    • latch

      protected CountDownLatch latch

    • future

      protected com.google.common.util.concurrent.ListenableFuture<Boolean> future

  • Constructor Details

    • AbstractListenableFutureTest

      public AbstractListenableFutureTest()

  • Method Details

    • setUp

      protected void setUp() throws Exception
      Overrides:
      setUp in class junit.framework.TestCase
      Throws:
      Exception

    • tearDown

      protected void tearDown() throws Exception
      Overrides:
      tearDown in class junit.framework.TestCase
      Throws:
      Exception

    • createListenableFuture

      protected abstract <V> com.google.common.util.concurrent.ListenableFuture<V> createListenableFuture(V value, @Nullable Exception except, CountDownLatch waitOn)
      Constructs a listenable future with a value available after the latch has counted down.

    • testGetBlocksUntilValueAvailable

      public void testGetBlocksUntilValueAvailable() throws Throwable
      Tests that the Future.get() method blocks until a value is available.
      Throws:
      Throwable

    • testTimeoutOnGetWorksCorrectly

      public void testTimeoutOnGetWorksCorrectly() throws InterruptedException, ExecutionException
      Tests that the Future.get(long, TimeUnit) method times out correctly.
      Throws:
      InterruptedException
      ExecutionException

    • testCanceledFutureThrowsCancellation

      public void testCanceledFutureThrowsCancellation() throws Exception
      Tests that a canceled future throws a cancellation exception.

      This method checks the cancel, isCancelled, and isDone methods.

      Throws:
      Exception

    • testListenersNotifiedOnError

      public void testListenersNotifiedOnError() throws Exception
      Throws:
      Exception

    • testAllListenersCompleteSuccessfully

      public void testAllListenersCompleteSuccessfully() throws InterruptedException, ExecutionException
      Tests that all listeners complete, even if they were added before or after the future was finishing. Also acts as a concurrency test to make sure the locking is done correctly when a future is finishing so that no listeners can be lost.
      Throws:
      InterruptedException
      ExecutionException