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

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

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

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

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

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

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

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

تُعد الفئة Query هي الفئة الأساسية لطلبات البيانات، فهي تتعامل مع طلب البحث المرئي.

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

datasource

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

وعلى هذا المستوى الأعلى أيضًا، هناك 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.