< Précédent | Suivant >

Leçon 1 : Définition de votre projet Java

Dans cette leçon, vous configurerez Optim Development Studio pour développer une application Java utilisant l'optimisation client pureQuery.

Avant de commencer

Assurez-vous que vous pouvez vous connecter à la base de données DB2 SAMPLE à partir de votre ordinateur.

Dans cette leçon, vous allez créer un projet Java et une connexion à la base de données avec le plan de travail, vous allez créer une application Java simple et ajouter au projet le support pureQuery.

Création d'une connexion à la base de données et d'un projet Java

L'activation du support pureQuery dans le plan de travail requiert à la fois un projet Java et une connexion à la base de données. Vous pouvez créer le projet et la connexion dans n'importe quel ordre.
Ce tutoriel suppose que le plan de travail démarre avec la perspective Développement de routine et de code SQL IBM® et l'ensemble de vues par défaut.

Vous créez une connexion à la base de données SAMPLE dans le plan de travail à l'aide de la perspective Développement de routine et de code SQL. Vous basculez ensuite vers la perspective Java et créez un projet Java. La connexion à la base de données est nécessaire lorsque vous activez le support pureQuery pour le projet

Pour créer une connexion à la base de données et un projet Java :

  1. Démarrez Optim Development Studio.

    Le plan de travail ouvre la perspective Développement de routine et de code SQL IBM.

  2. Créez une connexion à la base de données SAMPLE.
    1. Dans la fenêtre Explorateur de source de données, cliquez avec le bouton droit de la souris sur le dossier Connexions à la base de données et sélectionnez Nouveau.
    2. Suivez les étapes de l'assistant pour créer une connexion à votre instance de la base de données SAMPLE.
      Dans Paramètres de connexion, sélectionnez les éléments suivants pour créer une connexion DB2 :
      • Dans la zone Select a database manager field (Sélectionner une zone de gestionnaire de base de données), sélectionnez DB2 for Linux, UNIX, and Windows.
      • Dans la zone Pilote JDBC, sélectionnez IBM Data Server Driver for JDBC et SQLJ (JDBC 4.0) par défaut.
  3. Passez dans la perspective Java.

    Cliquez sur Navigateur de tâches > Java Database Application Development.

    La perspective Java s'ouvre. Ce tutoriel suppose que vous travaillez avec la perspective Java par défaut.

    Notez les deux onglets dans l'angle supérieur gauche de la perspective Java : les onglets Explorateur de package et Hiérarchie :

    Figure 1. Onglets Explorateur de packages et Hiérarchie
    Onglets Explorateur de package et Hiérarchie
  4. Si la vue Lanceur de tâches est ouverte, fermez-la.

    Cliquez sur X dans l'onglet Lanceur de tâches.

  5. Créez un projet Java.
    1. Cliquez avec le bouton droit de la souris dans l'explorateur de packages et sélectionnez Nouveau > Projet Java.

      L'assistant Nouveau projet Java s'ouvre.

    2. Saisissez pq-tutorial dans la zone Nom de projet en haut de l'assistant. Conservez les valeurs par défaut des options restantes.
    3. Cliquez sur Terminer.

    Optim Development Studio crée votre projet Java. Vous voyez le projet pq-tutorial dans l'Explorateur de package.

    Figure 2. Le projet Java pureQuery_test dans l'explorateur de packages
    Vue Explorateur de package avec le projet pureQuery_test

Ajout d'une application Java simple à votre projet

Vous ajoutez le code pour une application Java simple à votre projet. L'application exécute des instructions SQL différentes sur la base de données SAMPLE.

Pour ajouter une application Java simple à votre projet :

  1. Créez un package dans votre projet.
    1. Dans l'Explorateur de package, cliquez avec le bouton droit de la souris sur le dossier pq_tutorial/src, puis cliquez sur Nouveau > Classe. L'assistant Nouvelle classe Java s'ouvre.
    2. Renseignez les zones suivantes :
      • Dans la zone Package, saisissez myTestApp.
      • Dans la zone Nom, entrez MySample.
    3. Modifiez les paramètres suivants :

      Dans la section Which method stubs would you like to create (Quel module de remplacement de méthode souhaitez-vous créer) :

      • Sélectionnez public static void (main[] string args).
      • Décochez Inherited abstract methods (Méthodes abstraites non héritées).
    4. Cliquez sur Terminer.
    Le plan de travail crée une classe et ouvre le fichier MySample.java dans l'éditeur Java.
  2. Ajoutez le code source pour l'application.

    Remplacez le texte dans le fichier MySample.java par le texte du code source du tutoriel . .

  3. Sauvegardez le fichier.

