如何在Java Record中设置预计算的最终hashCode值？

对于不可变类，我们常在构造时预计算hashCode（或toString）值，避免重复计算，同时自定义的hashCode还能方便调试（比如从hash值反推字段信息）。例如传统类的实现：

public final class RowColumn {
  private final int row;
  private final int column;
  private final int hashCode;
  private final String toString;

  public RowColumn(int row, int column) {
    this.row = row;
    this.column = column;
    this.hashCode = row * 100 + column;
    this.toString = String.format("%02d %2d", row, column);
  }

  @Override
  public int hashCode() { return hashCode; }

  @Override
  public String toString() { return toString; }

  // getters、equals方法省略
}

但Java Record默认会自动生成hashCode和toString，无法直接预计算。对于包含大量字段的复杂Record，预计算能提升性能，那么如何在Record中实现这一需求？

解决方案 #

Java Record允许定义额外的私有final字段，结合紧凑构造器即可实现预计算逻辑，具体实现如下：

public record RowColumn(int row, int column) {
    // 定义预计算的私有final字段
    private final int hashCode;
    private final String toString;

    // 紧凑构造器：自动处理主字段的赋值，添加预计算逻辑
    public RowColumn {
        // 可选：参数合法性校验
        if (row < 0 || row > 18) throw new IllegalArgumentException("行号超出范围（0-18）");
        if (column < 0 || column > 3) throw new IllegalArgumentException("列号超出范围（0-3）");
        
        // 预计算hashCode和toString
        this.hashCode = row * 100 + column;
        this.toString = String.format("%02d %2d", row, column);
    }

    // 重写方法，直接返回预计算值
    @Override
    public int hashCode() {
        return hashCode;
    }

    @Override
    public String toString() {
        return toString;
    }
}

关键说明 #

• Record支持添加额外的私有不可变字段（必须是final），只要在构造器中完成初始化，符合Record的不可变性约束。
• 紧凑构造器是Record特有的简化构造方式，它会自动处理主字段（row、column）的赋值，我们只需要在其中添加参数校验、预计算等逻辑即可。
• 重写hashCode时需确保符合equals约定：如果两个对象equals返回true，它们的hashCode必须相等。这里自定义的hashCode基于row和column生成，与Record默认的equals逻辑（基于所有主字段）保持一致，因此是安全的。
• 对于复杂Record，只需在紧凑构造器中完成所有字段的组合计算，将结果存入预定义的私有字段，再重写对应方法即可，同样能避免重复计算带来的性能开销。

内容的提问来源于stack exchange，提问作者MiguelMunoz