jdk-24/test/jdk/java/lang/Thread/StopTest.java

/*
 * Copyright (c) 2022, 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 8289610
 * @summary Test Thread.stop throws UnsupportedOperationException
 * @run testng StopTest
 */

import java.time.Duration;
import java.util.concurrent.atomic.AtomicBoolean;
import java.util.concurrent.locks.LockSupport;
import org.testng.annotations.Test;
import static org.testng.Assert.*;

public class StopTest {

    /**
     * Test stop on the current thread.
     */
    @Test
    public void testCurrentThread() {
        var thread = Thread.currentThread();
        assertThrows(UnsupportedOperationException.class, thread::stop);
    }

    /**
     * Test stop on an unstarted thread.
     */
    @Test
    public void testUnstartedThread() {
        Thread thread = new Thread(() -> { });
        assertThrows(UnsupportedOperationException.class, thread::stop);
        assertTrue(thread.getState() == Thread.State.NEW);
    }

    /**
     * Test stop on a thread spinning in a loop.
     */
    @Test
    public void testRunnableThread() throws Exception {
        AtomicBoolean done = new AtomicBoolean();
        Thread thread = new Thread(() -> {
            while (!done.get()) {
                Thread.onSpinWait();
            }
        });
        thread.start();
        try {
            assertThrows(UnsupportedOperationException.class, thread::stop);

            // thread should not terminate
            boolean terminated = thread.join(Duration.ofMillis(500));
            assertFalse(terminated);
        } finally {
            done.set(true);
            thread.join();
        }
    }

    /**
     * Test stop on a thread that is parked.
     */
    @Test
    public void testWaitingThread() throws Exception {
        Thread thread = new Thread(LockSupport::park);
        thread.start();
        try {
            // wait for thread to park
            while ((thread.getState() != Thread.State.WAITING)) {
                Thread.sleep(10);
            }
            assertThrows(UnsupportedOperationException.class, thread::stop);
            assertTrue(thread.getState() == Thread.State.WAITING);
        } finally {
            LockSupport.unpark(thread);
            thread.join();
        }
    }

    /**
     * Test stop on a terminated thread.
     */
    @Test
    public void testTerminatedThread() throws Exception {
        Thread thread = new Thread(() -> { });
        thread.start();
        thread.join();
        assertThrows(UnsupportedOperationException.class, thread::stop);
        assertTrue(thread.getState() == Thread.State.TERMINATED);
    }

}