CKTIS / Java
Заместващи символи в типовите аргументи на Java
Научете какво можете да четете и записвате с `?`, `? extends T` и `? super T` в Java SE 21 и как правилата важат за списъци, масиви, обекти `Class` и опашки от референции.
Версия: Java SE 21
Синтаксис
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"; }Като типов аргумент ? означава неизвестен тип, който отговаря на ограниченията на обобщената декларация. Това не е условният оператор ?:. List<?> има един неизвестен тип на елементите, който компилаторът може да прихване като нова типова променлива. Можете да прочетете елемент като Object, но не можете просто да добавите стойност, различна от null. List<Object> има конкретен типов аргумент Object и приема произволни обекти, ако поддържа добавяне. Непараметризираният тип List заобикаля част от проверките за обобщени типове.
Списъците са инвариантни спрямо типовия си аргумент: List<Manager> не е подтип на List<Employee>, дори ако Manager наследява Employee. List<? extends Employee> приема списък с тип на елементите Employee или негов подтип. Можете да четете като Employee, но не можете просто да добавите дори Manager. List<? super Manager> приема списък с тип на елементите Manager или негов надтип. Можете да добавите Manager или негов подтип, но без явно преобразуване при четене е гарантиран само Object. Това е правилото PECS: производител extends, потребител super. Добавянето на null преминава типовата проверка и при трите форми, но списъкът може да не допуска null или да не поддържа добавяне. Заместващият символ не прави списъка неизменяем.
В copyFirst декларираният типов параметър <T> свързва двата списъка: ? extends T позволява да прочетете стойност като T, а ? super T — да я запишете. Нито един от двата записа не декларира T. Ако трябва да използвате отново същия неизвестен тип на елементите от List<?>, компилаторът може да изведе прихванатия тип за обобщен помощен метод, приемащ List<T>.
List<?> е един списък, а List<?>[] е масив, чиито позиции могат да съдържат списъци с различни типове на елементите. И двата типа са реифицируеми: new List<?>[2] е допустимо, а new List<String>[2] води до грешка при компилация. Проверката при запис в масива не проверява типовия аргумент на списъка. Class<?> е обект Class, чийто представен тип не е указан в сигнатурата. typeName(Class<?> type) може да приеме String.class и да извика getName(), без да знае този аргумент.
При ReferenceQueue<Asset> методът poll() не изчаква: изважда и връща Reference<? extends Asset> или веднага връща null, ако опашката е празна. ? extends Asset ограничава типа на обекта, към който сочи референцията, а не типа на самата референция. Резултат от get(), различен от null, може да се използва като Asset; изчистена референция връща null. Дефинираният в примера клас Asset предефинира Object.toString() чрез метода на екземпляр public String toString(). @Override кара компилатора да провери предефинирането; методът се изпълнява и при извикване през променлива от тип Object.
Примери
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));
}
}
Резултат
asset copied: 1 tag java.lang.String empty: true same cleared reference: true
`copyFirst` добавя един елемент в целевия списък, без да го премахва от изходния. `enqueue()` изрично изчиства слабата референция и я добавя в опашката, а `reachabilityFence` запазва `manager` силно достижим дотогава. Изходът не зависи от момента на автоматичното освобождаване на паметта.
Свързани уроци
- Java · Урок 45 · Напреднало · Версия: 2
- Java · Урок 58 · Начално · Версия: 2
- Java · Урок 59 · Начално · Версия: 2
- Java · Урок 33 · Средно · Версия: 2
- Java · Урок 34 · Средно · Версия: 2
- Java · Урок 36 · Средно · Версия: 2
- Java · Урок 37 · Средно · Версия: 2
Източници
- 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