OpenJDK 27 · jdk.internal.classfile.impl.Util · APIdia, the JavaDoc alternative

Modifier and Type	Class and Description
pack-priv static interface	Util.Writable A generic interface for objects to write to a buf writer.
pack-priv static interface	Util.WritableLocalVariable

Modifier and Type	Field and Description
private static final int	ATTRIBUTE_STABILITY_COUNT
pack-priv static final int	INVERSE_31
pack-priv static final int[]	powers The code below is as if: `int[] powers = new int[7 * SIGNIFICANT_OCTAL_DIGITS]; for (int i = 1, k = 31; i <= 7; i++, k = 31) { int t = powers[powersIndex(i, 0)] = k; for (int j = 1; j < SIGNIFICANT_OCTAL_DIGITS; j++) { t = t; t = t; t = t; powers[powersIndex(i, j)] = t; } }` int[] powers = new int[7 * SIGNIFICANT_OCTAL_DIGITS]; for (int i = 1, k = 31; i <= 7; i++, k = 31) { int t = powers[powersIndex(i, 0)] = k; for (int j = 1; j < SIGNIFICANT_OCTAL_DIGITS; j++) { t = t; t = t; t = t; powers[powersIndex(i, j)] = t; } }
pack-priv static final int	SIGNIFICANT_OCTAL_DIGITS

Access	Constructor and Description
private	Util()

Method Summary

Modifier and Type	Method and Description
public static IllegalArgumentException	badOpcodeKindException(Opcode op, Opcode.Kind k)
public static Consumer<MethodBuilder>	buildingCode(Consumer<? super CodeBuilder> codeHandler)
public static Consumer<FieldBuilder>	buildingFlags(int flags)
public static char	checkFlags(int mask) Ensures the given mask won't be truncated when written as an access flag
public static void	checkKind(Opcode op, Opcode.Kind k)
public static int	checkU1(int incoming, String valueName) Ensures the given value won't be truncated when written as a u1
public static char	checkU2(int incoming, String valueName) Ensures the given value won't be truncated when written as a u2
public static int	descriptorStringHash(int length, int hash) Returns the hash code of a class or interface L descriptor given the internal name.
public static void	dumpBytesHex(Consumer<String> dump, byte[] bytes, int length)
public static void	dumpMethod(SplitConstantPool cp, ClassDesc cls, String methodName, MethodTypeDesc methodDesc, int acc, RawBytecodeHelper.CodeRange bytecode, Consumer<String> dump)
public static List<ClassEntry>	entryList(List<? extends ClassDesc> list)
public static ClassDesc	fieldTypeSymbol(Utf8Entry utf8)
public static int	flagsToBits(AccessFlag.Location location, Collection<AccessFlag> flags)
public static int	flagsToBits(AccessFlag.Location location, AccessFlag... flags)
public static boolean	has(AccessFlag.Location location, int flagsMask, AccessFlag flag)
public static boolean	isAttributeAllowed(final Attribute<?> attr, final ClassFileImpl context)
public static boolean	isDoubleSlot(ClassDesc desc)
public static <T, U> List<U>	mappedList(List<? extends T> list, Function<T, U> mapper)
public static int	maxLocals(int flags, MethodTypeDesc mDesc)
public static MethodTypeDesc	methodTypeSymbol(Utf8Entry utf8)
public static List<ModuleEntry>	moduleEntryList(List<? extends ModuleDesc> list)
public static IllegalArgumentException	outOfRangeException(int value, String fieldName, String typeName)
public static int	parameterSlots(MethodTypeDesc mDesc)
public static int	paramSlotSize(ClassDesc desc)
public static int[]	parseParameterSlots(int flags, MethodTypeDesc mDesc)
public static int	pow31(int k)
private static int	powerOctal(int digit, int index)
pack-priv static int	powersIndex(int digit, int index)
public static List<List<Annotation>>	sanitizeParameterAnnotations(List<List<Annotation>> input) Sanitizes an input nested list of parameter annotations.
public static <T> List<T>	sanitizeU1List(List<T> input) Sanitizes an input list to make it immutable, and verify its size can be represented with U1, throwing IAE otherwise.
public static <T> List<T>	sanitizeU2List(Collection<T> input) Sanitizes an input list to make it immutable, and verify its size can be represented with U2, throwing IAE otherwise.
public static int	slotSize(ClassDesc desc)
public static String	toBinaryName(ClassDesc cd) Converts a descriptor of classes or interfaces into a binary name.
public static ClassDesc	toClassDesc(String classInternalNameOrArrayDesc)
public static String	toInternalName(ClassDesc cd)
public static <T extends Attribute<T>> void	writeAttribute(BufWriterImpl writer, Attribute<?> attr)
public static void	writeAttributes(BufWriterImpl buf, List<? extends Attribute<?>> list)
pack-priv static void	writeList(BufWriterImpl buf, Util.Writable[] array, int size)
public static void	writeListIndices(BufWriter writer, List<? extends PoolEntry> list)
public static boolean	writeLocalVariable(BufWriterImpl buf, PseudoInstruction lvOrLvt)
public static <T> Consumer<Consumer<T>>	writingAll(Iterable<T> container)

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

