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 proje için açık kaynak koduna nasıl katkıda bulunulacağı açıklanmaktadır.

İçindekiler

  1. Şartlar
  2. Bağımlılıklar
  3. Kitaplığı sağlandığı şekilde kullanma
  4. Örnekleri Çalıştırma
  5. Kitaplıkta değişiklik yapma
  6. Açık Kaynak Projesi'ne katkıda bulunma

Ş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 2.4 veya sonraki bir sürümü. En sık kullanılan servlet kapsayıcılarından biri, Servlet API'yi içeren Apache Tomcat'tir. 5.5 sürümüne ait ikili programı indirmek için http://tomcat.apache.org/download-55.cgi adresine bakın. Yalnızca Core modülü yüklemeniz gerekir. Ayrıca, Tomcat'in eğitim bölümlerini tamamlaması gerekir: Başlarken, Harici Veri Deposu Kullanma, Özellikleri ve Etkinlik Akışını Tanımlama.
  • Java Development Kit 6.0 veya sonraki sürümler.

    Not: JDK 5.0 sürümünü de kullanmak mümkündür. Ancak daha sonra @Override hizmetini kitaplıkta bulunan ve bir arayüz yöntemini geçersiz kılan tüm yöntemlerden kaldırmanız gerekir. Bunun nedeni, JDK sürüm 6.0'da @Override ek açıklaması 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 olsa da test edilmemiştir.

Kaynağa veya indirilene dahil edilenler:

Kaynağa veya indirmeye dahil edilmeyen veriler:

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

Kitaplığı sağlandığı şekilde kullanma

Bu bölümde, değişiklik yapmanız gerekmiyorsa görselleştirme Java kitaplığını nasıl kullanacağınız açıklanmaktadır. Bu işlem, derleme sisteminize göre değişir:

Maven kullanıyorsanız aşağıdaki ayarlarla görselleştirme kitaplığında 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 kitaplık JAR'larla birlikte eklenir. Örneklerin çalıştırılmasıyla ilgili talimatlar Başlarken sayfasında verilmiştir.

Kitaplıkta değişiklik yapma

Kitaplık kodunda değişiklik yapmak isterseniz açık kaynak barındırma sitesinden kaynağı indirip oluşturmanız gerekir. Bu işlemi yapmadan önce, kullanım alanınıza izin verilip verilmediğini görmek için proje sayfasındaki "Kod lisansı" bölümünde bağlantısı verilen lisans bilgilerini okuyun.

Kitaplığı indirme ve oluşturma adımları şunlardır:

  1. Açık kaynak proje sayfasındaki Kaynak > Ödeme sekmesinde açıklandığı gibi, SVN'yi kullanarak kaynak kodu indirin.
  2. Kodunuzu oluşturun. Maven'de derliyorsanı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ü ile test edildiğini unutmayın. Ant'ın daha eski bir sürümüne sahipseniz yeni sürüme geçmeniz gerekebilir)

Karınca Oluşturma Talimatları

1. Derleme özelliklerinizi değiştirin:

  1. Seçtiğiniz yükleme dizininin build-src alt dizinine gidin.
  2. Metin düzenleyici 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ıza işaret edecek şekilde düzenleyin. Örneğin, tomcat_home dizinindeki c: sürücünüze Tomcat'i yüklediyseniz servlet-api.jar özelliğini şu şekilde 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 düz eğik çizgi kullanın

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

2. Kitaplığı oluşturma:

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ığı değiştirirken çok kullanışlıdır.

Açık Kaynak Projesi'ne Katkıda Bulunma

Açık kaynak projesinde yapılan değişikliklere katkıda bulunmak istiyorsanız proje için gönderim izinlerini almanız gerekir. google-visualization-api@googlegroups.com adresine e-posta gönderin ve değişikliklerin nasıl gönderileceği ile ilgili izin ve talimatları isteyin.