JiBX 1.2, Phần 1: Từ mã Java thành lược đồ XML Cải thiện chất lượng lược đồ bằng phép biến đổi tùy

JiBX 1.2, Phần 1: Từ mã Java thành lược đồ XML

Cải thiện chất lượng lược đồ bằng phép biến đổi tùy chỉnh các mô hình dữ liệu

Java thành tài liệu XML và từ tài liệu XML

Dennis Sosnoski, Nhà tư vấn, Sosnoski Software Solutions, Inc.

Tóm tắt: Các định nghĩa lược đồ XML là cơ sở cho nhiều kiểu trao đổi dữ liệu,

bao gồm hầu hết các dạng dịch vụ web. Nhưng lược đồ XML là một tiêu chuẩn

phức tạp và hầu hết các công cụ để tạo và sửa đổi các định nghĩa lược đồ không đủ

mạnh mẽ hay dễ sử dụng như các công cụ để làm việc với mã Java™. Các đặc tính

mới của JiBX 1.2 mà bạn sẽ tìm hiểu về nó trong hướng dẫn này — Phần 1 của

một loạt bài viết có hai phần — cho phép bạn bắt đầu từ mã Java và dễ dàng tạo ra

các định nghĩa lược đồ có chất lượng khớp với các cấu trúc dữ liệu của bạn. Sau

đó bạn có thể sử dụng trực tiếp các lược đồ này, dù bạn có sử dụng liên kết dữ liệu

JiBX hay không.

Trước khi bạn bắt đầu

Về hướng dẫn này

JiBX là một công cụ để liên kết dữ liệu XML với các đối tượng Java. Liên kết dữ

liệu JiBX đã được biết đến từ lâu như là cách tiếp cận nhanh nhất và linh hoạt nhất

để liên kết mã Java tới XML. Nhưng sự phức tạp của các định nghĩa liên kết JiBX

và sự hỗ trợ còn hạn chế của nó với các định nghĩa lược đồ XML đang được sử

dụng ngày càng rộng rãi hơn đã làm cho những người dùng thất vọng nhiều lần.

May mắn thay, phiên bản 1.2 của JiBX đã tiến một bước dài theo hướng loại bỏ

những vấn đề này. Trong hướng dẫn này, bạn sẽ tìm hiểu về việc sử dụng các đặc

tính mới của JiBX 1.2 để tạo ra các định nghĩa lược đồ XML một cách dễ dàng từ

mã Java hiện có và để đọc và viết các tài liệu khớp với các định nghĩa lược đồ đã

tạo ra — hoàn toàn không cần phải đi vào các chi tiết của các định nghĩa liên kết

của JiBX. Phần 2 trình bày nửa còn lại của vấn đề: bắt đầu từ các định nghĩa lược

đồ XML và tạo mã Java.

Mục tiêu

Hướng dẫn này chỉ dẫn cho bạn về quá trình sử dụng JiBX để tạo ra các định

nghĩa lược đồ XML từ mã Java. Đầu tiên, bạn sẽ thấy làm thế nào để bắt đầu với

một mô hình dữ liệu Java đơn giản và tạo ra một lược đồ mặc định khớp với mô

hình đó. Trên cơ sở đó, bạn sẽ tìm hiểu cách làm thế nào để bạn có thể dễ dàng áp

dụng một loạt các tuỳ chỉnh để kiểm soát các giá trị thực tế đã sử dụng trong các

lớp Java của bạn và cách làm thế nào để truy cập chúng, cho dù chúng là cần phải

có (required) hay tùy chọn (optional); để kiểm soát các tên và các không gian tên

(namespaces) được sử dụng trong XML và thậm chí để kiểm soát cấu trúc của các

định nghĩa lược đồ đã tạo ra. Đồng thời, bạn sẽ thấy JiBX tăng thêm giá trị cho các

lược đồ bạn đã tạo ra như thế nào khi sử dụng những công sức đầu tư của bạn vào

Javadocs để làm tài liệu về định nghĩa lược đồ một cách tự động. Sau khi đọc

hướng dẫn này và thực hiện các ví dụ được cung cấp, bạn sẽ có khả năng sử dụng

JiBX để tạo ra các định nghĩa lược đồ XML có chất lượng từ các lớp cấu trúc dữ

liệu Java riêng của bạn.

Các điều kiện cần có trước

Để hiểu được hướng dẫn này, bạn ít nhất nên có các kiến thức cơ bản về cả mã

Java và XML. Bạn không cần phải hiểu biết chi tiết về các định nghĩa lược đồ

XML nhưng sự quen thuộc với các lược đồ sẽ giúp bạn hiểu các ví dụ tốt hơn.

Các yêu cầu hệ thống

