การติดตั้งไลบรารี Java ของแหล่งข้อมูล

หน้านี้จะอธิบายวิธีใช้หรือแก้ไขไลบรารี Java การแสดงภาพของ Google และวิธีมีส่วนร่วมในโค้ดโอเพนซอร์สสําหรับโปรเจ็กต์

เนื้อหา

  1. ข้อกำหนด
  2. การขึ้นต่อกัน
  3. การใช้ไลบรารีตามที่ให้ไว้
  4. การเรียกใช้ตัวอย่าง
  5. การแก้ไขไลบรารี
  6. การมีส่วนร่วมในโครงการโอเพนซอร์ส

ข้อกำหนด

คุณต้องมีคอมโพเนนต์ต่อไปนี้จึงจะใช้ไลบรารี Java ของ Google Visualization ได้

  • คอนเทนเนอร์ของเซิร์ฟเล็ตและ Servlet API เวอร์ชัน 2.4 ขึ้นไป หนึ่งในคอนเทนเนอร์ของเซิร์ฟเล็ตที่ใช้บ่อยที่สุดคือ Apache Tomcat ซึ่งรวมถึง Servlet API โปรดดู http://tomcat.apache.org/download-55.cgi เพื่อดาวน์โหลดไบนารีสำหรับเวอร์ชัน 5.5 คุณต้องติดตั้งเฉพาะโมดูลหลัก คุณยังต้องใช้ Tomcat เพื่อดำเนินการในส่วนบทแนะนำให้เสร็จสมบูรณ์ ซึ่งได้แก่ การเริ่มต้นใช้งาน การใช้พื้นที่เก็บข้อมูลภายนอก และการกำหนดความสามารถและโฟลว์ของเหตุการณ์
  • Java Development Kit เวอร์ชัน 6.0 ขึ้นไป

    หมายเหตุ: คุณใช้ JDK เวอร์ชัน 5.0 ได้ด้วย อย่างไรก็ตาม คุณต้องนำ @Override ออกจากทุกเมธอดในไลบรารีที่ลบล้างเมธอดอินเทอร์เฟซ นั่นเป็นเพราะการเปลี่ยนแปลงลักษณะการทำงานของคำอธิบายประกอบ @Override ใน JDK เวอร์ชัน 6.0

การขึ้นต่อกัน

ไลบรารี Java ของแหล่งข้อมูลมีทรัพยากร Dependency ต่อไปนี้ ไลบรารีได้รับการทดสอบด้วยเวอร์ชันที่แสดงอยู่ เวอร์ชันอื่นๆ อาจยอมรับได้ แต่ยังไม่ได้รับการทดสอบ

รวมอยู่ในแหล่งที่มาหรือดาวน์โหลด:

  • icu4j เวอร์ชัน 4.0.1
  • Jakarta Commons lang เวอร์ชัน 2.4
  • Jakarta Commons Logging เวอร์ชัน 1.1.1
  • ไลบรารีคอลเล็กชันของ Google เวอร์ชัน 1.0
  • javacc เวอร์ชัน 4.2 โดยจำเป็นเฉพาะเมื่อคุณต้องการคอมไพล์ไลบรารี เช่น เมื่อทำการแก้ไขตามที่อธิบายไว้ด้านล่าง
  • opencsv เวอร์ชัน 1.8. ต้องระบุแอตทริบิวต์นี้เฉพาะในกรณีที่ตั้งใจจะใช้แหล่งข้อมูล CSV เท่านั้น

ไม่รวมอยู่ในแหล่งที่มาหรือดาวน์โหลด

  • หากต้องการใช้คลาส SqlDataSourceHelper กับฐานข้อมูล mySQL คุณต้องมี mysql.jar ในสภาพแวดล้อมรันไทม์ด้วย ดูรายละเอียดและเวอร์ชันที่สามารถดาวน์โหลดได้ที่ http://www.mysql.com/products/connector/j/

การใช้ไลบรารีตามที่มีให้

ส่วนนี้จะอธิบายวิธีใช้ไลบรารี Java สำหรับการแสดงภาพ หากคุณไม่ต้องการแก้ไข กระบวนการนี้จะแตกต่างกันไปตามระบบบิลด์:

