disruptor README

The project's README from github.com/LMAX-Exchange/disruptor. As one markdown file: README.md.

= LMAX Disruptor

image:https://github.com/LMAX-Exchange/disruptor/workflows/Java%20CI%20with%20Gradle/badge.svg[Java CI with Gradle,link=https://github.com/LMAX-Exchange/disruptor/actions/workflows/gradle-build.yml] image:https://github.com/LMAX-Exchange/disruptor/workflows/CodeQL/badge.svg[CodeQL,link=https://github.com/LMAX-Exchange/disruptor/actions/workflows/codeql-analysis.yml] image:https://img.shields.io/github/license/LMAX-Exchange/disruptor[License,link=https://github.com/LMAX-Exchange/disruptor/blob/master/LICENCE.txt]

A High Performance Inter-Thread Messaging Library

== Maintainer

LMAX Development Team

== Support

== Documentation

disruptor (LMAX-Exchange/disruptor)

Searching Database…

18.5K ·GitHub
What is this?LMAX Disruptor is a Java library for high-performance messaging between threads inside a single application — very fast in-process event passing.
Is it a library I add to my own Java project, or something I deploy as a server?A library: you add it as a dependency to your own Java project and use it inside your process — there is no server or daemon to deploy.
How do I add it to a project and start using it?Start with the Guide and documentation the README links — they walk through the programming model; then wire the library into your Gradle or Maven build.
Do I need anything besides a JDK to run it?Just a JDK — it is pure Java with no native components or external services; the project's own CI builds it with Gradle.
So it wires threads together inside one app — it doesn't send messages between machines or services?Right — its scope is inter-thread messaging within one JVM. It is not a network broker and won't carry messages between machines or services.
What kind of applications is it built for?Latency-sensitive Java systems — it comes from the LMAX Exchange team, so think in-process pipelines where throughput and latency matter more than convenience.
Is the concurrency actually stress-tested, or do I just have to trust it?CI runs Java Concurrency Stress (jcstress) suites — a quick pass plus a manual deep run — alongside Gradle builds and CodeQL analysis.
Can I use it in commercial software?Yes — it is Apache-2.0 licensed, a permissive license, so it is free to use in commercial products.
Is this battle-tested infrastructure or a recent experiment?Established: the repository dates back to 2012 and the project is maintained by the LMAX Development Team, with stress tests wired into CI.
Size
9.9 MB
Stars
18.5K
Age
14y
Commits · 90 Days