java.lang.IllegalStateException: Queue full
Ai apelat add() pe o coadă cu capacitate limitată (ArrayBlockingQueue, LinkedBlockingQueue cu limită) care era deja plină. Folosește offer(), care întoarce false în loc să arunce excepție, și tratează cazul în care nu mai e loc.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Cozile din java.util.concurrent, precum ArrayBlockingQueue, au o capacitate fixă, dată la creare. Când e plină, fiecare metodă de adăugare se comportă diferit:
add(x)aruncăIllegalStateException: Queue full;offer(x)întoarcefalseși nu adaugă nimic;put(x)așteaptă până se eliberează un loc (util când alt fir consumă din coadă).
Excepția apare de obicei când un producător adaugă mai repede decât se consumă: comenzi, mesaje, joburi. La cozile cu două capete (LinkedBlockingDeque cu limită) mesajul este Deque full.
În stivă vezi AbstractQueue.add și linia ta. Întrebarea de fond este ce trebuie să se întâmple când nu mai e loc: respingi elementul, aștepți sau mărești capacitatea. Codul trebuie să spună asta explicit.
De ce apare: cauzele frecvente
1add() pe o coadă plină
BlockingQueue<String> comenzi = new ArrayBlockingQueue<>(2);
comenzi.add("C1");
comenzi.add("C2");
comenzi.add("C3");BlockingQueue<String> comenzi = new ArrayBlockingQueue<>(2);
for (String c : List.of("C1", "C2", "C3")) {
if (!comenzi.offer(c)) {
System.out.println("Respinsa: " + c);
}
}offer îți spune prin false că nu mai e loc, iar tu decizi ce faci cu elementul.
2Capacitate aleasă prea mică
Queue<String> mesaje = new ArrayBlockingQueue<>(10);
// se primesc sute de mesaje deodatăQueue<String> mesaje = new ArrayBlockingQueue<>(1000);
// sau, fără limită: new ArrayDeque<>()Dacă nu ai nevoie de limită (fără mai multe fire), ArrayDeque sau LinkedList cresc automat.
3Elementele nu sunt scoase din coadă
coada.add(job);
Job j = coada.peek();
proceseaza(j);coada.add(job);
Job j = coada.poll();
proceseaza(j);peek doar se uită la primul element. poll îl și scoate, eliberând locul.
Repară eroarea, direct în pagină
Ghișeul primește clienți într-o coadă cu 3 locuri, iar al patrulea client oprește programul cu IllegalStateException: Queue full. Folosește offer, ca programul să afișeze In coada: Ana, In coada: Dan, In coada: Ioana, Coada plina, revino: Radu și Clienti in coada: 3.
import java.util.concurrent.*;
public class Main {
public static void main(String[] args) {
BlockingQueue<String> coada = new ArrayBlockingQueue<>(3);
String[] clienti = {"Ana", "Dan", "Ioana", "Radu"};
for (String c : clienti) {
coada.add(c);
System.out.println("In coada: " + c);
}
System.out.println("Clienti in coada: " + coada.size());
}
}In coada: Ana In coada: Dan In coada: Ioana Coada plina, revino: Radu Clienti in coada: 3
Indiciu
offer întoarce false când coada e plină: verifică rezultatul cu if.
Reparația
import java.util.concurrent.*;
public class Main {
public static void main(String[] args) {
BlockingQueue<String> coada = new ArrayBlockingQueue<>(3);
String[] clienti = {"Ana", "Dan", "Ioana", "Radu"};
for (String c : clienti) {
if (coada.offer(c)) {
System.out.println("In coada: " + c);
} else {
System.out.println("Coada plina, revino: " + c);
}
}
System.out.println("Clienti in coada: " + coada.size());
}
}De ce merge
ArrayBlockingQueue are o capacitate fixă de 3, iar add aruncă excepție când nu mai e loc. offer încearcă adăugarea și întoarce false în loc să oprească programul, așa că al patrulea client primește un mesaj, iar coada rămâne cu 3 clienți.
Alte forme ale mesajului
java.lang.IllegalStateException: Deque fullException in thread "main" java.lang.IllegalStateException: Queue full at java.base/java.util.AbstractQueue.add(AbstractQueue.java)
Cum o eviți pe viitor
- La cozi cu limită, folosește
offerși verifică rezultatul, sauputdacă există un consumator pe alt fir. - Alege capacitatea după volumul real și decide dinainte ce se întâmplă la depășire.
- Folosește
pollpentru a consuma elemente, nupeek. - Pentru o simplă coadă de lucru într-un singur fir,
ArrayDequee suficientă și nu are limită.
Întrebări frecvente
De ce add() aruncă excepție și offer() nu?
Interfața Queue oferă ambele stiluri: metodele add, remove, element aruncă excepții, iar offer, poll, peek întorc o valoare specială (false sau null). Alegi stilul după cât de normală e situația „coadă plină”.
Ce rost are o coadă cu limită?
Protejează memoria: dacă producătorul e mult mai rapid decât consumatorul, o coadă fără limită ar crește până la OutOfMemoryError. Limita te obligă să tratezi supraîncărcarea.
Erori înrudite
java.lang.UnsupportedOperationException Încerci să modifici (add, remove, set, put) o colecție imutabilă, creată cu List.of, Set.of, Map.of, Arrays.asList sau stream().toList(). Fă o copie modificabilă: new ArrayList<>(List.of(...)). java.util.NoSuchElementException: No value present Ai apelat get() sau orElseThrow() pe un Optional gol, adică operația (findFirst, max, min, findAny) nu a găsit nimic. Folosește orElse(valoare), ifPresent(...) sau verifică isPresent() înainte. java.lang.OutOfMemoryError: Java heap space Programul a cerut mai multă memorie decât are JVM-ul la dispoziție: un tablou uriaș, o colecție care crește fără limită sau date încărcate integral în memorie. Repară cauza (dimensiuni, bucle, cache-uri); mărirea memoriei cu -Xmx ajută doar dacă programul chiar are nevoie de ea. Învață Java de la zero, cu exerciții la fiecare lecție
Curs Java: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
