במבוא לכיתות הנפוצות ביותר, קראו את הכיתות המרכזיות.
לקבלת מבוא לחבילות ספריית ה-Java של מקור הנתונים, לחצו על הקישורים הבאים:
כיתות מפתח
הכיתות המרכזיות הן DataSourceServlet
, DataTable
, Query
ו-DataSourceHelper
.
הדרך הפשוטה ביותר ליישם את הספרייה היא בירושה מ-DataSourceServlet
, כתיבת הטמעה משלכם של generateDataTable()
ואז הטמעת הקובץ בתוך שרת. הטמעה כזו מתוארת בקטע תחילת העבודה.
הכיתה DataTable
מגדירה את העמודות, סוגי העמודות, התוויות, המזהים והמאפיינים המותאמים אישית של טבלת נתונים.
מחלקת Query
היא המחלקה הבסיסית לשאילתות נתונים, והיא מטפלת בשאילתה שנוצרת על ידי ויזואליזציה.
בתרחישים מורכבים יותר, מחלקת העזרה DataSourceHelper
מספקת קבוצה של פונקציות עזר. הטמעה של הסוג הזה מפורטת במאמר הגדרה של יכולות וזרימת אירועים.
datasource
זוהי החבילה ברמה העליונה, שמכילה את המחלקות של ממשקי ה-API שאיתן רוב המפתחים של מקורות הנתונים מקיימים אינטראקציה.
הרמה העליונה היא גם Capabilities
, המשמשת להגדרת היכולות של מקור הנתונים.
base
החבילה הזו מכילה את כל הכיתות שבהן נעשה שימוש ביותר מחבילה אחת כדי למנוע יחסי תלות מעגליים בין החבילות. הפריטים הבולטים ביותר הם הודעות שגיאה במיקום ברירת המחדל באנגלית של ארה"ב. כדי לתרגם את ההטמעה באופן בינלאומי, צריך לתרגם את ההודעות האלו.
datatable
החבילה הזו מכילה מחלקות שמטפלות במבנה של טבלת נתונים (עמודות, שורות, תאים) ופונקציונליות (הוספה, הוספה).
החבילה הזו כוללת גם את החבילה value
שמטפלת בערכים ובסוגי ערכים שנתמכים על ידי הספרייה. סוגי הערכים הזמינים מוגדרים בספירה של ValueType
וכוללים: ערך בוליאני, תאריך, שעה, תאריך ושעה, ריק, מספר וטקסט.
query
החבילה הזו מכילה קורסים שמטפלים בשאילתות, ומחלקת הבסיס היא Query
.
חבילה זו מכילה גם את החבילות הבאות:
parser
– קורסים שמטפלים בניתוח שאילתות.
engine
– כיתות שמטפלות בביצוע שאילתות.scalarfunction
– מחלקות שמטפלות בפונקציות סקלריות שמופיעות בשאילתה.
render
החבילה הזו מכילה את המחלקות שמגדירות תגובה. למשל:
CsvRenderer
מעבדת טבלת נתונים כקובץ CSV.HtmlRenderer
מעבדת טבלת נתונים כ-HTML.JsonRenderer
מעבדת טבלת נתונים כקובץ JSON.- הפונקציה
EscapeUtil
מספקת כלי עזר לבריחה ממחרוזות.
util
החבילה הזו מספקת שתי קבוצות של פונקציות עזר:
CsvDataSourceHelper
ו-CsvDataSourceException
הן פונקציות מועילות שאפשר להשתמש בהן בקובץ CSV כמאגר נתונים. הן לא מספקות הטמעה מלאה של מקור נתונים. להטמעה לדוגמה, ראו שימוש במאגר נתונים חיצוני.- האפליקציות
SqlDataSourceHelper
ו-SqlDatabaseDescription
מספקות פונקציות עוזרות לשימוש במסד נתונים של mySQL כמאגר נתונים, הן לא מספקות הטמעה מלאה של מקור נתונים. להטמעה לדוגמה, ראוSqlDataSourceServlet
בחבילה שלexamples
.