ডেটা সোর্স দিয়ে শুরু করা

এই অংশে 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 কীভাবে চালাতে এবং পরীক্ষা করতে হয় তার নির্দেশাবলী দেওয়া হয়েছে।

যদি আপনি ইতিমধ্যে তা না করে থাকেন, তাহলে পূর্বশর্তসমূহ এবং লাইব্রেরিটি কীভাবে ডাউনলোড ও বিল্ড করতে হয় তার নির্দেশাবলীর জন্য ইনস্টলেশন বিভাগটি দেখুন। আপনার সিস্টেমে যদি আগে থেকে কোনো ওয়েব সার্ভার না থাকে, তবে নিশ্চিত করুন যে আপনি এমন একটি সার্ভার ইনস্টল করেছেন যা সার্ভলেট কন্টেইনার হিসেবেও কাজ করে, যেমন অ্যাপাচি টমক্যাট। এই বিভাগের নির্দেশাবলী বিশেষভাবে উইন্ডোজ সিস্টেমে অ্যাপাচি টমক্যাটের জন্য প্রযোজ্য।

SimpleExampleServlet চালানো এবং পরীক্ষা করার জন্য, একটি ওয়েব অ্যাপ্লিকেশন তৈরি করুন যা SimpleExampleServlet ডেটা সোর্সটি চালায়, তারপর ডেটা সোর্স থেকে কোয়েরি করা ডেটা প্রদর্শনকারী একটি ভিজ্যুয়ালাইজেশনসহ একটি উদাহরণ ওয়েব পেজ চালান। এটি নিম্নলিখিত বিভাগগুলিতে বর্ণনা করা হয়েছে:

• অ্যাপাচি টমক্যাটে একটি ওয়েব অ্যাপ্লিকেশন তৈরি করা
• ডেটা দেখার জন্য একটি ভিজ্যুয়ালাইজেশন ব্যবহার করা

অ্যাপাচি টমক্যাটে একটি ওয়েব অ্যাপ্লিকেশন তৈরি করা

অ্যাপাচি টমক্যাটে একটি ওয়েব অ্যাপ্লিকেশন তৈরি করতে নিচের নির্দেশাবলী অনুসরণ করুন বা প্রয়োজন অনুযায়ী পরিবর্তন করুন। এই নির্দেশাবলী বিশেষভাবে উইন্ডোজ সিস্টেমের অ্যাপাচি টমক্যাটের জন্য প্রযোজ্য:

1. আপনি যে ডিরেক্টরিতে টমক্যাট ইনস্টল করেছেন সেখানে যান। এই ডকুমেন্টে এটিকে <tomcat_home> হিসেবে লেখা হয়েছে।
   
2. webapps সাবডিরেক্টরিতে যান।
   
3. myWebApp নামে একটি সাবডিরেক্টরি তৈরি করুন।
   
4. আপনি এইমাত্র যে সাবডিরেক্টরিটি তৈরি করেছেন সেখানে যান এবং WEB-INF নামে আরেকটি সাবডিরেক্টরি তৈরি করুন।
   
5. WEB-INF সাবডিরেক্টরিতে যান এবং lib নামে আরেকটি সাবডিরেক্টরি তৈরি করুন।
   সম্পূর্ণ পাথটি হবে <tomcat_home>/webapps/myWebApp/WEB-INF/lib ।
   
6. <data_source_library_install>/examples/src/html থেকে web.xml 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.jar এবং visualization-datasource-examples.jar কপি করুন।
   <data_source_library_install> থেকে
   <tomcat_home>/webapps/myWebApp/WEB-INF/lib এ।
   মনে রাখবেন যে, সর্বশেষ ভার্সন নম্বরের উপর নির্ভর করে jar ফাইলের নামের ভার্সন নম্বরটি ভিন্ন হতে পারে।
   
10. Tomcat চালু করুন, অথবা যদি এটি আগে থেকেই চালু থাকে তবে পুনরায় চালু করুন।
    
11. নিম্নলিখিত লিঙ্কে ক্লিক করুন:
    
    http://localhost:8080/myWebApp/simpleexample
    
    আপনার স্ক্রিনের প্রস্থের উপর নির্ভর করে স্ক্রিনে ৬-৭ লাইন লেখা প্রদর্শিত হয়।
    লেখাটি google.visualization.Query.setResponse দিয়ে শুরু হয়।
    এবং /Tiger'},{v:80.0},{v:false}]}]}}); দিয়ে শেষ হয়
    
    এটি সেই ডেটা যা আপনার ডেটা সোর্স থেকে কোনো কোয়েরি করা ভিজ্যুয়ালাইজেশনে ফেরত আসে।

ডেটা দেখার জন্য একটি ভিজ্যুয়ালাইজেশন ব্যবহার করা

<data_source_library_install>/examples/src/html ডিরেক্টরিতে থাকা getting_started.html ফাইলটি ডেটার একটি ভিজ্যুয়ালাইজেশন দেখার জন্য ব্যবহার করা যেতে পারে। getting_started.html থেকে নেওয়া নিম্নলিখিত লাইনটি ব্যবহার করার জন্য সার্ভলেট নির্দিষ্ট করে। অ্যাপাচি টমক্যাটে একটি ওয়েব অ্যাপ্লিকেশন তৈরি করার ধাপ ৮-এ সার্ভলেট ম্যাপিংটি সেট আপ করা হয়েছিল।

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 , আপনি নিম্নলিখিতটি দেখতে পাবেন:
   
   
   
   ব্যাস! আপনি আপনার প্রথম ডেটা সোর্সটি সেট আপ করে ফেলেছেন।

পরবর্তী পদক্ষেপ

পরবর্তী উদাহরণটি ‘একটি বাহ্যিক ডেটা স্টোর ব্যবহার’ বিভাগে বর্ণনা করা হয়েছে। বিকল্পভাবে আপনি ‘ভূমিকা’- তে ফিরে যেতে পারেন, অথবা নিম্নলিখিত লিঙ্কগুলি দেখতে পারেন:

• লাইব্রেরির সর্বাধিক ব্যবহৃত ক্লাসগুলোর পরিচিতির জন্য, মূল ক্লাসসমূহ (Key Classes) দেখুন।
• আপনার নিজস্ব ইভেন্ট প্রবাহ এবং কোয়েরি সক্ষমতা কীভাবে প্রয়োগ করবেন তার একটি উদাহরণের জন্য, "সক্ষমতা এবং ইভেন্ট প্রবাহ নির্ধারণ" দেখুন।
• আপনি যদি DataSourceServlet থেকে ইনহেরিট করতে না চান, তাহলে "Using Your Own Servlet" অংশে বর্ণিত পদ্ধতি অনুযায়ী একটি ডেটা সোর্স ইমপ্লিমেন্ট করতে পারেন। উদাহরণস্বরূপ, আপনি যদি অন্য কোনো ক্লাস থেকে একটি সার্ভলেট ইনহেরিট করেন, তবে আপনি DataSourceServlet থেকে ইনহেরিট করতে নাও চাইতে পারেন।
• আপনি যদি সার্ভলেট ব্যবহার করতে না চান, তাহলে ‘নন-সার্ভলেট ডেটা সোর্স বাস্তবায়ন’ দেখুন।
• অ্যাপ্লিকেশন থেকে ডেটা সোর্সে কিভাবে প্যারামিটার পাস করতে হয়, তা জানতে “Passing Parameters to DataTableGenerator.generateDataTable ” দেখুন।