Метка интерфейса

public sealed interface Label

Маркер позиции внутри тела метода. Позиция — это позиция курсора в списке инструкций, аналогичная позиции итератора ListIterator.

Чтение меток

Метки, считанные из class файлов, представляют позиции в массиве code атрибута Code. Они связаны с индексом байткода (bytecode index), также известным как индекс программного счётчика (pc), индексом в массиве code; фактическая позиция курсора находится непосредственно перед заданным индексом, поэтому метка в начале инструкций имеет bci 0, а метка в конце инструкций имеет bci codeLength() + 1. Значение bci можно проверить с помощью CodeAttribute::labelToBci.

В общих CodeModel, метка может не иметь значения bci; положение метки можно найти, выполнив поиск соответствующей LabelTarget в этой модели.

Запись меток

Многие модели в java.lang.classfile ссылаются на метки. Чтобы записать метку, необходимо получить её, привязать к CodeBuilder.

Для получения метки:

• Используйте метку, считанную из других моделей.
• Используйте предопределённые метки из CodeBuilder, такие как CodeBuilder::startLabel, CodeBuilder::endLabel или BlockCodeBuilder::breakLabel. Они уже привязаны.
• Создайте метки с помощью CodeBuilder::newLabel или CodeBuilder::newBoundLabel.

Метка должна быть привязана ровно один раз в CodeBuilder, где она используется; в противном случае запись завершится ошибкой. Чтобы привязать свободную метку:

• Отправьте прочитанную LabelTarget в CodeBuilder.
• Используйте CodeBuilder::labelBinding.

Обратите внимание, что метка, считанная из другой модели, не привязывается автоматически в CodeBuilder; они являются отдельными сущностями, и метка привязана к разным позициям в них.