Начало работы с источниками данных

В этом разделе представлен SimpleExampleServlet — простейший пример реализации источника данных, предоставляемого библиотекой. В этом разделе также приведены пошаговые инструкции по запуску и тестированию SimpleExampleServlet .

Знакомство SimpleExampleServlet

Класс SimpleExampleServlet находится в пакете examples . Этот класс представляет собой пример простейшей реализации источника данных. SimpleExampleServlet наследуется от DataSourceServlet , реализует generateDataTable() и должен выполняться в контейнере сервлетов.

Фрагмент SimpleExampleServlet приведен ниже. Функция generateDataTable предоставляет данные библиотеке. Эта функция создает описание таблицы данных, определяет столбцы таблицы данных и заполняет таблицу данных данными. Библиотека обрабатывает все остальные действия, необходимые для возврата таблицы данных в запрашивающую визуализацию.

// 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

В этом разделе приведены инструкции по запуску и тестированию SimpleExampleServlet .

Если вы еще этого не сделали, см. раздел « Установка » для получения информации о предварительных требованиях и инструкциях по загрузке и сборке библиотеки. Убедитесь, что вы установили веб-сервер, который также функционирует как контейнер сервлетов, например Apache Tomcat, если он еще не установлен в вашей системе. Инструкции в этом разделе относятся к Apache Tomcat в системе Windows.

Чтобы запустить и протестировать SimpleExampleServlet , создайте веб-приложение, которое запускает источник данных SimpleExampleServlet , а затем запустите пример веб-страницы с визуализацией, показывающей данные, запрошенные из источника данных. Это описано в следующих разделах:

Создание веб-приложения на Apache Tomcat

Следуйте приведенным ниже инструкциям или адаптируйте их, чтобы создать веб-приложение на Apache Tomcat. Эти инструкции относятся к Apache Tomcat в системе Windows:

  1. Перейдите в каталог, в который вы установили Tomcat. В этом документе это написано как <tomcat_home> .
  2. Перейдите в подкаталог webapps .
  3. Создайте подкаталог с именем myWebApp .
  4. Перейдите в только что созданный подкаталог и создайте еще один подкаталог с именем WEB-INF .
  5. Перейдите в подкаталог WEB-INF и создайте еще один подкаталог с именем lib .
    Полный путь должен быть <tomcat_home>/webapps/myWebApp/WEB-INF/lib .
  6. Скопируйте web.xml из <data_source_library_install>/examples/src/html в каталог WEB-INF . Где <data_source_library_install> — это каталог, в который вы установили библиотеку источника данных. Следующие строки в web.xml определяют и сопоставляют SimpleExampleServlet :
    <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. Перейдите в каталог, в котором вы установили библиотеку источника данных. В этом документе это написано как <data_source_library_install> .
  8. Скопируйте все пакеты зависимостей в <tomcat_home>/webapps/myWebApp/WEB-INF/lib . Пакеты устанавливаются в <data_source_library_install>/lib , если вы не поместите их в другой каталог.
  9. Если вы собрали библиотеку самостоятельно, скопируйте visualization-datasource-1.0.2.jar и visualization-datasource-examples.jar .
    из <data_source_library_install>/build
    в <tomcat_home>/webapps/myWebApp/WEB-INF/lib .

    Если вы разархивировали zip-файл, скопируйте visualization-datasource-1.0.2.jar и visualization-datasource-examples.jar .
    из <data_source_library_install>
    в <tomcat_home>/webapps/myWebApp/WEB-INF/lib .
    Обратите внимание, что номер версии в имени файла jar может различаться в зависимости от номера последней версии.
  10. Запустите Tomcat или перезапустите Tomcat, если он уже запущен.
  11. Щелкните следующую ссылку:

    http://локальный:8080/myWebApp/простойпример

    На экране отображается 6-7 строк текста, в зависимости от ширины экрана.
    Текст начинается с google.visualization.Query.setResponse
    и заканчивается на /Tiger'},{v:80.0},{v:false}]}]}});

    Это данные, которые ваш источник данных возвращает запрашивающей визуализации.

Использование визуализации для просмотра данных

Файл getting_started.html в <data_source_library_install>/examples/src/html можно использовать для просмотра визуализации данных. Следующая строка, взятая из getting_started.html , определяет используемый сервлет. Сопоставление сервлета было настроено на шаге 8 раздела Создание веб-приложения на Apache Tomcat .

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

Дополнительные сведения о том, как указать визуализацию и использовать язык запросов, см. в разделе Использование диаграмм и Справочник по языку запросов .

Следуйте или адаптируйте приведенные ниже инструкции, чтобы просмотреть визуализацию данных, предоставленных источником данных:

  1. Скопируйте файл getting_started.html из <data_source_library_install>/examples/src/html
    в <tomcat_home>/webapps/myWebApp/ .
  2. Щелкните следующую ссылку http://localhost:8080/myWebApp/getting_started.html , вы должны увидеть следующее:



    Вот и все! Вы настроили свой первый источник данных.

Следующие шаги

Следующий пример описан в разделе Использование внешнего хранилища данных . В качестве альтернативы вы можете вернуться к Введению или изучить следующие ссылки: