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

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

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