# jetbrains/fernflower architecture

> Architecture diagram of the GitHub repository jetbrains/fernflower, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jetbrains/fernflower
- Repository: https://github.com/jetbrains/fernflower

## Overview

Fernflower is a Java bytecode decompiler used by IntelliJ for class-file navigation and debugging, and as a command-line tool. Its workflow accepts class, archive, or directory inputs, builds class and method structures, analyzes bytecode into control-flow and expression representations, reconstructs Java constructs and names, then emits source through the configured result destination. The graph retains major documented features such as identifier renaming and language-construct reconstruction. Source excerpts support only selected links; documented or unsampled subsystems are shown without speculative internal wiring.

Main entry points: [`src/org/jetbrains/java/decompiler/struct/StructContext.java`](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/struct/StructContext.java) (Class context), [`src/org/jetbrains/java/decompiler/main/ClassesProcessor.java`](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/main/ClassesProcessor.java) (Class processing), [`src/org/jetbrains/java/decompiler/modules/decompiler/stats/Statement.java`](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/modules/decompiler/stats/Statement.java) (Statement tree), [`src/org/jetbrains/java/decompiler/struct/StructMethod.java`](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/struct/StructMethod.java) (Method model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Input and Context"]
  node_cli["CLI adapter"]
  node_api["Decompiler API"]
  node_context[("Class context<br/>[StructContext.java]")]
  node_classfile["Class model<br/>[StructClass.java]"]
  node_methodfile["Method model<br/>[StructMethod.java]"]
  node_constantpool["Constant pool<br/>[ConstantPool.java]"]
  node_contextstate["Decompiler state"]
end

subgraph group_analysis["Bytecode Analysis"]
  node_orchestrator["Class processing"]
  node_instructions["Bytecode instructions<br/>[Instruction.java]"]
  node_cfg["Control-flow graph"]
  node_statements["Statement tree<br/>[Statement.java]"]
  node_expressions["Expression model<br/>[Exprent.java]"]
end

subgraph group_reconstruction["Java Reconstruction"]
  node_exprprocessor["Expression processing<br/>[ExprProcessor.java]"]
  node_variables["Variable recovery<br/>[VarProcessor.java]"]
  node_nested["Nested classes"]
  node_switchpatterns["Switch patterns"]
  node_renaming["Identifier renaming"]
end

subgraph group_output["Source Output"]
  node_classwriter["Java source writer<br/>[ClassWriter.java]"]
  node_saver["Result saver<br/>[IResultSaver.java]"]
  node_javafiles["Java source files"]
end

node_user(("Decompiler user"))

node_user -->|"provides inputs"| node_cli
node_user -.->|"provides inputs"| node_api
node_cli -.->|"loads classes"| node_context
node_api -.->|"loads classes"| node_context
node_context -->|"parses classes"| node_classfile
node_classfile -->|"contains methods"| node_methodfile
node_methodfile -->|"decodes bytecode"| node_constantpool
node_context -->|"configures"| node_contextstate
node_orchestrator -->|"uses class context"| node_context
node_orchestrator -->|"processes nesting"| node_nested
node_methodfile -->|"parses bytecode"| node_instructions
node_instructions -.->|"resolves constants"| node_constantpool
node_instructions -.->|"forms control flow"| node_cfg
node_cfg -.->|"structures statements"| node_statements
node_statements -.->|"holds expressions"| node_expressions
node_orchestrator -.->|"decompiles methods"| node_statements
node_exprprocessor -.->|"renders expressions"| node_expressions
node_variables -->|"recovers variables"| node_expressions
node_switchpatterns -->|"recognizes patterns"| node_statements
node_renaming -.->|"renames identifiers"| node_classfile
node_orchestrator -.->|"emits classes"| node_classwriter
node_classwriter -.->|"writes Java"| node_javafiles
node_saver -.->|"stores output"| node_javafiles

click node_cli "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/main/decompiler/ConsoleDecompiler.java"
click node_api "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/main/decompiler/BaseDecompiler.java"
click node_context "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/struct/StructContext.java"
click node_classfile "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/struct/StructClass.java"
click node_methodfile "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/struct/StructMethod.java"
click node_constantpool "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/struct/consts/ConstantPool.java"
click node_orchestrator "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/main/ClassesProcessor.java"
click node_instructions "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/code/Instruction.java"
click node_cfg "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/code/cfg/ControlFlowGraph.java"
click node_statements "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/modules/decompiler/stats/Statement.java"
click node_expressions "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/modules/decompiler/exps/Exprent.java"
click node_exprprocessor "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/modules/decompiler/ExprProcessor.java"
click node_variables "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/modules/decompiler/vars/VarProcessor.java"
click node_nested "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/main/rels/NestedClassProcessor.java"
click node_switchpatterns "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/modules/decompiler/SwitchPatternHelper.java"
click node_renaming "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/modules/renamer/IdentifierConverter.java"
click node_classwriter "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/main/ClassWriter.java"
click node_saver "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/main/extern/IResultSaver.java"
click node_contextstate "https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/main/DecompilerContext.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_api,node_context,node_classfile,node_methodfile,node_constantpool,node_contextstate,node_user toneBlue
class node_orchestrator,node_instructions,node_cfg,node_statements,node_expressions toneAmber
class node_exprprocessor,node_variables,node_nested,node_switchpatterns,node_renaming toneMint
class node_classwriter,node_saver,node_javafiles toneRose
```

## Components

### Input and Context

- [CLI adapter](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/main/decompiler/ConsoleDecompiler.java): `src/org/jetbrains/java/decompiler/main/decompiler/ConsoleDecompiler.java`
- [Decompiler API](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/main/decompiler/BaseDecompiler.java): `src/org/jetbrains/java/decompiler/main/decompiler/BaseDecompiler.java`
- [Class context](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/struct/StructContext.java): `src/org/jetbrains/java/decompiler/struct/StructContext.java`
- [Class model](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/struct/StructClass.java): `src/org/jetbrains/java/decompiler/struct/StructClass.java`
- [Method model](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/struct/StructMethod.java): `src/org/jetbrains/java/decompiler/struct/StructMethod.java`
- [Constant pool](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/struct/consts/ConstantPool.java): `src/org/jetbrains/java/decompiler/struct/consts/ConstantPool.java`
- [Decompiler state](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/main/DecompilerContext.java): `src/org/jetbrains/java/decompiler/main/DecompilerContext.java`

### Bytecode Analysis

- [Class processing](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/main/ClassesProcessor.java): `src/org/jetbrains/java/decompiler/main/ClassesProcessor.java`
- [Bytecode instructions](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/code/Instruction.java): `src/org/jetbrains/java/decompiler/code/Instruction.java`
- [Control-flow graph](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/code/cfg/ControlFlowGraph.java): `src/org/jetbrains/java/decompiler/code/cfg/ControlFlowGraph.java`
- [Statement tree](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/modules/decompiler/stats/Statement.java): `src/org/jetbrains/java/decompiler/modules/decompiler/stats/Statement.java`
- [Expression model](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/modules/decompiler/exps/Exprent.java): `src/org/jetbrains/java/decompiler/modules/decompiler/exps/Exprent.java`

### Java Reconstruction

- [Expression processing](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/modules/decompiler/ExprProcessor.java): `src/org/jetbrains/java/decompiler/modules/decompiler/ExprProcessor.java`
- [Variable recovery](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/modules/decompiler/vars/VarProcessor.java): `src/org/jetbrains/java/decompiler/modules/decompiler/vars/VarProcessor.java`
- [Nested classes](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/main/rels/NestedClassProcessor.java): `src/org/jetbrains/java/decompiler/main/rels/NestedClassProcessor.java`
- [Switch patterns](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/modules/decompiler/SwitchPatternHelper.java): `src/org/jetbrains/java/decompiler/modules/decompiler/SwitchPatternHelper.java`
- [Identifier renaming](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/modules/renamer/IdentifierConverter.java): `src/org/jetbrains/java/decompiler/modules/renamer/IdentifierConverter.java`

### Source Output

- [Java source writer](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/main/ClassWriter.java): `src/org/jetbrains/java/decompiler/main/ClassWriter.java`
- [Result saver](https://github.com/jetbrains/fernflower/blob/master/src/org/jetbrains/java/decompiler/main/extern/IResultSaver.java): `src/org/jetbrains/java/decompiler/main/extern/IResultSaver.java`
- **Java source files**

### Other components

- **Decompiler user**

## Connections

- Decompiler user → CLI adapter: provides inputs
- Decompiler user → Decompiler API: provides inputs
- CLI adapter → Class context: loads classes
- Decompiler API → Class context: loads classes (evidence: `src/org/jetbrains/java/decompiler/struct/StructContext.java`)
- Class context → Class model: parses classes (evidence: `src/org/jetbrains/java/decompiler/struct/StructContext.java`)
- Class model → Method model: contains methods (evidence: `src/org/jetbrains/java/decompiler/struct/StructClass.java`)
- Method model → Constant pool: decodes bytecode (evidence: `src/org/jetbrains/java/decompiler/struct/StructMethod.java`)
- Class context → Decompiler state: configures (evidence: `src/org/jetbrains/java/decompiler/struct/StructContext.java`)
- Class processing → Class context: uses class context (evidence: `src/org/jetbrains/java/decompiler/main/DecompilerContext.java`)
- Class processing → Nested classes: processes nesting (evidence: `src/org/jetbrains/java/decompiler/main/rels/NestedClassProcessor.java`)
- Method model → Bytecode instructions: parses bytecode (evidence: `src/org/jetbrains/java/decompiler/struct/StructMethod.java`)
- Bytecode instructions → Constant pool: resolves constants (evidence: `src/org/jetbrains/java/decompiler/code/interpreter/InstructionImpact.java`)
- Bytecode instructions → Control-flow graph: forms control flow (evidence: `src/org/jetbrains/java/decompiler/code/cfg/ControlFlowGraph.java`)
- Control-flow graph → Statement tree: structures statements
- Statement tree → Expression model: holds expressions (evidence: `src/org/jetbrains/java/decompiler/modules/decompiler/stats/Statement.java`)
- Class processing → Statement tree: decompiles methods
- Expression processing → Expression model: renders expressions (evidence: `src/org/jetbrains/java/decompiler/modules/decompiler/exps/Exprent.java`)
- Variable recovery → Expression model: recovers variables (evidence: `src/org/jetbrains/java/decompiler/modules/decompiler/exps/Exprent.java`)
- Switch patterns → Statement tree: recognizes patterns (evidence: `src/org/jetbrains/java/decompiler/modules/decompiler/SwitchPatternHelper.java`)
- Identifier renaming → Class model: renames identifiers (evidence: `src/org/jetbrains/java/decompiler/modules/renamer/IdentifierConverter.java`)
- Class processing → Java source writer: emits classes (evidence: `src/org/jetbrains/java/decompiler/main/ClassesProcessor.java`)
- Java source writer → Java source files: writes Java
- Result saver → Java source files: stores output