Để chạy các ví dụ này, bạn cần phải cài đặt:

 Cả hai:

o Sun's JDK 1.5.0_09 (hoặc mới hơn).

o Bộ dụng cụ của nhà phát triển của IBM cho công nghệ Java 1.5.0

SR3..

 Một phiên bản mới đây của công cụ xây dựng Apache Ant.

Các hướng dẫn tải về và cài đặt JiBX có trong hướng dẫn này.

Bắt đầu

Trong phần này, bạn sẽ có được cái nhìn tổng quan về JiBX và bạn sẽ cài đặt JiBX

và mã lệnh mẫu của hướng dẫn này.

Giới thiệu JiBX

JiBX là một trong nhiều công cụ dùng để chuyển đổi giữa các cấu trúc dữ liệu

Java và các tài liệu XML (Tài nguyên). Cái làm nên sự khác biệt của JiBX so với

những công cụ khác là các đặc tính linh hoạt và hiệu năng. Hiệu năng của JiBX

luôn được đánh giá ở vị trí cao nhất trong lĩnh vực này, vượt quá hai lần hoặc hơn

nữa so với hiệu năng của các công cụ phổ biến khác (như JAXB 2.0 chẳng hạn).

JiBX cũng linh hoạt hơn hầu hết tất cả các công cụ Java-XML khác, khi sử dụng

các định nghĩa liên kết để tách các cấu trúc Java khỏi biểu diễn XML sao cho từng

cái có thể được thay đổi độc lập với cái kia.

Với bản phát hành 1.2, JiBX bổ sung thêm các đặc tính hỗ trợ các định nghĩa lược

đồ XML. Bạn có thể sử dụng các công cụ kèm theo trong bản phát hành JiBX để

tạo ra một định nghĩa lược đồ khớp với mã Java của bạn hoặc để tạo mã Java khớp

với định nghĩa lược đồ của bạn. Dù bằng cách nào, bạn cũng nhận được một định

nghĩa liên kết để cho phép bạn sử dụng JiBX để chuyển đổi giữa các mã Java và

các tài liệu XML khớp với định nghĩa lược đồ. Trong hướng dẫn này, bạn sẽ thấy

cách làm thế nào để áp dụng kiểu tạo mã đầu tiên: từ mã Java sinh ra định nghĩa

lược đồ.

Cài đặt JiBX

Bạn cần phải cài đặt JiBX trước khi tiếp tục thực hiện hướng dẫn này. Hãy tải về

bản ZIP phân phối mới nhất 1.2.x và giải nén nó vào một chỗ thuận tiện trên hệ

thống của bạn. Xong việc, bạn sẽ nhận được một thư mục có tên là jibx, trong đó

có chứa tất cả các tệp JiBX JAR, tài liệu hướng dẫn, các ví dụ và thậm chí cả mã

nguồn.

Cài đặt mã nguồn các ví dụ của hướng dẫn này

Bây giờ hãy tải về các mã mẫu, của hướng dẫn này, cũng được cung cấp dưới

dạng một tệp tin ZIP. Cách dễ nhất để cài đặt nó trên hệ thống của bạn là giải nén

tệp tin ZIP vào thư mục gốc của bản phân phối JiBX của bạn (hoặc trên

Windows®, sao chép thư mục dwcode1 từ bên trong tệp tin ZIP này vào thư mục

gốc bản phân phối JiBX của bạn). Điều này sẽ tạo ra một thư mục con dwcode1

trong thư mục jibx, với các tệp tin ví dụ (bao gồm cả các tệp tin build.xml,

custom1.xml và các tệp tin khác) bên trong thư mục con dwcode1 đó.

Mã mẫu bao gồm một tệp tin xây dựng Ant Apache để tự động hoá cho chạy các

công cụ JiBX và xử lý các bước khác có trong các ví dụ. Nếu bạn cài đặt các mã

mẫu trực tiếp vào thư mục cài đặt của JiBX, công cụ xây dựng (build) có thể truy

cập các tệp JiBX JAR mà không cần thêm bất kỳ cấu hình nào. Nếu bạn cài đặt

các mã mẫu ở nơi khác, bạn vẫn có thể sử dụng công cụ xây dựng Ant. Trong

trường hợp này, bạn chỉ cần thiết lập một biến môi trường JIBX_HOME chỉ rõ

đường dẫn đến bản cài đặt JiBX của bạn. Ngoài ra, một cách khác là bạn có thể

chỉnh sửa các tệp tin build.xml-bên trong thư mục mã mẫu và bỏ dấu chú thích ở

đầu các dòng phía trên cùng của tệp tin, nơi trực tiếp thiết lập các thuộc tính jibx￾home.