Menginstal Library Java Sumber Data

Halaman ini menjelaskan cara menggunakan atau memodifikasi library Java Google Visualization, dan cara berkontribusi pada kode open source untuk project.

Daftar Isi

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

Persyaratan

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

  • Container 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.cgi untuk mendownload biner untuk versi 5.5. Anda hanya perlu menginstal modul Core. Anda juga perlu Tomcat untuk menyelesaikan bagian tutorial: Memulai, Menggunakan Penyimpanan Data Eksternal, serta 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 ini diuji dengan versi yang tercantum; versi lain mungkin dapat diterima, tetapi belum diuji.

Disertakan dalam sumber atau download:

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 mengetahui detail dan versi yang dapat didownload.

Menggunakan Library seperti yang Disediakan

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

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

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

Jika menggunakan sistem build lainnya:

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

Menjalankan Contoh

File contoh JAR disertakan bersama 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 melalui bagian "Lisensi kode" di halaman project untuk melihat apakah kasus penggunaan Anda diizinkan.

Berikut langkah-langkah untuk mendownload dan membuat library:

  1. Download kode sumber menggunakan SVN, seperti yang dijelaskan di tab Source > Checkout di halaman project open source.
  2. Bangun kode Anda. Jika membangun aplikasi di Maven, gunakan file pom.xml yang disediakan bersama sumber. Jika mem-build dengan Apache Ant, ikuti petunjuk yang diberikan berikutnya (perhatikan bahwa kode telah diuji dengan Ant versi 1.7.0; jika menggunakan Ant versi sebelumnya, Anda mungkin perlu mengupgrade)

Petunjuk Build Semut

1. Ubah properti build Anda:

  1. Buka subdirektori build-src dari direktori penginstalan yang Anda pilih.
  2. Dengan menggunakan editor teks, buka file build.properties dan lakukan perubahan berikut:
    • Edit properti servlet-api.jar agar mengarah ke file servlet-api.jar Anda. Misalnya, jika Anda menginstal Tomcat ke drive c: di direktori tomcat_home, Anda harus 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, bahkan saat menggunakan Windows

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

2. Membangun library:

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

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

Berkontribusi pada Project Open Source

Jika ingin berkontribusi pada perubahan pada project open source, Anda harus mendapatkan izin pengiriman ke project tersebut. Kirim email ke google-visualization-api@googlegroups.com untuk meminta izin dan petunjuk cara mengirimkan perubahan.