Vous avez créé une classe et ajouté le code Java à un fichier Java.

Dans l'éditeur Java, certaines erreurs apparaîtront. Les erreurs sont résolues lorsque vous activez la prise en charge de pureQuery pour le projet.

Ajout de la prise en charge de pureQuery à votre projet Java

Vous activez la prise en charge de pureQuery pour votre projet Java.

Avant de commencer

Vous devez avoir créé une connexion à la base de données et un projet Java.

Pour ajouter le support de pureQuery à votre projet Java, procédez comme suit :

  1. Dans l'Explorateur de package, cliquez avec le bouton droit de la souris sur le dossier du projet pq-tutorial et cliquez sur pureQuery > Ajouter le support pureQuery.

    L'élément de menu pureQuery se trouve dans la partie inférieure du menu.

  2. Dans l'assistant Ajouter le support pureQuery, sélectionnez la connexion SAMPLE dans la page Sélectionner les connexions et cliquez sur Suivant.
  3. Dans la page Ajout du support pureQuery, acceptez les paramètres par défaut et cliquez sur Terminer.
Votre projet Java est activé avec le support pureQuery. Les événements suivants se produisent :
  • Les bibliothèques DB2 utilisées par l'application Java pour se connecter à la base de données SAMPLE sont ajoutées au chemin de génération du projet Java.
  • Les fichiers pureQuery Runtime pdq.jar et pdqmgmt.jar sont ajoutés au projet Java.
  • Les fichiers de configuration pureQuery utilisés avec les utilitaires pureQuery Configure et StaticBinder sont ajoutés au dossier pureQueryFolder.
  • Une connexion à la base de données SAMPLE et les propriétés du projet pureQuery sont ajoutées aux propriétés de votre projet.
Lorsqu'une application Java est activée avec le support pureQuery, vous pouvez utiliser les fonctions pureQuery suivantes :
  • Assistance SQL avancée avec l'éditeur Java, qui inclut le formatage SQL, l'assistance au contenu pour les instructions SQL et les modèles SQL.
  • La vue Structure SQL, que vous pouvez utiliser pour visualiser la relation entre les instructions SQL, les objets de base de données et le code source Java.
  • Les éditeurs pour le fichier pureQueryXML, le fichier d'options pureQuery StaticBinder et le fichier d'options de configuration pureQuery.
  • L'API pureQuery.

Exécution de votre application Java

Vous mettez à jour les informations de connexion spécifiées dans le code source de votre application Java et exécutez l'application.
  1. Mettez à jour les informations de connexion à la base de données dans le code Java pour votre installation.
    1. Accédez à la méthode public static Connection getConnection().
    2. Dans les paramètres de la méthode getConnection, mettez à jour l'hôte, le numéro de port, le nom d'utilisateur et le mot de passe pour qu'ils correspondent à la connexion à la base de données SAMPLE sur votre ordinateur.
      Dans l'exemple de connexion suivant, l'hôte, le numéro de port et la base de données sont localhost:50000/SAMPLE et le nom d'utilisateur et le mot de passe sont testuser1 et mypwd:
      jdbcCon=DriverManager.getConnection(
      "jdbc:db2://localhost:50000/SAMPLE:" +
      "retrieveMessagesFromServerOnGetMessage=true;",
      "testuser1", "mypwd");
      Remarque : Dans cet exemple d'application, les informations de connexion, y compris le nom d'utilisateur et le mot de passe, sont incluses dans l'application pour être facilement mises à jour. Dans une application de production, le nom d'utilisateur et le mot de passe ne seraient pas inclus avec l'application.
  2. Sauvegardez le fichier.
  3. Exécutez l'application.

    Dans l'Explorateur de package, cliquez avec le bouton droit de la souris sur le fichier MySample.java, puis cliquez sur Run As (Exécuter en tant que) > Application Java.

    La sortie s'affiche dans la fenêtre Console. La sortie est similaire à l'exemple suivant :
     =======
    IBM Optim pureQuery Runtime 2.2.1.0 build 2.25.63
     =======
    case 0
    case 0 - employee count: 36
    Finished case 0

Point de contrôle de la leçon

Dans cette leçon, vous avez utilisé le plan de travail pour créer une application Java qui se connecte à la base de données SAMPLE DB2 et testé l'application.

Vous avez appris à effectuer les tâches suivantes :

  • Création d'un projet Java.
  • Activation d'un projet Java avec le support pureQuery.
  • Exécution d'une application Java.
< Précédent | Suivant >

Commentaires