compact3

java.lang.instrument

Интерфейс ClassFileTransformer

Функциональный Интерфейс:

Это - функциональный интерфейс и может поэтому использоваться в качестве цели присвоения для ссылки метода или лямбда-выражения.

public interface ClassFileTransformer

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

Отметьте термин, файл class используется как определено в разделе 3.1 из Спецификации Виртуальной машины Java™, чтобы означать последовательность байтов в формате файла class, находятся ли они в файле.

С тех пор:

1.5

См. Также:

Instrumentation, Instrumentation.addTransformer(java.lang.instrument.ClassFileTransformer, boolean), Instrumentation.removeTransformer(java.lang.instrument.ClassFileTransformer)

Сводка метода

Модификатор и Тип	Метод и Описание
byte[]	transform(ClassLoader loader, String className, Class<?> classBeingRedefined, ProtectionDomain protectionDomain, byte[] classfileBuffer) Реализация этого метода может преобразовать предоставленный файл class и возвратить новую замену файл class.

Деталь метода

преобразовать

byte[] transform(ClassLoader loader,
                 String className,
                 Class<?> classBeingRedefined,
                 ProtectionDomain protectionDomain,
                 byte[] classfileBuffer)
          throws IllegalClassFormatException

Реализация этого метода может преобразовать предоставленный файл class и возвратить новую замену файл class.

Есть два вида преобразователей, определенных canRetransform параметр Instrumentation.addTransformer(ClassFileTransformer,boolean):

• способные преобразователи перепреобразования, которые были добавлены с canRetransform как истина
• неспособные преобразователи перепреобразования, которые были добавлены с canRetransform как ложь или где добавлено с Instrumentation.addTransformer(ClassFileTransformer)

Как только преобразователь был зарегистрирован в addTransformer, преобразователь вызовут для каждого нового определения class и каждого переопределения class. Перепреобразование способные преобразователи также вызовут на каждом перепреобразовании class. С просьбой на новое определение class обращаются ClassLoader.defineClass или его собственные эквиваленты. С просьбой на переопределение class обращаются Instrumentation.redefineClasses или его собственные эквиваленты. С просьбой на перепреобразование class обращаются Instrumentation.retransformClasses или его собственные эквиваленты. Преобразователь вызывают во время обработки запроса, прежде, чем байты файла class были проверены или применены. Когда есть многократные преобразователи, преобразования составляются, объединяя в цепочку transform вызовы. Таким образом, байтовый массив возвратился одним звонком transform становится вводом (через classfileBuffer параметр) к следующему вызову.

Преобразования применяются в следующем порядке:

• Перепреобразование неспособные преобразователи
• Перепреобразование неспособные собственные преобразователи
• Перепреобразование способные преобразователи
• Перепреобразование способные собственные преобразователи

Для перепреобразований перепреобразования неспособные преобразователи не вызывают, вместо этого результат предыдущего преобразования снова используется. Во всех других случаях вызывают этот метод. В пределах каждой из этих группировок преобразователи вызывают в зарегистрированном порядке. Собственные преобразователи обеспечиваются ClassFileLoadHook событие в Интерфейсе Инструмента виртуальной машины Java).

Ввод (через classfileBuffer параметр) к первому преобразователю:

• для нового определения class, байты, к которым передают ClassLoader.defineClass
• для переопределения class, definitions.getDefinitionClassFile() где definitions параметр к Instrumentation.redefineClasses
• для перепреобразования class, байты, которые передают к новому определению class или, если пересмотрено, последнему переопределению, со всеми преобразованиями, сделанными перепреобразованием, неспособные преобразователи повторно применялись автоматически и неизменный; поскольку детали видят Instrumentation.retransformClasses

Если метод реализации решает, что никакие преобразования не необходимы, он должен возвратиться null. Иначе, это должно создать новое byte[] массив, скопируйте ввод classfileBuffer в это, наряду со всеми требуемыми преобразованиями, и возвратом новый массив. Ввод classfileBuffer не должен быть изменен.

В перепреобразовании и пересматривают случаи, преобразователь должен поддерживать семантику переопределения: если class, что преобразователь, измененный во время начального определения, позже повторно преобразовывается или пересматривается, преобразователь, должен обеспечить, чтобы второй вывод class файл class был юридическим переопределением первого вывода файл class.

Если преобразователь выдаст исключение (который он не ловит), то последующие преобразователи все еще вызовут и загрузка, пересмотрят, или перепреобразование будет все еще предпринято. Таким образом выдача исключения имеет тот же самый эффект как возврат null. Чтобы предотвратить неожиданное поведение, когда исключения непроверенные сгенерированы в коде преобразователя, преобразователь может поймать Throwable. Если преобразователь верит classFileBuffer не представляет законно отформатированный файл class, он должен бросить IllegalClassFormatException; в то время как это имеет тот же самый эффект как возврат нуля. это облегчает журналирование или отладку повреждений формата.

Параметры:

loader - загрузчик определения class, который будет преобразован, может быть null если программа начальной загрузки

className - имя class во внутренней форме полностью определенного class и интерфейса называет как определено в Спецификации виртуальной машины Java. Например, "java/util/List".

classBeingRedefined - если это инициировано пересматриванием, или повторно преобразуйте, class, пересматриваемый или повторно преобразованный; если это - загрузка class, null

protectionDomain - домен защиты class, определяемого или пересмотренного

classfileBuffer - входной буфер байта в формате файла class - не должен быть изменен

Возвраты:

правильно построенный буфер файла class (результат преобразования), или null если никакие не преобразовывают, выполняется.

Броски:

IllegalClassFormatException - если ввод не представляет правильно построенный файл class

См. Также:

Instrumentation.redefineClasses(java.lang.instrument.ClassDefinition...)