Menginstal Library Java Sumber Data

Halaman ini menjelaskan cara menggunakan atau mengubah library Java Visualisasi Google, dan cara berkontribusi pada kode open source untuk project tersebut.

Daftar Isi

1. Persyaratan
2. Dependensi
3. Menggunakan Library sebagai Disediakan
4. Menjalankan Contoh
5. Memodifikasi Library
6. Berkontribusi pada Project Open Source

Persyaratan

Anda harus memiliki komponen berikut untuk menggunakan library Java Visualisasi Google:

• Penampung servlet dan Servlet API versi 2.4 atau yang lebih tinggi. Salah satu container servlet yang paling umum digunakan adalah Apache Tomcat, yang mencakup Servlet API. Lihat http://tomcat.apache.org/download-55.microsoft untuk mendownload biner untuk versi 5.5. Anda hanya perlu menginstal modul Core. Anda juga memerlukan Tomcat untuk menyelesaikan bagian tutorial: Memulai , Menggunakan Penyimpanan Data Eksternal, dan Menentukan Kemampuan dan Alur Peristiwa.
• Java Development Kit versi 6.0 atau yang lebih baru.

  Catatan: Anda juga dapat menggunakan JDK versi 5.0. Namun, Anda harus menghapus @Override dari setiap metode di library yang mengganti metode antarmuka. Hal ini disebabkan oleh perubahan perilaku anotasi @Override di JDK versi 6.0.

Dependensi

Library Java sumber data memiliki dependensi berikut. Library telah diuji dengan versi yang tercantum; versi lain mungkin dapat diterima, tetapi belum diuji.

Disertakan dalam sumber atau download:

• icu4j versi 4.0.1.
• Jakarta Commons lang versi 2.4.
• Jakarta Commons Logging versi 1.1.1.
• Library koleksi Google versi 1.0.
• javacc versi 4.2. Tindakan ini hanya diperlukan jika Anda ingin mengompilasi library, misalnya saat memodifikasinya seperti yang dijelaskan di bawah.
• opencsv versi 1.8. Ini diperlukan hanya jika Anda bermaksud menggunakan sumber data CSV.

Tidak disertakan dalam sumber atau download:

• Untuk menggunakan class SqlDataSourceHelper dengan database mySQL, Anda juga memerlukan mysql.jar di lingkungan runtime. Lihat: http://www.mysql.com/products/connector/j/ untuk detail dan versi yang dapat didownload.

Menggunakan Library sebagaimana Diberikan

Bagian ini menjelaskan cara menggunakan library Java visualisasi jika Anda tidak perlu mengubahnya. Proses ini bervariasi sesuai sistem build Anda:

Jika Anda menggunakan Maven, siapkan dependensi pada library visualisasi dengan setelan berikut:

• ID Grup: com.google.visualization
• ID Artefak: Visualization-datasource
• Nomor versi: Menggunakan nomor versi terbaru yang tercantum di halaman project.

Jika menggunakan sistem build lain:

• Download file ZIP library dari halaman project, ekstrak file tersebut, dan sertakan dalam project Anda sesuai kebutuhan sistem build.

Menjalankan Contoh

Contoh file JAR disertakan dengan JAR library dalam file ZIP yang dapat didownload. Petunjuk untuk menjalankan contoh diberikan di halaman Memulai.

Memodifikasi Library

Jika ingin mengubah kode library, Anda harus mendownload sumber dari situs hosting open source dan mem-build-nya. Sebelum melakukannya, baca informasi pemberian lisensi yang ditautkan oleh bagian "Lisensi kode" di halaman project untuk melihat apakah kasus penggunaan Anda diizinkan.

Berikut adalah langkah-langkah untuk mendownload dan membuat library:

1. Download kode sumber menggunakan SVN, seperti yang dijelaskan pada tab Sumber > Checkout di halaman project open source.
2. Buat kode. Jika mem-build di Maven, gunakan file pom.xml yang disediakan dengan sumber tersebut. Jika mem-build dengan Apache Ant, ikuti petunjuk yang diberikan berikutnya (perhatikan bahwa kode telah diuji dengan Ant versi 1.7.0; jika Anda memiliki Ant versi sebelumnya, Anda mungkin perlu melakukan upgrade)

Petunjuk Pembuatan Semut

1. Mengubah properti build:

1. Buka subdirektori build-src dari direktori penginstalan yang Anda pilih.
2. Dengan menggunakan editor teks, buka file build.properties dan buat perubahan berikut:
   • Edit properti servlet-api.jar untuk diarahkan ke file servlet-api.jar Anda. Misalnya, jika Anda menginstal Tomcat ke drive c: di direktori tomcat_home, Anda akan menentukan properti servlet-api.jar sebagai berikut:
     servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar

     Catatan: Gunakan garis miring, bukan garis miring terbalik di jalur file, meskipun saat menggunakan Windows

   • Untuk menggunakan salinan dependensi yang dijelaskan di atas, edit jalur dalam file build.properties yang sama.

2. Buat library:

Buka subdirektori build-src dalam file dan ketik salah satu dari berikut ini:

• ant datasource - Membuat library sumber data
• ant example - Membuat contoh
• ant - Membuat sumber data dan contoh
• ant test - Membuat dan menjalankan pengujian library sumber data. Sangat berguna saat Anda memodifikasi library.

Berkontribusi pada Project Open Source

Jika ingin memberikan kontribusi perubahan pada project open source, Anda harus mendapatkan izin pengiriman ke project tersebut. Kirim email ke [e-mail] untuk meminta izin dan petunjuk tentang cara mengirimkan perubahan.