Paket Library dan Class Utama

Untuk pengantar tentang class yang paling sering digunakan, lihat class kunci.

Untuk pengantar paket library Java sumber data, ikuti link di bawah ini:

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 dan CsvDataSourceException 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 dan SqlDatabaseDescription menyediakan fungsi bantuan untuk menggunakan database mySQL sebagai penyimpanan data, keduanya tidak menyediakan implementasi lengkap sumber data. Untuk contoh implementasi, lihat SqlDataSourceServlet dalam paket examples.