Premiers pas avec les sources de données

Cette section présente SimpleExampleServlet, l'exemple d'implémentation le plus simple d'une source de données fournie avec la bibliothèque. Elle fournit également des instructions détaillées sur l'exécution et le test de SimpleExampleServlet.

Présentation de SimpleExampleServlet

La classe SimpleExampleServlet se trouve dans le package examples. Elle fournit un exemple de l'implémentation la plus simple d'une source de données. SimpleExampleServlet hérite de DataSourceServlet, implémente generateDataTable() et doit être exécuté dans un conteneur de servlet.

Un extrait de SimpleExampleServlet est fourni ci-dessous. La fonction generateDataTable expose les données à la bibliothèque. Elle crée une description de table de données, définit les colonnes de la table de données et remplit la table de données avec des données. La bibliothèque gère toutes les autres actions requises pour renvoyer la table de données à la visualisation de requête.

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

Exécution et test de SimpleExampleServlet

Cette section explique comment exécuter et tester SimpleExampleServlet.

Si ce n'est pas déjà fait, consultez la section Installation pour obtenir des informations sur les prérequis et des instructions sur le téléchargement et la création de la bibliothèque. Assurez-vous d'installer un serveur Web qui fonctionne également comme conteneur de servlet, tel qu'Apache Tomcat, si vous n'en avez pas déjà un sur votre système. Les instructions de cette section sont spécifiques à Apache Tomcat sur un système Windows.

Pour exécuter et tester SimpleExampleServlet, créez une application Web qui exécute la source de données SimpleExampleServlet, puis exécutez une page Web d'exemple avec une visualisation affichant les données interrogées à partir de la source de données. Ce processus est décrit dans les sections suivantes :

Créer une application Web sur Apache Tomcat

Suivez ou adaptez les instructions ci-dessous pour créer une application Web sur Apache Tomcat. Ces instructions sont spécifiques à Apache Tomcat sur un système Windows :

  1. Accédez au répertoire dans lequel vous avez installé Tomcat. Dans ce document, il est écrit comme <tomcat_home>.
     
  2. Accédez au sous-répertoire webapps.
     
  3. Créez un sous-répertoire appelé myWebApp.
     
  4. Accédez au sous-répertoire que vous venez de créer et créez-en un autre appelé WEB-INF.
     
  5. Accédez au sous-répertoire WEB-INF et créez-en un autre appelé lib.
    Le chemin complet doit être <tomcat_home>/webapps/myWebApp/WEB-INF/lib.
     
  6. Copiez web.xml de <data_source_library_install>/examples/src/html dans le répertoire WEB-INF. Où <data_source_library_install> est le répertoire dans lequel vous avez installé la bibliothèque de sources de données. Les lignes suivantes de web.xml définissent et mappent 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. Accédez au répertoire dans lequel vous avez installé la bibliothèque de sources de données. Dans ce document, il est écrit <data_source_library_install>.
     
  8. Copiez tous les packages de dépendances dans <tomcat_home>/webapps/myWebApp/WEB-INF/lib. Les packages sont installés dans <data_source_library_install>/lib, sauf si vous les placez dans un autre répertoire.
     
  9. Si vous avez créé la bibliothèque vous-même, copiez visualization-datasource-1.0.2.jar et visualization-datasource-examples.jar
    de <data_source_library_install>/build
    à <tomcat_home>/webapps/myWebApp/WEB-INF/lib.

    Si vous avez décompressé le fichier ZIP, copiez visualization-datasource-1.0.2.jar et visualization-datasource-examples.jar
    de <data_source_library_install>
    à <tomcat_home>/webapps/myWebApp/WEB-INF/lib.
    Notez que le numéro de version dans le nom du fichier JAR peut varier en fonction du dernier numéro de version.
  10. Démarrez Tomcat ou redémarrez-le s'il est déjà en cours d'exécution.
     
  11. Cliquez sur le lien suivant :

    http://localhost:8080/myWebApp/simpleexample

    L'écran affiche 6 à 7 lignes de texte, selon la largeur de votre écran.
    Le texte commence par google.visualization.Query.setResponse
    et se termine par /Tiger'},{v:80.0},{v:false}]}]}});

    Il s'agit des données renvoyées par votre source de données à une visualisation de requête.

Utiliser une visualisation pour afficher les données

Le fichier getting_started.html du répertoire <data_source_library_install>/examples/src/html peut être utilisé pour afficher une visualisation des données. La ligne suivante, extraite de getting_started.html, spécifie le servlet à utiliser. Le mappage de servlet a été configuré à l'étape 8 de la section Créer une application Web sur Apache Tomcat.

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

Pour en savoir plus sur la spécification d'une visualisation et l'utilisation du langage de requête, consultez la section Utiliser des graphiques et la référence du langage de requête.

Suivez ou adaptez les instructions ci-dessous pour afficher une visualisation des données fournies par la source de données :

  1. Copiez le fichier getting_started.html du répertoire <data_source_library_install>/examples/src/html
    dans le répertoire <tomcat_home>/webapps/myWebApp/.
     
  2. Cliquez sur le lien suivant : http://localhost:8080/myWebApp/getting_started.html, vous devriez voir ce qui suit :
     


    Et voilà ! Vous avez configuré votre première source de données.

Étapes suivantes

L'exemple suivant est décrit dans la section Utiliser un magasin de données externe. Vous pouvez également revenir à l'introduction ou explorer les liens suivants :