หน้านี้อธิบายวิธีใช้หรือแก้ไขไลบรารี Java การแสดงภาพของ Google และวิธีมีส่วนร่วมในโค้ดโอเพนซอร์สสําหรับโครงการ
เนื้อหา
ข้อกำหนด
คุณต้องมีคอมโพเนนต์ต่อไปนี้เพื่อใช้ไลบรารี Java Visual ของ Google
- คอนเทนเนอร์เซอร์เล็ตและ 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 Lan เวอร์ชัน 2.4
- Jaarta Common 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
- รหัสอาร์ติแฟกต์: picture-datasource
- หมายเลขเวอร์ชัน: ใช้หมายเลขเวอร์ชันล่าสุดที่ระบุไว้ในหน้าโปรเจ็กต์
หากใช้ระบบบิลด์อื่น ให้ทําดังนี้
- ดาวน์โหลดไฟล์ ZIP ของไลบรารีจากหน้าโปรเจ็กต์ แตกไฟล์ และรวมไว้ในโปรเจ็กต์ตามที่ระบบของบิลด์ต้องการ
การเรียกใช้ตัวอย่าง
ไฟล์ตัวอย่าง JAR จะรวมอยู่ใน JAR ของไลบรารีในไฟล์ ZIP ที่ดาวน์โหลดได้ ดูวิธีการเรียกใช้ตัวอย่างในหน้าเริ่มต้นใช้งาน
การแก้ไขไลบรารี
หากต้องการแก้ไขโค้ดไลบรารี คุณจะต้องดาวน์โหลดซอร์สโค้ดจากเว็บไซต์โฮสติ้งแบบโอเพนซอร์สและสร้างเทมเพลตดังกล่าว ก่อนที่จะดําเนินการ โปรดอ่านข้อมูลการอนุญาตให้ใช้สิทธิที่ลิงก์กับส่วน "ใบอนุญาตโค้ด" ในหน้าโปรเจ็กต์เพื่อดูว่าอนุญาตให้ใช้กรณีการใช้งานของคุณหรือไม่
ขั้นตอนในการดาวน์โหลดและสร้างไลบรารีมีดังนี้
- ดาวน์โหลดซอร์สโค้ดโดยใช้ SVN ตามที่อธิบายไว้ในแท็บแหล่งที่มา > การชําระเงินในหน้าโปรเจ็กต์โอเพนซอร์ส
- สร้างโค้ดของคุณ หากสร้างใน Maven ให้ใช้ไฟล์ pom.xml ที่ให้มากับแหล่งที่มา หากสร้างด้วย Apache Ant ให้ทําตามวิธีการถัดไป (โปรดทราบว่าโค้ดได้รับการทดสอบด้วย Ant เวอร์ชัน 1.7.0 หากคุณมี Ant เวอร์ชันก่อนหน้า คุณอาจต้องอัปเกรด)
วิธีการสร้างมด
1. แก้ไขพร็อพเพอร์ตี้ของบิลด์ ดังนี้
- ไปที่ไดเรกทอรีย่อยของ
build-src
ในไดเรกทอรีการติดตั้งที่เลือก - เปิดไฟล์
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 ของคุณเองตามที่อธิบายไว้ข้างต้น ให้แก้ไขเส้นทางในไฟล์ build.properities เดียวกัน
- แก้ไขพร็อพเพอร์ตี้
2. สร้างไลบรารีโดยทําดังนี้
ไปยังไดเรกทอรีย่อยของ build-src
ในไฟล์แล้วพิมพ์รายการใดรายการหนึ่งต่อไปนี้
ant datasource
- สร้างไลบรารีแหล่งข้อมูลant example
- สร้างตัวอย่างant
- สร้างทั้งแหล่งข้อมูลและตัวอย่างant test
- สร้างและใช้งานการทดสอบคลังแหล่งข้อมูล มีประโยชน์มากเมื่อคุณแก้ไขไลบรารี
การมีส่วนร่วมในโปรเจ็กต์โอเพนซอร์ส
หากต้องการร่วมเปลี่ยนแปลงโปรเจ็กต์โอเพนซอร์ส คุณจะต้องมีสิทธิ์ส่งในโปรเจ็กต์ ส่งอีเมลไปที่ google-visualization-api@googlegroups.com เพื่อขออนุญาตและแนะนําวิธีส่งการเปลี่ยนแปลง