Интерфейс ClassFileTransform<C extends ClassFileTransform<C,E,B>, E extends ClassFileElement, B extends ClassFileBuilder<E,B>>

Например, это простое преобразование CodeModel, которое перенаправляет все вызовы статических методов класса Foo в класс Bar, сохраняя все остальные элементы:

CodeTransform fooToBar = (b, e) -> {
    if (e instanceof InvokeInstruction i
            && i.owner().name().equalsString("Foo")
            && i.opcode() == Opcode.INVOKESTATIC) {
        // remove the old element i by doing nothing to the builder
        // add a new invokestatic instruction to the builder
        b.invokestatic(CD_Bar, i.name().stringValue(), i.typeSymbol(), i.isInterface());
    } else {
        b.with(e);  // leaves the element in place
    }
};

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

Пользователи могут определить пользовательскую обработку в начале и конце преобразования, переопределив atStart(B) и atEnd(B). Обработчик начала вызывается до обработки любого элемента-члена, а обработчик конца — после обработки всех элементов-членов. Например, обработчик начала можно использовать для добавления дополнительных элементов кода в начало массива кода, а обработчик конца в сочетании с преобразованием с сохранением состояния — для выполнения действий по очистке, таких как определение того, был ли объединен атрибут или следует ли определить новый атрибут. Каждый подтип ClassFileTransform определяет служебный метод endHandler, возвращающий преобразование, у которого есть только обработчик конца.

Преобразования могут иметь состояния, сохраняющиеся при обработке отдельных элементов-членов. Например, если преобразование добавляет аннотацию, оно может отслеживать, встречался ли ему обновленный RuntimeVisibleAnnotationsAttribute и передавался ли он построителю; если еще нет, в обработчике конца оно может передать новый атрибут, содержащий только добавленную аннотацию. Если такое преобразование предназначено для совместного использования или повторного применения, каждое возвращаемое преобразование должно иметь собственное состояние. Каждый подтип ClassFileTransform определяет служебный метод ofStateful, в котором поставщик создает преобразование в исходном состоянии при каждом повторном использовании преобразования.

Преобразования можно объединять с помощью andThen(C). Если это преобразование объединяется с другим, выходные элементы-члены, полученные ClassFileBuilder, становятся входными элементами для следующего преобразования. Композиция позволяет избежать создания промежуточных структур при выполнении нескольких преобразований. Каждый подтип ClassFileTransform реализует andThen(C); обычно пользователям не следует реализовывать этот метод.

Преобразования, работающие с небольшими структурами, можно перенести на содержащие их структуры, чтобы выборочно применять их ко всем вложенным структурам того же типа. Например, CodeTransform можно перенести с помощью ClassTransform.transformingMethodBodies(Predicate, CodeTransform), чтобы преобразовывать тела методов выбранных методов класса, с которым оно работает. Это позволяет пользователям создавать небольшие преобразования и применять их в более широком масштабе.

Помимо ClassFileBuilder.transform(CompoundElement, ClassFileTransform), существуют и другие методы, принимающие преобразование для удобства, например ClassFile.transformClass(ClassModel, ClassTransform), ClassBuilder.transformField(FieldModel, FieldTransform), ClassBuilder.transformMethod(MethodModel, MethodTransform) или MethodBuilder.transformCode(CodeModel, CodeTransform). Это вспомогательные методы, подходящие для большинства сценариев преобразования.