TopGit
Đánh giá repo GitHub

Gson: chuyển đổi Java Object sang JSON

google/gson
GTopGit review image for google/gson
Review by Topgit.dev for google/gson, with GitHub repository stats and README context.
Nhận định nhanh

Gson chỉ làm đúng một việc — chuyển object Java thành JSON và ngược lại — mà không bắt bạn thêm annotation vào class trước. Đó vẫn đúng với code bạn không sở hữu. Điểm cần lưu ý nằm ngay trong README: Gson tự nhận đang ở chế độ maintenance mode và khuyên developer Android chuyển sang Kotlin Serialization. Hãy xem đây là công cụ ổn định, đã hoàn thiện, không phải dự án còn phát triển thêm.

Sao
★ 24.2k
Fork
⑂ 4.5k
Ngôn ngữ
Java
Giấy phép
Apache-2.0
Chủ đề
—
Cập nhật
Nov 2026
Trang chủ
—
GitHub

Gson là gì

Gson là thư viện Java do Google phát triển, chuyển các object Java thành JSON và chuyển ngược JSON về lại object Java. Gson hoạt động qua reflection, nên không yêu cầu bạn thêm annotation vào class hay có quyền truy cập mã nguồn của class đó. README liệt kê hỗ trợ sâu cho Java Generics và khả năng xử lý object graph phức tạp như những mục tiêu thiết kế rõ ràng. Toàn bộ luồng làm việc chỉ gói gọn trong hai phương thức: toJson() và fromJson().

Tính năng cốt lõi

  • ✓toJson() và fromJson() xử lý toàn bộ việc chuyển đổi hai chiều, không cần cấu hình gì thêm.
  • ✓Hoạt động trên class không có annotation — kể cả những object mà bạn không có mã nguồn.
  • ✓Hỗ trợ sâu cho Java Generics, được README liệt kê như mục tiêu mà phần lớn thư viện cùng thời không làm tốt.
  • ✓Xử lý được object graph phức tạp: cấu trúc kế thừa nhiều tầng và generic type dùng dày đặc.
  • ✓Đi kèm JPMS module descriptor (tên module com.google.gson) để dùng gọn trên Java 9 trở lên.
  • ✓Module java.sql tùy chọn bổ sung adapter mặc định cho các kiểu date/time của SQL khi module đó có mặt.
  • ✓Có thể dùng class Unsafe nội bộ của JDK để khởi tạo object không có constructor không tham số.
Số sao GitHub của repo này thay đổi thế nào theo thời gian. Nguồn: star-history.com.Xem lịch sử sao ↗

Cách dùng cơ bản với toJson và fromJson

README mô tả API bằng tên phương thức chứ không kèm ví dụ code đầy đủ: hai phương thức chính là toJson(), để chuyển object Java thành chuỗi JSON, và fromJson(), để chuyển chuỗi JSON ngược lại thành object Java. Ngoài hai lệnh gọi này, chữ ký phương thức chi tiết và ví dụ từng bước nằm ở User Guide và API Javadoc riêng được liên kết từ repo — bản thân README không đi qua một ví dụ hoàn chỉnh.

Thêm Gson vào dự án

Thêm Gson làm dependency bằng Gradle: implementation 'com.google.code.gson:gson:2.14.0' trong khối dependencies. Với Maven, thêm khối dependency với groupId com.google.code.gson, artifactId gson, và version 2.14.0. File jar dựng sẵn cũng có sẵn trực tiếp trên Maven Central. Phiên bản Java tối thiểu phụ thuộc vào bản Gson bạn cài: 2.12.0 trở lên cần Java 8, từ 2.9.0 đến 2.11.0 cần Java 7, còn 2.8.9 trở về trước chạy được trên Java 6.

Điểm mạnh

  • ✓Không cần annotation — hoạt động trên class bạn không sở hữu hoặc không thể chỉnh sửa mã nguồn.
  • ✓Hỗ trợ Java Generics đầy đủ, được coi là mục tiêu thiết kế chứ không phải thêm vào sau.
  • ✓Xử lý được object graph sâu, phức tạp, kể cả cấu trúc kế thừa nhiều tầng.
  • ✓Có JPMS module descriptor đàng hoàng cho Java 9+, trong khi bản cũ vẫn hỗ trợ Java 6 và 7.

Hạn chế cần biết

  • △Đang ở chế độ maintenance mode: README nói các bug hiện tại sẽ được sửa nhưng tính năng lớn mới khó có khả năng được thêm vào.
  • △Chính đội ngũ duy trì cũng khuyên không nên dùng Gson trên Android, vì cách tiếp cận dựa trên reflection dễ vỡ khi build release chạy code shrinking và obfuscation.
  • △Chỉ hỗ trợ đầy đủ cho Java — dùng từ Kotlin hay Scala có thể gây hành vi khó hiểu hoặc sai với non-null type và constructor có tham số mặc định.
  • △Dựa vào class sun.misc.Unsafe nội bộ của JDK cho các class không có constructor không tham số, mà class này không chắc có mặt ở mọi môi trường.

