Generowanie kodu pureQuery na podstawie procedur składowanych

Jeśli procedura składowana ma parametry, można wygenerować komponent bean pureQuery reprezentujący te parametry. Jeśli procedura składowana zwraca tabele wynikowe, komponent bean pureQuery można wygenerować dla każdej tabeli wynikowej. Kod można także wygenerować do wsparcia stylów programowania metody z adnotacją i metody wstawianej.

Wymagania wstępne:

Komponenty bean pureQuery są przydatne przy przekazywaniu wartości wejściowych do metod z adnotacją lub metod wstawianych w celu wywołania procedur składowanych, na których oparte są te komponenty bean.

Jeśli ma być wykorzystywany styl programowania metody z adnotacją, można wybrać generowanie następujących obiektów języka Java:
  • Interfejs, który zawiera abstrakcyjną metodę z adnotacją do wywoływania procedury składowanej.

    Jeśli wybrane zostanie generowanie tego interfejsu, podczas budowania projektu Java środowisko robocze wygeneruje także implementację interfejsu.

  • Klasa testowa, która wywołuje metody z implementacji i wyświetla wyniki w widoku Konsola.

Jeśli ma być wykorzystywany styl programowania metody wstawianej, można wybrać generowanie klasy testowej, która zawiera metodę wstawianą do wywoływania procedury składowanej, na której są oparte wygenerowane komponenty bean pureQuery. Po uruchomieniu tej klasy wyniki są wyświetlane w widoku Konsola.

Procedura:

Aby wygenerować kod pureQuery na podstawie procedury składowanej:

  1. W Eksploratorze bazy danych prawym przyciskiem myszy kliknij wybraną procedurę składowaną i wybierz opcję Generuj kod pureQuery. Zostanie otwarty kreator Generowanie kodu pureQuery dla procedury składowanej.
  2. Na pierwszej stronie kreatora wykonaj następujące czynności:
    1. Określ folder w projekcie Java, który ma zawierać wygenerowane pliki.
    2. Określ pakiet, którego częścią mają się stać wygenerowane pliki.
    3. Określ, czy wygenerowany ma zostać kod dla stylu programowania metody z adnotacją, metody wstawianej lub obu.
    4. Jeśli ma być wygenerowana jedna lub obie klasy testowe, określ, czy mają w nich zostać utworzone przypadki testowe JUnit.
    5. Jeśli ma być wygenerowana jedna lub obie klasy testowe, określ, czy mają do nich zostać dołączone informacje dotyczące połączenia z bazą danych. Jeśli te informacje zostaną dołączone, wygenerowane klasy testowe kodu zawierają adres URL źródła danych oraz identyfikator użytkownika do użycia podczas łączenia się ze źródłem danych.
    6. Jeśli projekt Java nie jest jeszcze skonfigurowany do obsługi kodu pureQuery, należy wykonać następujące czynności:
      • Opcjonalnie: Zaznacz pole wyboru Importuj do projektu wymagane pliki JAR pureQuery, jeśli środowisko robocze ma kopiować do projektu plik JAR, który zapewnia obsługę kodu pureQuery.

        Nie trzeba zaznaczać tej opcji, jeśli ten plik zostanie dołączony do ścieżki klasy projektu Java. Na przykład jeśli dla kodu pureQuery w środowisku roboczym znajduje się więcej niż jeden projekt Java, plik JAR można dołączyć do ścieżki klasy dla każdego projektu, zamiast importować go osobno do każdego projektu. Aby dołączyć plik JAR do ścieżki klasy dla projektu Java, projekt należy kliknąć prawym przyciskiem myszy i wybrać opcję Właściwości. W oknie Właściwości należy otworzyć stronę Ścieżka budowania Java. Następnie należy wybrać kartę Biblioteka i kliknąć opcję Dodaj zewnętrzny plik JAR.

        Plikiem JAR jest plik pdq.jar, który domyślnie znajduje się we wtyczce com.ibm.pdq.tools.

      • Jeśli planowane jest wykorzystanie stylu programowania metody z adnotacją, należy określić katalog w projekcie, który ma zawierać implementacje interfejsów generowanych przez środowisko robocze.

        Jeśli planowane jest wykorzystanie stylu programowania metody wstawianej, środowisko robocze nie korzysta z tego folderu, ale folder ten nadal wymaga nazwy. Można zachować wartość domyślną.

        To pole wymaga podania katalogu w projekcie Java i nie odpowiada opcji rootPath generatora kodu pureQuery.

  3. Na stronie Definicja komponentu bean dla parametrów kreatora, która jest wyświetlana tylko wtedy, gdy procedura składowana ma parametry, wykonaj te czynności, aby zdefiniować komponent bean, w którym parametry procedury składowanej odpowiadają polom w komponencie bean:
    1. Określ, czy pola w wygenerowanym komponencie bean pureQuery mają być publiczne czy też chronione. Jeśli pola mają być chronione, środowisko robocze generuje dla tych pól metodę akcesora i metodę mutatora.
    2. Zmień nazwy lub typy pól, które są odwzorowywane na parametry w procedurze składowanej.
  4. Na stronie Definicja komponentu bean dla tabel wynikowych kreatora wykonaj następujące czynności, aby zdefiniować komponent bean oraz pola każdej tabeli wynikowej, jeśli procedura składowana zwraca tabele wynikowe:
    1. Określ nazwę podstawową komponentów bean. Środowisko robocze nadaje tę nazwę pierwszemu komponentowi bean, a dla następnych dodaje do niej podkreślenie oraz kolejny numer. Na przykład jeśli nazwą podstawową jest MójKomponent, nazwa pierwszego komponentu bean to także MójKomponent. Kolejne komponenty bean mają nazwy MójKomponent_1, MójKomponent_2 i tak dalej.
    2. Określ, czy pola w wygenerowanych komponentach bean mają być publiczne czy też chronione. Jeśli pola mają być chronione, środowisko robocze generuje dla tych pól metodę akcesora i metodę mutatora.
    3. Kliknij opcję Wykryj tabele wynikowe. Środowisko robocze musi uruchomić procedurę składowaną, aby sprawdzić, ile jest różnych tabel wynikowych oraz kolumn, które one zawierają. Po uruchomieniu procedury składowanej lista tabel wynikowych jest wyświetlana poniżej przycisku. Dla każdej tabeli wynikowej można zmienić nazwy oraz typy pól, które są odwzorowywane na kolumny.
  5. Kliknij przycisk Zakończ, aby wygenerować pliki, które zostały określone.
Zadania pokrewne
Generowanie kodu pureQuery na podstawie aliasów, tabel lub widoków
Tworzenie szablonów JET (Java Emitter Templates) środowiska EMFT (Eclipse Modeling Framework Technologies) do generowania niestandardowego kodu
Tworzenie aplikacji pureQuery w środowisku roboczym
Informacje pokrewne
Nawiązywanie połączenia z bazą danych za pomocą kreatora

Opinia