หากใช้ Maven ให้ตั้งค่าทรัพยากร Dependency ในไลบรารีการแสดงภาพด้วยการตั้งค่าต่อไปนี้

  • รหัสกลุ่ม: com.google.visualization
  • รหัสอาร์ติแฟกต์: การแสดงข้อมูลผ่านภาพ
  • หมายเลขเวอร์ชัน: ใช้หมายเลขเวอร์ชันล่าสุดที่ระบุไว้ในหน้าโปรเจ็กต์

หากใช้ระบบบิลด์อื่นๆ

การเรียกใช้ตัวอย่าง

ไฟล์ตัวอย่าง JAR จะรวมอยู่ใน JAR ของไลบรารีในไฟล์ ZIP ที่ดาวน์โหลดได้ คุณสามารถดูคำแนะนำเกี่ยวกับการเรียกใช้ตัวอย่างได้ในหน้าเริ่มต้นใช้งาน

การแก้ไขไลบรารี

หากต้องการแก้ไขโค้ดไลบรารี คุณจะต้องดาวน์โหลดแหล่งที่มาจากเว็บไซต์โฮสติ้งโอเพนซอร์สแล้วสร้างขึ้นมา ก่อนดำเนินการนี้ ให้อ่านข้อมูลการอนุญาตให้ใช้สิทธิที่ลิงก์โดยส่วน "ใบอนุญาตโค้ด" ในหน้าโปรเจ็กต์เพื่อดูว่า Use Case ของคุณได้รับอนุญาตหรือไม่

ขั้นตอนในการดาวน์โหลดและสร้างไลบรารีมีดังนี้

  1. ดาวน์โหลดซอร์สโค้ดโดยใช้ SVN ตามที่อธิบายไว้ในแท็บแหล่งที่มา > การชำระเงินในหน้าโปรเจ็กต์โอเพนซอร์ส
  2. สร้างโค้ดของคุณ หากสร้างใน Maven ให้ใช้ไฟล์ pom.xml ที่มาพร้อมกับแหล่งที่มา หากสร้างด้วย Apache Ant ให้ทำตามวิธีการที่ระบุไว้ถัดไป (โปรดทราบว่าโค้ดได้รับการทดสอบกับ Ant เวอร์ชัน 1.7.0 หากใช้ Ant เวอร์ชันก่อนหน้า คุณอาจต้องอัปเกรด)

วิธีการสร้างมด

1. แก้ไขพร็อพเพอร์ตี้ของบิลด์ ดังนี้

  1. ไปที่ไดเรกทอรีย่อย build-src ของไดเรกทอรีการติดตั้งที่เลือก
  2. เปิดไฟล์ build.properties โดยใช้เครื่องมือแก้ไขข้อความ แล้วทำการเปลี่ยนแปลงต่อไปนี้
    • แก้ไขพร็อพเพอร์ตี้ servlet-api.jar ให้ชี้ไปที่ไฟล์ servlet-api.jar เช่น หากติดตั้ง Tomcat ลงในไดรฟ์ c: ในไดเรกทอรี tomcat_home คุณจะต้องระบุพร็อพเพอร์ตี้ servlet-api.jar ดังนี้
      servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar

      หมายเหตุ: ใช้เครื่องหมายทับแทนแบ็กสแลชในเส้นทางไฟล์ แม้ว่าจะใช้ Windows อยู่ก็ตาม

    • หากต้องการใช้สำเนาของทรัพยากร Dependency ของคุณเองที่อธิบายไว้ข้างต้น ให้แก้ไขเส้นทางในไฟล์ create.properties เดียวกัน

2. สร้างไลบรารีโดยทำดังนี้

ไปยังไดเรกทอรีย่อย build-src ในไฟล์และพิมพ์อย่างใดอย่างหนึ่งต่อไปนี้

  • ant datasource - สร้างไลบรารีแหล่งข้อมูล
  • ant example - สร้างตัวอย่าง
  • ant - สร้างทั้งแหล่งข้อมูลและตัวอย่าง
  • ant test - สร้างและเรียกใช้การทดสอบไลบรารีแหล่งข้อมูล มีประโยชน์มากเมื่อคุณแก้ไขไลบรารี

การมีส่วนร่วมในโปรเจ็กต์โอเพนซอร์ส

หากต้องการมีส่วนร่วมในการเปลี่ยนแปลงในโปรเจ็กต์โอเพนซอร์ส คุณจะต้องรับสิทธิ์การส่งไปยังโปรเจ็กต์ดังกล่าว ส่งอีเมลไปที่ google-visualization-api@googlegroups.com โดยขอรับสิทธิ์และวิธีการในการส่งการเปลี่ยนแปลง