Génération de code pureQuery à partir de beans

Vous pouvez générer du code pureQuery à partir d'un bean ouvert dans l'éditeur Java. Si aucune table correspondant au bean n'existe dans la base de données associée, vous pouvez générer une instruction DDL pour créer la table.

Avant de commencer

Affichez l'explorateur de source de données et l'affichage de console dans votre plan de travail :
  • Si l'explorateur de sources de données n'est pas ouvert dans le plan de travail, sélectionnez Fenêtre > Afficher la vue > Autre. Dans la fenêtre Afficher la vue, sélectionnez Connectivité > Explorateur de sources de données.
  • Si la vue de la console n'est pas ouverte dans le plan de travail, sélectionnez Fenêtre > Afficher la vue > Console.
  • Si la vue de la console est ouverte dans le plan de travail, cliquez sur cette vue avec le bouton droit de la souris puis sélectionnez Effacer.

Pourquoi et quand exécuter cette tâche

Si vous souhaitez utiliser les méthodes annotées, vous pouvez choisir de générer les objets Java suivants :
  • Une interface qui contient des méthodes abstraites annotées avec les instructions SQL pour analyser et mettre à jour la table sur laquelle le bean généré est basé. Vous devez disposer de tous les privilèges requis pour l'exécution d'instructions SQL.

    Si vous choisissez de générer cette interface, le plan de travail crée également une implémentation de l'interface lors d'une génération du projet Java.

  • Une classe de test qui appelle les méthodes dans l'implémentation et affiche les résultats dans la vue Console.

    Si vous choisissez de ne pas générer la classe de test ici, vous pouvez le faire ultérieurement en cliquant sur le bean avec le bouton droit de la souris et en sélectionnant pureQuery > Générer le code pureQuery. Cette option génère également l'interface associée ainsi que l'implémentation de cette interface.

Si vous souhaitez utiliser des méthodes intégrées, vous pouvez choisir de générer une classe de test qui contient des méthodes intégrées permettant d'analyser et de mettre à jour la table sur laquelle le bean généré est basé. Lorsque vous exécutez la classe, les résultats s'affichent dans la vue Console. Si vous choisissez de ne pas générer la classe de test ici, vous pouvez le faire ultérieurement en cliquant sur le bean avec le bouton droit de la souris et en sélectionnant pureQuery > Générer le code pureQuery.

Restriction : Vous ne pouvez pas générer de vues à partir de beans.

Procédure

Pour générer du code à partir d'un bean :

  1. Créez un bean correspondant à une table, ou importez le bean dans votre projet Java.
  2. Ouvrez le bean dans l'éditeur Java.
  3. Si la base de données associée à votre projet Java ne contient pas encore de table correspondant au bean, procédez comme suit :
    1. Cliquez sur le bean avec le bouton droit de la souris puis sélectionnez pureQuery > Générer un fichier DDL. Le fichier DDL apparaît dans la console.
    2. Copiez le contenu du fichier DDL et collez-le dans un nouveau fichier texte. Si vous voulez exécuter le langage DLL à partir du plan de travail, vous pouvez créer un nouveau fichier dans votre projet Java. Attribuez à ce fichier l'extension .sql.
    3. Exécutez le code DDL sur la base de données.
    4. Si vous souhaitez vous assurer que la table a été correctement créée, suivez l'une des étapes ci-après ou bien les deux :
      • Pour vérifier que le nom du bean est bien mappé vers la table appropriée, cliquez sur ce bean avec le bouton droit de la souris puis sélectionnez Afficher les tables dans l'explorateur de sources de données. La table est alors mise en évidence.
      • Pour vérifier qu'une propriété donnée est bien mappée à la colonne appropriée, cliquez avec le bouton droit de la souris sur le nom de cette propriété, puis sélectionnez Show Table in Data Source Explorer (Afficher la table dans l'Explorateur de source de données). La colonne associée à la propriété est alors mise en évidence.
  4. Dans l'éditeur Java, cliquez sur le bean avec le bouton droit de la souris puis sélectionnez pureQuery > Générer le code pureQuery. L'assistant Génération du code pureQuery à partir d'une table s'ouvre.
  5. Suivez les étapes de l'assistant. Pour des informations détaillées sur chaque zone, appuyez sur la touche F1.
  6. Cliquez sur Terminer pour générer les fichiers que vous avez spécifiés.

Résultats

Le tableau suivant répertorie les types de données Java et les types de données SQL Oracle correspondants :

Tableau 1. Comment les types de données Java sont mappés aux types SQL Oracle dans DDL générés par le plan de travail à partir de beans
Type de données Java Type de données Oracle SQL
BigDecimal NUMBER(9 , 2)
Blob BLOB
Boolean RAW(1)
boolean RAW(1)
byte RAW(1)
BYTE_ARRAY RAW(2000)
char CHAR(1)
CHAR_ARRAY VARCHAR2(255)
Clob CLOB
Date DATE
Double BINARY_DOUBLE
double BINARY_DOUBLE
Float BINARY_FLOAT
float BINARY_FLOAT
int NUMBER
Integer NUMBER
Long NUMBER
long NUMBER
Ref VARCHAR2(255)
Short NUMBER
short NUMBER
String VARCHAR2(255)
Time DATE
Timestamp TIMESTAMP(6)
URL BFILE

Commentaires