लाइब्रेरी पैकेज और मुख्य क्लास

सबसे ज़्यादा इस्तेमाल की जाने वाली क्लास के बारे में जानने के लिए, मुख्य क्लास देखें.

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, डेटा टेबल को एचटीएमएल के तौर पर रेंडर करता है.
• JsonRenderer, डेटा टेबल को JSON के तौर पर रेंडर करता है.
• EscapeUtil स्ट्रिंग एस्केप करने के लिए एक उपयोगिता प्रदान करता है.

util

यह पैकेज हेल्पर फ़ंक्शन के दो सेट देता है:

• CsvDataSourceHelper और CsvDataSourceException, CSV फ़ाइल को डेटा स्टोर के तौर पर इस्तेमाल करने के लिए सहायक फ़ंक्शन उपलब्ध कराते हैं, लेकिन वे डेटा सोर्स को पूरी तरह से लागू नहीं करते. लागू करने के उदाहरण के लिए, बाहरी डेटा स्टोर का इस्तेमाल करना देखें.
• SqlDataSourceHelper और SqlDatabaseDescription, mySQL डेटाबेस को डेटा स्टोर के तौर पर इस्तेमाल करने में मदद करने वाले फ़ंक्शन उपलब्ध कराते हैं, लेकिन ये डेटा सोर्स को पूरी तरह लागू नहीं करते. लागू करने के उदाहरण के लिए, examples पैकेज में SqlDataSourceServlet देखें.