Интерфейс Label

public sealed interface Label

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

Чтение меток

Метки, считываемые из файлов class, представляют позиции в массиве code атрибута Code. Они связаны с bci (индексом байткода), также известным как 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; это отдельные сущности, и метка привязана к разным позициям в каждой из них.