Генерирование кода pureQuery из алиасов, таблиц и производных таблиц

Можно сгенерировать функцию bean pureQuery из таблицы, производной таблицы, алиаса или материализованной таблицы запросов в базе данных. Можно также сгенерировать код для использовании как стиля программирования с аннотированными методами, так и стиля со встроенными методами.

Предварительные требования:

Функции bean pureQuery полезны для передачи входных значений аннотированным или встроенным методам для запросов или изменения объектов баз данных, на которых эти функции bean основаны.

Если вы хотите использовать стиль программирования с аннотированными методами, можно выбрать для генерации следующие объекты Java:
  • Интерфейс, который содержит абстрактные аннотированные методы для запросов и изменения объектов баз данных. На этих методах основаны сгенерированные функции bean pureQuery.

    Если вы решите генерировать этот интерфейс, инструментальная среда во время построения проекта Java сгенерирует также реализацию этого интерфейса.

  • Тестовый класс, который вызывает методы в этой реализации и выводит результаты в окне Консоль.

    Если вы решите не генерировать этот тестовый класс, это можно будет сделать позже, щелкнув правой кнопкой мыши по функции bean и выбрав Генерировать код pureQuery. Эта опция также перегенерирует связанный с ним интерфейс и реализацию этого интерфейса.

Если вы хотите использовать стиль программирования со встроенными методами, можно выбрать генерирование тестового класса, который содержит встроенные методы для запросов и изменения объектов баз данных. На этих методах основаны сгенерированные функции bean pureQuery. Когда вы запускаете этот класс, результаты выводятся в окне Консоль. Если вы решите не генерировать этот тестовый класс, это можно будет сделать позже, щелкнув правой кнопкой мыши по функции bean и выбрав Генерировать код pureQuery.

Порядок действий:

Чтобы сгенерировать:

  1. В проводнике баз данных щелкните правой кнопкой по алиасу, таблице или производной таблице, которую хотите представить в виде функции bean Java, и выберите Генерировать код pureQuery. Откроется мастер Генерировать код pureQuery для таблицы.
  2. На первой странице этого мастера выполните следующие действия:
    1. Задайте папку в проекте Java, в которую вы хотите поместить сгенерированные файлы.
    2. Задайте пакет, в который будут включены сгенерированные файлы.
    3. Задайте имя функции bean pureQuery, которая будет представлять этот алиас, таблицу или производную таблицу. Можно передавать функции bean pureQuery в качестве входных параметров аннотированным или встроенным методам для запросов или изменения объектов баз данных.
    4. Укажите, хотите ли вы генерировать код для метода с аннотациями, в стиле программирования со встроенными методами или же оба варианта кода.
    5. Если вы выбрали генерирование одного или обоих из тестовых классов, укажите, надо ли создавать тестовые наборы JUnit в них.
    6. Если вы выбрали генерирование одного или обоих из тестовых классов, укажите, надо ли включать в них информацию о соединении с базой данных. Если включить эту информацию, тестовые классы сгенерированного кода будут содержать URL источника данных и ID пользователя для соединения с этим источником данных.
    7. Если в вашем проекте Java еще не сконфигурирована поддержка pureQuery, выполните следующие действия:
      • Не обязательно: Включите переключатель Импортировать требуемые файлы JAR pureQuery в проект, если вы хотите, чтобы инструментальная среда скопировала в проект файл JAR, обеспечивающий поддержку pureQuery.

        Нет необходимости выбирать эту опцию, если вы включили этот файл в classpath для вашего проекта Java. Например, если у вас есть несколько проектов Java для pureQuery в вашем рабочем пространстве, можно выбрать включение файла JAR в classpath для каждого из проектов вместо того, чтобы импортировать этот файл в каждый проект. Чтобы включить файл JAR в classpath для вашего проекта Java, щелкните правой кнопкой мыши по проекту и выберите Свойства. В окне Свойства откройте страницу Путь построения Java. Выберите вкладку Библиотека и нажмите кнопку Добавить внешний файл JAR.

        Файл JAR называется pdq.jar и по умолчанию находится в подключаемом модуле com.ibm.pdq.tools.

      • Если вы собираетесь использовать стиль программирования с аннотированными методами, укажите каталог в вашем проекте, в который вы хотите помещать генерируемые инструментальной средой реализации интерфейса.

        Если вы планируете использовать стиль программирования со встроенными методами, инструментальная среда не использует эту папку, однако ее имя все равно надо задать. Можно оставить значение по умолчанию.

        Это поле указывает каталог в вашем проекте Java; оно не соответствует опции rootPath в генераторе pureQuery.

  3. На второй странице этого мастера выполните следующие действия:
    1. Задайте, хотите ли вы сделать поля в сгенерированной функции bean общедоступными или защищенными. Если вы решили сделать поля защищенными, инструментальная среда сгенерирует методы accessor и mutator для этих полей.
    2. Измените любые из имен или типов полей, которые отображаются на столбцы таблицы.
  4. На третьей странице этого мастера (она появляется, только если вы выбрали генерирование интерфейса) выполните следующие действия:
    1. Задайте, для каких операторов SQL вы хотите включить абстрактные методы в интерфейс. Каждый оператор SQL появится в аннотации к соответствующему абстрактному методу.
    2. Укажите, хотите ли вы, чтобы звездочка представляла все столбцы таблицы в операторах SELECT.
  5. Нажмите кнопку Готово, чтобы сгенерировать указанные вами файлы.
Задачи, связанные с данной
Генерирование кода pureQuery из хранимых процедур
Создание Java Emitter Templates (JET) Eclipse Modeling Framework Technologies (EMFT) для генерирования настроенного кода
Разработка программ pureQuery при помощи инструментальной среды
Информация, связанная с данной
Соединение с базой данных при помощи мастера

Отзыв