...
← Blog Lecții programare java

ArrayList în Java: metode, exemple și greșeli de începător

Sigla Java, ilustrație pentru lecția despre ArrayList în Java

ArrayList în Java este o listă care își schimbă singură dimensiunea: adaugi elemente cu add(), le citești cu get(), le ștergi cu remove() și afli câte sunt cu size(). Spre deosebire de un array, nu trebuie să știi dinainte câte elemente vei avea, de aceea e colecția pe care o vei folosi cel mai des în Java.

Structurile de date, cu exemple interactive: structuri de date explicate, stiva și coada și arbori binari.

Mai jos găsești metodele principale într-un tabel, un exemplu de coș de cumpărături care rulează, cum parcurgi și sortezi o listă, cum ștergi corect în timp ce parcurgi și cele două capcane care îi încurcă pe toți: remove() la liste de numere și ConcurrentModificationException.

Ce este ArrayList în Java?

ArrayList este o clasă din pachetul java.util care păstrează elemente într-o anumită ordine, cu indexuri de la 0, la fel ca un array, dar cu dimensiune variabilă. În spate folosește chiar un array: când se umple, creează unul mai mare și copiază elementele, fără ca tu să faci nimic.

Diferența practică se vede repede. Un coș de cumpărături dintr-un magazin online nu are un număr fix de produse: clientul adaugă trei, scoate unul, mai adaugă două. Cu un array ar trebui să ghicești dimensiunea maximă. Cu un ArrayList, lista crește și scade după nevoie. ArrayList face parte din colecțiile Java (Java Collections Framework), alături de HashSet și HashMap, pe care le vei întâlni mai târziu.

Cum declari un ArrayList?

Imporți clasa, apoi o creezi cu tipul elementelor între paranteze unghiulare: ArrayList<String> înseamnă „listă de texte”. Tipul dintre paranteze se numește parametru generic și îi spune compilatorului ce poate intra în listă.

import java.util.ArrayList;
import java.util.List;

ArrayList<String> cos = new ArrayList<>();
List<String> sarcini = new ArrayList<>();      // forma preferată în proiecte
ArrayList<Integer> scoruri = new ArrayList<>();

Parantezele goale din dreapta, <>, se numesc operatorul diamant: Java deduce tipul din stânga, așa că nu trebuie să-l scrii de două ori. În codul profesional vei vedea des forma cu List în stânga. List e o interfață, iar declarând variabila ca List poți schimba mai târziu implementarea fără să modifici restul codului. Pentru început, ambele forme sunt corecte.

De ce nu poți scrie ArrayList<int>?

Pentru că un ArrayList ține doar obiecte, iar int e un tip primitiv. Folosești clasa pereche, numită wrapper: Integer pentru int, Double pentru double, Boolean pentru boolean, Character pentru char. Conversia dintre ele se face automat (autoboxing), așa că scrii scoruri.add(95) ca și cum ar fi o listă de int.

Ce metode are ArrayList?

Zece metode acoperă aproape tot ce vei face cu o listă la început. Le ai pe toate în tabelul de mai jos, cu efectul lor pe o listă de exemplu.

MetodaCe faceExemplu
add(e)adaugă la finalcos.add("laptop")
add(i, e)inserează la poziția i, restul se mută la dreaptacos.add(1, "husă")
get(i)întoarce elementul de la poziția icos.get(0)
set(i, e)înlocuiește elementul de la poziția icos.set(2, "mouse wireless")
remove(i) / remove(e)șterge după poziție sau după valoarecos.remove("husă")
size()numărul de elementecos.size()
contains(e)verifică dacă elementul existăcos.contains("laptop")
indexOf(e)poziția primei apariții sau -1cos.indexOf("căști")
isEmpty()true dacă lista e goalăcos.isEmpty()
clear()golește listacos.clear()

Lista completă e în documentația oficială a clasei ArrayList.

Exemplu complet: coșul de cumpărături

Codul de mai jos folosește metodele din tabel pe un coș real. Comentariile arată exact ce afișează Java la fiecare pas.

ArrayList<String> cos = new ArrayList<>();
cos.add("laptop");
cos.add("mouse");
cos.add("căști");
cos.add(1, "husă");
System.out.println(cos);           // [laptop, husă, mouse, căști]

System.out.println(cos.size());    // 4
System.out.println(cos.get(0));    // laptop
System.out.println(cos.get(cos.size() - 1));  // căști, ultimul element

cos.set(2, "mouse wireless");
System.out.println(cos);           // [laptop, husă, mouse wireless, căști]

cos.remove("husă");
System.out.println(cos);           // [laptop, mouse wireless, căști]
System.out.println(cos.contains("laptop"));  // true
System.out.println(cos.indexOf("căști"));    // 2

