Veri Kaynaklarını Kullanmaya Başlama

Bu bölümde, kitaplıkla birlikte sağlanan bir veri kaynağının en basit örnek uygulaması olan SimpleExampleServlet tanıtılmaktadır. Bu bölümde, SimpleExampleServlet çalıştırma ve test etmeyle ilgili adım adım talimatlar da verilmektedir.

SimpleExampleServlet ile tanışın

SimpleExampleServlet sınıfı, examples paketinde yer alıyor. Bu sınıf, bir veri kaynağının en basit şekilde uygulanmasına dair bir örnek sunar. SimpleExampleServlet, DataSourceServlet öğesinden devralır, generateDataTable() öğesini uygular ve bir servlet container'ı içinde çalıştırılması gerekir.

SimpleExampleServlet ile ilgili bir snippet aşağıda verilmiştir. generateDataTable işlevi, verileri kitaplığa sunar. Bu işlev, bir veri tablosu açıklaması oluşturur, veri tablosu sütunlarını tanımlar ve veri tablosunu verilerle doldurur. Kitaplık, veri tablosunu sorgulayan görselleştirmeye döndürmek için gereken diğer tüm işlemleri gerçekleştirir.

// This example extends DataSourceServlet
public class SimpleExampleServlet extends DataSourceServlet {

  @Override
  public DataTable generateDataTable(Query query, HttpServletRequest request) {
    // Create a data table,
    DataTable data = new DataTable();
    ArrayList cd = new ArrayList();
    cd.add(new ColumnDescription("name", ValueType.TEXT, "Animal name"));
    cd.add(new ColumnDescription("link", ValueType.TEXT, "Link to wikipedia"));
    cd.add(new ColumnDescription("population", ValueType.NUMBER, "Population size"));
    cd.add(new ColumnDescription("vegeterian", ValueType.BOOLEAN, "Vegetarian?"));

    data.addColumns(cd);

    // Fill the data table.
    try {
      data.addRowFromValues("Aye-aye", "http://en.wikipedia.org/wiki/Aye-aye", 100, true);
      data.addRowFromValues("Sloth", "http://en.wikipedia.org/wiki/Sloth", 300, true);
      data.addRowFromValues("Leopard", "http://en.wikipedia.org/wiki/Leopard", 50, false);
      data.addRowFromValues("Tiger", "http://en.wikipedia.org/wiki/Tiger", 80, false);
    } catch (TypeMismatchException e) {
      System.out.println("Invalid type!");
    }
    return data;
  }
}

SimpleExampleServlet çalıştırma ve test etme

Bu bölümde, SimpleExampleServlet'yı çalıştırma ve test etmeyle ilgili talimatlar verilmektedir.

Henüz yapmadıysanız ön koşullar hakkında bilgi edinmek ve kitaplığı indirme ve oluşturma talimatlarını görmek için Yükleme bölümüne bakın. Sisteminizde henüz yoksa Apache Tomcat gibi bir servlet kapsayıcısı olarak da işlev gören bir web sunucusu yüklediğinizden emin olun. Bu bölümdeki talimatlar, Windows sistemindeki Apache Tomcat'e özeldir.

SimpleExampleServlet'yı çalıştırmak ve test etmek için SimpleExampleServlet veri kaynağını çalıştıran bir web uygulaması oluşturun, ardından veri kaynağından sorgulanan verileri gösteren bir görselleştirme içeren örnek bir web sayfası çalıştırın. Bu durum aşağıdaki bölümlerde açıklanmıştır:

Apache Tomcat'te web uygulaması oluşturma