Lựa chọn thay thế cho Gson

Jackson — thư viện JSON Java linh hoạt cấu hình hơn, có streaming parsing và hệ sinh thái module lớn cho nhiều kiểu dữ liệu.Moshi — thư viện JSON của Square, ưu tiên Kotlin, hoạt động ổn định hơn Gson dưới code shrinking trên Android.Kotlin Serialization — chính README của Gson khuyên dùng cho dự án Android và Kotlin, vì nó sinh adapter lúc compile thay vì dựa vào reflection lúc runtime.org.json — bộ parser JSON tối giản, ít dependency, cho những dự án chỉ cần parse mà không cần object mapping đầy đủ.

Câu hỏi thường gặp

Gson có còn được bảo trì tích cực không?

Gson đang ở chế độ maintenance mode, theo đúng README của dự án: các bug hiện tại vẫn được sửa, nhưng tính năng lớn mới khó có khả năng được thêm. Ai muốn thêm tính năng được yêu cầu mở GitHub issue để thảo luận trước, thay vì gửi thẳng pull request.

Có thể dùng Gson trên Android không?

Gson chạy được trên Android, nhưng README chủ động khuyên không nên: cách dùng reflection của Gson không hợp với code shrinking và obfuscation ở bản release. Đội ngũ duy trì gợi ý dùng Kotlin Serialization thay thế, hoặc cấu hình ProGuard/R8 nếu vẫn muốn dùng Gson.

Phiên bản Java tối thiểu để dùng Gson là gì?

Gson 2.12.0 trở lên cần Java 8; từ 2.9.0 đến 2.11.0 cần Java 7; còn 2.8.9 trở về trước chạy được trên Java 6. Các bản mới hơn còn có JPMS module descriptor, tên module com.google.gson, cho dự án chạy Java 9 trở lên.

Gson có yêu cầu annotation trong class không?

Gson không yêu cầu annotation trong class. Đây là một trong những mục tiêu thiết kế cốt lõi: chuyển object Java bất kỳ thành JSON kể cả khi bạn không có mã nguồn để thêm annotation vào, khác với phần lớn thư viện JSON Java khác cùng thời.

Gson xử lý Java Generics như thế nào?

Gson coi hỗ trợ đầy đủ Java Generics là mục tiêu thiết kế cốt lõi, điều mà README nói phần lớn thư viện cạnh tranh khi đó không làm tốt. Mục tiêu này được liệt kê cùng khả năng làm việc với object có sẵn, không thể chỉnh sửa, như lý do thư viện này ra đời.

Giấy phép của Gson là gì?

Gson được phát hành theo giấy phép Apache 2.0, bản quyền thuộc Google Inc. README cũng ghi rõ Gson không phải sản phẩm được Google chính thức hỗ trợ, dù nằm dưới tổ chức google trên GitHub.

Vấn đề mà Gson giải quyết

Trước Gson, việc chuyển một object Java sang JSON thường có hai lựa chọn: tự viết mapping bằng tay, hoặc dùng một thư viện bắt bạn thêm annotation vào mọi class nó chạm tới. Điều đó ổn với code bạn sở hữu. Nhưng nó không ổn với object đến từ một jar bên thứ ba, một module cũ, hay bất cứ thứ gì bạn không thể thêm annotation vào. Câu trả lời của Gson là bỏ hẳn yêu cầu annotation và né kiểu reflection ngại Generics mà một số thư viện khác dùng, để toJson() và fromJson() chạy được trên class đúng như chúng đang tồn tại.

Trường hợp sử dụng phù hợp nhất

  • •Serialize một object từ jar bên thứ ba hoặc module cũ mà bạn không thể thêm annotation vào.
  • •Chuyển đổi cấu trúc dữ liệu lồng sâu hoặc dùng generic nhiều sang JSON và ngược lại mà không cần viết parser tay.
  • •Thêm hỗ trợ JSON vào codebase Java hiện có, nơi refactor từng class để thêm annotation là không khả thi.
  • •Đọc/ghi giá trị date/time của SQL qua adapter tùy chọn của module java.sql.

Nên dùng Gson khi nào — và khi nào nên bỏ qua

Gson phù hợp với developer Java cần serialize những object họ không kiểm soát hoàn toàn — một class từ dependency jar, một module cũ, bất cứ thứ gì không có chỗ để thêm annotation — và muốn hỗ trợ Generics đầy đủ mà không cần cấu hình thêm. Gson là lựa chọn kém với app Android dùng ProGuard/R8 để shrink code, nơi chính README khuyên chuyển sang Kotlin Serialization, và với codebase Kotlin hay Scala dựa nhiều vào non-null type hay constructor có tham số mặc định, vì reflection của Gson có thể đọc sai cả hai.

Nguồn & ghi công

Thông tin và trích dẫn lấy từ README của repository google/gson trên GitHub.

Dữ liệu GitHub · đồng bộ lần cuối 15 thg 8, 2026Đánh giá bởi Henry
← Về TopGit

gson có đáng để bạn bỏ thời gian?

ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về gson.

GitHub