حِزم المكتبات والفئات الرئيسية

للاطّلاع على مقدمة عن الفئات الأكثر استخدامًا، يمكنك الاطّلاع على الفئات الرئيسية.

للحصول على مقدمة لحزم مكتبة Java لمصدر البيانات، اتبع الروابط أدناه:

• مصدر البيانات
• datasource.base
• datasource.datatable
• datasource.query
• datasource.render
• datasource.util

الفئات الأساسية

الفئات الرئيسية هي DataSourceServlet وDataTable وQuery وDataSourceHelper.

يتمثل أبسط تنفيذ للمكتبة في الوراثة من DataSourceServlet، وكتابة التنفيذ الخاص بك لـ generateDataTable()، ثم تنفيذ التنفيذ داخل سيرفلت. يتم وصف هذا النوع من التنفيذ في قسم البدء.

تحدد الفئة DataTable الأعمدة وأنواع الأعمدة والتصنيفات وأرقام التعريف والخصائص المخصّصة لجدول بيانات.

الفئة Query هي الفئة الأساسية لطلبات البحث عن البيانات، وتعالج الاستعلام الذي يتم إنشاؤه باستخدام التمثيل المرئي.

بالنسبة إلى حالات الاستخدام الأكثر تعقيدًا، توفّر الفئة المساعدة DataSourceHelper مجموعة من الدوال المساعدة. يتم وصف هذا النوع من التنفيذ في تحديد الإمكانيات وتدفق الأحداث.

datasource

هذه هي حزمة المستوى الأعلى وتحتوي على فئات واجهة برمجة التطبيقات التي يتفاعل معها معظم مطوّري مصادر البيانات.

في هذا المستوى الأعلى أيضًا، تتضمّن السمة Capabilities، وتُستخدَم لتحديد 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.