{"id":15088955,"url":"https://github.com/jctools/jctools","last_synced_at":"2025-10-05T18:31:21.209Z","repository":{"id":11750537,"uuid":"14281190","full_name":"JCTools/JCTools","owner":"JCTools","description":null,"archived":false,"fork":false,"pushed_at":"2024-06-01T14:55:08.000Z","size":7891,"stargazers_count":3584,"open_issues_count":48,"forks_count":563,"subscribers_count":192,"default_branch":"master","last_synced_at":"2024-11-24T16:09:26.276Z","etag":null,"topics":["awesome","benchmarks","concurrency","data-structures","java","lock-free","queues","wait-free"],"latest_commit_sha":null,"homepage":"http://jctools.github.io/JCTools","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JCTools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-11-10T18:04:40.000Z","updated_at":"2024-11-23T22:07:12.000Z","dependencies_parsed_at":"2023-11-22T11:13:25.846Z","dependency_job_id":"53009468-d270-4319-869a-7f9afe17378b","html_url":"https://github.com/JCTools/JCTools","commit_stats":null,"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JCTools%2FJCTools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JCTools%2FJCTools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JCTools%2FJCTools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JCTools%2FJCTools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JCTools","download_url":"https://codeload.github.com/JCTools/JCTools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235432187,"owners_count":18989473,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["awesome","benchmarks","concurrency","data-structures","java","lock-free","queues","wait-free"],"created_at":"2024-09-25T08:15:18.512Z","updated_at":"2025-10-05T18:31:15.632Z","avatar_url":"https://github.com/JCTools.png","language":"Java","readme":"[![Total alerts](https://img.shields.io/lgtm/alerts/g/JCTools/JCTools.svg?logo=lgtm\u0026logoWidth=18)](https://lgtm.com/projects/g/JCTools/JCTools/alerts/)\n[![Coverage Status](https://coveralls.io/repos/github/JCTools/JCTools/badge.svg?branch=master)](https://coveralls.io/github/JCTools/JCTools?branch=master)\n[![Build Status](https://app.travis-ci.com/JCTools/JCTools.svg?branch=master)](https://app.travis-ci.com/JCTools/JCTools)\n\nJCTools\n==========\nJava Concurrency Tools for the JVM. This project aims to offer some concurrent data structures currently missing from\nthe JDK:\n\n- SPSC/MPSC/SPMC/MPMC variations for concurrent queues:\n    * SPSC - Single Producer Single Consumer (Wait Free, bounded and unbounded)\n    * MPSC - Multi Producer Single Consumer (Lock less, bounded and unbounded)\n    * SPMC - Single Producer Multi Consumer (Lock less, bounded)\n    * MPMC - Multi Producer Multi Consumer (Lock less, bounded)\n\n- SPSC/MPSC linked array queues (bounded and unbounded) offer a balance between performance, allocation and footprint\n- MPSC/MPMC XAdd based, unbounded linked array queues offer reduced contention costs for producers (using XADD instead\n  of a CAS loop), and pooled queue chunks for reduced allocation.\n- An expanded queue interface (MessagePassingQueue):\n    * relaxedOffer/Peek/Poll: trade off conflated guarantee on full/empty queue state with improved performance.\n    * drain/fill: batch read and write methods for increased throughput and reduced contention\n\nMany queues are available in both `Unsafe` (default, uses `sun.mic.Unsafe`) and `Atomic` (relying\non `AtomicFieldUpdater`) variations, as well as `Unpadded` (lower footprint by removing false sharing avoiding field\npadding).\n\nThere's more to come and contributions/suggestions are most welcome. JCTools has enjoyed support from the community\nand contributions in the form of issues/tests/documentation/code have helped it grow.\nJCTools offers excellent performance at a reasonable price (FREE! under the Apache 2.0 License). It's stable and in\nuse by such distinguished frameworks as Netty, RxJava and others. JCTools is also used by commercial products to great\nresult.\n\nGet it NOW!\n==========\nAdd the latest version as a dependency using Maven:\n\n```xml\n\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.jctools\u003c/groupId\u003e\n    \u003cartifactId\u003ejctools-core\u003c/artifactId\u003e\n    \u003cversion\u003e4.0.3\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nOr use the awesome, built from source, \u003chttps://jitpack.io/\u003e version, you'll need to add the Jitpack repository:\n\n```xml\n\n\u003crepository\u003e\n    \u003cid\u003ejitpack.io\u003c/id\u003e\n    \u003curl\u003ehttps://jitpack.io\u003c/url\u003e\n\u003c/repository\u003e\n```\n\nAnd setup the following dependency:\n\n```xml\n\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.github.JCTools.JCTools\u003c/groupId\u003e\n    \u003cartifactId\u003ejctools-core\u003c/artifactId\u003e\n    \u003cversion\u003ev4.0.3\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nYou can also depend on latest snapshot from this repository (live on the edge) by setting the version to \n'4.0.5-SNAPSHOT'.\n\n\nBuild it from source\n==========\nJCTools is maven built and requires an existing Maven installation and JDK8 (only for building, runtime is 1.6\ncompliant).\n\nWith 'MAVEN_HOME/bin' on the path and JDK8 set to your 'JAVA_HOME' you should be able to run \"mvn install\" from this\ndirectory.\n\n\nBut I have a zero-dependency/single-jar project\n==========\nWhile you are free to copy \u0026 extend JCTools, we would much prefer it if you have a versioned dependency on JCTools to\nenable better support, upgrade paths and discussion. The shade plugin for Maven/Gradle is the preferred way to get\nJCTools fused with your library. Examples are available in\nthe [ShadeJCToolsSamples](https://github.com/JCTools/ShadeJCToolsSamples) project.\n\n\nBenchmarks\n==========\nJCTools is benchmarked using both JMH benchmarks and handrolled harnesses. The benchmarks and related instructions can\nbe\nfound in the jctools-benchmarks module [README](jctools-benchmarks/README.md). Go wild and please let us know how it did\non your hardware.\n\nConcurrency Testing\n===========\n\n```\nmvn package\ncd jctools-concurrency-test\njava -jar target/concurrency-test.jar -v\n```\n\nCome up to the lab...\n==========\nExperimental work is available under the jctools-experimental module. Most of the stuff is developed with an eye to\neventually porting it to the core where it will be stabilized and released, but some implementations are kept purely for\nreference and some may never graduate. Beware the Jabberwock my child.\n\nHave Questions? Suggestions?\n==========\nThe best way to discuss JCTools is on the GitHub issues system. Any question is good, and GitHub provides a better\nplatform for knowledge sharing than twitter/mailing-list/gitter (or at least that's what we think).\n\nThanks!!!\n=====\nWe have kindly been awarded [IntelliJ IDEA](https://www.jetbrains.com/idea/) licences\nby [JetBrains](https://www.jetbrains.com/) to aid in the development of JCTools. It's a great suite of tools which has\nbenefited the developers and ultimately the community.\n\nIt's an awesome and inspiring company, [**BUY THEIR PRODUCTS\nNOW!!!**](https://www.jetbrains.com/store/#edition=commercial)\n\nJCTools has enjoyed a steady stream of PRs, suggestions and user feedback. It's a community! Thank you all for getting\ninvolved!\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjctools%2Fjctools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjctools%2Fjctools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjctools%2Fjctools/lists"}