APIdia Launch Partner

Top Description Fields Constructors Methods

jdk.internal.util

public final Class ClassFileDumper

Class Inheritance

extends Object

java.lang.Object
jdk.internal.util.ClassFileDumper

Imports

jdk.internal.misc.VM, java.io.IOException, java.nio.file.Files, .Path, java.util.HexFormat, .Objects, .Set, java.util.concurrent.ConcurrentHashMap, java.util.concurrent.atomic.AtomicInteger

ClassFile dumper utility class to log normal and hidden classes.

Implementation Note

Because this class is called by MethodHandleStatics, LambdaForms generation and LambdaMetafactory, make use of lambda lead to recursive calls cause stack overflow.

Field Summary

Modifier and Type	Field and Description
private static final Set<Character>	BAD_CHARS
private final AtomicInteger	counter
private final String	dumpDir
private static final ConcurrentHashMap<String, ClassFileDumper>	DUMPER_MAP
private final boolean	enabled
private static final HexFormat	HEX
private final String	key

Constructor Summary

Access	Constructor and Description
private	ClassFileDumper(String key, String path)

Method Summary

Modifier and Type	Method and Description
public void	dumpClass(String name, Class<?> c, byte[] bytes) This method determines the path name from the given name and `Class` object.
public void	dumpFailedClass(String name, byte[] bytes) This method dumps the given bytes at a path of the given name with a suffix ".failed-$COUNTER" where $COUNTER will be incremented for each time this method is called.
private static String	encodeForFilename(String className)
public static ClassFileDumper	getInstance(String key, String path) Returns a ClassFileDumper instance for the given key with a given dump path.
public boolean	isEnabled()
public String	key()
private Path	pathname(String name)
private static Path	validateDumpDir(String dir)
private void	write(Path path, byte[] bytes)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

BAD_CHARS	back to summary
private static final Set<Character> BAD_CHARS

counter	back to summary
private final AtomicInteger counter

dumpDir	back to summary
private final String dumpDir

DUMPER_MAP	back to summary
private static final ConcurrentHashMap<String, ClassFileDumper> DUMPER_MAP

enabled	back to summary
private final boolean enabled

HEX	back to summary
private static final HexFormat HEX

key	back to summary
private final String key

Constructor Detail

ClassFileDumper	back to summary
private ClassFileDumper(String key, String path)

Method Detail

dumpClass	back to summary
public void dumpClass(String name, Class<?> c, byte[] bytes) This method determines the path name from the given name and `Class` object. If it is a hidden class, it will dump the given bytes at a path of the given name with a suffix "." concatenated with the suffix of the hidden class name.

dumpFailedClass	back to summary
public void dumpFailedClass(String name, byte[] bytes) This method dumps the given bytes at a path of the given name with a suffix ".failed-$COUNTER" where $COUNTER will be incremented for each time this method is called.

encodeForFilename	back to summary
private static String encodeForFilename(String className)

getInstance	back to summary
public static ClassFileDumper getInstance(String key, String path) Returns a ClassFileDumper instance for the given key with a given dump path. To enable dumping of the generated classes -D or -D=true The system property is read only once when it is the first time the dumper instance for the given key is created.

isEnabled	back to summary
public boolean isEnabled()

key	back to summary
public String key()

pathname	back to summary
private Path pathname(String name)

validateDumpDir	back to summary
private static Path validateDumpDir(String dir)

write	back to summary
private void write(Path path, byte[] bytes)