/Agrona

High Performance data structures and utility methods for Java and C++

Primary LanguageJavaApache License 2.0Apache-2.0

Agrona

Agrona provides a library of data structures and utility methods that are a common need when building high-performance applications in Java. Many of these utilities are used in the Aeron efficient reliable UDP unicast, multicast, and IPC message transport.

For the latest version information and changes see the Change Log.

The latest release and downloads can be found in Maven Central.

Utilities Included:

  • Buffers - Thread safe direct and atomic for working with on and off heap memory with memory ordering semantics.
  • Maps - Open addressing and linear probing with int/long primitive keys to object reference values.
  • Maps - Open addressing and linear probing with int/long primitive keys to int/long values.
  • Sets - Open addressing and linear probing for int/long primitives.
  • Cache - Set Associative with int/long primitive keys to object reference values.
  • Queues - Lock-less implementations for low-latency applications.
  • Ring/Broadcast Buffers - implemented off-heap for IPC communication.
  • Basic Agent framework.
  • Signal handling to support "Ctrl + c" in a server application.
  • Scalable Timer Wheel.
  • Basic code generation from annotated implementations that can vary on primitive types.
  • Off-heap counters implementation for application telemetry.
  • Implementations of InputStream and OutputStream that can wrap direct buffers.

License (See LICENSE file for full license)

Copyright 2014 - 2015 Real Logic Limited

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Build

Java Build

You require the following to build Agrona:

Full clean and build and install into local maven repository

$ ./gradlew