Пакет java.lang.classfile.constantpool

Предоставляет интерфейсы, описывающие записи постоянного пула для библиотеки java.lang.classfile.

Если не указано иное, передача null или массива или коллекции, содержащей элемент null, в качестве аргумента конструктору или методу любого класса или интерфейса API файлов Class-File вызовет исключение NullPointerException.

Чтение записей постоянного пула

boolean isStaticWorkMethod(MethodModel method) {
    // check static flag first to avoid unnecessary evaluation of UTF-8 entry
    return (method.flags().flagsMask() & ClassFile.ACC_STATIC) != 0
            // use equalsString to avoid full conversion to String for comparison
            // the Utf8Entry can also act as a basic CharSequence without full conversion
            && method.methodName().equalsString("work");
}

Записи также определяют обработчики валидированной символьной информации с абстракциями номинальных дескрипторов из пакета java.lang.constant. Эти обработчики символьной информации выполняют проверку по отношению к считанным файлам class и выбрасывают исключение IllegalArgumentException, когда доступная запись постоянного пула содержит недопустимые данные. Номинальные дескрипторы представляют валидированные данные, что избавляет пользователей от дополнительных проверок в последующей обработке.

Из-за ленивого характера парсинга файлов class исключение IllegalArgumentException, указывающее на повреждённые данные файла class, может быть выброшено в любом вызове метода. Например, исключение может быть выброшено из ClassEntry, когда оно впервые считывается из постоянного пула (ссылка на неверный индекс или неправильный тип записи), при расширении его записи UTF-8 (неправильные данные UTF-8) или при доступе к его символьной информации (строка некорректна для записи класса).

Запись записей постоянного пула

Как всегда, пользователи могут использовать фабрики, которые принимают записи постоянного пула, если они уже есть у них, или если они хотят получить точный контроль над генерацией файла class.

Если много моделей и элементов повторно используются из другого ClassModel в процессе создания класса, процесс создания класса может использовать генератор постоянного пула, который расширяет заданный ClassModel, доступный через ConstantPoolBuilder::of(ClassModel), чтобы данные байтов с ссылками на постоянный пул могли копироваться по частям, ускоряя процесс создания класса. Это особенно актуально для преобразования классов, и ConstantPoolSharingOption существует для управления этим поведением.