लाइब्रेरी पैकेज और की क्लास

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

डेटा सोर्स Java लाइब्रेरी पैकेज के बारे में जानने के लिए, नीचे दिए गए लिंक पर जाएं:

• डेटा सोर्स
• datasource.base
• datasource.datatable
• datasource.query
• datasource.रेंडर करें
• datasource.util

खास क्लास

कुंजी क्लास DataSourceServlet, DataTable, Query, और DataSourceHelper हैं.

लाइब्रेरी को लागू करने की प्रोसेस सबसे आसान है. इसमें DataSourceServlet का इस्तेमाल किया जाता है. इसके लिए, generateDataTable() को अपने हिसाब से लिखा जाता है और फिर सर्वलेट में उसे लागू किया जाता है. इस तरह के लागू करने के तरीके के बारे में शुरू करना सेक्शन में बताया गया है.

DataTable क्लास किसी डेटा टेबल के कॉलम, कॉलम टाइप, लेबल, आईडी, और कस्टम प्रॉपर्टी के बारे में बताती है.

Query क्लास, डेटा क्वेरी का बेस क्लास है. यह विज़ुअलाइज़ेशन से जनरेट की गई क्वेरी को हैंडल करती है.

ज़्यादा जटिल इस्तेमाल के उदाहरणों के लिए, हेल्पर क्लास DataSourceHelper हेल्पर फ़ंक्शन का एक सेट देती है. इस तरह के लागू करने के तरीके के बारे में तय करने की क्षमताएं और इवेंट के फ़्लो में बताया गया है.

datasource

यह टॉप लेवल पैकेज है और इसमें वे एपीआई क्लास शामिल हैं जिनसे ज़्यादातर डेटा सोर्स डेवलपर इंटरैक्ट करते हैं.

साथ ही, 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 देखें.