חבילות ספרייה ומחלקות של מפתחות

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

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

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

מחלקות מפתח

מחלקות המפתחות הן DataSourceServlet, DataTable, Query ו-DataSourceHelper.

ההטמעה הפשוטה ביותר של הספרייה כוללת ירושה מ-DataSourceServlet, כתיבת הטמעה משלכם של generateDataTable() ולאחר מכן הרצת ההטמעה בתוך servlet. סוג ההטמעה הזה מתואר בקטע תחילת העבודה.

המחלקה DataTable מגדירה את העמודות, סוגי העמודות, התוויות, המזהים והמאפיינים המותאמים אישית של טבלת נתונים.

המחלקה Query היא מחלקת הבסיס לשאילתות נתונים. היא מטפלת בשאילתה שנוצרה בהצגה חזותית.

בתרחישים מורכבים יותר, המחלקה המסייעת DataSourceHelper מספקת קבוצה של פונקציות מסייעות. סוג ההטמעה הזה מתואר במאמר הגדרת יכולות וזרימת האירועים.

datasource

זוהי החבילה ברמה העליונה, והיא מכילה את מחלקות ה-API שאיתם רוב המפתחים של מקורות הנתונים מקיימים אינטראקציה.

גם ברמה העליונה הזו אפשר למצוא את Capabilities, שמשמש להגדרת capabilities של שאילתות במקור הנתונים.

base

החבילה הזו מכילה את כל המחלקות שנמצאות בשימוש ביותר מחבילה אחת כדי למנוע יחסי תלות מעגליים בין החבילות. הפריטים הכי בולטים הם הודעות שגיאה בלוקאל ברירת המחדל של אנגלית (ארה"ב). כדי להפוך את ההטמעה לבינלאומית, תצטרכו לתרגם את ההודעות האלה.

datatable

החבילה הזו מכילה מחלקות שמטפלות במבנה של טבלת נתונים (עמודות, שורות, תאים) ובפונקציונליות (insert, add).

החבילה הזו מכילה גם את החבילה value שמטפלת בערכים ובסוגי הערכים שנתמכים בספרייה. סוגי הערכים הזמינים מוגדרים בספירה של ValueType וכוללים: בוליאני, תאריך, שעה ביום, תאריך ושעה, null, מספר וטקסט. 

query

החבילה הזו מכילה מחלקות שמטפלות בשאילתות, מחלקת הבסיס היא Query. החבילה הזו מכילה גם את החבילות הבאות:

• parser - מחלקות שמטפלות בניתוח שאילתות.
  
• engine - מחלקות שמטפלות בהפעלת שאילתות.
• scalarfunction - מחלקות שמטפלות בפונקציות סקלריות שנעשה בהן שימוש בשאילתה.

render

החבילה הזו מכילה את המחלקות שמעצבות תשובה. למשל:

• CsvRenderer מעבד טבלת נתונים כ-CSV.
• HtmlRenderer מעבד טבלת נתונים כ-HTML.
• JsonRenderer מעבד טבלת נתונים כ-JSON.
• הפונקציה EscapeUtil מאפשרת לסמן מחרוזות בתו בריחה (escape).

util

החבילה הזו מספקת שתי קבוצות של פונקציות מסייעות:

• CsvDataSourceHelper ו-CsvDataSourceException מספקות פונקציות עזרה לשימוש בקובץ CSV כמאגר נתונים, אבל הן לא מספקות הטמעה מלאה של מקור הנתונים. להטמעה לדוגמה, ראו שימוש במאגר נתונים חיצוני.
• SqlDataSourceHelper ו-SqlDatabaseDescription מספקות פונקציות עזרה לשימוש במסד נתוני mySQL כמאגר נתונים, אבל לא מספקות הטמעה מלאה של מקור נתונים. להטמעה לדוגמה, ראו SqlDataSourceServlet בחבילה examples.