# JoyQueue

**Repository Path**: mirrors/JoyQueue

## Basic Information

- **Project Name**: JoyQueue
- **Description**: 快乐队列 -- 云原生、高性能、企业级消息平台
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://www.oschina.net/p/joyqueue
- **GVP Project**: No

## Statistics

- **Stars**: 37
- **Forks**: 7
- **Created**: 2019-10-09
- **Last Updated**: 2025-09-06

## Categories & Tags

**Categories**: message-server

**Tags**: None

## README

# JoyQueue

[![License](https://img.shields.io/github/license/chubaostream/joyqueue)](./LICENSE)
[![Release](https://img.shields.io/github/v/release/chubaostream/joyqueue)](https://github.com/chubaostream/joyqueue/releases)
[![Maven Central](https://img.shields.io/maven-central/v/org.joyqueue/joyqueue-client?color=brightgreen)](https://search.maven.org/search?q=org.joyqueue)
[![Last commit](https://img.shields.io/github/last-commit/chubaostream/joyqueue)](https://github.com/chubaostream/joyqueue/commits)
[![Travis](https://img.shields.io/travis/chubaostream/joyqueue)](https://travis-ci.org/chubaostream/joyqueue)
[![Coverage Status](https://coveralls.io/repos/github/chubaostream/joyqueue/badge.svg)](https://coveralls.io/github/chubaostream/joyqueue)

[阅读中文版](docs/cn/README.md)

JoyQueue -- A cloud-native production-ready messaging platform with excellent performance. 

## Features

* High performance design with low latency and high throughput, see [performance](#Performance).
* Built-in multi-protocol support, working pretty well with OpenMessaging, Kafka and MQTT clients.
* easy to deploy: single-process, zero-dependent, no need of additional cluster coordination services.
* Large-scale clustering.
* Strong durability
* Consistent replication based on [Raft consensus algorithm](https://raft.github.io/).
* Full-featured web management console.
* Other nice features:
  * Rich metrics APIs
  * Transactions
  * Parallel message consumption
  * Message archiving
  * Message preview
  * Automatically save consumption failure messages and error logs
  * Unlimited message stacking capacity

## Performance

A JoyQueue performance test results here：

| Scenario | QPS | clients | Delay AVG/TP99/TP999 (ms) | Fail(%)
| :----:| :----:|:----: |:----: |:----:|
|**Online service**| **510, 924** | 400| 1/4/8 | 0
|**Streaming** | **32, 961, 776** | 900 | N/A | 0

Scenario settings:

Scenario | Sync/Async | Batch | Compress | Msg size | Partitions | Client SDK
-- | -- | -- | -- | -- | -- | --
**Online service** | Sync | 1 | Not compressed | 1KB | 200 | joyqueue-client-4.1.0
**Streaming** | Async | 100 | LZ4 | 1KB | 200 | kafka-clients-2.1.1

For detail，visit [Performance](./docs/cn/performance.md)。

## Quickstart

Visit [Quick start](./docs/cn/quickstart.md)。

## Documentation

Visit [Documentation Index](./docs/cn/index.md)。

## Dependency Analysis

The [License Maven Plugin](https://www.mojohaus.org/license-maven-plugin/) manages the license of this project and its dependencies. Use maven goal `license:third-party-report` to generate a report of all third-parties detected in the project.

```bash
mvn license:aggregate-third-party-report
```

## Contributing

We are dedicate to building high-quality messaging platform product. So any thoughts, pull requests, or issues are appreciated.
See [CONTRIBUTING.md](CONTRIBUTING.md) for details on submitting patches and the contribution workflow.

## License

Licensed under the [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0).