Untuk pengantar tentang class yang paling sering digunakan, lihat class kunci.
Untuk pengantar paket library Java sumber data, ikuti link di bawah ini:
- sumber data
- sumber data.base
- datasource.datatable
- datasource.query
- sumber data.render
- sumber data.util
Kelas Penting
Class utamanya adalah DataSourceServlet
, DataTable
, Query
, dan DataSourceHelper
.
Implementasi library yang paling sederhana melibatkan pewarisan dari DataSourceServlet
,
menulis implementasi Anda sendiri untuk generateDataTable()
, lalu
menjalankan implementasi dalam servlet. Jenis penerapan ini
dijelaskan di bagian Memulai
.
Class DataTable
menentukan kolom, jenis kolom,
label, ID, dan properti kustom untuk tabel data.
Class Query
adalah class dasar untuk kueri data, class ini
menangani kueri yang dihasilkan visualisasi.
Untuk kasus penggunaan
yang lebih kompleks, class helper DataSourceHelper
menyediakan
serangkaian fungsi bantuan. Jenis penerapan ini
dijelaskan dalam Menentukan Kemampuan dan Alur Peristiwa.
datasource
Ini adalah paket level atas dan berisi class API tempat sebagian besar developer sumber data berinteraksi.
Juga di tingkat teratas ini adalah Capabilities
, yang
digunakan untuk menentukan kemampuan kueri sumber data.
base
Paket ini berisi semua class yang digunakan oleh lebih dari satu paket untuk mencegah dependensi melingkar antar-paket. Item yang paling penting adalah pesan error dalam lokalitas default bahasa Inggris AS. Untuk menginternasionalkan implementasi, Anda perlu menerjemahkan pesan ini.
datatable
Paket ini berisi class yang menangani struktur tabel data (kolom, baris, sel) dan fungsi (masukkan, tambahkan).
Paket ini juga berisi paket value
yang menangani
nilai dan jenis nilai yang didukung oleh library. Jenis nilai yang tersedia
ditentukan dalam enumerasi ValueType
dan mencakup: boolean,
tanggal, waktu, tanggal dan waktu, null, angka, dan teks.
query
Paket
ini berisi class yang menangani kueri, class dasarnya adalah Query
.
Paket ini juga berisi paket berikut:
parser
- class yang menangani penguraian kueri.
engine
- class yang menangani eksekusi kueri.scalarfunction
- class yang menangani fungsi skalar yang digunakan dalam kueri.
render
Paket ini berisi class yang memformat respons. Contoh:
CsvRenderer
merender tabel data sebagai CSV.HtmlRenderer
merender tabel data sebagai HTML.JsonRenderer
merender tabel data sebagai JSON.EscapeUtil
menyediakan utilitas untuk meng-escape string.
util
Paket ini menyediakan dua kumpulan fungsi bantuan:
CsvDataSourceHelper
danCsvDataSourceException
menyediakan fungsi bantuan untuk menggunakan file CSV sebagai penyimpanan data, keduanya tidak menyediakan implementasi sumber data yang lengkap. Untuk contoh implementasi, lihat Menggunakan Penyimpanan Data Eksternal.SqlDataSourceHelper
danSqlDatabaseDescription
menyediakan fungsi bantuan untuk menggunakan database mySQL sebagai penyimpanan data, keduanya tidak menyediakan implementasi lengkap sumber data. Untuk contoh implementasi, lihatSqlDataSourceServlet
dalam paketexamples
.