डेटा सोर्स का इस्तेमाल शुरू करना

इस सेक्शन में SimpleExampleServlet की जानकारी दी गई है. यह लाइब्रेरी में दिए गए डेटा सोर्स को लागू करने का सबसे आसान तरीका है. इस सेक्शन में SimpleExampleServlet को चलाने और उसकी जांच करने के सिलसिलेवार निर्देश भी दिए गए हैं.

• पेश है 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();
    ArrayList cd = 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 पर वेब ऐप्लिकेशन बनाना

Apache Tocat पर वेब ऐप्लिकेशन बनाने के लिए, नीचे दिए गए निर्देशों का पालन करें या उनमें बदलाव करें. ये निर्देश खास तौर पर Windows सिस्टम पर Apache टॉमकैट के लिए होते हैं:

1. उस डायरेक्ट्री पर जाएं जिसमें आपने टॉमकैट इंस्टॉल किया है. यह इस दस्तावेज़ में, <tomcat_home> के तौर पर लिखा गया है.
    
2. webapps सबडायरेक्ट्री पर जाएं.
    
3. myWebApp नाम की सबडायरेक्ट्री बनाएं.
    
4. अभी-अभी बनाई गई सबडायरेक्ट्री में बदलें और WEB-INF नाम की एक सबडायरेक्ट्री बनाएं.
    
5. WEB-INF सबडायरेक्ट्री पर जाएं और libएक दूसरी सबडायरेक्ट्री बनाएं.
   पूरा पाथ <tomcat_home>/webapps/myWebApp/WEB-INF/lib होना चाहिए.
    
6. 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>

7. उस डायरेक्ट्री पर जाएं जिसमें आपने डेटा सोर्स लाइब्रेरी इंस्टॉल की है. यह इस दस्तावेज़ में <data_source_library_install> के रूप में लिखा गया है.
    
8. सभी डिपेंडेंसी पैकेज <tomcat_home>/webapps/myWebApp/WEB-INF/lib पर कॉपी करें. पैकेज <data_source_library_install>/lib में इंस्टॉल किए जाते हैं, बशर्ते आपने उन्हें किसी दूसरी डायरेक्ट्री में न डाला हो.
    
9. अगर आपने खुद लाइब्रेरी बनाई है, तो 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.jarvisualization-datasource-examples.jar और
   को <data_source_library_install>
   से <tomcat_home>/webapps/myWebApp/WEB-INF/lib पर कॉपी करें.
   ध्यान दें कि जार फ़ाइल के नाम में मौजूद वर्शन नंबर, नए वर्शन नंबर के हिसाब से अलग-अलग हो सकता है.
   
10. टॉमकैट शुरू करें या अगर यह पहले से चल रहा है, तो टॉमकैट को रीस्टार्ट करें.
     
11. नीचे दिए गए लिंक पर क्लिक करें:
    
    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');

विज़ुअलाइज़ेशन तय करने और क्वेरी भाषा के लिए, क्वेरी का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, चार्ट और क्वेरी भाषा का संदर्भ देखें.

डेटा सोर्स से मिले डेटा का विज़ुअलाइज़ेशन देखने के लिए, नीचे दिए गए निर्देशों का पालन करें या उनके मुताबिक बदलाव करें:

1. <data_source_library_install>/examples/src/html फ़ाइल
   से getting_started.html फ़ाइल को <tomcat_home>/webapps/myWebApp/ डायरेक्ट्री में कॉपी करें.
    
2. नीचे दिए गए लिंक http://localhost:8080/myWebApp/getting_started.html पर क्लिक करें: आपको यह दिखना चाहिए:
   
   
   
   यह! आपने अपना पहला डेटा सोर्स सेट अप कर लिया है.

अगले चरण

अगला उदाहरण बाहरी डेटा स्टोर का इस्तेमाल करना सेक्शन में बताया गया है. इसके अलावा, आप चाहें, तो परिचय पर वापस लौट सकते हैं या इन लिंक पर जा सकते हैं:

• लाइब्रेरी में सबसे ज़्यादा इस्तेमाल की जाने वाली क्लास के बारे में जानने के लिए, मुख्य क्लास देखें.
• इवेंट के अपने फ़्लो और क्वेरी की क्षमता को लागू करने के तरीके के उदाहरण के लिए, क्षमताएं और इवेंट का फ़्लो तय करना देखें.
• अगर आपको DataSourceServlet से इनहेरिट नहीं करना है, तो आप अपना सर्वे इस्तेमाल करें में बताए गए तरीके से डेटा सोर्स लागू कर सकते हैं. उदाहरण के लिए, हो सकता है कि आप DataSourceServlet से इनहेरिट करना न चाहें.
• अगर आप सर्वलेट का इस्तेमाल नहीं करना चाहते हैं, तो नॉन-सर्लेट डेटा सोर्स लागू करना देखें.
• किसी ऐप्लिकेशन से डेटा सोर्स में पैरामीटर पास करने के तरीके के बारे में जानने के लिए, पैरामीटर को DataTableGenerator.generateDataTable में पास करना देखें.