หน้านี้จะอธิบายวิธีใช้หรือแก้ไขไลบรารี Java การแสดงภาพของ Google และวิธีมีส่วนร่วมในโค้ดโอเพนซอร์สสําหรับโปรเจ็กต์
เนื้อหา
ข้อกำหนด
คุณต้องมีคอมโพเนนต์ต่อไปนี้จึงจะใช้ไลบรารี 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
- รหัสอาร์ติแฟกต์: การแสดงข้อมูลผ่านภาพ
- หมายเลขเวอร์ชัน: ใช้หมายเลขเวอร์ชันล่าสุดที่ระบุไว้ในหน้าโปรเจ็กต์
หากใช้ระบบบิลด์อื่นๆ
- ดาวน์โหลดไฟล์ ZIP ของไลบรารีจากหน้าโปรเจ็กต์ คลายการบีบอัดไฟล์และรวมไฟล์ไว้ในโปรเจ็กต์ของคุณในระบบบิลด์
การเรียกใช้ตัวอย่าง
ไฟล์ตัวอย่าง JAR จะรวมอยู่ใน JAR ของไลบรารีในไฟล์ ZIP ที่ดาวน์โหลดได้ คุณสามารถดูคำแนะนำเกี่ยวกับการเรียกใช้ตัวอย่างได้ในหน้าเริ่มต้นใช้งาน
การแก้ไขไลบรารี
หากต้องการแก้ไขโค้ดไลบรารี คุณจะต้องดาวน์โหลดแหล่งที่มาจากเว็บไซต์โฮสติ้งโอเพนซอร์สแล้วสร้างขึ้นมา ก่อนดำเนินการนี้ ให้อ่านข้อมูลการอนุญาตให้ใช้สิทธิที่ลิงก์โดยส่วน "ใบอนุญาตโค้ด" ในหน้าโปรเจ็กต์เพื่อดูว่า Use Case ของคุณได้รับอนุญาตหรือไม่
ขั้นตอนในการดาวน์โหลดและสร้างไลบรารีมีดังนี้
- ดาวน์โหลดซอร์สโค้ดโดยใช้ 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 ของคุณเองที่อธิบายไว้ข้างต้น ให้แก้ไขเส้นทางในไฟล์ create.properties เดียวกัน
- แก้ไขพร็อพเพอร์ตี้
2. สร้างไลบรารีโดยทำดังนี้
ไปยังไดเรกทอรีย่อย build-src ในไฟล์และพิมพ์อย่างใดอย่างหนึ่งต่อไปนี้
ant datasource- สร้างไลบรารีแหล่งข้อมูลant example- สร้างตัวอย่างant- สร้างทั้งแหล่งข้อมูลและตัวอย่างant test- สร้างและเรียกใช้การทดสอบไลบรารีแหล่งข้อมูล มีประโยชน์มากเมื่อคุณแก้ไขไลบรารี
การมีส่วนร่วมในโปรเจ็กต์โอเพนซอร์ส
หากต้องการมีส่วนร่วมในการเปลี่ยนแปลงในโปรเจ็กต์โอเพนซอร์ส คุณจะต้องรับสิทธิ์การส่งไปยังโปรเจ็กต์ดังกล่าว ส่งอีเมลไปที่ google-visualization-api@googlegroups.com โดยขอรับสิทธิ์และวิธีการในการส่งการเปลี่ยนแปลง