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 eklentisinin nasıl çalıştırılacağı ve test edileceğiyle ilgili adım adım talimatlar da yer almaktadır.

Karşınızda SimpleExampleServlet

SimpleExampleServlet sınıfı examples paketinde bulunur. Bu sınıf, bir veri kaynağının en basit şekilde nasıl uygulandığını gösteren bir örnek sunar. SimpleExampleServlet, DataSourceServlet öğesinden devralır, generateDataTable() uygular ve bir servlet kapsayıcısı içinde çalıştırılmalıdır.

Aşağıda SimpleExampleServlet snippet'i sunulmuştur. generateDataTable işlevi, verileri kitaplığa sergiler. 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 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 uygulamasını çalıştırma ve test etme

Bu bölümde, SimpleExampleServlet eklentisinin nasıl çalıştırılacağı ve test edileceği ile ilgili talimatlar sunulmaktadır.

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

SimpleExampleServlet veri kaynağını çalıştıran bir web uygulaması oluşturup test etmek için SimpleExampleServlet veri kaynağından sorgulanan verileri gösteren bir görselleştirmeye sahip örnek bir web sayfası çalıştırın. Bu, 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, Windows sistemindeki Apache Tomcat'e özeldir:

  1. Tomcat'i yüklediğiniz dizine gidin. Bu değer, bu dokümanda <tomcat_home> olarak yazılır.
     
  2. webapps alt dizinine gidin.
     
  3. myWebApp adında bir alt dizin oluşturun.
     
  4. Oluşturduğunuz alt dizine geçin ve WEB-INF adında 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 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 öğesini 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 belge bu dokümanda <data_source_library_install> olarak yazılmıştır.
     
  8. Tüm bağımlılık paketlerini <tomcat_home>/webapps/myWebApp/WEB-INF/lib hedefine kopyalayın. Farklı bir dizine koymadığınız sürece paketler <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
    öğelerini <data_source_library_install>/build
    alan adından <tomcat_home>/webapps/myWebApp/WEB-INF/lib hizmetine kopyalayın.

    Sıkıştırılmış dosyayı açtıysanız visualization-datasource-1.0.2.jar ve visualization-datasource-examples.jar
    dosyalarını <data_source_library_install>
    konumundan <tomcat_home>/webapps/myWebApp/WEB-INF/lib konumuna kopyalayın.
    Jar dosyası 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 çalışıyorsa Tomcat'i yeniden başlatın.
     
  11. Aşağıdaki bağlantıyı tıklayın:

    http://localhost:8080/myWebApp/simpleexample

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

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

Verileri Görüntülemek için Görselleştirme 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 öğesinden alınan aşağıdaki satır, kullanılacak servlet'i belirtir. Serlet eşlemesi, Apache Tomcat'te Web Uygulaması Oluşturma bölümünün 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ı'na 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. <data_source_library_install>/examples/src/html dizininden
    adlı getting_started.html dosyasını <tomcat_home>/webapps/myWebApp/ dizinine kopyalayın.
     
  2. http://localhost:8080/myWebApp/getting_started.html bağlantısını tıkladığınızda aşağıdakileri görmeniz gerekir:
     


    Bu kadar! İlk veri kaynağınızı oluşturdunuz.

Sonraki adımlar

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