Field Detail

ATTRIBUTE_STABILITY_COUNT	back to summary
private static final int ATTRIBUTE_STABILITY_COUNT

INVERSE_31	back to summary
pack-priv static final int INVERSE_31

powers back to summary

powers	back to summary
pack-priv static final int[] powers The code below is as if: `int[] powers = new int[7 * SIGNIFICANT_OCTAL_DIGITS]; for (int i = 1, k = 31; i <= 7; i++, k = 31) { int t = powers[powersIndex(i, 0)] = k; for (int j = 1; j < SIGNIFICANT_OCTAL_DIGITS; j++) { t = t; t = t; t = t; powers[powersIndex(i, j)] = t; } }` int[] powers = new int[7 * SIGNIFICANT_OCTAL_DIGITS]; for (int i = 1, k = 31; i <= 7; i++, k = 31) { int t = powers[powersIndex(i, 0)] = k; for (int j = 1; j < SIGNIFICANT_OCTAL_DIGITS; j++) { t = t; t = t; t = t; powers[powersIndex(i, j)] = t; } } This is converted to explicit initialization to avoid bootstrap overhead. Validated in UtilTest. Annotations @Stable

pack-priv static final int[] powers

The code below is as if:

int[] powers = new int[7 * SIGNIFICANT_OCTAL_DIGITS];

for (int i = 1, k = 31; i <= 7; i++, k *= 31) {
   int t = powers[powersIndex(i, 0)] = k;
   for (int j = 1; j < SIGNIFICANT_OCTAL_DIGITS; j++) {
       t *= t;
       t *= t;
       t *= t;
       powers[powersIndex(i, j)] = t;
   }
}

This is converted to explicit initialization to avoid bootstrap overhead. Validated in UtilTest.

Annotations

@Stable

SIGNIFICANT_OCTAL_DIGITS	back to summary
pack-priv static final int SIGNIFICANT_OCTAL_DIGITS

Constructor Detail

Util	back to summary
private Util()

Method Detail

badOpcodeKindException	back to summary
public static IllegalArgumentException badOpcodeKindException(Opcode op, Opcode.Kind k)

buildingCode	back to summary
public static Consumer<MethodBuilder> buildingCode(Consumer<? super CodeBuilder> codeHandler)

buildingFlags	back to summary
public static Consumer<FieldBuilder> buildingFlags(int flags)

checkFlags	back to summary
public static char checkFlags(int mask) Ensures the given mask won't be truncated when written as an access flag

checkKind	back to summary
public static void checkKind(Opcode op, Opcode.Kind k)

checkU1	back to summary
public static int checkU1(int incoming, String valueName) Ensures the given value won't be truncated when written as a u1

checkU2	back to summary
public static char checkU2(int incoming, String valueName) Ensures the given value won't be truncated when written as a u2

descriptorStringHash	back to summary
public static int descriptorStringHash(int length, int hash) Returns the hash code of a class or interface L descriptor given the internal name.

dumpBytesHex	back to summary
public static void dumpBytesHex(Consumer<String> dump, byte[] bytes, int length)

