Yes, we're now running our Black Friday Sale. All Access and Pro are 33% off until 2nd December, 2025:
Modern software architecture is often broken. Slow delivery leads to missed opportunities, innovation is stalled due to architectural complexities, and engineering resources are exceedingly expensive.
Orkes is the leading workflow orchestration platform built to enable teams to transform the way they develop, connect, and deploy applications, microservices, AI agents, and more.
With Orkes Conductor managed through Orkes Cloud, developers can focus on building mission critical applications without worrying about infrastructure maintenance to meet goals and, simply put, taking new products live faster and reducing total cost of ownership.
Try a 14-Day Free Trial of Orkes Conductor today.
Modern software architecture is often broken. Slow delivery leads to missed opportunities, innovation is stalled due to architectural complexities, and engineering resources are exceedingly expensive.
Orkes is the leading workflow orchestration platform built to enable teams to transform the way they develop, connect, and deploy applications, microservices, AI agents, and more.
With Orkes Conductor managed through Orkes Cloud, developers can focus on building mission critical applications without worrying about infrastructure maintenance to meet goals and, simply put, taking new products live faster and reducing total cost of ownership.
Try a 14-Day Free Trial of Orkes Conductor today.
Mocking is an essential part of unit testing, and the Mockito library makes it easy to write clean and intuitive unit tests for your Java code.
Get started with mocking and improve your application tests using our Mockito guide:
Spring 5 added support for reactive programming with the Spring WebFlux module, which has been improved upon ever since. Get started with the Reactor project basics and reactive programming in Spring Boot:
Since its introduction in Java 8, the Stream API has become a staple of Java development. The basic operations like iterating, filtering, mapping sequences of elements are deceptively simple to use.
But these can also be overused and fall into some common pitfalls.
To get a better understanding on how Streams work and how to combine them with other language features, check out our guide to Java Streams:
Explore Spring Boot 3 and Spring 6 in-depth through building a full REST API with the framework:
Yes, Spring Security can be complex, from the more advanced functionality within the Core to the deep OAuth support in the framework.
I built the security material as two full courses - Core and OAuth, to get practical with these more complex scenarios. We explore when and how to use each feature and code through it on the backing project.
You can explore the course here:
Modern software architecture is often broken. Slow delivery leads to missed opportunities, innovation is stalled due to architectural complexities, and engineering resources are exceedingly expensive.
Orkes is the leading workflow orchestration platform built to enable teams to transform the way they develop, connect, and deploy applications, microservices, AI agents, and more.
With Orkes Conductor managed through Orkes Cloud, developers can focus on building mission critical applications without worrying about infrastructure maintenance to meet goals and, simply put, taking new products live faster and reducing total cost of ownership.
Try a 14-Day Free Trial of Orkes Conductor today.
Spring Data JPA is a great way to handle the complexity of JPA with the powerful simplicity of Spring Boot.
Get started with Spring Data JPA through the guided reference course:
Refactor Java code safely — and automatically — with OpenRewrite.
Refactoring big codebases by hand is slow, risky, and easy to put off. That’s where OpenRewrite comes in. The open-source framework for large-scale, automated code transformations helps teams modernize safely and consistently.
Each month, the creators and maintainers of OpenRewrite at Moderne run live, hands-on training sessions — one for newcomers and one for experienced users. You’ll see how recipes work, how to apply them across projects, and how to modernize code with confidence.
Join the next session, bring your questions, and learn how to automate the kind of work that usually eats your sprint time.
Yes, we're now running our Black Friday Sale. All Access and Pro are 33% off until 2nd December, 2025:
1. Overview
Garbage collection is the process by which Java’s runtime system identifies and removes unreferenced objects in memory. It plays a critical role in managing memory by clearing up unreferenced objects, temporary objects, unused metadata, and more.
In this tutorial, we’ll explore Metaspace and the Metadata GC Threshold, along with how to tune their parameters.
2. Metadata
Metadata contains information about the objects in the heap, including their class definitions, method tables, and related information. Depending on the version of Java, the JVM stores this data in the permanent generation or Metaspace.
The JVM relies on this information to perform tasks like class loading, bytecode verification, and dynamic binding.
3. PermGen and Metaspace
Starting with Java 8, the JVM replaced the permanent generation or PermGen with a new area in memory called the Metaspace to store metadata.
The PermGen was a fixed-size memory area separate from the main heap used to store metadata for the classes and methods loaded by the JVM. It had a fixed maximum size, and once it was full, the JVM would throw an OutOfMemoryError.
The Metaspace is not fixed in size and can grow dynamically, depending on the amount of metadata in the application. The Metaspace is present separately from the main heap in a segment of native memory (process memory). It is only limited in size by the constraints set by the host operating system.
4. Metadata GC Threshold
In Java, when we create an object with metadata, it occupies memory space just like any other object. The JVM requires this metadata for various tasks. Unlike regular objects, metadata does not undergo garbage collection until a certain threshold is reached.
As more classes get loaded dynamically during the execution of a Java program, the Metaspace fills up.
The JVM maintains a threshold for the size of the Metaspace contents, and when a particular allocation doesn’t fit within this threshold, it triggers a Metadata GC Threshold garbage collection cycle.
5. JVM Parameters for Metadata
We can use JVM flags like -XX:+PrintClassHistogram and -XX:+PrintMetaspaceStatistics to gather information about classes that use a lot of metadata memory and print statistics about the Metaspace, such as the amount of space used for class metadata.
Using this information, we can aim at optimizing our code to improve the usage of Metaspace and Garbage Collection cycles. Additionally, we can also tune the JVM parameters associated with Metaspace.
Let’s take a look at some of the JVM parameters used to tune metadata and Metaspace.
5.1. -XX:MetaspaceSize=<size>
This parameter helps to set the initial amount of space (initial high-water-mark) allocated for class metadata (in bytes) that may induce a Garbage Collection to unload classes. The amount is approximate, which means the JVM can decide to increase or decrease the size of the Metaspace as well.
A large value for this parameter ensures that garbage collection happens less frequently. The default value for the parameter is platform-dependent and ranges from 12 MB to about 20 MB.
For example, we could set it to 128 megabytes:
-XX:MetaspaceSize=128m5.2. -XX:MaxMetaspaceSize=<size>
This parameter sets the maximum size of the Metaspace, after which an OutOfMemory error is thrown. This flag limits the amount of space allocated for class metadata, and the value assigned to this parameter is an approximate one.
By default, there’s no limit set, meaning that it’s possible for the Metaspace to grow to the size of the native memory available.
As an example, let’s set it to 100 megabytes:
‑XX:MaxMetaSpaceSize=100m5.3. -XX:+UseCompressedClassPointers
This feature aims to reduce the memory footprint of 64-bit Java applications by compressing object references. When this parameter is set to true, the JVM will use compressed pointers for class metadata, which allows the JVM to use 32-bit addressing for class-related data instead of the full 64-bit pointers.
This optimization becomes especially valuable on 64-bit architectures because it reduces the memory usage of class metadata, as well as the memory required for object references, thus potentially improving the application’s overall performance.
Compressed class pointers keep class space allocations separate from non-class space allocations. So, we have two global Metaspace contexts: one holding allocations of Klass structures (compressed class space), and one holding everything else (non-class Metaspace).
It’s important to note that in recent versions of the JVM, the flag is typically enabled by default when running a 64-bit Java application, so we don’t usually need to set this flag explicitly.
5.4. -XX:+UseCompressedOops
This JVM flag enables or disables the use of compressed pointers for Java objects in 64-bit JVMs. When the parameter is set to true, the JVM will use compressed pointers, which means that object references will use 32-bit pointers instead of the full 64-bit pointers.
With compressed pointers, it is only possible to address a smaller range of memory. This forces the JVM to use smaller pointers and save memory.
6. Conclusion
In this article, we’ve explored the concept of metadata and Metaspace.
We explored the reason behind triggering of Metadata GC Threshold. Also, we learned about the Metadata GC Threshold and the different JVM parameters available to tune Metaspace and optimize the garbage collection cycles.
