CKTIS / Java
Jokers dans les arguments de type Java
Découvrez ce que `?`, `? extends T` et `? super T` permettent de lire ou d’écrire dans Java SE 21, avec des listes, des tableaux, des objets `Class` et des files de références.
Version : Java SE 21
Syntaxe
Generic type arguments: G<?>, G<? extends T>, G<? super T> (T must already be in scope)
static <T> void copyFirst(List<? extends T> source, List<? super T> target)
List<? extends Employee> employees; List<? super Manager> destination;
Class<?> token = String.class;
List<?> list = List.of("tag"); List<?>[] lists = new List<?>[] { list };
Reference<? extends Asset> reference = queue.poll(); // queue has type ReferenceQueue<Asset>
Inside a class: @Override public String toString() { return "asset"; }Dans un argument de type, ? désigne un type inconnu qui respecte les bornes de la déclaration générique. Ce n’est pas l’opérateur conditionnel ?:. Une List<?> a un seul type d’élément inconnu, que le compilateur peut capturer dans une nouvelle variable de type. On peut lire un élément comme Object, mais pas ajouter directement une valeur non nulle. List<Object> a l’argument de type précis Object et accepte tout objet si l’ajout est pris en charge. Le type brut List contourne certains contrôles des génériques.
Les listes sont invariantes par rapport à leur argument de type : List<Manager> n’est pas un sous-type de List<Employee>, même si Manager hérite de Employee. List<? extends Employee> accepte une liste dont le type des éléments est Employee ou un sous-type. On peut lire un Employee, mais pas ajouter directement un Manager. List<? super Manager> accepte une liste dont le type des éléments est Manager ou un supertype. On peut ajouter un Manager ou un sous-type, mais sans conversion explicite la lecture ne garantit que Object. C’est la règle PECS : producteur extends, consommateur super. L’ajout de null passe le contrôle de types pour ces trois formes, mais la liste peut refuser null ou ne pas prendre en charge l’ajout. Un joker ne rend pas une liste immuable.
Dans copyFirst, le paramètre de type déclaré <T> relie les deux listes : ? extends T permet de lire une valeur comme T, et ? super T de l’écrire. Aucun joker ne déclare T. Pour réutiliser le même type d’élément inconnu d’une List<?>, le compilateur peut inférer le type capturé pour une méthode auxiliaire générique qui reçoit une List<T>.
List<?> est une liste, tandis que List<?>[] est un tableau dont les cases peuvent contenir des listes de types d’éléments différents. Les deux types sont réifiables : new List<?>[2] est valide, mais new List<String>[2] provoque une erreur de compilation. Le contrôle d’écriture dans le tableau ne vérifie pas l’argument de type de la liste. Class<?> est un objet Class dont le type représenté n’est pas précisé dans la signature. typeName(Class<?> type) peut recevoir String.class et appeler getName() sans connaître cet argument.
Sur une ReferenceQueue<Asset>, poll() n’attend pas : elle retire et renvoie une Reference<? extends Asset>, ou renvoie aussitôt null si la file est vide. ? extends Asset borne le type de l’objet référencé, non celui de l’objet référence. Un résultat non nul de get() est utilisable comme Asset ; une référence effacée donne null. La classe personnalisée Asset redéfinit Object.toString() avec la méthode d’instance public String toString(). @Override demande au compilateur de vérifier la redéfinition ; la méthode s’exécute même si l’appel passe par une variable de type Object.
Exemples
import java.lang.ref.Reference;
import java.lang.ref.ReferenceQueue;
import java.lang.ref.WeakReference;
import java.util.ArrayList;
import java.util.List;
public class Main {
static class Asset {
@Override
public String toString() {
return "asset";
}
}
static class Employee extends Asset {}
static final class Manager extends Employee {}
static <T> void copyFirst(List<? extends T> source, List<? super T> target) {
if (!source.isEmpty()) {
target.add(source.get(0));
}
}
static String typeName(Class<?> type) {
return type.getName();
}
public static void main(String[] args) {
Manager manager = new Manager();
List<Manager> managers = List.of(manager);
List<? extends Employee> employees = managers;
Object asset = employees.get(0);
System.out.println(asset.toString());
List<? super Manager> destination = new ArrayList<Employee>();
copyFirst(managers, destination);
System.out.println("copied: " + destination.size());
List<?> tags = List.of("tag");
List<?>[] groups = new List<?>[] { destination, tags };
Object tag = groups[1].get(0);
System.out.println(tag);
System.out.println(typeName(String.class));
ReferenceQueue<Asset> queue = new ReferenceQueue<>();
System.out.println("empty: " + (queue.poll() == null));
WeakReference<Manager> reference = new WeakReference<>(manager, queue);
reference.enqueue();
Reference.reachabilityFence(manager);
Reference<? extends Asset> polled = queue.poll();
System.out.println("same cleared reference: " + (polled == reference && polled.get() == null));
}
}
Résultat
asset copied: 1 tag java.lang.String empty: true same cleared reference: true
`copyFirst` ajoute un élément à la destination sans le retirer de la source. `enqueue()` efface et met explicitement en file la référence faible, et `reachabilityFence` maintient `manager` fortement accessible jusque-là. L’affichage ne dépend pas du moment où intervient le ramasse-miettes.
Leçons associées
- Java · Leçon 45 · Avancé · Version : 2
- Java · Leçon 58 · Débutant · Version : 2
- Java · Leçon 59 · Débutant · Version : 2
- Java · Leçon 33 · Intermédiaire · Version : 2
- Java · Leçon 34 · Intermédiaire · Version : 2
- Java · Leçon 36 · Intermédiaire · Version : 2
- Java · Leçon 37 · Intermédiaire · Version : 2
Sources
- Java Language Specification, Java SE 21, §4.5.1: Type Arguments of Parameterized Types
- Java Language Specification, Java SE 21, §4.7: Reifiable Types
- Java Language Specification, Java SE 21, §5.1.10: Capture Conversion
- Java Language Specification, Java SE 21, §15.10.1: Array Creation Expressions
- Java SE 21 API: List
- Java SE 21 API: Class and getName()
- Java SE 21 API: ReferenceQueue.poll()
- Java SE 21 API: Reference
- Java SE 21 API: WeakReference
- Java SE 21 API: Object.toString()
- Java SE 21 API: Override