Apache Tomcat'te web uygulaması oluşturmak için aşağıdaki talimatları uygulayın veya uyarlayın. Bu talimatlar, Windows sistemindeki Apache Tomcat'e özeldir:

  1. Tomcat'i yüklediğiniz dizine gidin. Bu, dokümanda <tomcat_home> olarak yazılmıştır.
     
  2. webapps alt dizinine gidin.
     
  3. myWebApp adlı bir alt dizin oluşturun.
     
  4. Yeni oluşturduğunuz alt dizine geçin ve WEB-INF adlı başka bir alt dizin oluşturun.
     
  5. WEB-INF alt dizinine geçin ve lib adlı başka bir alt dizin oluşturun.
    Tam yol <tomcat_home>/webapps/myWebApp/WEB-INF/lib olmalıdır.
     
  6. web.xml dosyasını <data_source_library_install>/examples/src/html konumundan WEB-INF dizinine kopyalayın. Burada <data_source_library_install>, veri kaynağı kitaplığını yüklediğiniz dizindir. web.xml dosyasındaki aşağıdaki satırlar SimpleExampleServlet değerini tanımlayıp eşler:
    <servlet>
  <servlet-name>My Servlet</servlet-name>
  <description>My servlet description.</description>
  <servlet-class>SimpleExampleServlet</servlet-class>
</servlet>

<servlet-mapping>
  <servlet-name>My Servlet</servlet-name>
  <url-pattern>/simpleexample</url-pattern>
</servlet-mapping>
  7. Veri kaynağı kitaplığını yüklediğiniz dizine gidin. Bu, dokümanda <data_source_library_install> olarak belirtilir.
     
  8. Tüm bağımlılık paketlerini <tomcat_home>/webapps/myWebApp/WEB-INF/lib konumuna kopyalayın. Paketler, farklı bir dizine yerleştirmediğiniz sürece <data_source_library_install>/lib konumuna yüklenir.
     
  9. Kitaplığı kendiniz oluşturduysanız visualization-datasource-1.0.2.jar ve visualization-datasource-examples.jar
    dosyalarını <data_source_library_install>/build
    konumundan <tomcat_home>/webapps/myWebApp/WEB-INF/lib konumuna kopyalayın.

    Zip dosyasını açtıysanız visualization-datasource-1.0.2.jar ve visualization-datasource-examples.jar
    dosyalarını <data_source_library_install>
    klasöründen <tomcat_home>/webapps/myWebApp/WEB-INF/lib klasörüne kopyalayın.
    Jar dosya adındaki sürüm numarasının, en son sürüm numarasına bağlı olarak değişebileceğini unutmayın.
     
  10. Tomcat'i başlatın veya zaten çalışıyorsa yeniden başlatın.
     
  11. Şu bağlantıyı tıklayın:

    http://localhost:8080/myWebApp/simpleexample

    Ekran genişliğinize bağlı olarak ekranda 6-7 satır metin gösterilir.
    Metin google.visualization.Query.setResponse ile başlar
    ve /Tiger'},{v:80.0},{v:false}]}]}}); ile biter.

    Bu, veri kaynağınız tarafından sorgulayan bir görselleştirmeye döndürülen verilerdir.

Verileri Görüntülemek İçin Görselleştirme Kullanma

<data_source_library_install>/examples/src/html dizinindeki getting_started.html dosyası, verilerin görselleştirilmesini görüntülemek için kullanılabilir. getting_started.html dosyasından alınan aşağıdaki satır, kullanılacak servlet'i belirtir. Servlet eşlemesi, Apache Tomcat'te Web Uygulaması Oluşturma başlıklı makalenin 8. adımında ayarlanmıştır.

var query = new google.visualization.Query('simpleexample');

Görselleştirme belirtme ve sorgu dilini kullanma hakkında daha fazla bilgi için Grafikleri Kullanma ve Sorgu Dili Referansı başlıklı makalelere bakın.

Veri kaynağı tarafından sağlanan verilerin görselleştirmesini görüntülemek için aşağıdaki talimatları uygulayın veya bu talimatları kendi durumunuza göre uyarlayın:

  1. getting_started.html dosyasını <data_source_library_install>/examples/src/html dizininden
    <tomcat_home>/webapps/myWebApp/ dizinine kopyalayın.
     
  2. http://localhost:8080/myWebApp/getting_started.html bağlantısını tıkladığınızda şunları görmelisiniz:
     


    İşlem tamamlandı. İlk veri kaynağınızı ayarlamış olmanız gerekir.

Sonraki Adımlar

Sonraki örnek, Harici Veri Deposu Kullanma bölümünde açıklanmaktadır. Alternatif olarak, Giriş bölümüne dönebilir veya aşağıdaki bağlantıları inceleyebilirsiniz: