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

ส่วนนี้จะแนะนำ 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. คัดลอกแพ็กเกจทรัพยากร Dependency ทั้งหมดไปยัง <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 คุณจะเห็นข้อความต่อไปนี้
     


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

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

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