Để biết giới thiệu về các lớp thường dùng nhất, hãy xem các lớp khoá.
Để xem giới thiệu về các gói thư viện Java nguồn dữ liệu, hãy truy cập vào các đường liên kết dưới đây:
- nguồn dữ liệu
- datasource.base
- datasource.datatable
- datasource.query
- datasource.render
- datasource.util
Các lớp chính
Các lớp khoá là DataSourceServlet, DataTable, Query và DataSourceHelper.
Cách triển khai đơn giản nhất của thư viện bao gồm việc kế thừa từ DataSourceServlet, viết phương thức triển khai generateDataTable() của riêng bạn, sau đó chạy quy trình triển khai trong một servlet. Phương thức triển khai này được mô tả trong phần Bắt đầu.
Lớp DataTable xác định các cột, loại cột, nhãn, mã nhận dạng và thuộc tính tuỳ chỉnh của một bảng dữ liệu.
Lớp Query là lớp cơ sở cho các truy vấn dữ liệu, lớp này xử lý truy vấn được tạo bằng hình ảnh trực quan.
Đối với các trường hợp sử dụng phức tạp hơn, lớp trợ giúp DataSourceHelper cung cấp một tập hợp các hàm trợ giúp. Hình thức triển khai này được mô tả trong phần Xác định khả năng và luồng sự kiện.
datasource
Đây là gói cấp cao nhất và chứa các lớp API mà hầu hết các nhà phát triển nguồn dữ liệu có thể tương tác.
Ngoài ra ở cấp cao nhất này là Capabilities, dùng để xác định capabilities truy vấn của nguồn dữ liệu.
base
Gói này chứa tất cả các lớp mà nhiều gói sử dụng để ngăn chặn các phần phụ thuộc vòng tròn giữa các gói. Các mục đáng chú ý nhất là thông báo lỗi bằng ngôn ngữ mặc định là tiếng Anh (Mỹ). Để quốc tế hoá cách triển khai, bạn sẽ cần dịch các thông báo này.
datatable
Gói này chứa các lớp xử lý cấu trúc bảng dữ liệu (cột, hàng, ô) và chức năng (chèn, thêm).
Gói này cũng chứa gói value xử lý các giá trị và kiểu giá trị được thư viện hỗ trợ. Các loại giá trị có sẵn được xác định trong bản liệt kê ValueType và bao gồm: boolean, ngày, giờ trong ngày, ngày và giờ, rỗng, số và văn bản.
query
Gói này chứa các lớp xử lý truy vấn, lớp cơ sở là Query.
Gói này cũng chứa các gói sau:
parser– các lớp xử lý phân tích cú pháp truy vấn.
engine– các lớp xử lý việc thực thi truy vấn.scalarfunction– các lớp xử lý hàm vô hướng dùng trong truy vấn.
render
Gói này chứa các lớp định dạng một phản hồi. Ví dụ:
CsvRendererhiển thị bảng dữ liệu dưới dạng CSV.HtmlRendererkết xuất bảng dữ liệu dưới dạng HTML.JsonRendererkết xuất bảng dữ liệu ở dạng JSON.EscapeUtilcung cấp một tiện ích cho các chuỗi thoát.
util
Gói này cung cấp 2 bộ chức năng trợ giúp:
CsvDataSourceHelpervàCsvDataSourceExceptioncung cấp các chức năng trợ giúp để sử dụng tệp CSV làm kho dữ liệu. Các chức năng này không cung cấp cách triển khai nguồn dữ liệu hoàn chỉnh. Để tham khảo ví dụ về cách triển khai, hãy xem bài viết Sử dụng Kho dữ liệu bên ngoài.SqlDataSourceHelpervàSqlDatabaseDescriptioncung cấp các hàm trợ giúp để sử dụng cơ sở dữ liệu mySQL làm kho lưu trữ dữ liệu. Chúng không cung cấp cách triển khai nguồn dữ liệu hoàn chỉnh. Để tham khảo ví dụ về cách triển khai, hãy xemSqlDataSourceServlettrong góiexamples.