חבילות כיתות וכיתות מפתח

במבוא לכיתות הנפוצות ביותר, קראו את הכיתות המרכזיות.

לקבלת מבוא לחבילות ספריית ה-Java של מקור הנתונים, לחצו על הקישורים הבאים:

• מקור נתונים
• datasource.base
• datasource.datatable
• datasource.query
• datasource.render
• datasource.util

כיתות מפתח

הכיתות המרכזיות הן 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.