# reactor/reactor-core architecture

> Architecture diagram of the GitHub repository reactor/reactor-core, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/reactor/reactor-core
- Repository: https://github.com/reactor/reactor-core

## Overview

##### Main Components Identification
The system should be divided into these key components:

a. Core Publishers
- Flux (multi-element stream)
- Mono (0-1 element stream)
- ParallelFlux (parallel processing stream)

b. Scheduler System
- Various scheduler implementations
- Thread management components
- Execution context handlers

c. Operators Layer
- Stream transformation operators
- Error handling operators
- Flow control operators

d. Infrastructure Components
- Context propagation system
- Backpressure management
- Queue implementations
- Metrics & monitoring

##### Relationships and Interactions

**[Publisher Sources] → [Operators Chain] → [Subscribers]**
- ↑                  ↕                ↓
- [Scheduler System]───────────┘
- ↕
- [Infrastructure Layer]

##### Detailed Component Breakdown

Publishers Section:
**┌─ Publishers ─────────┐**
- Flux              │
- Mono              │
- ParallelFlux      │
- ConnectableFlux   │
- ┘

Operators Section:
**┌─ Operators ──────────────┐**
- Transformation         │
- Combination           │
- Filtering             │
- Error Handling        │
- Backpressure Control  │
- ┘

##### Features

- Operator fusion optimization paths
- Context propagation channels
- Error recovery paths
- Subscription lifecycle
- Resource cleanup flows

##### Documentation Elements

Annotations:
- Thread boundary crossings
- Backpressure control points
- Fusion optimization opportunities
- Hot vs cold publisher distinctions

##### Implementation Notes

- Non-blocking nature of operations
- Reactive Streams specification compliance
- Integration points with other systems
- Extension and customization points

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Publishers
        Flux["Flux"]:::publisher
        Mono["Mono"]:::publisher
        ParallelFlux["ParallelFlux"]:::publisher
        ConnectableFlux["ConnectableFlux"]:::publisher
    end

    subgraph Operators
        BaseOps["Base Operators"]:::operator
        TransformOps["Transformation"]:::operator
        CombineOps["Combination"]:::operator
        FilterOps["Filtering"]:::operator
        ErrorOps["Error Handling"]:::operator
        BackpressureOps["Backpressure Control"]:::operator
    end

    subgraph "Scheduler System"
        Schedulers["Schedulers"]:::scheduler
        SchedulerInterface["Scheduler Interface"]:::scheduler
        BoundedElastic["Bounded Elastic"]:::scheduler
        ParallelScheduler["Parallel Scheduler"]:::scheduler
    end

    subgraph "Infrastructure Layer"
        Context["Context"]:::infra
        Queues["Queue Implementations"]:::infra
        Backpressure["Backpressure"]:::infra
        ErrorHandling["Error Handling"]:::infra
    end

    subgraph "Core Interfaces"
        CorePub["CorePublisher"]:::core
        CoreSub["CoreSubscriber"]:::core
        Scannable["Scannable"]:::core
    end

    Publishers --> BaseOps
    BaseOps --> |"Transform"| TransformOps
    BaseOps --> |"Combine"| CombineOps
    BaseOps --> |"Filter"| FilterOps
    BaseOps --> |"Handle Errors"| ErrorOps
    BaseOps --> |"Control Flow"| BackpressureOps

    Schedulers --> Publishers
    Schedulers --> Operators
    
    Context --> Publishers
    Context --> Operators
    Queues --> Publishers
    Queues --> Operators
    Backpressure --> Publishers
    ErrorHandling --> Publishers

    CorePub --> Publishers
    CoreSub --> Publishers
    Scannable --> Publishers

    %% Click events for component mapping
    click Flux "https://github.com/reactor/reactor-core/blob/main/reactor-core/src/main/java/reactor/core/publisher/Flux.java"
    click Mono "https://github.com/reactor/reactor-core/blob/main/reactor-core/src/main/java/reactor/core/publisher/Mono.java"
    click ParallelFlux "https://github.com/reactor/reactor-core/blob/main/reactor-core/src/main/java/reactor/core/publisher/ParallelFlux.java"
    click Schedulers "https://github.com/reactor/reactor-core/blob/main/reactor-core/src/main/java/reactor/core/scheduler/Schedulers.java"
    click SchedulerInterface "https://github.com/reactor/reactor-core/blob/main/reactor-core/src/main/java/reactor/core/scheduler/Scheduler.java"
    click BoundedElastic "https://github.com/reactor/reactor-core/blob/main/reactor-core/src/main/java/reactor/core/scheduler/BoundedElasticScheduler.java"
    click ParallelScheduler "https://github.com/reactor/reactor-core/blob/main/reactor-core/src/main/java/reactor/core/scheduler/ParallelScheduler.java"
    click BaseOps "https://github.com/reactor/reactor-core/blob/main/reactor-core/src/main/java/reactor/core/publisher/Operators.java"
    click Context "https://github.com/reactor/reactor-core/blob/main/reactor-core/src/main/java/reactor/util/context/Context.java"
    click Queues "https://github.com/reactor/reactor-core/blob/main/reactor-core/src/main/java/reactor/util/concurrent/Queues.java"
    click Backpressure "https://github.com/reactor/reactor-core/blob/main/reactor-core/src/main/java/reactor/core/publisher/FluxOnBackpressureBuffer.java"
    click ErrorHandling "https://github.com/reactor/reactor-core/blob/main/reactor-core/src/main/java/reactor/core/Exceptions.java"
    click CorePub "https://github.com/reactor/reactor-core/blob/main/reactor-core/src/main/java/reactor/core/CorePublisher.java"
    click CoreSub "https://github.com/reactor/reactor-core/blob/main/reactor-core/src/main/java/reactor/core/CoreSubscriber.java"
    click Scannable "https://github.com/reactor/reactor-core/blob/main/reactor-core/src/main/java/reactor/core/Scannable.java"

    %% Styling
    classDef publisher fill:#2196F3,stroke:#1565C0,color:white
    classDef operator fill:#FF9800,stroke:#F57C00,color:white
    classDef scheduler fill:#4CAF50,stroke:#388E3C,color:white
    classDef infra fill:#9E9E9E,stroke:#616161,color:white
    classDef core fill:#673AB7,stroke:#512DA8,color:white

    %% Legend
    subgraph Legend
        L1["Publishers"]:::publisher
        L2["Operators"]:::operator
        L3["Schedulers"]:::scheduler
        L4["Infrastructure"]:::infra
        L5["Core Interfaces"]:::core
    end
```
