Module org.glavo.classfile
Package org.glavo.classfile

Interface Classfile.Option

All Known Implementing Classes:
Options.OptionValue
Enclosing class:
Classfile
public static sealed interface Classfile.Option permits Options.OptionValue
An option that affects the writing of classfiles.

  • Method Details

    • generateStackmap

      static Classfile.Option generateStackmap(boolean b)
      Returns an option describing whether or not to generate stackmaps. Default is to generate stack maps.
      Parameters:
      b - whether to generate stack maps
      Returns:
      an option describing whether or not to generate stackmaps

    • processDebug

      static Classfile.Option processDebug(boolean b)
      Returns an option describing whether to process or discard debug elements. Debug elements include the local variable table, local variable type table, and character range table. Discarding debug elements may reduce the overhead of parsing or transforming classfiles. Default is to process debug elements.
      Parameters:
      b - whether or not to process debug elements
      Returns:
      an option describing whether to process or discard debug elements

    • processLineNumbers

      static Classfile.Option processLineNumbers(boolean b)
      Returns an option describing whether to process or discard line numbers. Discarding line numbers may reduce the overhead of parsing or transforming classfiles. Default is to process line numbers.
      Parameters:
      b - whether or not to process line numbers
      Returns:
      an option describing whether to process or discard line numbers

    • processUnknownAttributes

      static Classfile.Option processUnknownAttributes(boolean b)
      Returns an option describing whether to process or discard unrecognized attributes. Default is to process unrecognized attributes, and deliver as instances of UnknownAttribute.
      Parameters:
      b - whether or not to process unrecognized attributes
      Returns:
      an option describing whether to process or discard unrecognized attributes

    • constantPoolSharing

      static Classfile.Option constantPoolSharing(boolean b)
      Returns an option describing whether to preserve the original constant pool when transforming a classfile. Reusing the constant pool enables significant optimizations in processing time and minimizes differences between the original and transformed classfile, but may result in a bigger classfile when a classfile is significantly transformed. Default is to preserve the original constant pool.
      Parameters:
      b - whether or not to preserve the original constant pool
      Returns:
      an option describing whether to preserve the original constant pool when transforming a classfile

    • fixShortJumps

      static Classfile.Option fixShortJumps(boolean b)
      Returns an option describing whether or not to automatically rewrite short jumps to long when necessary. Default is to automatically rewrite jump instructions.
      Parameters:
      b - whether or not to automatically rewrite short jumps to long when necessary
      Returns:
      an option describing whether or not to automatically rewrite short jumps to long when necessary

    • patchDeadCode

      static Classfile.Option patchDeadCode(boolean b)
      Returns an option describing whether or not to patch out unreachable code. Default is to automatically patch out unreachable code with NOPs.
      Parameters:
      b - whether or not to automatically patch out unreachable code
      Returns:
      an option describing whether or not to patch out unreachable code

    • classHierarchyResolver

      static Classfile.Option classHierarchyResolver(ClassHierarchyResolver r)
      Returns an option describing the class hierarchy resolver to use when generating stack maps.
      Parameters:
      r - the resolver
      Returns:
      an option describing the class hierarchy resolver to use when generating stack maps

    • attributeMapper

      static Classfile.Option attributeMapper(Function<Utf8Entry,AttributeMapper<?>> r)
      Returns an option describing attribute mappers for custom attributes. Default is only to process standard attributes.
      Parameters:
      r - a function mapping attribute names to attribute mappers
      Returns:
      an option describing attribute mappers for custom attributes

    • filterDeadLabels

      static Classfile.Option filterDeadLabels(boolean b)
      Returns an option describing whether or not to filter unresolved labels. Default is to throw IllegalStateException when any ExceptionCatch, LocalVariableInfo, LocalVariableTypeInfo, or CharacterRangeInfo reference to unresolved Label during bytecode serialization. Setting this option to true filters the above elements instead.
      Parameters:
      b - whether or not to automatically patch out unreachable code
      Returns:
      an option describing whether or not to filter unresolved labels