org.jenkinsci.bytecode

Class Transformer

java.lang.Object

org.jenkinsci.bytecode.Transformer

public class Transformer
extends Object

Transform byte code where code references bytecode rewrite annotations.

Author:

Kohsuke Kawaguchi

Constructor Summary

Constructors

Constructor and Description
Transformer()

Method Summary

Modifier and Type	Method and Description
void	loadRules(ClassLoader cl)
void	loadRules(Collection<? extends ClassLoader> loaders) Scans the rewrite instructions and prepare to rewrite classes that refer to them accordingly.
byte[]	transform(String className, byte[] image) Deprecated. - see transform(String, byte[], ClassLoader)
byte[]	transform(String className, byte[] image, ClassLoader classLoader) Transforms a class file.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Transformer

public Transformer()

Method Detail

loadRules

public void loadRules(ClassLoader cl)
               throws IOException

Throws:

IOException

loadRules

public void loadRules(Collection<? extends ClassLoader> loaders)
               throws IOException

Scans the rewrite instructions and prepare to rewrite classes that refer to them accordingly.

The effects of this method is cumulative. The added rules are stored on top of what's already in this transformer. This method is concurrency safe, and can be invoked even when Transformer is already being in use.

Throws:

IOException

transform

@Deprecated
public byte[] transform(String className,
                                    byte[] image)

Deprecated. - see transform(String, byte[], ClassLoader)

Transforms a class file.

Parameters:

className - Binary name of the class, such as "java.security.KeyStore$Builder$FileBuilder$1"

image - Class file image loaded from the disk.

Returns:

Transformed byte code.

transform

public byte[] transform(String className,
                        byte[] image,
                        ClassLoader classLoader)

Transforms a class file.

Parameters:

className - Binary name of the class, such as "java.security.KeyStore$Builder$FileBuilder$1"

image - Class file image loaded from the disk.

classLoader - The classloader to use when searching for a common parent of 2 classes (used for generating certain StackFrames)

Returns:

Transformed byte code.