Package org.objectweb.asm.tools

Class Retrofitter

java.lang.Object

org.objectweb.asm.tools.Retrofitter

public class Retrofitter
extends Object

A tool to transform classes in order to make them compatible with Java 1.5, and to check that they use only the JDK 1.5 API and JDK 1.5 class file features. The original classes can either be transformed "in place", or be copied first to destination directory and transformed here (leaving the original classes unchanged).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) class	Retrofitter.ClassRetrofitter	A ClassVisitor that retrofits classes to 1.5 version.
(package private) class	Retrofitter.ClassVerifier	A ClassVisitor checking that a class uses only JDK 1.5 class file features and the JDK 1.5 API.

Field Summary

Fields

Modifier and Type	Field	Description
private final HashSet<String>	exports	The internal names of the packages exported by the retrofitted classes.
private final HashSet<String>	imports	The internal names of the packages imported by the retrofitted classes.
private static final String	JAVA_BASE_MODULE	The name of the java.base module.
private final HashSet<String>	jdkApi	The fields and methods of the JDK 1.5 API.
private final HashMap<String,String>	jdkHierarchy	The class hierarchy of the JDK 1.5 API.
private static final String	MODULE_INFO	The name of the module-info file.

Constructor Summary

Constructors

Constructor	Description
Retrofitter()

Method Summary

Modifier and Type	Method	Description
private void	generateModuleInfoClass(File dstDir, String version)
private List<File>	getAllClasses(File file, List<File> allClasses)
private static boolean	isAsmModule(String packageName)
static void	main(String[] args)	Transforms the class files in the given directory, in place, in order to make them compatible with the JDK 1.5.
private void	readJdkApi()
void	retrofit(File classesDir, String version)	Transforms the class files in the given directory, in place, in order to make them compatible with the JDK 1.5.
void	verify(File classesDir, String expectedVersion, List<String> expectedExports, List<String> expectedRequires)	Verify that the class files in the given directory only use JDK 1.5 APIs, and that a module-info class is present with the expected content.
private void	verifyModuleInfoClass(File dstDir, String expectedVersion, Set<String> expectedExports, Set<String> expectedRequires)

Methods inherited from class java.lang.Object

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

Field Details

MODULE_INFO

private static final String MODULE_INFO

The name of the module-info file.

See Also:

• Constant Field Values

JAVA_BASE_MODULE

private static final String JAVA_BASE_MODULE

The name of the java.base module.

See Also:

• Constant Field Values

jdkApi

private final HashSet<String> jdkApi

The fields and methods of the JDK 1.5 API. Each string has the form "<owner><name><descriptor>".

jdkHierarchy

private final HashMap<String,String> jdkHierarchy

The class hierarchy of the JDK 1.5 API. Maps each class name to the name of its super class.

exports

private final HashSet<String> exports

The internal names of the packages exported by the retrofitted classes.

imports

private final HashSet<String> imports

The internal names of the packages imported by the retrofitted classes.

Constructor Details

Retrofitter

public Retrofitter()

Method Details

main

public static void main(String[] args)
                 throws IOException

Transforms the class files in the given directory, in place, in order to make them compatible with the JDK 1.5. Also generates a module-info class in this directory, with the given module version.

Parameters:

args - a directory containing compiled classes and the ASM release version.

Throws:

IOException - if a file can't be read or written.

retrofit

public void retrofit(File classesDir,
 String version)
              throws IOException

Transforms the class files in the given directory, in place, in order to make them compatible with the JDK 1.5. Also generates a module-info class in this directory, with the given module version.

Parameters:

classesDir - a directory containing compiled classes.

version - the module-info version.

Throws:

IOException - if a file can't be read or written.

verify

public void verify(File classesDir,
 String expectedVersion,
 List<String> expectedExports,
 List<String> expectedRequires)
            throws IOException

Verify that the class files in the given directory only use JDK 1.5 APIs, and that a module-info class is present with the expected content.

Parameters:

classesDir - a directory containing compiled classes.

expectedVersion - the expected module-info version.

expectedExports - the expected module-info exported packages.

expectedRequires - the expected module-info required modules.

Throws:

IOException - if a file can't be read.

IllegalArgumentException - if the module-info class does not have the expected content.

getAllClasses

private List<File> getAllClasses(File file,
 List<File> allClasses)
                          throws IOException

Throws:

IOException

generateModuleInfoClass

private void generateModuleInfoClass(File dstDir,
 String version)
                              throws IOException

Throws:

IOException

verifyModuleInfoClass

private void verifyModuleInfoClass(File dstDir,
 String expectedVersion,
 Set<String> expectedExports,
 Set<String> expectedRequires)
                            throws IOException

Throws:

IOException

isAsmModule

private static boolean isAsmModule(String packageName)

readJdkApi

private void readJdkApi()
                 throws IOException

Throws:

IOException