Reads the annotations of a annotations attributes.

From the Specification

annotation {
     u2 type_index;
     u2 num_element_value_pairs;
     {   u2 element_name_index;
         element_value value;
     }   element_value_pairs[num_element_value_pairs]
}

Factory method to create the ClassFile object that represents the class file as a whole, plus any ClassFiles that have been synthesized in the process of parsing it.

The result will always contain at least one ClassFile object, namely the one that is created from this method's parameters. Regardless of how many ClassFiles the result contains, the ClassFile created from this method's parameters will always be the result's first element.

Reads in a single class file from a Jar file.

Reads in a single class file from a Jar file.

Reads in a class file.

Template method that reads a Java class file from the given input stream.

All other methods to read a class file use this method to eventually parse a class file.

Class File Structure

Parses a class file according to the specification:

ClassFile {
   u4 magic;
   u2 minor_version;
   u2 major_version;
   u2 constant_pool_count;
   cp_info constant_pool[constant_pool_count-1];
   u2 access_flags;
   u2 this_class;
   u2 super_class;
   u2 interfaces_count;
   u2 interfaces[interfaces_count];
   u2 fields_count;
   field_info fields[fields_count];
   u2 methods_count;
   method_info methods[methods_count];
   u2 attributes_count;
   attribute_info attributes[attributes_count];
}

Loads class files from the given file location.

• If the file denotes a single ".class" file this class file is loaded.
• If the file object denotes a ".jar|.war|.ear|.zip" file, all class files in the jar file will be loaded.
• If the file object specifies a directory object, all ".class" files in the directory and in all subdirectories are loaded as well as all class files stored in ".jar" files in one of the directories. This class loads all class files in parallel. However, this does not effect analyses working on the resulting List.

Reads in parallel all class files stored in the given jar file. For each successfully read class file the function classFileHandler is called.

Reads the class files from the given JarInputStream

Reads in parallel all class files stored in the given jar/zip file.

Parses an element value.

From the Specification

element_value {
   u1 tag;
   union {
     u2   const_value_index;

     {
       u2 type_name_index;
       u2 const_name_index;
     } enum_const_value;

     u2 class_info_index;

     annotation annotation_value;

     {
       u2    num_values;
       element_value values[num_values];
     } array_value;
   } value;
}

Returns the class files of the current Java Runtime Image grouped by module.

Factory method to create a LocalvarTableEntry. To completely resolve such entries; i.e., to resolve the local_variable_table_index it may be necessary to do some post-processing after all attributes belonging to a code block are loaded. This can be done using the method org.opalj.bi.reader.AttributeReader.registerAttributesPostProcessor.

Factory method to create a representation of a RuntimeInvisibleParameterAnnotations_attribute.

Creates a Signature_attribute.

From the Specification

The constant pool entry at signature_index must be a CONSTANT_Utf8_info structure representing either a class signature, if this signature attribute is an attribute of a ClassFile structure, a method type signature, if this signature is an attribute of a method_info structure, or a field type signature otherwise.

The type_path_kind was 0 (and the type_argument_index was also 0).

The type_path_kind was 1 (and the type_argument_index was (as defined by the specification) also 0).

The path's length was 0.

The type_path_kind was 2 (and the type_argument_index was (as defined by the specification) also 0).

u1 target_type;
union {
 type_parameter_target;
 supertype_target;
 type_parameter_bound_target;
 empty_target;
 method_formal_parameter_target;
 throws_target;
 localvar_target;
 catch_target;
 offset_target;
 type_argument_target;
 } target_info;

Reads a Runtime(In)VisibleTypeAnnotations attribute.

type_annotation {
           u1 target_type;
           union {
               type_parameter_target;
               supertype_target;
               type_parameter_bound_target;
               empty_target;
               method_formal_parameter_target;
               throws_target;
               localvar_target;
               catch_target;
               offset_target;
               type_argument_target;
           } target_info;
           type_path target_path;
           u2        type_index;
           u2        num_element_value_pairs;
           { u2              element_name_index;
             element_value   value;
           } element_value_pairs[num_element_value_pairs];
}

This method is called/needs to be called after the class file was completely loaded to perform class file specific transformations.

The Config object that will be used to read the configuration settings for reading in class files.

Creates a storage area for functions that will be called after the class file was completely loaded. This makes it possible to register functions that are newly created for a special class file object to perform actions related to that specific class file object. For further information study the resolving process of invokedynamic instructions.

This property determines whether artificial SynthesizedClassFiles attributes are kept or removed.

Tests if the class file has a SynthesizedClassFiles attribute and – if so – extracts the class file and removes the attribute.

Searches for the first class file that is accepted by the filter. If no class file can be found that is accepted by the filter the set of all class names is returned.

If true method bodies are never loaded.

The org.opalj.log.LogContext that should be used to log rewritings.

Goes over all files in parallel and calls back the given function which has to be thread-safe!

See AttributeReader.registerAttributeReader for details.

Registers a new processor for the list of all attributes of a given class file element (class, field, method, code). This can be used to post-process attributes. E.g., to merge multiple line number tables if they exist or to link attributes that have strong dependencies. E.g., (in Java 8) the localvar_target structure of the Runtime(In)VisibleTypeAnnotations attribute has a reference in the local variable table attribute.

Register a class file post processor. A class file post processor can transform the completely read and reified class file. Post processors can only be registered before the usage of a class file reader. Registering new ClassFilePostProcessors while processing class files is not supported and the behavior is undefined.

Controls whether empty attributes (e.g., a LocalVariableTypeTable with no entries) should be reified or should be dropped.

Removes all BootstrapMethodTable attributes because the invokedynamic instructions are either completely resolved by creating code that resembles the code executed by the JVM or the instructions are at least enhanced and have explicit references to the bootstrap methods.

Returns true if an exception is to be raised if an invalid signature is found. The default is to just log the invalid signature and to otherwise ignore it.

This method is intended to be overridden.