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

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

Пакет java.lang.classfile.instruction содержит интерфейсы, описывающие инструкции кода. Реализации этих интерфейсов неизменяемы.

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

Чтение инструкций

К инструкциям и псевдоинструкциям обычно обращаются через CodeModel, например CodeModel::forEach, и классифицируют с помощью сопоставления с образцом.

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

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

Запись инструкций

Запись инструкций выполняется с помощью CodeBuilder. Самый простой способ записать инструкции — передать объект инструкции в CodeBuilder::with, который поддерживает все допустимые инструкции. Однако CodeBuilder предоставляет множество вспомогательных методов-фабрик для удобного создания инструкций, названных по их мнемонике. Эти методы доступа лаконичнее и зачастую эффективнее во время выполнения, чем передача объектов инструкций.

Из-за ограничений формата файла class некоторые инструкции могут быть непредставимы в CodeBuilder. В некоторых случаях, например для BranchInstruction, параметры Class-File API управляют тем, могут ли вместо них использоваться альтернативы при генерации кода. В противном случае их можно настроить на немедленное завершение с ошибкой, чтобы обеспечить соответствие команд CodeBuilder данным сгенерированного массива code.