इस सेक्शन में SimpleExampleServlet
की जानकारी दी गई है. यह लाइब्रेरी में दिए गए डेटा सोर्स को
लागू करने का सबसे आसान तरीका है. इस सेक्शन में SimpleExampleServlet
को चलाने और उसकी जांच करने के सिलसिलेवार निर्देश भी दिए गए हैं.
पेश है SimpleExampleServlet
SimpleExampleServlet
क्लास, examples
पैकेज में मौजूद है. यह क्लास, डेटा सोर्स को सबसे
आसानी से लागू करने का एक उदाहरण देती है. SimpleExampleServlet
, DataSourceServlet
से इनहेरिट की जाती है,
generateDataTable()
लागू करती है, और इसे सर्वलेट कंटेनर के अंदर
चलना चाहिए.
SimpleExampleServlet
का स्निपेट नीचे दिया गया है. generateDataTable
फ़ंक्शन लाइब्रेरी में डेटा दिखाता है. यह फ़ंक्शन डेटा टेबल का ब्यौरा बनाता है, डेटा टेबल के कॉलम तय करता है, और डेटा टेबल में डेटा भरता है.
लाइब्रेरी, क्वेरी विज़ुअलाइज़ेशन को डेटा टेबल देने के लिए ज़रूरी अन्य सभी कार्रवाइयां मैनेज करती है.
// This example extends DataSourceServlet public class SimpleExampleServlet extends DataSourceServlet { @Override public DataTable generateDataTable(Query query, HttpServletRequest request) { // Create a data table, DataTable data = new DataTable(); ArrayListcd = new ArrayList (); cd.add(new ColumnDescription("name", ValueType.TEXT, "Animal name")); cd.add(new ColumnDescription("link", ValueType.TEXT, "Link to wikipedia")); cd.add(new ColumnDescription("population", ValueType.NUMBER, "Population size")); cd.add(new ColumnDescription("vegeterian", ValueType.BOOLEAN, "Vegetarian?")); data.addColumns(cd); // Fill the data table. try { data.addRowFromValues("Aye-aye", "http://en.wikipedia.org/wiki/Aye-aye", 100, true); data.addRowFromValues("Sloth", "http://en.wikipedia.org/wiki/Sloth", 300, true); data.addRowFromValues("Leopard", "http://en.wikipedia.org/wiki/Leopard", 50, false); data.addRowFromValues("Tiger", "http://en.wikipedia.org/wiki/Tiger", 80, false); } catch (TypeMismatchException e) { System.out.println("Invalid type!"); } return data; } }
SimpleExampleServlet
को चलाना और उसकी जांच करना
इस सेक्शन में, SimpleExampleServlet
को चलाने और उसकी जांच करने के बारे में निर्देश दिए गए हैं.
अगर आपने पहले से ऐसा नहीं किया है, तो ज़रूरी शर्तों के बारे में जानने के लिए, इंस्टॉलेशन सेक्शन देखें. साथ ही, लाइब्रेरी को डाउनलोड करने और बनाने के तरीके से जुड़े निर्देश देखें. अगर आपके सिस्टम में पहले से कोई ऐसा सर्वर नहीं है जो वेब सर्वर की तरह काम करता है, तो आप सर्विंगलेट कंटेनर जैसे Apache टॉमकैट की तरह भी काम कर सकते हैं. इस सेक्शन में दिए गए निर्देश खास तौर पर Windows सिस्टम पर Apache Tomcat के लिए हैं.
SimpleExampleServlet
को चलाने और उसकी जांच करने के लिए, एक ऐसा वेब ऐप्लिकेशन बनाएं जो SimpleExampleServlet
डेटा सोर्स को चलाता है. इसके बाद, डेटा के सोर्स से क्वेरी किए गए डेटा को दिखाने वाले विज़ुअलाइज़ेशन के साथ एक उदाहरण वेब पेज चलाएं. नीचे दिए गए सेक्शन में इसके बारे में बताया गया है:
Apache Tocat पर वेब ऐप्लिकेशन बनाना
Apache Tocat पर वेब ऐप्लिकेशन बनाने के लिए, नीचे दिए गए निर्देशों का पालन करें या उनमें बदलाव करें. ये निर्देश खास तौर पर Windows सिस्टम पर Apache टॉमकैट के लिए होते हैं:
- उस डायरेक्ट्री पर जाएं जिसमें आपने टॉमकैट इंस्टॉल किया है. यह इस दस्तावेज़ में,
<tomcat_home>
के तौर पर लिखा गया है.
webapps
सबडायरेक्ट्री पर जाएं.
myWebApp
नाम की सबडायरेक्ट्री बनाएं.
- अभी-अभी बनाई गई सबडायरेक्ट्री में बदलें और
WEB-INF
नाम की एक सबडायरेक्ट्री बनाएं.
WEB-INF
सबडायरेक्ट्री पर जाएं औरlib
एक दूसरी सबडायरेक्ट्री बनाएं.
पूरा पाथ<tomcat_home>/webapps/myWebApp/WEB-INF/lib
होना चाहिए.
web.xml
को<data_source_library_install>/examples/src/html
सेWEB-INF
डायरेक्ट्री में कॉपी करें. जहां<data_source_library_install>
वह डायरेक्ट्री है जिसमें आपने डेटा सोर्स लाइब्रेरी इंस्टॉल की थी.web.xml
में नीचे दी गई लाइनेंSimpleExampleServlet
को परिभाषित करती हैं और मैप करती हैं:
<servlet> <servlet-name>My Servlet</servlet-name> <description>My servlet description.</description> <servlet-class>SimpleExampleServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>My Servlet</servlet-name> <url-pattern>/simpleexample</url-pattern> </servlet-mapping>
- उस डायरेक्ट्री पर जाएं जिसमें आपने डेटा सोर्स लाइब्रेरी इंस्टॉल की है.
यह इस दस्तावेज़ में
<data_source_library_install>
के रूप में लिखा गया है.
- सभी डिपेंडेंसी पैकेज
<tomcat_home>/webapps/myWebApp/WEB-INF/lib
पर कॉपी करें. पैकेज<data_source_library_install>/lib
में इंस्टॉल किए जाते हैं, बशर्ते आपने उन्हें किसी दूसरी डायरेक्ट्री में न डाला हो.
- अगर आपने खुद लाइब्रेरी बनाई है, तो
visualization-datasource-1.0.2.jar
औरvisualization-datasource-examples.jar
को<data_source_library_install>/build
से<tomcat_home>/webapps/myWebApp/WEB-INF/lib
में कॉपी करें.
अगर आपने ज़िप फ़ाइल को अनज़िप किया है, तोvisualization-datasource-1.0.2.jar
visualization-datasource-examples.jar
और
को<data_source_library_install>
से<tomcat_home>/webapps/myWebApp/WEB-INF/lib
पर कॉपी करें.
ध्यान दें कि जार फ़ाइल के नाम में मौजूद वर्शन नंबर, नए वर्शन नंबर के हिसाब से अलग-अलग हो सकता है. - टॉमकैट शुरू करें या अगर यह पहले से चल रहा है, तो टॉमकैट को रीस्टार्ट करें.
- नीचे दिए गए लिंक पर क्लिक करें:
http://localhost:8080/myWebApp/Simpleexample
स्क्रीन पर मौजूद टेक्स्ट की चौड़ाई के हिसाब से, स्क्रीन पर टेक्स्ट के लिए 6 से 7 लाइनें दिखती हैं.
टेक्स्टgoogle.visualization.Query.setResponse
से शुरू होता है और/Tiger'},{v:80.0},{v:false}]}]}});
पर खत्म होता है
यह वह डेटा है जिसे आपके डेटा सोर्स ने क्वेरी करने के विज़ुअलाइज़ेशन के ज़रिए लौटाया है.
डेटा देखने के लिए विज़ुअलाइज़ेशन का इस्तेमाल करना
<data_source_library_install>/examples/src/html
डायरेक्ट्री में मौजूद getting_started.html
फ़ाइल का इस्तेमाल करके, डेटा का विज़ुअलाइज़ेशन देखा जा सकता है. नीचे दी गई लाइन, getting_started.html
से ली गई
है. इससे यह पता चलता है कि
सर्वलेट का इस्तेमाल कैसे करना है. सर्वलेट मैपिंग को Apache टॉमकैट पर वेब ऐप्लिकेशन बनाना के आठवें चरण में सेट अप किया गया था.
var query = new google.visualization.Query('simpleexample');
विज़ुअलाइज़ेशन तय करने और क्वेरी भाषा के लिए, क्वेरी का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, चार्ट और क्वेरी भाषा का संदर्भ देखें.
डेटा सोर्स से मिले डेटा का विज़ुअलाइज़ेशन देखने के लिए, नीचे दिए गए निर्देशों का पालन करें या उनके मुताबिक बदलाव करें:
<data_source_library_install>/examples/src/html
फ़ाइल
सेgetting_started.html
फ़ाइल को<tomcat_home>/webapps/myWebApp/
डायरेक्ट्री में कॉपी करें.
- नीचे दिए गए लिंक http://localhost:8080/myWebApp/getting_started.html पर क्लिक करें:
आपको यह दिखना चाहिए:
यह! आपने अपना पहला डेटा सोर्स सेट अप कर लिया है.
अगले चरण
अगला उदाहरण बाहरी डेटा स्टोर का इस्तेमाल करना सेक्शन में बताया गया है. इसके अलावा, आप चाहें, तो परिचय पर वापस लौट सकते हैं या इन लिंक पर जा सकते हैं:
- लाइब्रेरी में सबसे ज़्यादा इस्तेमाल की जाने वाली क्लास के बारे में जानने के लिए, मुख्य क्लास देखें.
- इवेंट के अपने फ़्लो और क्वेरी की क्षमता को लागू करने के तरीके के उदाहरण के लिए, क्षमताएं और इवेंट का फ़्लो तय करना देखें.
- अगर आपको
DataSourceServlet
से इनहेरिट नहीं करना है, तो आप अपना सर्वे इस्तेमाल करें में बताए गए तरीके से डेटा सोर्स लागू कर सकते हैं. उदाहरण के लिए, हो सकता है कि आपDataSourceServlet
से इनहेरिट करना न चाहें. - अगर आप सर्वलेट का इस्तेमाल नहीं करना चाहते हैं, तो नॉन-सर्लेट डेटा सोर्स लागू करना देखें.
- किसी ऐप्लिकेशन से डेटा सोर्स में पैरामीटर पास करने के तरीके के बारे में जानने के लिए, पैरामीटर को
DataTableGenerator.generateDataTable
में पास करना देखें.