CKTIS / Java
Capture de variables locales effectivement finales
Une lambda peut capturer une variable locale sans le modificateur `final` si elle est effectivement finale. Une référence fixe ne rend pas l’objet référencé immuable.
Version : Java SE 21
Syntaxe
Java SE 21: a lambda expression or an inner class can use an enclosing local variable or parameter only if it is final or effectively final. A captured local variable must also be definitely assigned before the lambda or inner-class body. For example: String prefix = "task "; Runnable task = () -> System.out.println(prefix);En Java SE 21, une lambda ou une classe interne, notamment locale ou anonyme, peut utiliser une variable locale ou un paramètre du contexte englobant uniquement si cette variable ou ce paramètre est final ou effectivement final. Une variable locale doit aussi avoir reçu une valeur de façon certaine avant le corps de la lambda ou de la classe interne. La capture porte sur la valeur, pas sur un emplacement modifiable. La lambda peut utiliser cette valeur après le retour de la méthode englobante.
Une variable locale déclarée avec un initialiseur mais sans final est effectivement finale si elle n’apparaît jamais à gauche d’un opérateur d’affectation ni comme opérande de ++ ou --. Cela vaut aussi pour les affectations dans l’initialiseur : int x = (x = 1); est valide, mais x n’est pas effectivement finale. Les paramètres sont traités comme des variables initialisées. Même x = x ou x += 0 enfreint la règle, y compris après la création de la lambda ; la capture provoque alors une erreur de compilation. Une variable locale déclarée sans final ni initialiseur peut recevoir une valeur dans des branches alternatives et rester effectivement finale. Pour chaque affectation, après l’évaluation de l’opérande de droite, elle doit être à la fois définitivement non affectée et non définitivement affectée. Elle ne doit jamais être un opérande de ++ ou --. Elle doit toutefois être définitivement affectée avant la capture.
On ne peut pas capturer l’indice i d’une boucle for classique qui le modifie avec i++. Déclarez final int id = i; dans la boucle pour obtenir une copie à chaque itération. Une boucle for améliorée dispose d’une variable distincte à chaque itération, capturable si elle reste final ou effectivement finale.
Pour un type référence, la valeur capturée est la référence, pas une copie de l’objet. ++acc[0] modifie un élément du tableau sans réaffecter acc. Les champs d’instance et les champs static partagés suivent leurs propres règles, pas celle de la capture des variables locales. final ne garantit pas la sûreté des accès concurrents : coordonnez les accès à l’état mutable partagé, par exemple en protégeant tous les accès à cet état avec le même verrou.
Exemples
public class CaptureDemo {
static Runnable[] makeTasks() {
String prefix = "task ";
final int[] acc = {0};
Runnable[] tasks = new Runnable[2];
for (int i = 0; i < tasks.length; i++) {
final int id = i;
tasks[i] = () -> System.out.println(prefix + id + ": " + ++acc[0]);
}
return tasks;
}
public static void main(String[] args) {
Runnable[] tasks = makeTasks();
tasks[0].run();
tasks[1].run();
}
}Résultat
task 0: 1 task 1: 2
`prefix` est effectivement finale ; `id` et `acc` sont explicitement `final`. Après le retour de `makeTasks()`, chaque tâche utilise son propre `id`, mais les deux incrémentent le même `acc[0]`. Les tâches s’exécutent dans l’ordre sur un seul thread.
Leçons associées
- Java · Leçon 22 · Avancé · Version : 2
- Java · Leçon 34 · Avancé · Version : 2
- Java · Leçon 36 · Avancé · Version : 2
- Java · Leçon 8 · Intermédiaire · Version : 2
Sources
- Java Language Specification, Java SE 21, §4.12.4: final Variables
- Java Language Specification, Java SE 21, §15.27.2: Lambda Body
- Java Language Specification, Java SE 21, §8.1.3: Inner Classes and Enclosing Instances
- Java Language Specification, Java SE 21, §14.14.2: The enhanced for Statement
- Java Language Specification, Java SE 21, Chapter 16: Definite Assignment
- Java Language Specification, Java SE 21, §17.4.5: Happens-before Order