Library for fast mapping of Java records to native memory

TypedMemory, a new Java library that maps Java record types onto native memory, has been released as an experimental project for Java 25 and higher, aiming to simplify high-performance off-heap programming.

Built on the Java Foreign Function & Memory (FFM) API, TypedMemory provides a type-safe, expressive API for working with contiguous off-heap memory. It allows developers to allocate, read, write, and reinterpret memory regions using Java record types, reducing boilerplate and increasing safety compared to manual memory management. The library supports features like nested structured data, bulk operations, and reinterpreting existing memory segments.

Currently, TypedMemory is in an experimental state, with core features such as typed memory allocation, layout derivation, and basic get/set operations implemented. Planned future features include pointer-typed fields beyond long addresses, union types, and enhanced native interop capabilities. It requires Java 25 due to reliance on the ClassFile API and reinterprets calls.

Why It Matters

This development matters because it addresses longstanding challenges in Java for high-performance, low-level memory management. By providing a type-safe, high-level API for off-heap memory, TypedMemory can benefit applications in native interop, graphics, simulations, and data processing, where control over memory layout and performance is critical. It aims to make off-heap programming more accessible and less error-prone, potentially influencing future Java native interop practices.

Background

Java’s memory management traditionally relies on garbage collection, but high-performance applications often require off-heap memory for efficiency. The FFM API introduced in Java 14 offers low-level access but remains verbose and complex. TypedMemory builds on this API, aiming to simplify structured off-heap data handling with a focus on safety and expressiveness. The project is part of ongoing efforts to improve native interop and memory control in Java, with early testing and adoption expected among systems and graphics developers.

“TypedMemory aims to make off-heap programming feel more natural by providing strongly typed views over contiguous memory.”

— Project author

“By leveraging the FFM API, TypedMemory offers a practical way to handle structured data off-heap without sacrificing control or performance.”

— Java community developer

What Remains Unclear

As an experimental project, it is unclear how broadly TypedMemory will be adopted or how quickly it will stabilize with future updates. Some planned features, such as pointer-typed fields and unions, are still in development, and its long-term stability and compatibility with various Java environments remain to be seen.

Modern Data Structures and Algorithms in Java: Leverage High Performance Logic To Build Scalable Systems For Senior Engineering Roles

AmazonView Latest Price

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

What’s Next

Next steps include further development of planned features, extensive testing in real-world applications, and gathering community feedback. Developers interested in native interop and high-performance data handling are encouraged to experiment with the current API and contribute to its evolution.

Key Questions

What is TypedMemory?

TypedMemory is a Java library that maps Java record types onto native memory, enabling safe, efficient off-heap data handling using the FFM API.

Is TypedMemory ready for production use?

Currently, it is in an experimental state. While core features are usable, developers should be cautious and monitor updates as the project evolves.

What Java version is required?

Java 25 or higher, due to reliance on the ClassFile API and reinterpretation features.

What are the main use cases?

Native interop, high-performance memory layouts, simulations, graphics, and data-oriented programming where control over memory structure is critical.