Observă două lucruri. Spre deosebire de un array, System.out.println(cos) afișează direct conținutul, fără Arrays.toString. Și după ce ai șters „husă”, indexurile s-au refăcut: „căști” a trecut de pe poziția 3 pe 2. Lista nu lasă găuri.

Diferența dintre add(i, e) și set(i, e)

add(1, "husă") inserează un element nou și mută restul la dreapta, deci lista crește cu unu. set(2, "mouse wireless") înlocuiește ce era acolo, iar lista rămâne la fel de lungă. Dacă le confunzi, fie pierzi un element, fie îl dublezi.

Cum parcurgi un ArrayList?

La fel ca un array: cu for clasic când ai nevoie de poziție și cu for-each când ai nevoie doar de valori. Singurele diferențe sunt size() în loc de length și get(i) în loc de [i].

List<String> sarcini = new ArrayList<>();
sarcini.add("plătește factura la curent");
sarcini.add("programare la service");
sarcini.add("cumpără bilete de tren");

for (int i = 0; i < sarcini.size(); i++) {
    System.out.println((i + 1) + ". " + sarcini.get(i));
}

for (String sarcina : sarcini) {
    System.out.println("- " + sarcina);
}

Pentru calcule pe numere, tiparul e cel din lecția despre array-uri: o variabilă în care aduni și o buclă. for (int s : scoruri) suma += s; funcționează direct pe un ArrayList<Integer>, iar Java convertește fiecare Integer în int.

Cum sortezi o listă și afli minimul sau maximul?

Cu clasa Collections, care are metode gata făcute pentru liste: sort, max, min, reverse. Sortarea se face chiar în lista dată, nu într-o copie.

import java.util.Collections;

ArrayList<Integer> scoruri = new ArrayList<>(List.of(70, 95, 40, 88, 55));

Collections.sort(scoruri);
System.out.println(scoruri);   // [40, 55, 70, 88, 95]

scoruri.sort(Collections.reverseOrder());
System.out.println(scoruri);   // [95, 88, 70, 55, 40]

System.out.println(Collections.max(scoruri));  // 95
System.out.println(Collections.min(scoruri));  // 40

List.of(...) e o scurtătură pentru a crea o listă cu valori de la început; o „împachetezi” în new ArrayList<>(...) ca să o poți modifica după. Textele se sortează alfabetic cu aceeași metodă, dar atenție la diacritice: sortarea implicită se face după codul caracterelor, așa că „Ștefan” ajunge după „Zoe”.

Cum ștergi elemente în timp ce parcurgi lista?

Nu cu for-each. Dacă ștergi un element din listă în timp ce o parcurgi cu for-each, Java oprește de obicei programul cu ConcurrentModificationException. Ai trei variante corecte.

ArrayList<String> tehnologii = new ArrayList<>(List.of("Java", "Git", "SQL", "Docker"));

// greșit: ConcurrentModificationException
for (String t : tehnologii) {
    if (t.equals("Git")) {
        tehnologii.remove(t);
    }
}
  1. removeIf, cea mai scurtă: scoruri.removeIf(s -> s < 60); șterge toate scorurile sub 60. Săgeata e o expresie lambda; o înveți pe larg mai târziu, deocamdată citește-o ca „șterge fiecare s pentru care s < 60”.
  2. Un Iterator, care știe să șteargă sigur elementul curent cu iterator.remove().
  3. Un for clasic parcurs de la final spre început, ca ștergerea să nu mute elementele pe care nu le-ai verificat încă.
// varianta 3: de la coadă la cap
for (int i = tehnologii.size() - 1; i >= 0; i--) {
    if (tehnologii.get(i).length() <= 3) {
        tehnologii.remove(i);
    }
}
System.out.println(tehnologii);  // [Java, Docker]

ArrayList sau array: pe care îl alegi?

Alege ArrayList când numărul de elemente se schimbă și array când e fix sau când lucrezi cu multe numere primitive și contează memoria. În aplicațiile obișnuite, ArrayList e alegerea implicită.

CriteriuArrayArrayList
Dimensiunefixăvariabilă
Tipuri primitivedirect (int[])prin wrapper (Integer)
Lungimelengthsize()
Citire / scrierea[i], a[i] = xget(i), set(i, x)
AfișareArrays.toString(a)println(lista)
Inserare și ștergeremanual, cu copiereadd, remove

Ca viteză, citirea cu get(i) e la fel de rapidă ca la un array, iar adăugarea la final e rapidă în medie. Inserarea și ștergerea de la început sunt mai lente, pentru că toate elementele de după trebuie mutate cu o poziție. Pentru liste de câteva mii de elemente, diferența nu se simte.