dumpMethod	back to summary
public static void dumpMethod(SplitConstantPool cp, ClassDesc cls, String methodName, MethodTypeDesc methodDesc, int acc, RawBytecodeHelper.CodeRange bytecode, Consumer<String> dump)

entryList	back to summary
public static List<ClassEntry> entryList(List<? extends ClassDesc> list)

fieldTypeSymbol	back to summary
public static ClassDesc fieldTypeSymbol(Utf8Entry utf8)

flagsToBits	back to summary
public static int flagsToBits(AccessFlag.Location location, Collection<AccessFlag> flags)

flagsToBits	back to summary
public static int flagsToBits(AccessFlag.Location location, AccessFlag... flags)

has	back to summary
public static boolean has(AccessFlag.Location location, int flagsMask, AccessFlag flag)

isAttributeAllowed	back to summary
public static boolean isAttributeAllowed(final Attribute<?> attr, final ClassFileImpl context)

isDoubleSlot	back to summary
public static boolean isDoubleSlot(ClassDesc desc)

mappedList	back to summary
public static <T, U> List<U> mappedList(List<? extends T> list, Function<T, U> mapper)

maxLocals	back to summary
public static int maxLocals(int flags, MethodTypeDesc mDesc)

methodTypeSymbol	back to summary
public static MethodTypeDesc methodTypeSymbol(Utf8Entry utf8)

moduleEntryList	back to summary
public static List<ModuleEntry> moduleEntryList(List<? extends ModuleDesc> list)

outOfRangeException	back to summary
public static IllegalArgumentException outOfRangeException(int value, String fieldName, String typeName)

parameterSlots	back to summary
public static int parameterSlots(MethodTypeDesc mDesc)

paramSlotSize	back to summary
public static int paramSlotSize(ClassDesc desc)

parseParameterSlots	back to summary
public static int[] parseParameterSlots(int flags, MethodTypeDesc mDesc)

pow31	back to summary
public static int pow31(int k)

powerOctal	back to summary
private static int powerOctal(int digit, int index)

powersIndex	back to summary
pack-priv static int powersIndex(int digit, int index)

sanitizeParameterAnnotations	back to summary
public static List<List<Annotation>> sanitizeParameterAnnotations(List<List<Annotation>> input) Sanitizes an input nested list of parameter annotations.

sanitizeU1List	back to summary
public static <T> List<T> sanitizeU1List(List<T> input) Sanitizes an input list to make it immutable, and verify its size can be represented with U1, throwing IAE otherwise.

sanitizeU2List	back to summary
public static <T> List<T> sanitizeU2List(Collection<T> input) Sanitizes an input list to make it immutable, and verify its size can be represented with U2, throwing IAE otherwise.

slotSize	back to summary
public static int slotSize(ClassDesc desc)

toBinaryName	back to summary
public static String toBinaryName(ClassDesc cd) Converts a descriptor of classes or interfaces into a binary name. Rejects primitive types or arrays. This is an inverse of `ClassDesc#of(String)`.

toClassDesc	back to summary
public static ClassDesc toClassDesc(String classInternalNameOrArrayDesc)

toInternalName	back to summary
public static String toInternalName(ClassDesc cd)

writeAttribute	back to summary
public static <T extends Attribute<T>> void writeAttribute(BufWriterImpl writer, Attribute<?> attr) Annotations @SuppressWarnings:unchecked

writeAttributes	back to summary
public static void writeAttributes(BufWriterImpl buf, List<? extends Attribute<?>> list) Annotations @ForceInline

writeList	back to summary
pack-priv static void writeList(BufWriterImpl buf, Util.Writable[] array, int size) Annotations @ForceInline

writeListIndices	back to summary
public static void writeListIndices(BufWriter writer, List<? extends PoolEntry> list)

writeLocalVariable	back to summary
public static boolean writeLocalVariable(BufWriterImpl buf, PseudoInstruction lvOrLvt)

writingAll	back to summary
public static <T> Consumer<Consumer<T>> writingAll(Iterable<T> container)

public final Class Util

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv Interface Util.Writable

Method Summary

Method Detail

pack-priv Interface Util.WritableLocalVariable

Method Summary

Method Detail