Veri Kaynağı Java Kitaplığı'nı yükleme

Bu sayfada Google Görselleştirme Java kitaplığının nasıl kullanılacağı veya değiştirileceği ve projenin açık kaynak koduna nasıl katkıda bulunulacağı açıklanmaktadır.

İçindekiler

  1. Koşullar
  2. Bağımlılıklar
  3. Kitaplığınızı sağlandığı şekilde kullanma
  4. Örnekleri Çalıştırma
  5. Kitaplık'ı değiştirme
  6. Açık Kaynak Projesine Katkı

Şartlar

Google Görselleştirme Java kitaplığını kullanmak için aşağıdaki bileşenlere sahip olmanız gerekir:

  • Bir servlet kapsayıcısı ve Servlet API'si 2.4 veya daha sonraki bir sürümü. En yaygın olarak kullanılan servlet kapsayıcılarından biri, Servlet API'yi içeren Apache Tomcat'tir. 5.5 sürümünün ikili programını indirmek için http://tomcat.apache.org/download-55.CGI adresine göz atın. Yalnızca temel modülü yüklemeniz yeterlidir. Tom'un şu eğitim bölümlerini de tamamlaması gerekiyor: Başlarken, Harici Veri Deposu Kullanma ve Yetenekleri ve Etkinlik Akışını Tanımlama.
  • Java Geliştirme Kiti 6.0 veya daha sonraki bir sürüm.

    Not: JDK 5.0 sürümü de kullanılabilir. Ancak, @Override öğesini kitaplıktaki bir arayüz yöntemini geçersiz kılan her yöntemden kaldırmanız gerekir. Bunun nedeni, JDK 6.0 sürümündeki @Override ek açıklama davranışındaki değişikliktir.

Bağımlılıklar

Veri kaynağı Java kitaplığı aşağıdaki bağımlılıklara sahiptir. Kitaplık, listelenen sürümlerle test edildi. Diğer sürümler kabul edilebilir ancak test edilmedi.

Kaynağa dahil edilir veya indirilir:

Kaynağa veya indirme işlemine dahil edilmez:

  • SqlDataSourceHelper sınıfını mySQL veritabanıyla kullanmak için çalışma zamanı ortamınızda mysql.jar öğesine de ihtiyacınız vardır. Ayrıntılar ve indirilebilir sürümler için http://www.mysql.com/products/connector/j/ adresine bakın.

Kitaplık'ı Gerektiği Şekilde Kullanma

Bu bölümde, görselleştirmeye ihtiyaç duymadığınız görselleştirme Java kitaplığının nasıl kullanılacağı açıklanmaktadır. Bu işlem, derleme sisteminize göre farklılık gösterir:

Maven kullanıyorsanız aşağıdaki ayarlarla görselleştirme kitaplığına bağımlılık oluşturun:

  • Grup Kimliği: com.google.visualization
  • Yapı Kimliği: görselleştirme-veri kaynağı
  • Sürüm numarası: Proje sayfasında listelenen en son sürüm numarasını kullanın.

Başka bir derleme sistemi kullanıyorsanız:

Örnekleri Çalıştırma

JAR örnek dosyaları, indirilebilir ZIP dosyasındaki JAR kitaplığıyla birlikte sunulur. Örneklerin çalıştırılmasıyla ilgili talimatlar, Başlarken sayfasında sunulur.

Kitaplık'ı değiştirme

Kitaplık kodunu değiştirmek istiyorsanız kaynağı açık kaynak barındırma sitesinden indirip derlemeniz gerekir. Bunu yapmadan önce, kullanım alanınıza izin verilip verilmediğini görmek için proje sayfasındaki "Kod lisansı" ile bağlantı verilen lisanslama bilgilerini okuyun.

Kitaplığı indirmek ve oluşturmak için şu adımları uygulayın:

  1. Açık kaynak proje sayfasındaki Kaynak > Ödeme sekmesinden açıklandığı gibi SVN kullanarak kaynak kodu indirin.
  2. Kodunuzu oluşturun. Maven'de derleme yapıyorsanız kaynakla birlikte sağlanan pom.xml dosyasını kullanın. Apache Ant ile derleme yapıyorsanız sonraki talimatları uygulayın (kodun Ant 1.7.0 sürümüyle test edildiğini unutmayın; Ant'in önceki bir sürümünü kullanıyorsanız yeni sürüme geçmeniz gerekebilir)

Karınca Derlemesi Talimatları

1. Yapı özelliklerinizi değiştirin:

  1. Seçtiğiniz yükleme dizininin build-src alt dizinine gidin.
  2. Metin düzenleyiciyi kullanarak build.properties dosyasını açın ve aşağıdaki değişiklikleri yapın:
    • servlet-api.jar özelliğini servlet-api.jar dosyanızı işaret edecek şekilde düzenleyin. Örneğin, c: dizininize tomcat_home dizinindeki Tomcat'i yüklediyseniz servlet-api.jar özelliğini aşağıdaki gibi belirtirsiniz:
      servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar

      Not: Windows kullanılırken bile dosya yolunda ters eğik çizgi yerine eğik çizgi kullanın

    • Yukarıda açıklanan bağımlılıkların kendi kopyalarınızı kullanmak için aynı derleme.özellikler dosyasındaki yolları düzenleyin.

2. Kitaplığı oluşturun:

Dosyadaki build-src alt dizinine gidin ve aşağıdakilerden birini yazın:

  • ant datasource - Veri kaynağı kitaplığını oluşturur
  • ant example - Örnekleri oluşturur
  • ant - Hem veri kaynağı hem de örnekler oluşturur
  • ant test - Veri kaynağı kitaplığı testlerini oluşturur ve çalıştırır. Kitaplıkta değişiklik yaparken çok yararlıdır.

Açık Kaynak Projesine Katkı

Açık kaynak projesindeki değişikliklere katkıda bulunmak istiyorsanız projeye gönderim izni almanız gerekir. google-visualization-api@googlegroups.com adresine, değişikliklerin nasıl gönderileceğine dair izin ve talimatlar içeren bir e-posta gönderin.