Package java.lang.classfile.constantpool

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

API этого пакета выполняют проверку аргументов на null и непредставимые значения, если не указано иное.

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

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.