Package org.eolang.jeo.representation.bytecode

Class BytecodeClass

java.lang.Object

org.eolang.jeo.representation.bytecode.BytecodeClass

All Implemented Interfaces:

Testable

public final class BytecodeClass
extends Object
implements Testable

Class useful for generating bytecode for testing purposes.

Since:

0.1.0

Constructor Summary

Constructors

Constructor	Description
BytecodeClass()	Constructor.
BytecodeClass(String name)	Constructor.
BytecodeClass(String name, int access)	Constructor.
BytecodeClass(String name, BytecodeClassProperties properties)	Constructor.
BytecodeClass(String name, BytecodeClassProperties properties, boolean verify)	Constructor.
BytecodeClass(String name, CustomClassWriter writer, Collection<BytecodeMethod> methods, BytecodeClassProperties properties)	Constructor.

Method Summary

Modifier and Type	Method	Description
Bytecode	bytecode()	Generate bytecode.
BytecodeClass	helloWorldMethod()	Hello world bytecode.
String	testCode()	Generate test Java code.
BytecodeClass	withAnnotations(XmlAnnotations all)	Add anns.
BytecodeMethod	withConstructor(int... modifiers)	Add constructor.
BytecodeMethod	withConstructor(String descriptor, int... modifiers)	Add constructor.
BytecodeClass	withField(String fname)	Add field.
BytecodeField	withField(String fname, String descriptor, String signature, Object value, int... modifiers)	Add field.
BytecodeMethod	withMethod(String mname, String descriptor, int... modifiers)	Add method.
BytecodeMethod	withMethod(BytecodeMethodProperties properties)	Add method.
BytecodeMethod	withMethod(BytecodeMethodProperties properties, int stack, int locals)	Add method.
com.jcabi.xml.XML	xml()	Converts bytecode into XML.

Methods inherited from class java.lang.Object

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

Constructor Detail

BytecodeClass

public BytecodeClass()

Constructor. Used in tests only.

BytecodeClass

public BytecodeClass(String name)

Constructor. Used in tests only.

Parameters:

name - Class name.

BytecodeClass

public BytecodeClass(String name,
                     int access)

Constructor. Used in tests only.

Parameters:

name - Class name.

access - Access modifiers.

BytecodeClass

public BytecodeClass(String name,
                     BytecodeClassProperties properties)

Constructor. Used in tests only.

Parameters:

name - Class name.

properties - Class properties.

BytecodeClass

public BytecodeClass(String name,
                     BytecodeClassProperties properties,
                     boolean verify)

Constructor. Has real usages.

Parameters:

name - Class name.

properties - Class properties.

verify - Verify bytecode.

BytecodeClass

public BytecodeClass(String name,
                     CustomClassWriter writer,
                     Collection<BytecodeMethod> methods,
                     BytecodeClassProperties properties)

Constructor.

Parameters:

name - Class name.

writer - ASM class writer.

methods - Methods.

properties - Class properties.

Method Detail

xml

public com.jcabi.xml.XML xml()

Converts bytecode into XML.

Returns:

XML representation of bytecode.

bytecode

public Bytecode bytecode()

Generate bytecode.

In this method we intentionally use the Thread.currentThread().getContextClassLoader() for the class loader of the CheckClassAdapter.verify(ClassReader, ClassLoader, boolean, PrintWriter) instead of default implementation. This is because the default class loader doesn't know about classes compiled on the previous maven step. You can read more about the problem here: PluginStartup.init() ()}

Returns:

Bytecode.

withConstructor

public BytecodeMethod withConstructor(int... modifiers)

Add constructor.

Parameters:

modifiers - Constructor modifiers.

Returns:

This object.

withMethod

public BytecodeMethod withMethod(BytecodeMethodProperties properties)

Add method.

Parameters:

properties - Method properties.

Returns:

This object.

withMethod

public BytecodeMethod withMethod(BytecodeMethodProperties properties,
                                 int stack,
                                 int locals)

Add method.

Parameters:

properties - Method properties.

stack - Stack size.

locals - Local variables size.

Returns:

This object.

withConstructor

public BytecodeMethod withConstructor(String descriptor,
                                      int... modifiers)

Add constructor.

Parameters:

descriptor - Constructor descriptor.

modifiers - Constructor modifiers.

Returns:

This object.

withMethod

public BytecodeMethod withMethod(String mname,
                                 String descriptor,
                                 int... modifiers)

Add method.

Parameters:

mname - Method name.

descriptor - Method descriptor.

modifiers - Access modifiers.

Returns:

This object.

withField

public BytecodeClass withField(String fname)

Add field.

Parameters:

fname - Field name.

Returns:

This object.

withField

public BytecodeField withField(String fname,
                               String descriptor,
                               String signature,
                               Object value,
                               int... modifiers)

Add field.

Parameters:

fname - Field name.

descriptor - Field descriptor.

signature - Field signature.

value - Field value.

modifiers - Access modifiers.

Returns:

This object.

withAnnotations

public BytecodeClass withAnnotations(XmlAnnotations all)

Add anns.

Parameters:

all - Annotations.

Returns:

This object.

testCode

public String testCode()

Description copied from interface: Testable

Generate test Java code.

Specified by:

testCode in interface Testable

Returns:

Java code.

helloWorldMethod

public BytecodeClass helloWorldMethod()

Hello world bytecode.

Returns:

The same class with the hello world method.