/* * Copyright (c) 2006, 2023, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ /* * @test * @bug 6399443 8302899 * @summary Test that Executors.newSingleThreadExecutor wraps an ExecutorService that * automatically shuts down and terminates when the wrapper is GC'ed * @modules java.base/java.util.concurrent:+open * @run junit AutoShutdown */ import java.lang.reflect.Field; import java.time.Duration; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; import java.util.concurrent.atomic.AtomicInteger; import java.util.function.Supplier; import java.util.stream.Stream; import java.util.stream.IntStream; import org.junit.jupiter.api.Test; import org.junit.jupiter.params.ParameterizedTest; import org.junit.jupiter.params.provider.MethodSource; import org.junit.jupiter.params.provider.Arguments; import static org.junit.jupiter.api.Assertions.*; class AutoShutdown { private static Stream> executors() { return Stream.of( () -> Executors.newSingleThreadExecutor(), () -> Executors.newSingleThreadExecutor(Executors.defaultThreadFactory()) ); } private static Stream executorAndQueuedTaskCounts() { int[] queuedTaskCounts = { 0, 1, 2 }; return executors().flatMap(s -> IntStream.of(queuedTaskCounts) .mapToObj(i -> Arguments.of(s, i))); } /** * SingleThreadExecutor with no worker threads. */ @ParameterizedTest @MethodSource("executors") void testNoWorker(Supplier supplier) throws Exception { ExecutorService executor = supplier.get(); ExecutorService delegate = getDelegate(executor); executor = null; gcAndAwaitTermination(delegate); } /** * SingleThreadExecutor with an idle worker thread. */ @ParameterizedTest @MethodSource("executors") void testIdleWorker(Supplier supplier) throws Exception { ExecutorService executor = supplier.get(); // submit a task to get a worker to start executor.submit(() -> null).get(); ExecutorService delegate = getDelegate(executor); executor = null; gcAndAwaitTermination(delegate); } /** * SingleThreadExecutor with an active worker and queued tasks. */ @ParameterizedTest @MethodSource("executorAndQueuedTaskCounts") void testActiveWorker(Supplier supplier,int queuedTaskCount) throws Exception { ExecutorService executor = supplier.get(); // the worker will execute one task, the other tasks will be queued int ntasks = 1 + queuedTaskCount; AtomicInteger completedTaskCount = new AtomicInteger(); for (int i = 0; i < ntasks; i++) { executor.submit(() -> { Thread.sleep(Duration.ofMillis(500)); completedTaskCount.incrementAndGet(); return null; }); } ExecutorService delegate = getDelegate(executor); executor = null; gcAndAwaitTermination(delegate); assertEquals(ntasks, completedTaskCount.get()); } /** * Returns the delegate for the given ExecutorService. The given ExecutorService * must be a Executors$DelegatedExecutorService. */ private ExecutorService getDelegate(ExecutorService executor) throws Exception { Field eField = Class.forName("java.util.concurrent.Executors$DelegatedExecutorService") .getDeclaredField("e"); eField.setAccessible(true); return (ExecutorService) eField.get(executor); } /** * Invokes System.gc and waits for the given ExecutorService to terminate. */ private void gcAndAwaitTermination(ExecutorService executor) throws Exception { System.err.println(executor); boolean terminated = false; while (!terminated) { System.gc(); terminated = executor.awaitTermination(100, TimeUnit.MILLISECONDS); } } }