# neo4j/apoc architecture

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

- Interactive diagram: https://gitdiagram.com/neo4j/apoc
- Repository: https://github.com/neo4j/apoc

## Overview

APOC is a Java library of Neo4j procedures and functions invoked from Cypher. A representative workflow loads JSON, returns records to a Cypher query, and lets that query update the graph. Its broader capabilities include data import/export, graph algorithms, conversion, refactoring, metadata, and triggers. The tree supports these subsystem boundaries; sampled code additionally shows Arrow export dispatch and trigger persistence. Most subsystem internals were not sampled, so their connections are omitted unless the README documents them.

Main entry points: [`core/src/main/java/apoc/export/arrow/ExportArrowService.java`](https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/export/arrow/ExportArrowService.java) (Arrow Export), [`core/src/main/java/apoc`](https://github.com/neo4j/apoc/tree/dev/core/src/main/java/apoc) (APOC Procedures), [`core/src/main/java/apoc/load/LoadJson.java`](https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/load/LoadJson.java) (JSON Loading), [`core/src/main/java/apoc/trigger/TriggerHandler.java`](https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/trigger/TriggerHandler.java) (Transaction Triggers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Cypher Entry"]
  node_procedures["APOC Procedures"]
end

subgraph group_data["Data Integration"]
  node_jsonload["JSON Loading<br/>[LoadJson.java]"]
  node_csvload["CSV Import<br/>[ImportCsv.java]"]
  node_xmlload["XML Loading<br/>[Xml.java]"]
  node_arrowload["Arrow Loading<br/>[LoadArrow.java]"]
  node_export["Data Export<br/>[ExportCypher.java]"]
  node_arrowexport["Arrow Export"]
end

subgraph group_graph["Graph Operations"]
  node_graphalgo["Graph Algorithms<br/>[PathFinding.java]"]
  node_paths["Path Exploration<br/>[Paths.java]"]
  node_graphbuild["Graph Construction<br/>[Create.java]"]
  node_refactor["Graph Refactoring"]
  node_convert["Data Conversion<br/>[Convert.java]"]
  node_metadata["Graph Metadata<br/>[Meta.java]"]
end

subgraph group_runtime["Runtime Services"]
  node_fileaccess["File and URL Access<br/>[FileUtils.java]"]
  node_triggers["Transaction Triggers"]
  node_config["APOC Configuration<br/>[ApocConfig.java]"]
  node_pools["Task Pools<br/>[Pools.java]"]
end

node_user(("Cypher User"))
node_neo4j[("Neo4j Database")]

node_user -->|"calls from Cypher"| node_procedures
node_procedures -.->|"invokes"| node_jsonload
node_jsonload -->|"supplies records"| node_neo4j
node_user -->|"updates via Cypher"| node_neo4j
node_user -.->|"calls procedures"| node_csvload
node_user -.->|"calls procedures"| node_xmlload
node_user -.->|"calls procedures"| node_arrowload
node_user -.->|"calls procedures"| node_export
node_user -.->|"calls procedures"| node_arrowexport
node_arrowexport -.->|"exports graph or results"| node_neo4j
node_user -.->|"calls procedures"| node_graphalgo
node_user -.->|"calls procedures"| node_paths
node_user -.->|"calls procedures"| node_graphbuild
node_user -.->|"calls procedures"| node_refactor
node_user -.->|"calls procedures"| node_convert
node_user -.->|"calls procedures"| node_metadata
node_user -.->|"configures triggers"| node_triggers
node_config -->|"uses file utilities"| node_fileaccess
node_arrowexport -->|"uses task pools"| node_pools
node_triggers -.->|"persists trigger state"| node_neo4j

click node_procedures "https://github.com/neo4j/apoc/tree/dev/core/src/main/java/apoc"
click node_jsonload "https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/load/LoadJson.java"
click node_csvload "https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/export/csv/ImportCsv.java"
click node_xmlload "https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/load/Xml.java"
click node_arrowload "https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/load/LoadArrow.java"
click node_export "https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/export/cypher/ExportCypher.java"
click node_arrowexport "https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/export/arrow/ExportArrowService.java"
click node_fileaccess "https://github.com/neo4j/apoc/blob/dev/common/src/main/java/apoc/util/FileUtils.java"
click node_graphalgo "https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/algo/PathFinding.java"
click node_paths "https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/path/Paths.java"
click node_graphbuild "https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/create/Create.java"
click node_refactor "https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/refactor/GraphRefactoring.java"
click node_convert "https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/convert/Convert.java"
click node_metadata "https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/meta/Meta.java"
click node_triggers "https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/trigger/TriggerHandler.java"
click node_config "https://github.com/neo4j/apoc/blob/dev/common/src/main/java/apoc/ApocConfig.java"
click node_pools "https://github.com/neo4j/apoc/blob/dev/common/src/main/java/apoc/Pools.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_procedures,node_user toneBlue
class node_jsonload,node_csvload,node_xmlload,node_arrowload,node_export,node_arrowexport,node_neo4j toneAmber
class node_graphalgo,node_paths,node_graphbuild,node_refactor,node_convert,node_metadata toneMint
class node_fileaccess,node_triggers,node_config,node_pools toneRose
```

## Components

### Cypher Entry

- [APOC Procedures](https://github.com/neo4j/apoc/tree/dev/core/src/main/java/apoc): `core/src/main/java/apoc`

### Data Integration

- [JSON Loading](https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/load/LoadJson.java): `core/src/main/java/apoc/load/LoadJson.java`
- [CSV Import](https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/export/csv/ImportCsv.java): `core/src/main/java/apoc/export/csv/ImportCsv.java`
- [XML Loading](https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/load/Xml.java): `core/src/main/java/apoc/load/Xml.java`
- [Arrow Loading](https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/load/LoadArrow.java): `core/src/main/java/apoc/load/LoadArrow.java`
- [Data Export](https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/export/cypher/ExportCypher.java): `core/src/main/java/apoc/export/cypher/ExportCypher.java`
- [Arrow Export](https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/export/arrow/ExportArrowService.java): `core/src/main/java/apoc/export/arrow/ExportArrowService.java`

### Graph Operations

- [Graph Algorithms](https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/algo/PathFinding.java): `core/src/main/java/apoc/algo/PathFinding.java`
- [Path Exploration](https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/path/Paths.java): `core/src/main/java/apoc/path/Paths.java`
- [Graph Construction](https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/create/Create.java): `core/src/main/java/apoc/create/Create.java`
- [Graph Refactoring](https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/refactor/GraphRefactoring.java): `core/src/main/java/apoc/refactor/GraphRefactoring.java`
- [Data Conversion](https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/convert/Convert.java): `core/src/main/java/apoc/convert/Convert.java`
- [Graph Metadata](https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/meta/Meta.java): `core/src/main/java/apoc/meta/Meta.java`

### Runtime Services

- [File and URL Access](https://github.com/neo4j/apoc/blob/dev/common/src/main/java/apoc/util/FileUtils.java): `common/src/main/java/apoc/util/FileUtils.java`
- [Transaction Triggers](https://github.com/neo4j/apoc/blob/dev/core/src/main/java/apoc/trigger/TriggerHandler.java): `core/src/main/java/apoc/trigger/TriggerHandler.java`
- [APOC Configuration](https://github.com/neo4j/apoc/blob/dev/common/src/main/java/apoc/ApocConfig.java): `common/src/main/java/apoc/ApocConfig.java`
- [Task Pools](https://github.com/neo4j/apoc/blob/dev/common/src/main/java/apoc/Pools.java): `common/src/main/java/apoc/Pools.java`

### Other components

- **Cypher User**
- **Neo4j Database**

## Connections

- Cypher User → APOC Procedures: calls from Cypher
- APOC Procedures → JSON Loading: invokes
- JSON Loading → Neo4j Database: supplies records
- Cypher User → Neo4j Database: updates via Cypher
- Cypher User → CSV Import: calls procedures
- Cypher User → XML Loading: calls procedures
- Cypher User → Arrow Loading: calls procedures
- Cypher User → Data Export: calls procedures
- Cypher User → Arrow Export: calls procedures
- Arrow Export → Neo4j Database: exports graph or results
- Cypher User → Graph Algorithms: calls procedures
- Cypher User → Path Exploration: calls procedures
- Cypher User → Graph Construction: calls procedures
- Cypher User → Graph Refactoring: calls procedures
- Cypher User → Data Conversion: calls procedures
- Cypher User → Graph Metadata: calls procedures
- Cypher User → Transaction Triggers: configures triggers
- APOC Configuration → File and URL Access: uses file utilities (evidence: `common/src/main/java/apoc/ApocConfig.java`)
- Arrow Export → Task Pools: uses task pools (evidence: `core/src/main/java/apoc/export/arrow/ExportArrowService.java`)
- Transaction Triggers → Neo4j Database: persists trigger state
