JSON – Góc Học Tập

Giới thiệu

Trong nội dung bài này, chúng ta cùng nhau tìm hiểu kỹ thuật cơ bản trong Java chuyển đổi dữ liệu sang định dạng Json sử dụng bộ thư viện Gson và định dạng XML sử dụng bộ thư viện JAXB.

Những nội dung chính được trình bày trong bài này:

Giới thiệu bộ thư viện Gson.

Giới thiệu bộ thư viện JAXB.

Kỹ thuật đọc / ghi dữ liệu theo định dạng Json sử dụng bộ thư viện Gson.

Kỹ thuật đọc / ghi dữ liệu theo định dạng XML sử dụng bộ thư viện JAXB.

Kế hoạch thực hiện chung

Chúng ta cùng lên kế hoạch thực hiện chung cho nhóm bài này bằng MindMap như sau:

Giới thiệu bộ thư viện Gson

Gson (https://github.com/google/gson) là một bộ thư viện dành cho ngôn ngữ Java, cho phép người sử dụng chuyển đổi một đối tượng Java (lưu trữ dữ liệu) sang định dạng chuỗi Json và có thể chuyển đổi ngược lại từ một chuỗi Json sang một đối tượng Java.

Gson có thể làm việc với các đối tượng Java tùy ý bao gồm các đối tượng hiện có mà không cần có mã nguồn của chúng.

Từ phiên bản 1.6, Gson giới thiệu hai lớp xử lý mới – JsonReader và JsonWriter để cung cấp tiến trình xử lý trực tiếp trên dữ liệu Json.

JsonWriter – Ghi trực tiếp thành Json. Cú pháp để thực thi tổng quan như sau. Chúng ta tạo một đối tượng JsonWriter. Để bắt đầu và kết thúc việc tạo một chuỗi Json, chúng ta sử dụng phương thức beginObject() và endObject(). Trong khoảng giữa việc thực thi hai phương thức này, chúng ta thực hiện việc ghi dữ liệu với những cặp (khóa => giá trị).

JsonWriter writer = new JsonWriter();

writer.beginObject();

writer.name("khóa").value("giá trị");

writer.endObject();

JsonReader – Đọc trực tiếp từ Json. Cú pháp để thực thi tổng quát như sau. Chúng ta tạo một đối tượng JsonReader. Để bắt đầu và kết thúc việc đọc một chuỗi Json, chúng ta sử dụng phương thức beginObject() và endObject(). Trong khoảng giữa việc thực thi hai phương thức này, chúng ta thực hiện việc ghi dữ liệu với những cặp (khóa => giá trị).

JsonReader reader = new JsonReader();

reader.beginObject();

while (reader.hasNext()) {

String name = reader.nextName();

if (name.equals("key")) { String value = reader.nextString(); }

}

reader.endObject();

Gson xử lý trực tiếp nhanh. Tuy nhiên, chúng ta cần xử lý từng cặp (khóa => giá trị) xử lý dữ liệu Json.

Giới thiệu bộ thư viện JAXB

JAXB là viết tắt của Java Architecture for XML Binding, là một thư viện sử dụng các chú thích để chuyển đổi các đối tượng Java thành nội dung XML và ngược lại.

Vì JAXB được định nghĩa thông qua một đặc tả, chúng ta có thể sử dụng các triển khai khác nhau cho tiêu chuẩn này.

Với JAXB, chúng ta thường sử dụng các chú thích cơ bản sau, cụ thể là:

@XmlRootElement: Annotation này chỉ rõ thẻ ngoài cùng của file XML là gì và do đó, nó được khai báo trên đầu một lớp.

@XmlElementWrapper: Annotation này tạo ra một phần tử XML bao quanh một danh sách.

@XmlElement: Annotation này sử dụng để khai báo một thuộc tính của đối tượng là một thẻ của file XML.

@XmlAttribute: Annotation này cũng được sử dụng để khai báo một thuộc tính của đối tượng là một thẻ của file XML.

Cú pháp để thực hiện chung là như sau. Đầu tiên, chúng ta sẽ khởi tạo đối tượng JAXBContext với đối tượng MyObject để chuyển đổi.

JAXBContext jaxbContext = JAXBContext.newInstance(MyObject.class);

Trong đối tượng JAXBContext này, nó có một phương thức để tạo một đối tượng chuyển đổi nội dung XML thành một đối tượng Java, Unmarshaller.

Unmarshaller jaxbUnmarshaller = jaxbContext.createUnmarshaller();

Trong đối tượng JAXBContext này, nó có một phương thức để tạo đối tượng chuyển đổi đối tượng Java thành nội dung XML là Marshaller.

Marshaller marshallerObj = jaxbContext.createMarshaller ();

Thiết lập chương trình

Bước 1.

Chúng ta thực hiện tạo một project Java mới.

Chúng ta đặt tên project là XmlToJsonExample.

Bước 2.

Chúng ta nhấn chuột phải vào tên project.

Chúng ta lựa chọn New → Folder để tạo thư mục mới.

Bước 3.

Màn hình tạo thư mục mới hiện ra.

Chúng ta đặt tên thư mục là data.

Thư mục này sẽ dùng để lưu trữ những file dữ liệu XML và Json sẵn có.

Chúng ta lựa chọn nút Finish để thực hiện.

Bước 4.

Chúng ta thực hiện download file gson-2.8.5.jar tại địa chỉ:

Here

Bước 5.

Chúng ta tiếp tục tạo các thư mục:

Thư mục input và output nằm bên trong thư mục data.

Thư mục lib để lưu trữ các thư viện.

Chúng ta chép file gson-2.8.5.jar vào trong thư mục lib.

Bước 6.

Chúng ta nhấn chuột phải vào tên project.

Chúng ta lựa chọn Properties.

Bước 7.

Màn hình tùy chỉnh Properties hiện ra.

Chúng ta lựa chọn mục Java Build Path và tab Libraries.

Chúng ta lựa chọn nút Add JARs để thực hiện nạp thêm thư viện.

Bước 8.

Màn hình JAR Selection hiện ra.

Chúng ta lựa chọn file gson-2.8.5.jar trong thư mục lib.

Chúng ta lựa chọn nút OK để thực hiện.

Bước 9.

Quay trở lại cửa sổ Properties.

Chúng ta nhận thấy thư viện gson-2.8.5.jar đã được nạp vào project.

Chúng ta lựa chọn nút Apply and Close để thực hiện.

Bước 10.

Màn hình chính của project hiện ra.

Chúng ta nhận thấy trong mục Referenced Libraries đã hiển thị thông tin về thư viện gson-2.8.5.jar.