เริ่มต้นใช้งานแหล่งข้อมูล

ส่วนนี้จะแนะนํา 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 Tomcat หากยังไม่ได้ติดตั้งในระบบ วิธีการในส่วนนี้มีไว้สําหรับ Apache Tomcat ในระบบ Windows โดยเฉพาะ

หากต้องการเรียกใช้และทดสอบ SimpleExampleServlet ให้สร้างเว็บแอปพลิเคชัน ที่เรียกใช้แหล่งข้อมูล SimpleExampleServlet จากนั้นเรียกใช้หน้าเว็บตัวอย่างที่มีภาพแสดงข้อมูลที่สอบถามจากแหล่งข้อมูล ซึ่งอธิบายไว้ในส่วนต่อไปนี้

การสร้างเว็บแอปพลิเคชันบน Apache Tomcat

ทําตามหรือปรับวิธีการด้านล่างนี้เพื่อสร้างเว็บแอปพลิเคชันใน Apache Tomcat วิธีการเหล่านี้ใช้สําหรับ Apache Tomcat ในระบบ Windows โดยเฉพาะ

  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

    หากแตกไฟล์ ZIP แล้ว ให้คัดลอก visualization-datasource-1.0.2.jar และ visualization-datasource-examples.jar
    จาก <data_source_library_install>
    ไปยัง <tomcat_home>/webapps/myWebApp/WEB-INF/lib
    โปรดทราบว่าหมายเลขเวอร์ชันในชื่อไฟล์ jar อาจแตกต่างกันไปตามหมายเลขเวอร์ชันล่าสุด
  10. เริ่ม Tomcat หรือรีสตาร์ท Tomcat ถ้าทํางานอยู่แล้ว
     
  11. คลิกลิงก์ต่อไปนี้

    http://localhost:8080/myWebApp/Simpleexample

    หน้าจอจะแสดงข้อความ 6-7 บรรทัด ขึ้นอยู่กับความกว้างของหน้าจอ
    ข้อความขึ้นต้นด้วย google.visualization.Query.setResponse
    และลงท้ายด้วย /Tiger'},{v:80.0},{v:false}]}]}});

    นี่เป็นข้อมูลที่แสดงผลโดยแหล่งข้อมูลไปยังการแสดงภาพการค้นหา

การใช้การแสดงภาพ เพื่อดูข้อมูล

คุณสามารถใช้ไฟล์ getting_started.html ในไดเรกทอรี <data_source_library_install>/examples/src/html เพื่อดูภาพข้อมูล บรรทัดต่อไปนี้จาก getting_started.html ระบุเซิร์ฟเล็ตที่จะใช้ ตั้งค่าการแมปเซิร์ฟเล็ตในขั้นตอนที่ 8 ของการสร้างเว็บแอปพลิเคชันบน 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 คุณจะเห็นสิ่งต่อไปนี้



    เท่านี้ก็เรียบร้อย! คุณได้ตั้งค่าแหล่งข้อมูลแห่งแรกแล้ว

ขั้นตอนถัดไป

ตัวอย่างถัดไปจะอธิบายไว้ในส่วนการใช้ที่เก็บข้อมูลภายนอก หรือจะกลับไปที่บทนําหรือสํารวจลิงก์ต่อไปนี้ก็ได้