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

ส่วนนี้จะแนะนำ 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 จะระบุ เซอร์ฟเล็ตที่จะใช้ การแมป Servlet ได้รับการตั้งค่าในขั้นตอนที่ 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 คุณควรเห็นข้อความต่อไปนี้
     


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

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

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