Veri Kaynaklarını Kullanmaya Başlama

Bu bölümde, kitaplıkla birlikte sağlanan bir veri kaynağının en basit örneği olan SimpleExampleServlet açıklanmaktadır. Bu bölümde, SimpleExampleServlet komut dosyasını çalıştırma ve test etmeyle ilgili adım adım talimatlar da sunulmuştur.

Karşınızda SimpleExampleServlet

SimpleExampleServlet sınıfı examples paketinde yer alıyor. Bu sınıfta, bir veri kaynağının en basit uygulamasına dair örnek verilmiştir. SimpleExampleServlet, DataSourceServlet değerini devralır, generateDataTable() özelliğini uygular ve bir servlet kapsayıcısında çalıştırılmalıdır.

Aşağıda, SimpleExampleServlet snippet'i verilmiştir. generateDataTable işlevi, verileri kitaplıkta gösterir. Bu işlev, veri tablosu açıklaması oluşturur, veri tablosu sütunlarını tanımlar ve veri tablosunu verilerle doldurur. Kitaplık, veri tablosunu sorgu görselleştirmesine 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ırılıp test ediliyor

Bu bölümde, SimpleExampleServlet'nun çalıştırılması ve test edilmesiyle ilgili talimatlar verilmiştir.

Henüz yapmadıysanız ön koşullar hakkında bilgi ve kitaplığın nasıl indirilip oluşturulduğuyla ilgili talimatlar için Yükleme bölümüne bakın. Sisteminizde yoksa, Apache Tomcat gibi bir servlet kapsayıcısı olarak çalışan bir web sunucusu yüklediğinizden emin olun. Bu bölümdeki talimatlar bir Windows sisteminde Apache Tomcat'e özeldir.

SimpleExampleServlet aracını ç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ştirmeyi içeren örnek bir web sayfası çalıştırın. Bu durum, aşağıdaki bölümlerde açıklanmaktadı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 bir Windows sisteminde Apache Tomcat'e özeldir:

  1. Tomcat'i yüklediğiniz dizine gidin. Bu metin bu dokümanda <tomcat_home> olarak yazılmıştır.
     
  2. webapps alt dizinine gidin.
     
  3. myWebApp adında bir alt dizin oluşturun.
     
  4. Yeni oluşturduğunuz alt dizine geçin ve WEB-INF adında başka bir alt dizin oluşturun.
     
  5. WEB-INF alt dizinini değiştirin 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 dizininden WEB-INF dizinine kopyalayın. Burada <data_source_library_install>, veri kaynağı kitaplığını yüklediğiniz dizindir. web.xml içindeki aşağıdaki satırlar SimpleExampleServlet özelliğini tanımlar ve 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 yazılmıştır.
     
  8. Tüm bağımlı paketlerini şuraya kopyala: <tomcat_home>/webapps/myWebApp/WEB-INF/lib. Paketler, farklı bir dizine eklemediğiniz sürece <data_source_library_install>/lib içinde yüklenir.
     
  9. Kitaplığı kendiniz oluşturduysanız visualization-datasource-1.0.2.jar ve visualization-datasource-examples.jar
    değerlerini <data_source_library_install>/build
    öğesinden <tomcat_home>/webapps/myWebApp/WEB-INF/lib klasörüne kopyalayın.

    Sıkıştırılmış dosyayı çıkardıysanız visualization-datasource-1.0.2.jar ve

    dosyasını <data_source_library_install>
    konumundan <tomcat_home>/webapps/myWebApp/WEB-INF/lib konumuna kopyalayın.
    Japon dosya adındaki sürüm numarasının en son sürüm numarasına göre değişebileceğini unutmayın.
  10. Tomcat'i başlatın veya zaten çalışıyorsa Tomcat'i yeniden başlatın.
     
  11. Şu bağlantıyı tıklayın:

    http://localhost:8080/myWebApp/simpleexample

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

    Veri kaynağınız tarafından sorgu görselleştirmeye döndürülen verilerdir.

Verileri Görüntülemek için Görselleştirmeyi Kullanma

<data_source_library_install>/examples/src/html dizinindeki getting_started.html dosyası, verilerin görselleştirmesini görüntülemek için kullanılabilir. getting_started.html numaralı satırdan alınan aşağıdaki satır, kullanılacak servlet'i belirtir. Serlet eşleme, Apache Tomcat'te Web Uygulaması Oluşturma adımının 8. adımında kuruldu.

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

Görselleştirme ve sorgu dilini kullanma hakkında daha fazla bilgi için Grafikleri Kullanma ve Sorgu Dili Referansı bölümlerine 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 uyarlayın:

  1. getting_started.html dosyasını <data_source_library_install>/examples/src/html dizininden
    dizinine <tomcat_home>/webapps/myWebApp/ dizinine kopyalayın.
     
  2. Şu bağlantıyı tıklayın: http://localhost:8080/myWebApp/getting_started.html. Aşağıdaki adresi görürsünüz:



    Hepsi bu kadar. İlk veri kaynağınızı ayarladınız.

Sonraki Adımlar

Bir sonraki örnek, Harici Veri Deposu Kullanma bölümünde açıklanmıştır. Alternatif olarak, Giriş ekranına dönebilir veya aşağıdaki bağlantıları keşfedebilirsiniz: