Byte Code Engineering Library

Apache Commons BCEL
Developer(s)Apache Software Foundation
Stable release
6.8.1 / January 11, 2024; 24 days ago (2024-01-11)
Repositoryhttps://github.com/apache/commons-bcel
Written inJava
Operating systemCross-platform
TypeBytecode Engineering Library
LicenseApache License 2.0
Websitecommons.apache.org/bcel/

The Byte Code Engineering Library (BCEL) is a project sponsored by the Apache Foundation previously under their Jakarta charter to provide a simple API for decomposing, modifying, and recomposing binary Java classes (I.e. bytecode). The project was conceived and developed by Markus Dahm prior to officially being donated to the Apache Jakarta foundation on 27 October 2001.

Uses

BCEL provides a simple library that exposes the internal aggregate components of a given Java class through its API as object constructs (as opposed to the disassembly of the lower-level opcodes). These objects also expose operations for modifying the binary bytecode, as well as generating new bytecode (via injection of new code into the existing code, or through generation of new classes altogether.) The BCEL library has been used in several diverse applications, such as:

  • Java Bytecode Decompiling, Obfuscation, and Refactoring
  • Performance and Profiling
Instrumentation calls that capture performance metrics can be injected into Java class binaries to examine memory/coverage data. (For example, injecting instrumentation at entry/exit points.)
  • Implementation of New Language Semantics
For example, Aspect-Oriented additions to the Java language have been implemented by using BCEL to decompose class structures for point-cut identification, and then again when reconstituting the class by injecting aspect-related code back into the binary. (See: AspectJ)
FindBugs uses BCEL to analyze Java bytecode for code idioms which indicate bugs.

See also

External links