Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Konstruktor ArrayBlockingQueue(int): pojemność a czas bezczynności

Utwórz kolejkę o stałej pojemności dwóch elementów i odróżnij limit kolejki od zerowego czasu bezczynności nadmiarowych wątków puli.

Wersja: Java SE 21

Składnia

public ArrayBlockingQueue(int capacity)

// Java SE 21: a queue with two slots for waiting tasks
new ThreadPoolExecutor(1, 2, 0L, TimeUnit.MILLISECONDS, new ArrayBlockingQueue<Runnable>(2))

W Java SE 21 konstruktor ArrayBlockingQueue(int) z pakietu java.util.concurrent tworzy pustą kolejkę blokującą opartą na tablicy, ze stałą pojemnością. Argument 2 pozwala przechowywać najwyżej dwa elementy naraz; 0 i wartości ujemne powodują IllegalArgumentException. Elementy są pobierane w kolejności FIFO. Domyślna polityka nie gwarantuje jednak kolejności dostępu oczekujących wątków; aby obsługiwać je w kolejności FIFO, użyj przeciążenia ArrayBlockingQueue(int, boolean) z true.

Gdy kolejka jest pełna, offer(E) zwraca false, nie czekając na wolne miejsce, a put(E) czeka na miejsce, chyba że wątek zostanie przerwany. Jeśli kolejka służy jako kolejka robocza ThreadPoolExecutor, jej pojemność ogranicza liczbę zadań oczekujących w kolejce, a nie liczbę wątków ani wszystkich przyjętych zadań.

W konstruktorze ThreadPoolExecutor literał 0L ma wartość zero i typ long. Literał 0 ma typ int, ale też pasuje do tego parametru dzięki konwersji rozszerzającej do long. TimeUnit.MILLISECONDS to stała typu wyliczeniowego z pakietu java.util.concurrent; milisekunda to jedna tysięczna sekundy. Czas 0L w tej jednostce oznacza, że bezczynne wątki ponad corePoolSize nie czekają na nowe zadania przed zakończeniem. Nie jest to limit czasu wykonania zadania. Domyślnie limit bezczynności nie dotyczy wątków podstawowych; allowCoreThreadTimeOut(true) wymaga dodatniego czasu.

Przykłady

import java.util.concurrent.ArrayBlockingQueue;
import java.util.concurrent.ThreadPoolExecutor;
import java.util.concurrent.TimeUnit;

public class Main {
    public static void main(String[] args) {
        var queue = new ArrayBlockingQueue<String>(2);
        System.out.println(queue.offer("A"));
        System.out.println(queue.offer("B"));
        System.out.println(queue.offer("C"));

        try (var executor = new ThreadPoolExecutor(
                1, 2, 0L, TimeUnit.MILLISECONDS, new ArrayBlockingQueue<Runnable>(2))) {
            System.out.println("keepAliveMs=" + executor.getKeepAliveTime(TimeUnit.MILLISECONDS));
        }
    }
}

Wynik

true
true
false
keepAliveMs=0

Osobna kolejka przyjmuje dwa elementy i odrzuca trzeci (`false`). Pula ma własną kolejkę o dwóch miejscach. Program odczytuje ustawienie `keepAliveMs=0`, ale nie uruchamia zadań ani nie mierzy czasu życia wątków.

Powiązane lekcje

  • Java · Lekcja 37 · Zaawansowany · Wersja: 2
  • Java · Lekcja 42 · Zaawansowany · Wersja: 2

Źródła