Ce greșeli fac începătorii cu ArrayList?

Cele mai multe greșeli vin din amestecul dintre sintaxa de array și cea de listă și din câteva metode cu comportament surprinzător.

remove(1) la o listă de numere

ArrayList<Integer> numere = new ArrayList<>(List.of(10, 20, 30, 40));
numere.remove(1);                    // șterge elementul de pe poziția 1, adică 20
System.out.println(numere);          // [10, 30, 40]
numere.remove(Integer.valueOf(10));  // șterge valoarea 10
System.out.println(numere);          // [30, 40]

Când argumentul e un int, Java alege varianta „după poziție”. Ca să ștergi după valoare, transformi numărul în obiect cu Integer.valueOf.

Index care nu există

cos.get(5) pe o listă cu 3 elemente oprește programul cu IndexOutOfBoundsException: Index 5 out of bounds for length 3. O listă nouă, chiar creată cu o capacitate inițială precum new ArrayList<>(100), are size() egal cu 0; capacitatea e doar spațiu rezervat intern, nu elemente.

Liste care nu se pot modifica

List.of("a", "b") creează o listă imuabilă, iar Arrays.asList(...) una cu dimensiune fixă. Un add pe oricare dintre ele aruncă UnsupportedOperationException. Dacă vrei o listă pe care s-o modifici, pune-le într-un ArrayList nou: new ArrayList<>(List.of("a", "b")).

Copia care nu e copie

ArrayList<String> copie = cos; nu creează o listă nouă, ci încă un nume pentru aceeași listă. O copie independentă se face cu new ArrayList<>(cos).

Alte greșeli ale primelor săptămâni le găsești în articolul despre greșelile frecvente ale începătorilor în Java.

Exercițiu: lista de sarcini în consolă

Scrie un program cu un meniu care rulează până alegi ieșirea: 1 adaugă o sarcină, 2 afișează toate sarcinile numerotate, 3 șterge o sarcină după numărul ei, 4 afișează câte sarcini au rămas, 0 ieșire. Folosește un ArrayList<String>, Scanner și o buclă do-while.

Atenție la două detalii: utilizatorul numerotează de la 1, iar lista de la 0, deci la ștergere scazi 1. Și verifică numărul înainte de remove, ca o valoare greșită să afișeze un mesaj, nu să oprească programul.

Întrebări frecvente

Ce este ArrayList în Java?

Este o clasă din java.util care implementează o listă ordonată, cu indexuri de la 0, care își mărește singură capacitatea. Adaugi cu add(), citești cu get(), ștergi cu remove() și afli lungimea cu size().

Care e diferența dintre ArrayList și array?

Un array are dimensiune fixă și poate ține direct tipuri primitive. Un ArrayList are dimensiune variabilă, ține doar obiecte (deci Integer în loc de int) și vine cu metode pentru adăugare, ștergere și căutare.

Poate un ArrayList să conțină duplicate?

Da, același element poate apărea de mai multe ori. Dacă ai nevoie de valori unice, de exemplu adresele de e-mail ale abonaților, folosește un HashSet.

Cum aflu ultimul element dintr-un ArrayList?

Cu lista.get(lista.size() - 1), după ce verifici că lista nu e goală. Din Java 21 există și metoda lista.getLast().

De ce nu pot folosi int într-un ArrayList?

Pentru că un ArrayList ține doar obiecte, iar int e tip primitiv. Folosești ArrayList<Integer>, iar Java convertește automat între int și Integer când adaugi sau citești.

Primul pas: rescrie un exemplu cu array ca ArrayList

Ia exemplul cu vânzările săptămânii din lecția anterioară și rescrie-l cu un ArrayList<Integer>. Adaugă apoi o zi în plus și șterge una, lucruri pe care cu un array nu le puteai face ușor. Încearcă intenționat remove(1) pe lista de numere și ștergerea în for-each, ca să vezi cele două capcane cu ochii tăi.

Colecțiile (liste, mulțimi, Map) sunt în modulul avansat din cursul de Java, după tablouri și programarea orientată pe obiecte; primele 15 lecții, cu fundamentele, sunt gratuite. Toate exercițiile rulează în browser, cu verificare automată și indicii de la Profu’, tutorele AI din lecții. Pentru imaginea completă a ce înveți până la primul job, vezi traseul de Java Developer.

Lecția anterioară: arrays și vectori în Java. Lecția următoare: metode în Java.

Logo Curs Java Interactiv · 15 lecții gratuite

Curs Java

Programare Java pentru începători: de la sintaxă la OOP și colecții

Începe gratuit

Citește și

Primul tău program e la 5 minute distanță.

Creează-ți contul gratuit și începe primele 15 lecții. Fără card, fără instalări.

Începe gratuit