Để biết giới thiệu về các lớp thường dùng nhất, hãy xem các lớp chính.
Để xem giới thiệu về các gói thư viện Java nguồn dữ liệu, hãy truy cập 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 chính là DataSourceServlet
, DataTable
,
Query
và DataSourceHelper
.
Cách triển khai thư viện đơn giản nhất bao gồm việc kế thừa từ DataSourceServlet
, viết cách triển khai generateDataTable()
của riêng bạn, rồi chạy phương thức triển khai trong GVP. Loại triển khai này được mô tả trong mục 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 cho bảng dữ liệu.
Lớp Query
là lớp cơ sở để truy vấn dữ liệu, lớp này xử lý một truy vấn do hình ảnh tạo ra.
Đối với các trường hợp sử dụng phức tạp hơn, lớp trình trợ giúp DataSourceHelper
sẽ cung cấp một tập hợp các hàm trợ giúp. Loại 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 nhà phát triển nguồn dữ liệu tương tác.
Ngoài ra, ở cấp cao nhất này còn có Capabilities
, được dùng để xác định khả năng 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 các phần phụ thuộc tuần hoà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 trong tiếng Anh (Mỹ). Để quốc tế hoá hoạt động triển khai, bạn 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à loại giá trị mà thư viện hỗ trợ. Các loại giá trị có sẵn được xác định trong bảng liệt kê ValueType
và bao gồm: boolean, ngày, giờ trong ngày, ngày và giờ, giá trị 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ý việc 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ý các hàm vô hướng được dùng trong một truy vấn.
render
Gói này chứa các lớp định dạng nội dung phản hồi. Ví dụ:
CsvRenderer
sẽ hiển thị một bảng dữ liệu dưới dạng CSV.HtmlRenderer
sẽ hiển thị một bảng dữ liệu dưới dạng HTML.JsonRenderer
sẽ hiển thị một bảng dữ liệu dưới dạng JSON.EscapeUtil
cung cấp một tiện ích để thoát chuỗi.
util
Gói này cung cấp 2 nhóm hàm trợ giúp:
CsvDataSourceHelper
vàCsvDataSourceException
cung cấp các chức năng trợ giúp để sử dụng tệp CSV làm kho dữ liệu, không cung cấp cách triển khai đầy đủ nguồn dữ liệu. Để xem ví dụ về cách triển khai, hãy xem phần Sử dụng Kho dữ liệu bên ngoài.SqlDataSourceHelper
vàSqlDatabaseDescription
cung cấp các hàm trợ giúp để sử dụng cơ sở dữ liệu mySQL dưới dạng kho lưu trữ dữ liệu, chứ không cung cấp phương thức triển khai đầy đủ nguồn dữ liệu. Để tìm hiểu ví dụ về quá trình triển khai, hãy xemSqlDataSourceServlet
trong góiexamples
.