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

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

पेश है SimpleExampleServlet

SimpleExampleServlet क्लास, examples पैकेज में मौजूद है. यह क्लास, डेटा सोर्स को लागू करने का सबसे आसान उदाहरण देती है. SimpleExampleServlet, DataSourceServlet से इनहेरिट होता है. साथ ही, यह generateDataTable() को लागू करता है और इसे servlet कंटेनर में चलाना ज़रूरी है.

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 Tomcat. इस सेक्शन में दिए गए निर्देश, Windows सिस्टम पर Apache Tomcat के लिए हैं.

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

Apache Tomcat पर वेब ऐप्लिकेशन बनाना

Apache Tomcat पर वेब ऐप्लिकेशन बनाने के लिए, यहां दिए गए निर्देशों का पालन करें या इन्हें अपने हिसाब से बदलें. ये निर्देश, Windows सिस्टम पर Apache Tomcat के लिए हैं:

  1. उस डायरेक्ट्री पर जाएं जिसमें आपने Tomcat इंस्टॉल किया है. इस दस्तावेज़ में इसे <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 में कॉपी करें.

    अगर आपने ज़िप फ़ाइल को अनज़िप कर दिया है, तो <data_source_library_install> से <tomcat_home>/webapps/myWebApp/WEB-INF/lib में visualization-datasource-1.0.2.jar और visualization-datasource-examples.jar
    को कॉपी करें.

    ध्यान दें कि जार फ़ाइल के नाम में मौजूद वर्शन नंबर, नए वर्शन नंबर के हिसाब से अलग-अलग हो सकता है.
     
  10. Tomcat शुरू करें या अगर यह पहले से चल रहा है, तो इसे रीस्टार्ट करें.
     
  11. इस लिंक पर क्लिक करें:

    http://localhost:8080/myWebApp/simpleexample

    स्क्रीन की चौड़ाई के हिसाब से, स्क्रीन पर छह से सात लाइनें दिखती हैं.
    टेक्स्ट, google.visualization.Query.setResponse से शुरू होता है
    और /Tiger'},{v:80.0},{v:false}]}]}}); से खत्म होता है

    यह वह डेटा है जो आपका डेटा सोर्स, क्वेरी करने वाले विज़ुअलाइज़ेशन को दिखाता है.

डेटा देखने के लिए, विज़ुअलाइज़ेशन का इस्तेमाल करना

डेटा का विज़ुअलाइज़ेशन देखने के लिए, getting_started.html डायरेक्ट्री में मौजूद getting_started.html फ़ाइल का इस्तेमाल किया जा सकता है.<data_source_library_install>/examples/src/html getting_started.html से ली गई यह लाइन, इस्तेमाल किए जाने वाले सर्वलेट के बारे में बताती है. सर्वलेट मैपिंग को Apache Tomcat पर वेब ऐप्लिकेशन बनाना लेख के आठवें चरण में सेट अप किया गया था.

var query = new google.visualization.Query('simpleexample');

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

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

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


    बस इतना ही! आपने अपना पहला डेटा सोर्स सेट अप कर लिया है.

अगले चरण

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