Java records: bẫy bất biến nông và vì sao không làm JPA entity

- Published on
- 13 mins read
Dưới một PR có comment: "Record là immutable rồi, sao còn List.copyOf trong constructor làm gì?". Nghe rất hợp lý. Có điều xoá dòng đó đi thì một lệnh roles.add("ADMIN") ở bên ngoài vẫn sửa được quyền của một object tưởng đã khoá chặt.
Nhiều người coi Record là bản thay Lombok (@Value hay @Getter) để đỡ gõ vài chục dòng boilerplate. Vậy mới thấy phần ngọn. Record là thay đổi trong thiết kế của chính ngôn ngữ: một "lớp vỏ trong suốt" (transparent carrier) chở dữ liệu bất biến. Nó đổi luôn cách JVM làm serialization, và mở đường cho kiểu dữ liệu đại số (Algebraic Data Types) đi cùng Pattern Matching.
Từ khi chính thức ra mắt ở Java 16 (JEP 395), Record đã thành viên gạch cơ bản trong codebase Java hiện đại. Dùng theo quán tính thì dễ vấp hai chỗ: đánh đồng bất biến nông (shallow immutability) với bất biến sâu (deep immutability), và cố ép Record làm JPA Entity. Một bên rò rỉ trạng thái, một bên ra runtime exception khó lường.
# cam kết về ngữ nghĩa: transparent carrier là gì?
Brian Goetz (Java Language Architect tại Oracle) từng nhấn mạnh rằng mục tiêu của Record không phải là "giảm gõ phím", việc bớt code chỉ là hệ quả đi kèm. Bản chất của Record là một cam kết về mặt ngữ nghĩa: class này thuần túy là một tập hợp dữ liệu, toàn bộ trạng thái của nó nằm trọn ở các component khai báo trên tiêu đề, không giấu giếm gì thêm. Nhờ lời cam kết đó mà trình biên dịch mới tự tin sinh ra constructor, accessor, equals(), hashCode(), toString(), và quan trọng hơn là JVM mới dám khôi phục lại object thông qua constructor chuẩn khi deserialize:
# mấy luật cứng JVM đặt cho Record
Để bảo toàn tính trong suốt này, Java áp đặt bốn ràng buộc cứng. Mọi record đều ngầm kế thừa lớp trừu tượng java.lang.Record và mang cờ final, nghĩa là không class nào kế thừa được record và bản thân record cũng không thể extends class khác (nhưng vẫn implements interface bình thường). Toàn bộ các trường dữ liệu (component fields) đều bị khóa chặt thành private final, đồng thời trình biên dịch cấm khai báo thêm bất kỳ instance field nào nằm ngoài danh sách trên header (chỉ cho phép static field). Cuối cùng, mọi record luôn có một Canonical Constructor nhận vào đúng danh sách tham số khớp với các component đã khai báo.
# nông vs sâu: cạm bẫy shallow immutability
Có một hiểu lầm rất hay gặp: "Dùng Record là dữ liệu bất biến 100%!".
Thật ra Java Records chỉ bảo đảm bất biến nông (Shallow Immutability). Tham chiếu (reference) thì final, nhưng bản thân object được trỏ tới vẫn bị sửa (mutate) như thường nếu nó là mutable!
Xem đoạn code làm lộ state ra ngoài dưới đây:
// NGUY HIỂM: Rò rỉ trạng thái nội tại!
public record SecurityContext(String username, List<String> roles) {}
// Hacker hoặc code ngoài luồng có thể sửa đổi:
List<String> roles = new ArrayList<>(List.of("USER"));
SecurityContext ctx = new SecurityContext("alice", roles);
// BÊN NGOÀI THAY ĐỔI:
roles.add("ADMIN"); // SecurityContext bị thay đổi mà không hề hay biết!
// HOẶC TRUY XUẤT ĐỂ SỬA:
ctx.roles().clear(); // Toàn bộ quyền bị xóa sạch!# cách xử lý: defensive copying trong compact constructor
Muốn bất biến thật thì phải copy phòng thủ (defensive copy) trong compact constructor:
public record SecurityContext(String username, List<String> roles) {
// Compact Constructor: Chuẩn hóa và bảo vệ trạng thái khi khởi tạo
public SecurityContext {
Objects.requireNonNull(username, "Username không được null");
// Ép sang Unmodifiable List để triệt tiêu mọi hành vi mutation từ bên ngoài
roles = (roles == null) ? List.of() : List.copyOf(roles);
}
}List.copyOf làm hai việc: tạo bản sao (bên ngoài sửa list gốc cũng không ảnh hưởng) và trả về list không sửa được (ctx.roles().clear() ném UnsupportedOperationException). Vì thế không cần override accessor roles() nữa. Chỉ khi bạn buộc phải giữ một collection mutable bên trong thì mới cần override accessor để trả bản sao ra ngoài. Hai điều cần nhớ: List.copyOf ném NullPointerException nếu list có phần tử null, và nó chỉ khoá cái list chứ không khoá phần tử, list chứa object mutable thì phần tử vẫn bị sửa được. String vốn bất biến nên ví dụ này an toàn.
# đổi hẳn chuyện bảo mật: Java deserialization defense
Lỗ hổng Java Deserialization Vulnerability (qua ObjectInputStream.readObject()) từng làm khổ không biết bao nhiêu hệ thống doanh nghiệp.
# tại sao POJO truyền thống dễ bị tấn công qua serialization?
Với một class Java truyền thống implement Serializable, khi nhận một luồng byte từ bên ngoài, JVM không hề gọi constructor của class đó. Thay vào đó, nó dùng cơ chế đặc biệt qua ReflectionFactory để cấp phát vùng nhớ trống (chỉ gọi constructor không tham số của class cha đầu tiên không Serializable, thường là java.lang.Object), rồi dùng reflection gán thẳng dữ liệu từ luồng byte vào từng field bên trong, kể cả các field private final. Hệ quả là mọi đoạn code kiểm tra điều kiện hợp lệ (như if (amount <= 0) throw new IllegalArgumentException()) mà bạn dày công viết trong constructor đều bị đi vòng qua hết, trừ khi bạn nhớ viết lặp lại toàn bộ logic kiểm tra đó vào phương thức readObject().
# cơ chế phòng thủ tự nhiên của Record
Record thay đổi tận gốc quy trình này: khi deserialize một Record, JVM đọc các giá trị trường dữ liệu từ luồng byte ra rồi bắt buộc truyền chúng qua Canonical Constructor để khởi tạo đối tượng. Các phương thức can thiệp ngầm như readObject() hay readObjectNoData() khai báo trên record đều bị JVM phớt lờ, triệt tiêu mọi đường tắt tạo object. Nếu dữ liệu đầu vào vi phạm điều kiện kiểm tra trong constructor và làm ném ra exception, ObjectInputStream.readObject() sẽ lập tức bọc lỗi đó thành InvalidObjectException và huỷ bỏ việc khởi tạo. Bạn có thể kiểm chứng dễ dàng bằng cách sửa tay vài byte trong stream của một record Money(long amount) có ràng buộc amount > 0 thành số âm: quá trình deserialize sẽ bị chặn đứng ngay lập tức.
Nhưng đừng hiểu thành "dùng Record là hết lo deserialization". Record chỉ bảo vệ bất biến của chính nó. Các đòn tấn công kiểu gadget chain (ghép những class có sẵn trên classpath như Commons Collections để chạy code) vẫn dùng được nếu ứng dụng còn deserialize dữ liệu không tin cậy bằng ObjectInputStream. Cách phòng chính vẫn là không nhận Java serialization từ ngoài, hoặc ít nhất cấu hình ObjectInputFilter (JEP 290) để chỉ cho phép đúng các class cần thiết.
# hệ thống kiểu đại số: sealed interfaces & pattern matching
Ghép Records với Sealed Interfaces là Java có được Algebraic Data Types (ADT), món vốn là đặc sản của mấy ngôn ngữ hàm như Haskell hay Scala:
# khai báo model nghiệp vụ cho chặt
public sealed interface OrderPaymentResult permits
OrderPaymentResult.Success,
OrderPaymentResult.Declined,
OrderPaymentResult.PendingReview {
record Success(String transactionId, BigDecimal amount) implements OrderPaymentResult {}
record Declined(String reasonCode, String message) implements OrderPaymentResult {}
record PendingReview(String verificationUrl, Instant timeoutAt) implements OrderPaymentResult {}
}# tận dụng pattern matching trong Java 21+
Từ Java 21, pattern matching cho switch (JEP 441) và record pattern (JEP 440) đã chính thức. Với sealed interface, compiler kiểm tra được đủ case hay chưa (exhaustiveness checking): quên xử lý một trường hợp con là code không compile:
public class PaymentProcessingEngine {
public String handlePaymentOutcome(OrderPaymentResult result) {
// Record Pattern Deconstruction kết hợp với Pattern Matching Switch
return switch (result) {
case OrderPaymentResult.Success(var txId, var amount) ->
"Giao dịch " + txId + " thành công số tiền: " + amount;
case OrderPaymentResult.Declined(var code, var msg) ->
"Từ chối thanh toán [" + code + "]: " + msg;
case OrderPaymentResult.PendingReview(var url, var expire) ->
"Cần xác minh bảo mật trước " + expire + " tại: " + url;
// Không cần nhánh 'default:'! Trình biên dịch đảm bảo 100% không sót case.
};
}
}Cái lợi lớn nhất của việc bỏ default là khi sau này thêm một kiểu kết quả mới vào permits, mọi switch chưa xử lý nó sẽ báo lỗi compile ngay, thay vì lặng lẽ rơi vào nhánh default lúc runtime. Nếu class được compile riêng rồi gặp một subtype lạ lúc chạy, JVM ném MatchException.
# cái bẫy lớn: tại sao Record không làm JPA Entity được?
Nhiều người hứng lên muốn thay hết @Entity bằng record. Đừng làm vậy, sai từ gốc về thiết kế.
# vì sao Record đụng nhau với JPA Entity?
- Spec của JPA: entity phải có constructor không tham số và không được là class
final. Record vi phạm cả hai ngay từ đầu. - Hibernate Proxy Generation: quan hệ
FetchType.LAZYthì Hibernate sinh một subclass động (proxy) kế thừa entity để chặn các getter. Record làfinalnên không tạo proxy được. - Dirty Checking: entity được nạp lên rồi bạn sửa field, Hibernate so với bản chụp (snapshot) lúc nạp để biết cần
UPDATEgì. Record không sửa được field nào thì cơ chế này không còn ý nghĩa, và một entity đã được quản lý (managed) phải là cùng một object suốt phiên, không thể thay bằng bản sao mới.
Riêng @Embeddable thì khác: từ Hibernate 6.2, record dùng làm embeddable được (ví dụ value object Money(BigDecimal amount, String currency) nhúng vào entity), vì embeddable không cần proxy và được thay nguyên cả cục khi đổi giá trị.
# cách dùng chuẩn: Record làm DTO projection & query result
Record không làm Entity được, nhưng làm DTO Projection trong Spring Data JPA thì rất hợp:
// DTO Projection siêu nhẹ, bỏ qua hoàn toàn chi phí quản lý trạng thái của First-Level Cache
public record CustomerSummaryDTO(Long id, String fullName, String email, Long totalOrders) {}
public interface CustomerRepository extends JpaRepository<Customer, Long> {
// Constructor Expression: Ánh xạ thẳng kết quả SQL vào Record
@Query("""
SELECT new com.enterprise.dto.CustomerSummaryDTO(
c.id, c.fullName, c.email, COUNT(o.id)
)
FROM Customer c
LEFT JOIN c.orders o
GROUP BY c.id, c.fullName, c.email
""")
List<CustomerSummaryDTO> findAllCustomerSummaries();
}# tối ưu hóa jackson & serialization trong REST API
Dùng Record làm Request/Response DTO trong Spring Boot REST API thì Jackson 2.12+ hỗ trợ sẵn, khỏi cần thêm annotation lỉnh kỉnh nào:
public record CreateUserRequest(
@NotBlank(message = "Tên đăng nhập không được để trống")
@Size(min = 4, max = 32)
String username,
@Email(message = "Email không đúng định dạng chuẩn RFC")
String email,
@NotNull(message = "Hạn mức tín dụng là bắt buộc")
@DecimalMin(value = "0.0")
BigDecimal creditLimit
) {}Jackson tự lấy các tham số từ JSON rồi đưa thẳng vào canonical constructor. Annotation đặt trên record component được Java truyền xuống field, tham số constructor và accessor tương ứng, nên chỉ cần @Valid @RequestBody CreateUserRequest request ở Controller là Jakarta Bean Validation chạy luôn.
# checklist trước khi lên production (architect's checklist)
- 1. Deep Immutability: các component kiểu Collection (
List,Set,Map) trong Record đã được copy bằngList.copyOf()/Set.copyOf()/Map.copyOf()trong Compact Constructor chưa?Collections.unmodifiableList()chỉ là một lớp vỏ nhìn vào list gốc, bên ngoài sửa list gốc thì record vẫn đổi theo, nên một mình nó là chưa đủ. - 2. Không dùng làm JPA Entity: đừng gắn
@Entitylênrecordnào hết. Record hợp với DTO, Event Message, Value Object (kể cả@Embeddabletừ Hibernate 6.2) hoặc Projection. - 3. Đừng clone / mutate lung tung: cần đổi vài component của Record thì dùng "Wither Pattern" (
withAmount(...)trả về instance mới) cho có quy củ. - 4. Tận dụng Pattern Matching: dùng
sealed interfacekết hợprecordthay cho mấy chuỗiif-else instanceofrối rắm. - 5. Đừng lo GC quá sớm: record là object sống ngắn, mà GC thế hệ (G1 mặc định, Generational ZGC) dọn object sống ngắn ở vùng Eden rất rẻ, JIT còn có thể bỏ hẳn việc cấp phát nhờ escape analysis. Chỉ khi profiler (JFR, async-profiler) cho thấy allocation là nút thắt thật thì mới tính chuyện tối ưu.
# lời kết
Một quy tắc review dễ áp: record nào có component là collection hay object mutable thì phải có compact constructor, thiếu là trả PR. Còn chỗ đặt Record thì cứ bám mấy vị trí nó hợp nhất: Value Object trong DDD, DTO trong REST/gRPC API, Event Payload trong Kafka. Muốn đọc kỹ hơn thì xem JEP 395 và bài Data Classes and Sealed Types for Java của Brian Goetz.
Chỉ là những ghi chép cá nhân với hy vọng mang lại chút giá trị. Nếu thấy hữu ích, đừng ngại chia sẻ cho bạn bè & đồng nghiệp nhé!
Happy coding 😎 👍🏻 🚀 🔥.
On this page
- # cam kết về ngữ nghĩa: transparent carrier là gì?
- # mấy luật cứng JVM đặt cho Record
- # nông vs sâu: cạm bẫy shallow immutability
- # cách xử lý: defensive copying trong compact constructor
- # đổi hẳn chuyện bảo mật: Java deserialization defense
- # tại sao POJO truyền thống dễ bị tấn công qua serialization?
- # cơ chế phòng thủ tự nhiên của Record
- # hệ thống kiểu đại số: sealed interfaces & pattern matching
- # khai báo model nghiệp vụ cho chặt
- # tận dụng pattern matching trong Java 21+
- # cái bẫy lớn: tại sao Record không làm JPA Entity được?
- # vì sao Record đụng nhau với JPA Entity?
- # cách dùng chuẩn: Record làm DTO projection & query result
- # tối ưu hóa jackson & serialization trong REST API
- # checklist trước khi lên production (architect's checklist)
- # lời kết