Java Class isRecord() Method

The isRecord() method in Java, part of the java.lang.Class class, is used to determine whether the class object represents a record type.

Table of Contents

  1. Introduction
  2. isRecord() Method Syntax
  3. Understanding isRecord()
  4. Examples
    • Basic Usage
    • Checking Non-Record Classes
  5. Real-World Use Case
  6. Conclusion


The isRecord() method returns true if the class object represents a record type, otherwise it returns false. This method is useful for reflection-based operations where you need to verify if a class is a record.

isRecord() Method Syntax

The syntax for the isRecord() method is as follows:

public boolean isRecord()


  • This method does not take any parameters.


  • true if this class object represents a record type; false otherwise.

Understanding isRecord()

The isRecord() method checks whether the class object represents a record type. Records are a special kind of class in Java that are immutable and provide a compact syntax for declaring data carrier classes. This method is particularly useful when working with Java records, introduced in Java 14 as a preview feature and made standard in Java 16.


Basic Usage

To demonstrate the basic usage of isRecord(), we will create a record type and check if it is a record.


public class IsRecordExample {
    public static void main(String[] args) {
        Class<?> personRecordClass = PersonRecord.class;
        boolean isRecord = personRecordClass.isRecord();

        System.out.println("Is PersonRecord a record? " + isRecord);

    public record PersonRecord(String name, int age) {}


Is PersonRecord a record? true

Checking Non-Record Classes

This example shows how the isRecord() method behaves with non-record classes.


public class NonRecordExample {
    public static void main(String[] args) {
        Class<String> stringClass = String.class;
        boolean isRecord = stringClass.isRecord();

        System.out.println("Is String a record? " + isRecord);


Is String a record? false

Real-World Use Case

Dynamic Record Type Checking in Frameworks

In a real-world scenario, you might use the isRecord() method to dynamically check for record types within a framework. This can be useful for operations such as serialization, deserialization, or custom processing logic that needs to handle records differently.


import java.lang.reflect.Field;

public class RecordChecker {
    public static void main(String[] args) {

    public static void checkIfRecord(Class<?> clazz) {
        if (clazz.isRecord()) {
            System.out.println(clazz.getName() + " is a record.");
        } else {
            System.out.println(clazz.getName() + " is not a record.");

    public record PersonRecord(String name, int age) {}


RecordChecker$PersonRecord is a record.
java.lang.String is not a record.


The Class.isRecord() method in Java provides a way to determine whether a class object represents a record type. By using this method, you can dynamically check and process record types, making it particularly useful for reflection-based operations in frameworks and libraries.

Whether you are working with standard classes or custom records, the isRecord() method offers a reliable way to verify record types at runtime.