Персональные инструменты
 

Кодогенерация в Oracle и не только — различия между версиями

Материал из CustisWiki

Перейти к: навигация, поиск
(Новая страница: «<blockquote>''Виктор Осоловский, наш разработчик-экспе…»)
 
м
 
(не показана одна промежуточная версия этого же участника)
Строка 1: Строка 1:
<blockquote>''[[:Категория:Виктор Осоловский (Статьи)|Виктор Осоловский]], наш разработчик-эксперт, опубликовал в блоге компании на [http://habrahabr.ru/ «Хабрахабре»] статью, посвященную решению проблемы кодогенерации при&nbsp;разработке приложений для&nbsp;СУБД&nbsp;Oracle. Какие существуют возможности для генерации кода «из&nbsp;коробки»? В чем заключаются достоинства и&nbsp;недостатки клиентских средств и&nbsp;сторонних решений? Каким образом удалось создать свой инструмент для решения проблемы с&nbsp;генерацией кода? Ответы на эти вопросы&nbsp;— в материале [http://habrahabr.ru/company/custis/blog/253881/ «Кодогенерация в Oracle и не только»].''</blockquote>
+
<blockquote>''[[:Категория:Виктор Осоловский (Статьи)|Виктор Осоловский]], наш разработчик-эксперт, опубликовал в&nbsp;блоге компании на&nbsp;[http://habrahabr.ru/ «Хабрахабре»] статью, посвященную решению проблемы кодогенерации при&nbsp;разработке приложений для&nbsp;СУБД&nbsp;Oracle. Какие существуют возможности для&nbsp;генерации кода «из&nbsp;коробки»? В&nbsp;чем заключаются достоинства и&nbsp;недостатки клиентских средств и&nbsp;сторонних решений? Каким образом удалось создать свой инструмент для&nbsp;решения проблемы с&nbsp;генерацией кода? Ответы на&nbsp;эти вопросы&nbsp;— в&nbsp;материале [http://habrahabr.ru/company/custis/blog/253881/ «Кодогенерация в&nbsp;Oracle и&nbsp;не&nbsp;только»].''</blockquote>
В этой статье я расскажу о&nbsp;решении проблемы кодогенерации при разработке приложений для&nbsp;СУБД&nbsp;Oracle. Хотя написанное ниже частично можно применить и&nbsp;к&nbsp;другим СУБД, и&nbsp;для&nbsp;генерации не&nbsp;только кода.
+
 
 +
В&nbsp;этой статье я&nbsp;расскажу о&nbsp;решении проблемы кодогенерации при&nbsp;разработке приложений для&nbsp;СУБД&nbsp;Oracle. Хотя написанное ниже частично можно применить и&nbsp;к&nbsp;другим&nbsp;СУБД, и&nbsp;для&nbsp;генерации не&nbsp;только кода.
  
 
== Проблема ==
 
== Проблема ==
  
При разработке приложений иногда возникают ситуации, когда требуется написать много похожих кусков кода, которые в&nbsp;силу различных ограничений нельзя заменить одной универсальной программной единицей. Следуя принципу&nbsp;[http://en.wikipedia.org/wiki/Don%27t_repeat_yourself DRY], вместо того чтобы копировать похожие фрагменты кода вручную с заменой отличающихся частей, лучше воспользоваться техникой кодогенерации из статичных заготовок на основе метаданных, вносящих разнообразие в получившиеся экземпляры кода. К&nbsp;кодогенерации приходится прибегать как в&nbsp;develop/deploy-time (когда все вариации известны заранее и&nbsp;есть возможность создать весь спектр экземпляров кода в&nbsp;статичном виде), так и&nbsp;в&nbsp;runtime, когда код генерируется на&nbsp;основе неизвестных заранее данных и&nbsp;сразу же&nbsp;исполняется.
+
При&nbsp;разработке приложений иногда возникают ситуации, когда требуется написать много похожих кусков кода, которые в&nbsp;силу различных ограничений нельзя заменить одной универсальной программной единицей. Следуя принципу&nbsp;[http://en.wikipedia.org/wiki/Don%27t_repeat_yourself DRY], вместо того чтобы копировать похожие фрагменты кода вручную с&nbsp;заменой отличающихся частей, лучше воспользоваться техникой кодогенерации из&nbsp;статичных заготовок на&nbsp;основе метаданных, вносящих разнообразие в&nbsp;получившиеся экземпляры кода. К&nbsp;кодогенерации приходится прибегать как&nbsp;в&nbsp;develop/deploy-time (когда все вариации известны заранее и&nbsp;есть возможность создать весь спектр экземпляров кода в&nbsp;статичном виде), так&nbsp;и&nbsp;в&nbsp;runtime, когда код генерируется на&nbsp;основе неизвестных заранее данных и&nbsp;сразу же&nbsp;исполняется.
  
Специфика кодогенерации при разработке приложений для&nbsp;СУБД состоит в&nbsp;том, что метаданные, как правило, хранятся в&nbsp;ней&nbsp;же.
+
Специфика кодогенерации при&nbsp;разработке приложений для&nbsp;СУБД состоит в&nbsp;том, что&nbsp;метаданные, как правило, хранятся в&nbsp;ней&nbsp;же.
  
 
Приведу несколько примеров задач, в&nbsp;которых востребована кодогенерация:
 
Приведу несколько примеров задач, в&nbsp;которых востребована кодогенерация:
  
 
* формирование SQL/DML/DDL-выражений на&nbsp;основе пользовательского  
 
* формирование SQL/DML/DDL-выражений на&nbsp;основе пользовательского  
* создание процедуры загрузки в систему-приемник очередного источника данных по&nbsp;его метаописанию в&nbsp;удаленной (remote) системе-источнике;
+
* создание процедуры загрузки в&nbsp;систему-приемник очередного источника данных по&nbsp;его метаописанию в&nbsp;удаленной (remote) системе-источнике;
* разворачивание системы в разных окружениях, версиях и редакциях СУБД, где необходимо (де)активировать некоторые опции или создать вспомогательные объекты: например, при разворачивании Oracle-приложения на&nbsp;редакции&nbsp;EE секционировать таблицы и&nbsp;строить локальные индексы; или&nbsp;при разворачивании на&nbsp;версии Oracle ниже&nbsp;11 вместо виртуальных колонок и&nbsp;индексов по&nbsp;ним создавать представления-обертки с&nbsp;дополнительными вычислимыми колонками и&nbsp;строить function-based-индексы.
+
* разворачивание системы в&nbsp;разных окружениях, версиях и&nbsp;редакциях&nbsp;СУБД, где необходимо (де)активировать некоторые опции или&nbsp;создать вспомогательные объекты: например, при&nbsp;разворачивании Oracle-приложения на&nbsp;редакции&nbsp;EE секционировать таблицы и&nbsp;строить локальные индексы; или&nbsp;при&nbsp;разворачивании на&nbsp;версии Oracle ниже&nbsp;11 вместо виртуальных колонок и&nbsp;индексов по&nbsp;ним создавать представления-обертки с&nbsp;дополнительными вычислимыми колонками и&nbsp;строить function-based-индексы.
  
 
== Родные средства Oracle ==
 
== Родные средства Oracle ==
  
Oracle предоставляет несколько возможностей для генерации кода «из&nbsp;коробки». Бегло рассмотрим существующие средства и&nbsp;их&nbsp;достоинства и&nbsp;недостатки.
+
Oracle предоставляет несколько возможностей для&nbsp;генерации кода «из&nbsp;коробки». Бегло рассмотрим существующие средства и&nbsp;их&nbsp;достоинства и&nbsp;недостатки.
  
 
=== Серверные средства ===
 
=== Серверные средства ===
  
«Серверные» в&nbsp;данном контексте означает, что процесс кодогенерации происходит на&nbsp;сервере внутри самой&nbsp;СУБД без привлечения сторонних утилит. Как кодовая основа, так и&nbsp;метаданные хранятся&nbsp;в&nbsp;БД или&nbsp;иных источниках, доступных средствами&nbsp;СУБД.
+
«Серверные» в&nbsp;данном контексте означает, что&nbsp;процесс кодогенерации происходит на&nbsp;сервере внутри самой&nbsp;СУБД без&nbsp;привлечения сторонних утилит. Как&nbsp;кодовая основа, так&nbsp;и&nbsp;метаданные хранятся&nbsp;в&nbsp;БД или&nbsp;иных источниках, доступных средствами&nbsp;СУБД.
  
==== Динамический SQL (Dynamic SQL) ====
+
==== Динамический&nbsp;SQL (Dynamic&nbsp;SQL) ====
  
Этот способ доступен с&nbsp;давних версий Oracle и&nbsp;является самым универсальным из&nbsp;возможных. Разработчик практически ничем не&nbsp;ограничен и,&nbsp;используя все возможности языка PL/SQL, может формировать произвольные строковые выражения на&nbsp;основе данных, извлеченных из&nbsp;БД, и&nbsp;исполнять их на&nbsp;инстансе.
+
Этот способ доступен с&nbsp;давних версий Oracle и&nbsp;является самым универсальным из&nbsp;возможных. Разработчик практически ничем не&nbsp;ограничен и,&nbsp;используя все&nbsp;возможности языка&nbsp;PL/SQL, может формировать произвольные строковые выражения на&nbsp;основе данных, извлеченных из&nbsp;БД, и&nbsp;исполнять их&nbsp;на&nbsp;инстансе.
  
Еще с версии&nbsp;8i существует два механизма исполнения cгенерированного таким образом кода: DBMS_SQL&nbsp;и&nbsp;Native Dynamic&nbsp;SQL. Их различия в&nbsp;контексте данной статьи не&nbsp;очень принципиальны, важно лишь, что пользоваться вторым проще, но не&nbsp;всегда возможно, поэтому используются оба&nbsp;— в зависимости от&nbsp;задач. Подробнее о них&nbsp;и&nbsp;их различиях можно почитать в&nbsp;[https://docs.oracle.com/database/121/LNPLS/dynamic.htm#LNPLS011 документации].
+
Еще с&nbsp;версии&nbsp;8i существует два механизма исполнения cгенерированного таким образом кода: DBMS_SQL&nbsp;и&nbsp;Native Dynamic&nbsp;SQL. Их&nbsp;различия в&nbsp;контексте данной статьи не&nbsp;очень принципиальны, важно лишь, что&nbsp;пользоваться вторым проще, но&nbsp;не&nbsp;всегда возможно, поэтому используются оба&nbsp;— в&nbsp;зависимости от&nbsp;задач. Подробнее о&nbsp;них&nbsp;и&nbsp;их различиях можно почитать в&nbsp;[https://docs.oracle.com/database/121/LNPLS/dynamic.htm#LNPLS011 документации].
  
 
===== Достоинства =====
 
===== Достоинства =====
  
Использование всех возможностей PL/SQL как процедурного языка для компоновки генерируемого текста и&nbsp;как языка доступа к&nbsp;БД для выборки и&nbsp;обработки метаданных.
+
Использование всех возможностей&nbsp;PL/SQL как&nbsp;процедурного языка для&nbsp;компоновки генерируемого текста и&nbsp;как языка доступа к&nbsp;БД для&nbsp;выборки и&nbsp;обработки метаданных.
  
 
===== Недостатки =====
 
===== Недостатки =====
  
Сложность кода-генератора, как&nbsp;правило, усыпанного строковыми литералами, кавычками, операторами конкатенации, замены, символами переноса строк. Все это перемежается с&nbsp;управляющими конструкциями PL/SQL&nbsp;— условными переходами,&nbsp;циклами. За «пеленой» кода-генератора бывает непросто разглядеть генерируемый код и&nbsp;понять его логику. Поддерживать такую смесь довольно сложно. В&nbsp;то&nbsp;же время это&nbsp;самый распространенный способ кодогенерации.
+
Сложность кода-генератора, как&nbsp;правило, усыпанного строковыми литералами, кавычками, операторами конкатенации, замены, символами переноса строк. Все это перемежается с&nbsp;управляющими конструкциями PL/SQL&nbsp;— условными переходами,&nbsp;циклами. За&nbsp;«пеленой» кода-генератора бывает непросто разглядеть генерируемый код и&nbsp;понять его логику. Поддерживать такую смесь довольно сложно. В&nbsp;то&nbsp;же время это&nbsp;самый распространенный способ кодогенерации.
  
 
Выглядит это примерно так.
 
Выглядит это примерно так.
  
Приведенный ниже пакет генерирует скрипт создания секционированной таблицы товаров&nbsp;ORDERS, у&nbsp;которой partitioning clause заранее неизвестен и формируется на основе запроса к&nbsp;другой таблице-справочнику&nbsp;— SHOPS, разбивая заказы по&nbsp;регионам расположения магазинов.  
+
Приведенный ниже пакет генерирует скрипт создания секционированной таблицы товаров&nbsp;ORDERS, у&nbsp;которой partitioning clause заранее неизвестен и&nbsp;формируется на&nbsp;основе запроса к&nbsp;другой таблице-справочнику&nbsp;— SHOPS, разбивая заказы по&nbsp;регионам расположения магазинов.  
 
<code-sql>create or replace package body generator as
 
<code-sql>create or replace package body generator as
  
Строка 143: Строка 144:
 
/</code-sql>
 
/</code-sql>
  
Результат генерации — созданная таблица и выведенный в output скрипт:
+
Результат генерации&nbsp;— созданная таблица и&nbsp;выведенный в&nbsp;output скрипт:
  
 
<code-sql>create table orders (
 
<code-sql>create table orders (
Строка 177: Строка 178:
 
/</code-sql>
 
/</code-sql>
  
==== Условная компиляция PL/SQL (PL/SQL Conditional Compilation) ====
+
==== Условная компиляция&nbsp;PL/SQL (PL/SQL&nbsp;Conditional Compilation) ====
  
Официально этот способ появился в&nbsp;версии&nbsp;10.2, но с&nbsp;помощью скрытого параметра его можно активировать и&nbsp;в&nbsp;более ранних версиях&nbsp;— 9.2.0.6 и&nbsp;10.1.0.4. Это не&nbsp;совсем инструмент кодогенерации, но он позволяет привнести немного динамики в&nbsp;статичный программный код на&nbsp;этапе компиляции с&nbsp;помощью специальных директив. Условная компиляция потому так и&nbsp;называется, что предоставляет лишь условный оператор с&nbsp;возможностью проверки специальных флагов компиляции (PLSQL_CCFLAGS) и&nbsp;пакетных констант (инициализированных строго литералами) числового или&nbsp;булевого типа. Несмотря на&nbsp;примитивность, этот способ позволяет, например, сильно облегчить написание кода, переносимого между разными версиями&nbsp;СУБД, скрывая от&nbsp;компилятора не&nbsp;поддерживаемые целевым инстансом фрагменты кода. Также это неплохое решение для добавления необходимого для отладки кода, который при компиляции в&nbsp;production-окружении просто отключается и&nbsp;не&nbsp;требует выполнения постоянных проверок типа if&nbsp;is&nbsp;debug_mode&nbsp;then.
+
Официально этот способ появился в&nbsp;версии&nbsp;10.2, но&nbsp;с&nbsp;помощью скрытого параметра его можно активировать и&nbsp;в&nbsp;более ранних версиях&nbsp;— 9.2.0.6&nbsp;и&nbsp;10.1.0.4. Это не&nbsp;совсем инструмент кодогенерации, но&nbsp;он&nbsp;позволяет привнести немного динамики в&nbsp;статичный программный код на&nbsp;этапе компиляции с&nbsp;помощью специальных директив. Условная компиляция потому так&nbsp;и&nbsp;называется, что&nbsp;предоставляет лишь условный оператор с&nbsp;возможностью проверки специальных флагов компиляции (PLSQL_CCFLAGS) и&nbsp;пакетных констант (инициализированных строго литералами) числового или&nbsp;булевого типа. Несмотря на&nbsp;примитивность, этот способ позволяет, например, сильно облегчить написание кода, переносимого между разными версиями&nbsp;СУБД, скрывая от&nbsp;компилятора не&nbsp;поддерживаемые целевым инстансом фрагменты кода. Также это неплохое решение для&nbsp;добавления необходимого для&nbsp;отладки кода, который при&nbsp;компиляции в&nbsp;production-окружении просто отключается и&nbsp;не&nbsp;требует выполнения постоянных проверок типа if&nbsp;is&nbsp;debug_mode&nbsp;then.
  
 
===== Достоинства =====
 
===== Достоинства =====
Строка 187: Строка 188:
 
===== Недостатки =====
 
===== Недостатки =====
  
Крайне примитивный функционал, возможность использования только в&nbsp;программных единицах (анонимных блоках, пакетах, процедурах и&nbsp;т.&nbsp;д.), но, например, не&nbsp;в&nbsp;представлениях.
+
Крайне примитивный функционал, возможность использования только в&nbsp;программных единицах (анонимных блоках, пакетах, процедурах&nbsp;и&nbsp;т.&nbsp;д.), но,&nbsp;например, не&nbsp;в&nbsp;представлениях.
  
Приведенный ниже скрипт выводит названия таблиц текущего пользователя вместе со&nbsp;списком их&nbsp;колонок. Начиная с&nbsp;версии Oracle&nbsp;11.2 используется более естественная для&nbsp;строковой агрегации функция listagg, а&nbsp;для версий ниже&nbsp;— воркэраунд&nbsp;из микса различных функций.
+
Приведенный ниже скрипт выводит названия таблиц текущего пользователя вместе со&nbsp;списком их&nbsp;колонок. Начиная с&nbsp;версии Oracle&nbsp;11.2 используется более естественная для&nbsp;строковой агрегации функция listagg, а&nbsp;для версий ниже&nbsp;— воркэраунд&nbsp;из&nbsp;микса различных функций.
  
 
<code-sql>begin
 
<code-sql>begin
Строка 241: Строка 242:
 
/</code-sql>
 
/</code-sql>
  
Подробно об условной компиляции PL/SQL можно почитать в&nbsp;[http://www.oracle.com/technetwork/database/features/plsql/overview/plsql-conditional-compilation-133587.pdf официальном обзоре] этой фичи.
+
Подробно об&nbsp;условной компиляции&nbsp;PL/SQL можно почитать в&nbsp;[http://www.oracle.com/technetwork/database/features/plsql/overview/plsql-conditional-compilation-133587.pdf официальном обзоре] этой фичи.
  
 
==== XSLT ====
 
==== XSLT ====
  
На мой взгляд, не самый удобный способ генерации кода, однако и&nbsp;он иногда применяется. Несмотря на&nbsp;то, что XML не вполне нативный формат для реляционных СУБД, он хорошо поддерживается Oracle, в том числе есть и встроенный XSLT-процессор. Основная же причина, по которой его стоит упомянуть, — он является примером шаблонной генерации: в отличие от первого способа (DynSQL), здесь генерируемый код является первичным и, как следствие, легче читаемым в теле шаблона, а управляющие конструкции кода-генератора, наоборот, вторичны и требуют к себе внимания только в тех местах, где код становится динамичным. При том XSLT — механизм только генерации кода, но не его исполнения, поэтому пользоваться динамическим SQL все равно приходится.
+
На&nbsp;мой взгляд, не&nbsp;самый удобный способ генерации кода, однако и&nbsp;он&nbsp;иногда применяется. Несмотря на&nbsp;то, что&nbsp;XML не&nbsp;вполне нативный формат для&nbsp;реляционных&nbsp;СУБД, он хорошо поддерживается Oracle, в&nbsp;том числе есть и&nbsp;встроенный XSLT-процессор. Основная&nbsp;же причина, по&nbsp;которой его стоит упомянуть,&nbsp;— он является примером шаблонной генерации: в&nbsp;отличие от&nbsp;первого способа&nbsp;(DynSQL), здесь генерируемый код является первичным и,&nbsp;как следствие, легче читаемым в&nbsp;теле шаблона, а&nbsp;управляющие конструкции кода-генератора, наоборот, вторичны и&nbsp;требуют к&nbsp;себе внимания только в&nbsp;тех местах, где код становится динамичным. При&nbsp;том&nbsp;XSLT&nbsp;— механизм только генерации кода, но&nbsp;не&nbsp;его исполнения, поэтому пользоваться динамическим&nbsp;SQL все равно приходится.
  
 
===== Достоинства =====
 
===== Достоинства =====
  
Целевой код представлен в виде шаблона, его легче понимать и поддерживать, чем собираемый по частям из строковых литералов.
+
Целевой код представлен в&nbsp;виде шаблона, его легче понимать и&nbsp;поддерживать, чем собираемый по&nbsp;частям из&nbsp;строковых литералов.
  
 
===== Недостатки =====
 
===== Недостатки =====
  
Нетипичный для&nbsp;реляционных СУБД формат, недружелюбный громоздкий синтаксис языка шаблонов, необходимость предварительно приводить метаданные к&nbsp;XML для последующей трансформации.  
+
Нетипичный для&nbsp;реляционных&nbsp;СУБД формат, недружелюбный громоздкий синтаксис языка шаблонов, необходимость предварительно приводить метаданные к&nbsp;XML для&nbsp;последующей трансформации.  
  
С позволения читателя, я&nbsp;не буду приводить примеры использования XSLT в&nbsp;Oracle. Интересующиеся темой могут ознакомиться с&nbsp;[http://docs.oracle.com/database/121/ADXDB/xdb08tra.htm#ADXDB0900 документацией] и&nbsp;[http://www.codeproject.com/Articles/263100/XSL-Code-Generator примерами] генерации кода на&nbsp;других языках с&nbsp;его помощью.  
+
С&nbsp;позволения читателя, я&nbsp;не буду приводить примеры использования XSLT&nbsp;в&nbsp;Oracle. Интересующиеся темой могут ознакомиться с&nbsp;[http://docs.oracle.com/database/121/ADXDB/xdb08tra.htm#ADXDB0900 документацией] и&nbsp;[http://www.codeproject.com/Articles/263100/XSL-Code-Generator примерами] генерации кода на&nbsp;других языках с&nbsp;его помощью.  
  
 
=== Клиентские средства ===
 
=== Клиентские средства ===
  
«Клиентские» в&nbsp;данном контексте означает, что код генерируется внешней утилитой, работающей снаружи СУБД (хотя хост-средой может быть сам сервер, на&nbsp;котором поднят инстанс) и&nbsp;имеющей доступ к&nbsp;ее данным как клиент.
+
«Клиентские» в&nbsp;данном контексте означает, что&nbsp;код генерируется внешней утилитой, работающей снаружи&nbsp;СУБД (хотя хост-средой может быть сам сервер, на&nbsp;котором поднят инстанс) и&nbsp;имеющей доступ к&nbsp;ее&nbsp;данным как клиент.
  
 
==== SQL*Plus ====
 
==== SQL*Plus ====
  
SQL*PLus&nbsp;— это стандартная CLI-утилита для работы с&nbsp;СУБД Oracle с&nbsp;небольшим набором собственных команд. Она предоставляет возможность сделать код немного динамичнее благодаря [https://docs.oracle.com/database/121/SQPUG/ch_five.htm#i1211130 переменным подстановки] (substitution variables) и&nbsp;[https://docs.oracle.com/database/121/SQPUG/ch_five.htm#i1211006 вложению фрагментов] (script nesting).
+
SQL*PLus&nbsp;— это стандартная CLI-утилита для&nbsp;работы с&nbsp;СУБД Oracle с&nbsp;небольшим набором собственных команд. Она предоставляет возможность сделать код немного динамичнее благодаря [https://docs.oracle.com/database/121/SQPUG/ch_five.htm#i1211130 переменным подстановки] (substitution variables) и&nbsp;[https://docs.oracle.com/database/121/SQPUG/ch_five.htm#i1211006 вложению фрагментов] (script nesting).
  
В&nbsp;отличие от&nbsp;директив компиляции, переменные подстановки можно использовать вообще в&nbsp;любом месте кода, а значения им&nbsp;могут быть присвоены произвольным запросом. Правда, эти переменные могут быть только строковыми, а&nbsp;в&nbsp;самом SQL*Plus нет даже условного оператора и&nbsp;циклов. Их имитация выглядит весьма пугающе и&nbsp;делает этот инструмент малопригодным для кодогенерации хоть со&nbsp;сколько-нибудь сложной логикой: см.&nbsp;примеры [http://orasql.org/2013/04/09/sqlplus-tips-3-iterators-and-recursions/ итераций] и [http://orasql.org/2013/04/17/sqlplus-tips-4-branching-execution/ ветвления] из блога [http://habrahabr.ru/users/xtender/ @xtender]. Кроме того, кодовая основа может быть доступна SQL*Plus'у только из файлов.
+
В&nbsp;отличие от&nbsp;директив компиляции, переменные подстановки можно использовать вообще в&nbsp;любом месте кода, а&nbsp;значения им&nbsp;могут быть присвоены произвольным запросом. Правда, эти переменные могут быть только строковыми, а&nbsp;в&nbsp;самом SQL*Plus нет даже условного оператора и&nbsp;циклов. Их&nbsp;имитация выглядит весьма пугающе и&nbsp;делает этот инструмент малопригодным для&nbsp;кодогенерации хоть со&nbsp;сколько-нибудь сложной логикой: см.&nbsp;примеры [http://orasql.org/2013/04/09/sqlplus-tips-3-iterators-and-recursions/ итераций] и&nbsp;[http://orasql.org/2013/04/17/sqlplus-tips-4-branching-execution/ ветвления] из&nbsp;блога [http://habrahabr.ru/users/xtender/ @xtender]. Кроме того, кодовая основа может быть доступна SQL*Plus'у только&nbsp;из файлов.
  
 
===== Достоинства =====
 
===== Достоинства =====
Строка 277: Строка 278:
 
== Сторонние проекты ==
 
== Сторонние проекты ==
  
Что предлагает сообщество для решения обозначенной проблемы? Удалось найти лишь несколько проектов по&nbsp;данной теме.
+
Что предлагает сообщество для&nbsp;решения обозначенной проблемы? Удалось найти лишь несколько проектов по&nbsp;данной теме.
  
 
==== PL/Generator ====
 
==== PL/Generator ====
  
Очень старый проект 1998 года от известного евангелиста Стивена Ферштейна для шаблонной генерации PL/SQL-кода, написанный еще&nbsp;под&nbsp;Oracle&nbsp;7/8. Давно не&nbsp;поддерживается. Использует специальный язык разметки CGML, очень жестко привязанный к&nbsp;специфике Oracle и&nbsp;PL/SQL, что сильно ограничивает область его применения. Для работы генератора требуется доступ к&nbsp;файловой системе сервера (через UTL_FILE) для чтения шаблонов и&nbsp;сохранения результатов генерации, хотя, судя по&nbsp;документации, автономная работа только внутри&nbsp;БД тоже была предусмотрена и,&nbsp;возможно, даже реализована. Скачать проект по-прежнему можно с&nbsp;[http://archive.stevenfeuerstein.com/puter/gencentral.htm сайта автора].
+
Очень старый проект 1998&nbsp;года от&nbsp;известного евангелиста Стивена Ферштейна для&nbsp;шаблонной генерации&nbsp;PL/SQL-кода, написанный еще&nbsp;под&nbsp;Oracle&nbsp;7/8. Давно не&nbsp;поддерживается. Использует специальный язык разметки&nbsp;CGML, очень жестко привязанный к&nbsp;специфике Oracle&nbsp;и&nbsp;PL/SQL, что сильно ограничивает область его&nbsp;применения. Для&nbsp;работы генератора требуется доступ к&nbsp;файловой системе сервера (через UTL_FILE) для&nbsp;чтения шаблонов и&nbsp;сохранения результатов генерации, хотя, судя по&nbsp;документации, автономная работа только внутри&nbsp;БД тоже была предусмотрена и,&nbsp;возможно, даже реализована. Скачать проект по-прежнему можно с&nbsp;[http://archive.stevenfeuerstein.com/puter/gencentral.htm сайта автора].
  
 
==== Quest CodeGen Utility ====
 
==== Quest CodeGen Utility ====
  
Реинкарнация PL/Generator, развиваемая в&nbsp;2004–2007 годах. Представляет из&nbsp;себя целую IDE с&nbsp;возможностью генерировать PL/SQL-код из&nbsp;тех же&nbsp;CGML-шаблонов и&nbsp;проносить результат на&nbsp;сервер. Проект давно закрыт, сайт не&nbsp;работает, документации и&nbsp;даже упоминаний в&nbsp;интернете почти не&nbsp;осталось. Удалось найти только предпоследнюю версию на&nbsp;одном софтверном ресурсе. Разобраться с&nbsp;продуктом оказалось непросто, а, учитывая ограниченность CGML, изучать его досконально я&nbsp;не&nbsp;стал.
+
Реинкарнация PL/Generator, развиваемая в&nbsp;2004–2007&nbsp;годах. Представляет из&nbsp;себя целую&nbsp;IDE с&nbsp;возможностью генерировать&nbsp;PL/SQL-код из&nbsp;тех же&nbsp;CGML-шаблонов и&nbsp;проносить результат на&nbsp;сервер. Проект давно закрыт, сайт не&nbsp;работает, документации и&nbsp;даже упоминаний в&nbsp;интернете почти не&nbsp;осталось. Удалось найти только предпоследнюю версию на&nbsp;одном софтверном ресурсе. Разобраться с&nbsp;продуктом оказалось непросто, а,&nbsp;учитывая ограниченность&nbsp;CGML, изучать&nbsp;его досконально я&nbsp;не&nbsp;стал.
  
 
==== iCodeGenerator ====
 
==== iCodeGenerator ====
  
Современный проект с&nbsp;открытым кодом на&nbsp;GitHub, позиционирующий себя как БД-центричный шаблонный кодогенератор для любых языков с&nbsp;поддержкой разных СУБД, в&nbsp;том числе Oracle. На поверку оказалось, что шаблонный язык чрезвычайно скуден и,&nbsp;кроме как для краткого документирования содержимого схемы, ни&nbsp;на что не&nbsp;годится. Представляет собой клиентское приложение на&nbsp;.NET. Подключиться к&nbsp;Oracle согласно инструкции так&nbsp;и&nbsp;не получилось. Доступен на&nbsp;[http://www.icodegenerator.net/ своем сайте].
+
Современный проект с&nbsp;открытым кодом на&nbsp;GitHub, позиционирующий себя как&nbsp;БД-центричный шаблонный кодогенератор для&nbsp;любых языков с&nbsp;поддержкой разных&nbsp;СУБД, в&nbsp;том числе Oracle. На&nbsp;поверку оказалось, что&nbsp;шаблонный язык чрезвычайно скуден и,&nbsp;кроме как для&nbsp;краткого документирования содержимого схемы, ни&nbsp;на что&nbsp;не&nbsp;годится. Представляет собой клиентское приложение на&nbsp;.NET. Подключиться к&nbsp;Oracle согласно инструкции так&nbsp;и&nbsp;не&nbsp;получилось. Доступен на&nbsp;[http://www.icodegenerator.net/ своем сайте].
  
 
==== Многочисленные Table API-генераторы ====
 
==== Многочисленные Table API-генераторы ====
  
[http://sourceforge.net/projects/plsqlgenpkg/ PL/SQLGenPkg], [http://sourceforge.net/projects/plsqlintgen/ PL/SQL Interface Generator], [http://sourceforge.net/projects/tapigen/ tapiGen], [https://code.google.com/p/tapig/ TAPIG]&nbsp;— узкопрофильные средства для генерации обвязок вокруг таблиц для возможности выполнения операций CRUD через них вместо обычного SQL.
+
[http://sourceforge.net/projects/plsqlgenpkg/ PL/SQLGenPkg], [http://sourceforge.net/projects/plsqlintgen/ PL/SQL Interface Generator], [http://sourceforge.net/projects/tapigen/ tapiGen], [https://code.google.com/p/tapig/ TAPIG]&nbsp;— узкопрофильные средства для&nbsp;генерации обвязок вокруг таблиц для&nbsp;возможности выполнения операций CRUD через&nbsp;них вместо обычного&nbsp;SQL.
  
Все рассмотренные либо давно заброшены, либо слишком узкоспецифичны&nbsp;и решают частные проблемы, нежели являются универсальными инструментами.
+
Все&nbsp;рассмотренные либо давно заброшены, либо слишком узкоспецифичны и&nbsp;решают частные проблемы, нежели являются универсальными инструментами.
  
 
== Создаем свой инструмент ==
 
== Создаем свой инструмент ==
  
Итак, инструмента, который удовлетворял бы&nbsp;широким потребностям промышленной разработки, к&nbsp;сожалению, не нашлось. Поэтому было решено сделать свой. Были выбраны самые полезные возможности из &nbsp;рсенала штатных средств и&nbsp;составлен список фич, необходимых для комфортной работы:
+
Итак, инструмента, который удовлетворял бы&nbsp;широким потребностям промышленной разработки, к&nbsp;сожалению, не&nbsp;нашлось. Поэтому было решено сделать свой. Были выбраны самые полезные возможности из&nbsp;арсенала штатных средств и&nbsp;составлен список фич, необходимых для&nbsp;комфортной работы:
  
* от&nbsp;обычного PL/SQL были взяты способы обращения к&nbsp;БД: выполнение запросов, вызов хранимых функций, получение результата в&nbsp;виде сложносоставных типов&nbsp;— result set'ов;
+
* от&nbsp;обычного&nbsp;PL/SQL были взяты способы обращения к&nbsp;БД: выполнение запросов, вызов хранимых функций, получение результата в&nbsp;виде сложносоставных типов&nbsp;— result set'ов;
  
* от PLSQLCC&nbsp;— возможность писать и&nbsp;хранить управляющие инструкции кода-генератора как plain text прямо в&nbsp;теле хранимых программных единиц, чтобы редактирование в&nbsp;IDE ничем не&nbsp;отличалось от&nbsp;привычной разработки обычного статичного кода;
+
* от&nbsp;PLSQLCC&nbsp;— возможность писать и&nbsp;хранить управляющие инструкции кода-генератора как plain text прямо в&nbsp;теле хранимых программных единиц, чтобы редактирование в&nbsp;IDE ничем не&nbsp;отличалось от&nbsp;привычной разработки обычного статичного кода;
  
* от XSLT&nbsp;— принцип шаблонной генерации: первичность генерируемого кода над кодом-генератором;
+
* от&nbsp;XSLT&nbsp;— принцип шаблонной генерации: первичность генерируемого кода над&nbsp;кодом-генератором;
  
* от SQL*Plus&nbsp;— возможность выполнения на клиенте.
+
* от&nbsp;SQL*Plus&nbsp;— возможность выполнения на&nbsp;клиенте.
  
Возникло еще одно требование, продиктованное инертностью Enterprise-сектора,&nbsp;— совместимость с&nbsp;Oracle как минимум 10-й версии (при текущей 12-й), поскольку она все еще активно используется в production.
+
Возникло еще одно требование, продиктованное инертностью Enterprise-сектора,&nbsp;— совместимость с&nbsp;Oracle как&nbsp;минимум 10-й версии (при&nbsp;текущей 12-й), поскольку она все еще активно используется в&nbsp;production.
  
 
=== Выбор движка шаблонов ===
 
=== Выбор движка шаблонов ===
Строка 315: Строка 316:
 
Поскольку Oracle имеет [https://docs.oracle.com/database/121/JJDEV/chone.htm#JJDEV13016 встроенную JVM] (ранее известную как&nbsp;Aurora), а&nbsp;Java-мир очень богат на&nbsp;инструменты любого вида, было решено посмотреть в&nbsp;сторону [http://java-source.net/open-source/template-engines Java Template Engines].
 
Поскольку Oracle имеет [https://docs.oracle.com/database/121/JJDEV/chone.htm#JJDEV13016 встроенную JVM] (ранее известную как&nbsp;Aurora), а&nbsp;Java-мир очень богат на&nbsp;инструменты любого вида, было решено посмотреть в&nbsp;сторону [http://java-source.net/open-source/template-engines Java Template Engines].
  
Практически сразу же определились два кандидата: [https://velocity.apache.org/ Velocity] и&nbsp;[http://freemarker.org/ FreeMarker]&nbsp;— самые популярные шаблонные движки. Изучив их&nbsp;возможности и&nbsp;попрактиковавшись с&nbsp;ними, мы поняли, что Velocity заморожен несколько лет назад, а&nbsp;FreeMarker обладает более обширным [http://freemarker.org/features.html арсеналом фич] и&nbsp;более гибким [http://freemarker.org/docs/index.html хорошо документированным] языком (FTL), продолжает активно развиваться и&nbsp;периодически выпускает новые версии.
+
Практически сразу&nbsp;же определились два кандидата: [https://velocity.apache.org/ Velocity] и&nbsp;[http://freemarker.org/ FreeMarker]&nbsp;— самые популярные шаблонные движки. Изучив их&nbsp;возможности и&nbsp;попрактиковавшись с&nbsp;ними, мы поняли, что Velocity заморожен несколько лет назад, а&nbsp;FreeMarker обладает более обширным [http://freemarker.org/features.html арсеналом фич] и&nbsp;более гибким [http://freemarker.org/docs/index.html хорошо документированным] языком&nbsp;(FTL), продолжает активно развиваться и&nbsp;периодически выпускает новые версии.
  
Судя по его описанию, FreeMarker теоретически позволял интегрироваться с Oracle и&nbsp;«допилить» его таким образом, чтобы из&nbsp;FTL было удобно обращаться&nbsp;к&nbsp;БД.
+
Судя по&nbsp;его&nbsp;описанию, FreeMarker теоретически позволял интегрироваться с&nbsp;Oracle и&nbsp;«допилить» его&nbsp;таким образом, чтобы из&nbsp;FTL было удобно обращаться&nbsp;к&nbsp;БД.
  
Кроме того, Java-приложения можно запускать на&nbsp;клиенте так же успешно, как и&nbsp;внутри СУБД. Это решало бы проблему совместимости с&nbsp;Oracle&nbsp;XE, в&nbsp;котором нет поддержки Java, а&nbsp;также очень старыми версиями Oracle (младше&nbsp;10), где JVM-версии&nbsp;— ниже 1.4, несовместимые с&nbsp;FreeMarker.
+
Кроме того, Java-приложения можно запускать на&nbsp;клиенте так&nbsp;же&nbsp;успешно, как&nbsp;и&nbsp;внутри&nbsp;СУБД. Это решало&nbsp;бы проблему совместимости с&nbsp;Oracle&nbsp;XE, в&nbsp;котором нет поддержки Java, а&nbsp;также очень старыми версиями Oracle (младше&nbsp;10), где&nbsp;JVM-версии&nbsp;— ниже 1.4, несовместимые с&nbsp;FreeMarker.
  
=== Интеграция с Oracle ===
+
=== Интеграция с&nbsp;Oracle ===
  
Чтобы сделать полноценный инструмент, необходимо было решить три основные проблемы.
+
Чтобы сделать полноценный инструмент, необходимо было решить три&nbsp;основные проблемы.
 
+
# Поселить FreeMarker в&nbsp;СУБД, заставить его там работать и&nbsp;дописать набор классов, расширяющий язык FTL возможностями JDBC.
+
 
+
# Научиться хранить шаблоны FTL наиболее удобным и нативным способом, как обычные программные единицы, сделать работу с&nbsp;ними в&nbsp;популярных IDE комфортной.
+
  
 +
# Поселить FreeMarker в&nbsp;СУБД, заставить&nbsp;его там работать и&nbsp;дописать набор классов, расширяющий язык FTL&nbsp;возможностями.
 +
# Научиться хранить шаблоны&nbsp;FTL наиболее удобным и&nbsp;нативным способом, как обычные программные единицы, сделать работу с&nbsp;ними в&nbsp;популярных&nbsp;IDE комфортной.
 
# Свести к&nbsp;минимуму заботу разработчика о&nbsp;процессинге шаблонов и&nbsp;выполнении сгенерированных скриптов на&nbsp;сервере.
 
# Свести к&nbsp;минимуму заботу разработчика о&nbsp;процессинге шаблонов и&nbsp;выполнении сгенерированных скриптов на&nbsp;сервере.
  
Забегая вперед, скажу, что все эти проблемы были успешно решены и&nbsp;родился инструмент FTLDB (названный по&nbsp;аналогии c&nbsp;HTMLDB и&nbsp;XMLDB), который теперь лежит [https://github.com/ftldb/ftldb на GitHub] под&nbsp;[https://www.apache.org/licenses/LICENSE-2.0 лицензией Apache License 2.0].
+
Забегая вперед, скажу, что все эти проблемы были успешно решены и&nbsp;родился инструмент&nbsp;FTLDB (названный по&nbsp;аналогии c&nbsp;HTMLDB и&nbsp;XMLDB), который теперь лежит [https://github.com/ftldb/ftldb на GitHub] под&nbsp;[https://www.apache.org/licenses/LICENSE-2.0 лицензией Apache License&nbsp;2.0].
  
А теперь расскажу подробнее о&nbsp;том, что было сделано.
+
А&nbsp;теперь расскажу подробнее о&nbsp;том, что&nbsp;было сделано.
  
 
==== Доработка FreeMarker ====
 
==== Доработка FreeMarker ====
  
Вся Java-разработка велась с&nbsp;минимальной конкретикой на&nbsp;Oracle, с&nbsp;использованием преимущественно интерфейсов&nbsp;JDBC из&nbsp;java.sql.*. Это позволило в&nbsp;дальнейшем использовать инструмент не&nbsp;только для&nbsp;Oracle, но&nbsp;и&nbsp;для других СУБД. В&nbsp;тех местах, где без специфики было не&nbsp;обойтись (серверное выполнение на&nbsp;встроенной&nbsp;JVM), были оставлены возможности расширения и&nbsp;для других СУБД, потенциально способных исполнять Java-код самостоятельно (например, PostgreSQL&nbsp;+&nbsp;PL/Java).
+
Вся&nbsp;Java-разработка велась с&nbsp;минимальной конкретикой на&nbsp;Oracle, с&nbsp;использованием преимущественно интерфейсов&nbsp;JDBC из&nbsp;java.sql.*. Это позволило в&nbsp;дальнейшем использовать инструмент не&nbsp;только для&nbsp;Oracle, но&nbsp;и&nbsp;для&nbsp;других&nbsp;СУБД. В&nbsp;тех местах, где&nbsp;без&nbsp;специфики было не&nbsp;обойтись (серверное выполнение на&nbsp;встроенной&nbsp;JVM), были оставлены возможности расширения и&nbsp;для&nbsp;других&nbsp;СУБД, потенциально способных исполнять Java-код самостоятельно (например, PostgreSQL&nbsp;+&nbsp;PL/Java).
  
Язык FTL был дополнен методами создания JDBC-соединений (или использования текущего соединения при работе на&nbsp;server-side), выполнения в&nbsp;рамках них&nbsp;SQL-запросов и&nbsp;программных вызовов, работы с&nbsp;результатами их выполнения в&nbsp;родном для&nbsp;FTL виде. Также были добавлены некоторые утилитарные методы для&nbsp;FTL, загрузчик шаблонов из&nbsp;БД с&nbsp;помощью произвольного вызова и&nbsp;main-методы для&nbsp;запуска движка из&nbsp;CLI и&nbsp;PL/SQL.
+
Язык&nbsp;FTL был дополнен методами создания JDBC-соединений (или&nbsp;использования текущего соединения при&nbsp;работе на&nbsp;server-side), выполнения в&nbsp;рамках них&nbsp;SQL-запросов и&nbsp;программных вызовов, работы с&nbsp;результатами их&nbsp;выполнения в&nbsp;родном для&nbsp;FTL виде. Также были добавлены некоторые утилитарные методы для&nbsp;FTL, загрузчик шаблонов из&nbsp;БД с&nbsp;помощью произвольного вызова и&nbsp;main-методы для&nbsp;запуска движка из&nbsp;CLI и&nbsp;PL/SQL.
  
 
==== Хранение шаблонов ====
 
==== Хранение шаблонов ====
  
С&nbsp;помощью директив PLSQLCC был придуман простой и&nbsp;элегантный способ хранения шаблонов в&nbsp;БД в&nbsp;телах хранимых программных единиц. Используя директиву $if&nbsp;$then&nbsp;$end с&nbsp;явным ложным условием, в&nbsp;теле любого пакета можно создать «контейнер», невидимый компилятору, в&nbsp;который можно поместить как plain text вообще любой код, а в&nbsp;частности&nbsp;— шаблоны&nbsp;FTL. Это позволяет очень удобно редактировать код в&nbsp;IDE (с&nbsp;сохранением подсветки и&nbsp;code assist фич) и&nbsp;устанавливать его на&nbsp;сервер так же, как обычные пакеты (к&nbsp;слову, проносить их в&nbsp;виде CLOB было бы не&nbsp;так тривиально).
+
С&nbsp;помощью директив PLSQLCC был придуман простой и&nbsp;элегантный способ хранения шаблонов в&nbsp;БД в&nbsp;телах хранимых программных единиц. Используя директиву $if&nbsp;$then&nbsp;$end с&nbsp;явным ложным условием, в&nbsp;теле любого пакета можно создать «контейнер», невидимый компилятору, в&nbsp;который можно поместить как&nbsp;plain text вообще любой код, а&nbsp;в&nbsp;частности&nbsp;— шаблоны&nbsp;FTL. Это позволяет очень удобно редактировать код в&nbsp;IDE (с&nbsp;сохранением подсветки и&nbsp;code assist фич) и&nbsp;устанавливать его на&nbsp;сервер так&nbsp;же, как обычные пакеты (к&nbsp;слову, проносить&nbsp;их в&nbsp;виде&nbsp;CLOB было бы не&nbsp;так тривиально).
  
 
Выглядит это примерно так:
 
Выглядит это примерно так:
Строка 363: Строка 362:
 
/</code-sql>
 
/</code-sql>
  
Очень похоже на хранимые функции в&nbsp;PostgreSQL :)
+
Очень похоже на&nbsp;хранимые функции в&nbsp;PostgreSQL :)
  
 
==== Процессинг шаблонов ====
 
==== Процессинг шаблонов ====
  
Для извлечения шаблонов из&nbsp;таких контейнеров был написан утилитарный пакет, позволяющий обращаться к&nbsp;ним по&nbsp;имени содержащего их&nbsp;объекта Oracle и&nbsp;возвращающий их&nbsp;в&nbsp;виде CLOB. Этот пакет используется загрузчиком шаблонов в&nbsp;FreeMarker.
+
Для&nbsp;извлечения шаблонов из&nbsp;таких контейнеров был написан утилитарный пакет, позволяющий обращаться к&nbsp;ним по&nbsp;имени содержащего их&nbsp;объекта Oracle и&nbsp;возвращающий их&nbsp;в&nbsp;виде CLOB. Этот пакет используется загрузчиком шаблонов в&nbsp;FreeMarker.
  
Обработка шаблонов осуществляется движком FreeMarker с&nbsp;использованием наших расширений JDBC для извлечения метаданных, после чего результат генерации возвращаются в&nbsp;вызывающую среду в&nbsp;виде out-потока (client-side) или&nbsp;CLOB (Oracle server-side).
+
Обработка шаблонов осуществляется движком FreeMarker с&nbsp;использованием наших расширений&nbsp;JDBC для&nbsp;извлечения метаданных, после чего результат генерации возвращаются в&nbsp;вызывающую среду в&nbsp;виде out-потока (client-side) или&nbsp;CLOB (Oracle server-side).
  
Кроме того, был написан специальный объектный PL/SQL-тип, в&nbsp;который опционально преобразуется результат обработки шаблона. Он представляет собой контейнер исполняемых выражений, которые можно выводить в&nbsp;output или&nbsp;запускать на&nbsp;инстансе с&nbsp;помощью встроенных методов. Это своеобразный серверный аналог SQL*Plus, позволяющий компоновать множество шаблонов или отдельных выражений в&nbsp;один объект и&nbsp;выполнять его как&nbsp;скрипт.
+
Кроме того, был написан специальный объектный&nbsp;PL/SQL-тип, в&nbsp;который опционально преобразуется результат обработки шаблона. Он&nbsp;представляет собой контейнер исполняемых выражений, которые можно выводить в&nbsp;output или&nbsp;запускать на&nbsp;инстансе с&nbsp;помощью встроенных методов. Это своеобразный серверный аналог&nbsp;SQL*Plus, позволяющий компоновать множество шаблонов или&nbsp;отдельных выражений в&nbsp;один объект и&nbsp;выполнять его как&nbsp;скрипт.
  
=== Что получилось и как выглядит ===
+
=== Что получилось и&nbsp;как выглядит ===
  
FTLDB для&nbsp;Oracle распространяется в&nbsp;виде инсталлятора под Windows&nbsp;batch и&nbsp;*nix&nbsp;shell. Устанавливается он как отдельная схема (так рекомендуется, хотя можно ставить и&nbsp;в&nbsp;существующую по соседству с&nbsp;другими объектами). Все объекты создаются в&nbsp;режиме выполнения c&nbsp;правами вызывающего (invoker's rights), что позволяет использовать его из&nbsp;других схем совершенно прозрачно.
+
FTLDB для&nbsp;Oracle распространяется в&nbsp;виде инсталлятора под&nbsp;Windows&nbsp;batch и&nbsp;*nix&nbsp;shell. Устанавливается он&nbsp;как&nbsp;отдельная схема (так&nbsp;рекомендуется, хотя можно ставить и&nbsp;в&nbsp;существующую по&nbsp;соседству с&nbsp;другими объектами). Все объекты создаются в&nbsp;режиме выполнения c&nbsp;правами вызывающего (invoker's rights), что позволяет использовать его из&nbsp;других схем совершенно прозрачно.
  
Для работы на клиенте (с&nbsp;любой СУБД) нужны только jar-архивы FreeMarker и&nbsp;FTLDB из&nbsp;инсталлятора, а также JDBC-драйвер, распространяемый производителем СУБД.
+
Для&nbsp;работы на&nbsp;клиенте (с&nbsp;любой СУБД) нужны только jar-архивы FreeMarker и&nbsp;FTLDB из&nbsp;инсталлятора, а&nbsp;также JDBC-драйвер, распространяемый производителем&nbsp;СУБД.
  
 
Меньше слов&nbsp;— больше примеров! Посмотрите еще раз на&nbsp;демонстрационный фрагмент кода из&nbsp;раздела про&nbsp;DynSQL.
 
Меньше слов&nbsp;— больше примеров! Посмотрите еще раз на&nbsp;демонстрационный фрагмент кода из&nbsp;раздела про&nbsp;DynSQL.
  
Вот как то же самое делается с&nbsp;помощью FTLDB на&nbsp;серверной стороне.
+
Вот как&nbsp;то&nbsp;же самое делается с&nbsp;помощью FTLDB на&nbsp;серверной стороне.
  
Сам пакет немного изменился в&nbsp;получении метаданных, а вместо конкатенации скрипта таблицы по&nbsp;кусочкам есть настоящий шаблон:
+
Сам пакет немного изменился в&nbsp;получении метаданных, а&nbsp;вместо конкатенации скрипта таблицы по&nbsp;кусочкам есть настоящий шаблон:
  
 
<code-sql>create or replace package body generator as
 
<code-sql>create or replace package body generator as
Строка 497: Строка 496:
 
/</code-sql>
 
/</code-sql>
  
А вот так на клиентской.
+
А&nbsp;вот так на&nbsp;клиентской.
  
Шаблон храним в отдельном файле:
+
Шаблон храним в&nbsp;отдельном файле:
  
 
<code-xml><#assign conn = new_connection(template_args[0], template_args[1], template_args[2])/>
 
<code-xml><#assign conn = new_connection(template_args[0], template_args[1], template_args[2])/>
Строка 563: Строка 562:
 
<#assign void = conn.close()/></code-xml>
 
<#assign void = conn.close()/></code-xml>
  
Вызов генерации и запуск скрипта:
+
Вызов генерации и&nbsp;запуск скрипта:
  
 
<code-bash>java -cp ../java/* ftldb.CommandLine orders.ftl "jdbc:oracle:oci:@orcl" scott tiger 1> orders.sql
 
<code-bash>java -cp ../java/* ftldb.CommandLine orders.ftl "jdbc:oracle:oci:@orcl" scott tiger 1> orders.sql
Строка 569: Строка 568:
 
sqlplus scott/tiger@orcl @orders.sql</code-bash>
 
sqlplus scott/tiger@orcl @orders.sql</code-bash>
  
Больше примеров использования доступны в&nbsp;демо проекта. Документация API приложена к&nbsp;дистрибутиву.
+
Больше примеров использования доступны в&nbsp;демо проекта. Документация&nbsp;API приложена к&nbsp;дистрибутиву.
  
 
=== Другие варианты применения ===
 
=== Другие варианты применения ===
  
Поскольку клиентский режим целиком и&nbsp;полностью работает на&nbsp;абстракции JDBC и&nbsp;не имеет Oracle-специфичных «зашивок», FTLDB можно использовать для клиентской генерации скриптов для&nbsp;любой СУБД, предоставляющей JDBC-драйвер. Вообще говоря, FTLDB подходит для генерации произвольных текстов в&nbsp;любой области применения самого FreeMarker, например, документации или&nbsp;web-страниц.
+
Поскольку клиентский режим целиком и&nbsp;полностью работает на&nbsp;абстракции JDBC и&nbsp;не&nbsp;имеет Oracle-специфичных «зашивок», FTLDB можно использовать для&nbsp;клиентской генерации скриптов для&nbsp;любой&nbsp;СУБД, предоставляющей JDBC-драйвер. Вообще говоря, FTLDB подходит для&nbsp;генерации произвольных текстов в&nbsp;любой области применения самого FreeMarker, например, документации или&nbsp;web-страниц.
  
=== Настоящее и будущее проекта ===
+
=== Настоящее и&nbsp;будущее проекта ===
  
 
FTLDB сейчас используется в&nbsp;нескольких наших промышленных проектах, поддерживается авторами и&nbsp;имеет планы дальнейшего развития.
 
FTLDB сейчас используется в&nbsp;нескольких наших промышленных проектах, поддерживается авторами и&nbsp;имеет планы дальнейшего развития.
  
С удовольствием ждем ваших отзывов, предложений по&nbsp;доработке и&nbsp;pull&nbsp;request'ов.
+
С&nbsp;удовольствием ждем ваших отзывов, предложений по&nbsp;доработке и&nbsp;pull&nbsp;request'ов.
 +
 
 
[[Категория:Виктор Осоловский (Статьи)]]
 
[[Категория:Виктор Осоловский (Статьи)]]
 
[[Категория:Хабрахабр (Публикации)]]
 
[[Категория:Хабрахабр (Публикации)]]
 
[[Категория:2015 год (Статьи)]]
 
[[Категория:2015 год (Статьи)]]
 
[[Категория:CustisWikiToLib]]
 
[[Категория:CustisWikiToLib]]

Текущая версия на 13:12, 24 апреля 2015

Виктор Осоловский, наш разработчик-эксперт, опубликовал в блоге компании на «Хабрахабре» статью, посвященную решению проблемы кодогенерации при разработке приложений для СУБД Oracle. Какие существуют возможности для генерации кода «из коробки»? В чем заключаются достоинства и недостатки клиентских средств и сторонних решений? Каким образом удалось создать свой инструмент для решения проблемы с генерацией кода? Ответы на эти вопросы — в материале «Кодогенерация в Oracle и не только».

В этой статье я расскажу о решении проблемы кодогенерации при разработке приложений для СУБД Oracle. Хотя написанное ниже частично можно применить и к другим СУБД, и для генерации не только кода.

Проблема

При разработке приложений иногда возникают ситуации, когда требуется написать много похожих кусков кода, которые в силу различных ограничений нельзя заменить одной универсальной программной единицей. Следуя принципу DRY, вместо того чтобы копировать похожие фрагменты кода вручную с заменой отличающихся частей, лучше воспользоваться техникой кодогенерации из статичных заготовок на основе метаданных, вносящих разнообразие в получившиеся экземпляры кода. К кодогенерации приходится прибегать как в develop/deploy-time (когда все вариации известны заранее и есть возможность создать весь спектр экземпляров кода в статичном виде), так и в runtime, когда код генерируется на основе неизвестных заранее данных и сразу же исполняется.

Специфика кодогенерации при разработке приложений для СУБД состоит в том, что метаданные, как правило, хранятся в ней же.

Приведу несколько примеров задач, в которых востребована кодогенерация:

  • формирование SQL/DML/DDL-выражений на основе пользовательского
  • создание процедуры загрузки в систему-приемник очередного источника данных по его метаописанию в удаленной (remote) системе-источнике;
  • разворачивание системы в разных окружениях, версиях и редакциях СУБД, где необходимо (де)активировать некоторые опции или создать вспомогательные объекты: например, при разворачивании Oracle-приложения на редакции EE секционировать таблицы и строить локальные индексы; или при разворачивании на версии Oracle ниже 11 вместо виртуальных колонок и индексов по ним создавать представления-обертки с дополнительными вычислимыми колонками и строить function-based-индексы.

Родные средства Oracle

Oracle предоставляет несколько возможностей для генерации кода «из коробки». Бегло рассмотрим существующие средства и их достоинства и недостатки.

Серверные средства

«Серверные» в данном контексте означает, что процесс кодогенерации происходит на сервере внутри самой СУБД без привлечения сторонних утилит. Как кодовая основа, так и метаданные хранятся в БД или иных источниках, доступных средствами СУБД.

Динамический SQL (Dynamic SQL)

Этот способ доступен с давних версий Oracle и является самым универсальным из возможных. Разработчик практически ничем не ограничен и, используя все возможности языка PL/SQL, может формировать произвольные строковые выражения на основе данных, извлеченных из БД, и исполнять их на инстансе.

Еще с версии 8i существует два механизма исполнения cгенерированного таким образом кода: DBMS_SQL и Native Dynamic SQL. Их различия в контексте данной статьи не очень принципиальны, важно лишь, что пользоваться вторым проще, но не всегда возможно, поэтому используются оба — в зависимости от задач. Подробнее о них и их различиях можно почитать в документации.

Достоинства

Использование всех возможностей PL/SQL как процедурного языка для компоновки генерируемого текста и как языка доступа к БД для выборки и обработки метаданных.

Недостатки

Сложность кода-генератора, как правило, усыпанного строковыми литералами, кавычками, операторами конкатенации, замены, символами переноса строк. Все это перемежается с управляющими конструкциями PL/SQL — условными переходами, циклами. За «пеленой» кода-генератора бывает непросто разглядеть генерируемый код и понять его логику. Поддерживать такую смесь довольно сложно. В то же время это самый распространенный способ кодогенерации.

Выглядит это примерно так.

Приведенный ниже пакет генерирует скрипт создания секционированной таблицы товаров ORDERS, у которой partitioning clause заранее неизвестен и формируется на основе запроса к другой таблице-справочнику — SHOPS, разбивая заказы по регионам расположения магазинов.

CREATE OR REPLACE package body generator AS
 
 
 
cursor cur_partitions IS
 
  SELECT
 
    t.region name,
 
    listagg(t.shop_id, ', ')
 
      WITHIN GROUP (ORDER BY t.shop_id) vals
 
  FROM shops t
 
  GROUP BY t.region
 
  ORDER BY t.region;
 
 
 
PROCEDURE gen_orders_plsql
 
IS
 
  l_scr CLOB;
 
BEGIN
 
  l_scr :=
 
    'create table orders (' || chr(10) ||
 
    '  order_id integer not null primary key,' || chr(10) ||
 
    '  customer_id integer not null,' || chr(10) ||
 
    '  shop_id integer not null,' || chr(10) ||
 
    '  order_date date not null,' || chr(10) ||
 
    '  status varchar2(10) not null' || chr(10) ||
 
    ')' || chr(10) ||
 
    'partition by list(shop_id) (';
 
 
 
  FOR r IN cur_partitions loop
 
    l_scr := l_scr ||
 
      CASE WHEN cur_partitions%rowcount > 1 THEN ',' END || chr(10) ||
 
      '  partition ' || r.name || ' values (' || r.vals || ')';
 
  END loop;
 
 
 
  l_scr := l_scr || chr(10) || ')';
 
 
 
  dbms_output.put_line(l_scr);
 
  dbms_output.put_line('/');
 
  EXECUTE immediate l_scr;
 
 
 
  l_scr := 'comment on table orders is ''Orders partitioned by region.''';
 
 
 
  dbms_output.put_line(l_scr);
 
  dbms_output.put_line('/');
 
  EXECUTE immediate l_scr;
 
 
 
END gen_orders_plsql;
 
 
 
END generator;
 
/

Вызов генерации:

BEGIN
 
  generator.gen_orders_plsql();
 
END;
 
/

Результат генерации — созданная таблица и выведенный в output скрипт:

CREATE TABLE orders (
 
  order_id INTEGER NOT NULL PRIMARY KEY,
 
  customer_id INTEGER NOT NULL,
 
  shop_id INTEGER NOT NULL,
 
  order_date DATE NOT NULL,
 
  STATUS varchar2(10) NOT NULL
 
)
 
partition BY list(shop_id) (
 
  partition east VALUES (2, 3, 7),
 
  partition north VALUES (1, 4, 6, 9),
 
  partition south VALUES (5, 8, 12),
 
  partition west VALUES (10, 11, 13)
 
)
 
/
 
comment ON TABLE orders IS 'Orders partitioned by region.'
 
/

Условная компиляция PL/SQL (PL/SQL Conditional Compilation)

Официально этот способ появился в версии 10.2, но с помощью скрытого параметра его можно активировать и в более ранних версиях — 9.2.0.6 и 10.1.0.4. Это не совсем инструмент кодогенерации, но он позволяет привнести немного динамики в статичный программный код на этапе компиляции с помощью специальных директив. Условная компиляция потому так и называется, что предоставляет лишь условный оператор с возможностью проверки специальных флагов компиляции (PLSQL_CCFLAGS) и пакетных констант (инициализированных строго литералами) числового или булевого типа. Несмотря на примитивность, этот способ позволяет, например, сильно облегчить написание кода, переносимого между разными версиями СУБД, скрывая от компилятора не поддерживаемые целевым инстансом фрагменты кода. Также это неплохое решение для добавления необходимого для отладки кода, который при компиляции в production-окружении просто отключается и не требует выполнения постоянных проверок типа if is debug_mode then.

Достоинства

Код остается статичным, легко читается и поддерживается.

Недостатки

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

Приведенный ниже скрипт выводит названия таблиц текущего пользователя вместе со списком их колонок. Начиная с версии Oracle 11.2 используется более естественная для строковой агрегации функция listagg, а для версий ниже — воркэраунд из микса различных функций.

BEGIN
 
  FOR r IN (
 
    SELECT
 
      TABLE_NAME,
 
      $if
 
        dbms_db_version.version = 11 AND dbms_db_version.release > 1 OR
 
        dbms_db_version.version > 11
 
      $then
 
        listagg(column_name, ', ') WITHIN GROUP(ORDER BY column_id)
 
      $else
 
        substr(utl_i18n.unescape_reference(
 
          xmlagg(sys_xmlgen(', ' || column_name) ORDER BY column_id)
 
            .extract('//text()')
 
            .GetStringVal()
 
        ), 3)
 
      $end AS column_list
 
    FROM
 
      user_tab_columns
 
    GROUP BY TABLE_NAME
 
    ORDER BY TABLE_NAME
 
  ) loop
 
    dbms_output.put_line(r.table_name || '''s columns: ' || r.column_list);
 
  END loop;   
 
END;
 
/

Подробно об условной компиляции PL/SQL можно почитать в официальном обзоре этой фичи.

XSLT

На мой взгляд, не самый удобный способ генерации кода, однако и он иногда применяется. Несмотря на то, что XML не вполне нативный формат для реляционных СУБД, он хорошо поддерживается Oracle, в том числе есть и встроенный XSLT-процессор. Основная же причина, по которой его стоит упомянуть, — он является примером шаблонной генерации: в отличие от первого способа (DynSQL), здесь генерируемый код является первичным и, как следствие, легче читаемым в теле шаблона, а управляющие конструкции кода-генератора, наоборот, вторичны и требуют к себе внимания только в тех местах, где код становится динамичным. При том XSLT — механизм только генерации кода, но не его исполнения, поэтому пользоваться динамическим SQL все равно приходится.

Достоинства

Целевой код представлен в виде шаблона, его легче понимать и поддерживать, чем собираемый по частям из строковых литералов.

Недостатки

Нетипичный для реляционных СУБД формат, недружелюбный громоздкий синтаксис языка шаблонов, необходимость предварительно приводить метаданные к XML для последующей трансформации.

С позволения читателя, я не буду приводить примеры использования XSLT в Oracle. Интересующиеся темой могут ознакомиться с документацией и примерами генерации кода на других языках с его помощью.

Клиентские средства

«Клиентские» в данном контексте означает, что код генерируется внешней утилитой, работающей снаружи СУБД (хотя хост-средой может быть сам сервер, на котором поднят инстанс) и имеющей доступ к ее данным как клиент.

SQL*Plus

SQL*PLus — это стандартная CLI-утилита для работы с СУБД Oracle с небольшим набором собственных команд. Она предоставляет возможность сделать код немного динамичнее благодаря переменным подстановки (substitution variables) и вложению фрагментов (script nesting).

В отличие от директив компиляции, переменные подстановки можно использовать вообще в любом месте кода, а значения им могут быть присвоены произвольным запросом. Правда, эти переменные могут быть только строковыми, а в самом SQL*Plus нет даже условного оператора и циклов. Их имитация выглядит весьма пугающе и делает этот инструмент малопригодным для кодогенерации хоть со сколько-нибудь сложной логикой: см. примеры итераций и ветвления из блога @xtender. Кроме того, кодовая основа может быть доступна SQL*Plus'у только из файлов.

Достоинства

Простая в использовании операция подстановки.

Недостатки

Только клиентская сторона выполнения и хранения кода, примитивность управляющих инструкций.

Сторонние проекты

Что предлагает сообщество для решения обозначенной проблемы? Удалось найти лишь несколько проектов по данной теме.

PL/Generator

Очень старый проект 1998 года от известного евангелиста Стивена Ферштейна для шаблонной генерации PL/SQL-кода, написанный еще под Oracle 7/8. Давно не поддерживается. Использует специальный язык разметки CGML, очень жестко привязанный к специфике Oracle и PL/SQL, что сильно ограничивает область его применения. Для работы генератора требуется доступ к файловой системе сервера (через UTL_FILE) для чтения шаблонов и сохранения результатов генерации, хотя, судя по документации, автономная работа только внутри БД тоже была предусмотрена и, возможно, даже реализована. Скачать проект по-прежнему можно с сайта автора.

Quest CodeGen Utility

Реинкарнация PL/Generator, развиваемая в 2004–2007 годах. Представляет из себя целую IDE с возможностью генерировать PL/SQL-код из тех же CGML-шаблонов и проносить результат на сервер. Проект давно закрыт, сайт не работает, документации и даже упоминаний в интернете почти не осталось. Удалось найти только предпоследнюю версию на одном софтверном ресурсе. Разобраться с продуктом оказалось непросто, а, учитывая ограниченность CGML, изучать его досконально я не стал.

iCodeGenerator

Современный проект с открытым кодом на GitHub, позиционирующий себя как БД-центричный шаблонный кодогенератор для любых языков с поддержкой разных СУБД, в том числе Oracle. На поверку оказалось, что шаблонный язык чрезвычайно скуден и, кроме как для краткого документирования содержимого схемы, ни на что не годится. Представляет собой клиентское приложение на .NET. Подключиться к Oracle согласно инструкции так и не получилось. Доступен на своем сайте.

Многочисленные Table API-генераторы

PL/SQLGenPkg, PL/SQL Interface Generator, tapiGen, TAPIG — узкопрофильные средства для генерации обвязок вокруг таблиц для возможности выполнения операций CRUD через них вместо обычного SQL.

Все рассмотренные либо давно заброшены, либо слишком узкоспецифичны и решают частные проблемы, нежели являются универсальными инструментами.

Создаем свой инструмент

Итак, инструмента, который удовлетворял бы широким потребностям промышленной разработки, к сожалению, не нашлось. Поэтому было решено сделать свой. Были выбраны самые полезные возможности из арсенала штатных средств и составлен список фич, необходимых для комфортной работы:

  • от обычного PL/SQL были взяты способы обращения к БД: выполнение запросов, вызов хранимых функций, получение результата в виде сложносоставных типов — result set'ов;
  • от PLSQLCC — возможность писать и хранить управляющие инструкции кода-генератора как plain text прямо в теле хранимых программных единиц, чтобы редактирование в IDE ничем не отличалось от привычной разработки обычного статичного кода;
  • от XSLT — принцип шаблонной генерации: первичность генерируемого кода над кодом-генератором;
  • от SQL*Plus — возможность выполнения на клиенте.

Возникло еще одно требование, продиктованное инертностью Enterprise-сектора, — совместимость с Oracle как минимум 10-й версии (при текущей 12-й), поскольку она все еще активно используется в production.

Выбор движка шаблонов

Поскольку Oracle имеет встроенную JVM (ранее известную как Aurora), а Java-мир очень богат на инструменты любого вида, было решено посмотреть в сторону Java Template Engines.

Практически сразу же определились два кандидата: Velocity и FreeMarker — самые популярные шаблонные движки. Изучив их возможности и попрактиковавшись с ними, мы поняли, что Velocity заморожен несколько лет назад, а FreeMarker обладает более обширным арсеналом фич и более гибким хорошо документированным языком (FTL), продолжает активно развиваться и периодически выпускает новые версии.

Судя по его описанию, FreeMarker теоретически позволял интегрироваться с Oracle и «допилить» его таким образом, чтобы из FTL было удобно обращаться к БД.

Кроме того, Java-приложения можно запускать на клиенте так же успешно, как и внутри СУБД. Это решало бы проблему совместимости с Oracle XE, в котором нет поддержки Java, а также очень старыми версиями Oracle (младше 10), где JVM-версии — ниже 1.4, несовместимые с FreeMarker.

Интеграция с Oracle

Чтобы сделать полноценный инструмент, необходимо было решить три основные проблемы.

  1. Поселить FreeMarker в СУБД, заставить его там работать и дописать набор классов, расширяющий язык FTL возможностями.
  2. Научиться хранить шаблоны FTL наиболее удобным и нативным способом, как обычные программные единицы, сделать работу с ними в популярных IDE комфортной.
  3. Свести к минимуму заботу разработчика о процессинге шаблонов и выполнении сгенерированных скриптов на сервере.

Забегая вперед, скажу, что все эти проблемы были успешно решены и родился инструмент FTLDB (названный по аналогии c HTMLDB и XMLDB), который теперь лежит на GitHub под лицензией Apache License 2.0.

А теперь расскажу подробнее о том, что было сделано.

Доработка FreeMarker

Вся Java-разработка велась с минимальной конкретикой на Oracle, с использованием преимущественно интерфейсов JDBC из java.sql.*. Это позволило в дальнейшем использовать инструмент не только для Oracle, но и для других СУБД. В тех местах, где без специфики было не обойтись (серверное выполнение на встроенной JVM), были оставлены возможности расширения и для других СУБД, потенциально способных исполнять Java-код самостоятельно (например, PostgreSQL + PL/Java).

Язык FTL был дополнен методами создания JDBC-соединений (или использования текущего соединения при работе на server-side), выполнения в рамках них SQL-запросов и программных вызовов, работы с результатами их выполнения в родном для FTL виде. Также были добавлены некоторые утилитарные методы для FTL, загрузчик шаблонов из БД с помощью произвольного вызова и main-методы для запуска движка из CLI и PL/SQL.

Хранение шаблонов

С помощью директив PLSQLCC был придуман простой и элегантный способ хранения шаблонов в БД в телах хранимых программных единиц. Используя директиву $if $then $end с явным ложным условием, в теле любого пакета можно создать «контейнер», невидимый компилятору, в который можно поместить как plain text вообще любой код, а в частности — шаблоны FTL. Это позволяет очень удобно редактировать код в IDE (с сохранением подсветки и code assist фич) и устанавливать его на сервер так же, как обычные пакеты (к слову, проносить их в виде CLOB было бы не так тривиально).

Выглядит это примерно так:

CREATE OR REPLACE package my_template AS
 
$if FALSE $then
 
 
 
здесь можно хранить любой невалидный с точки зрения компилятора код
 
 
 
$end
 
END;
 
/

Очень похоже на хранимые функции в PostgreSQL :)

Процессинг шаблонов

Для извлечения шаблонов из таких контейнеров был написан утилитарный пакет, позволяющий обращаться к ним по имени содержащего их объекта Oracle и возвращающий их в виде CLOB. Этот пакет используется загрузчиком шаблонов в FreeMarker.

Обработка шаблонов осуществляется движком FreeMarker с использованием наших расширений JDBC для извлечения метаданных, после чего результат генерации возвращаются в вызывающую среду в виде out-потока (client-side) или CLOB (Oracle server-side).

Кроме того, был написан специальный объектный PL/SQL-тип, в который опционально преобразуется результат обработки шаблона. Он представляет собой контейнер исполняемых выражений, которые можно выводить в output или запускать на инстансе с помощью встроенных методов. Это своеобразный серверный аналог SQL*Plus, позволяющий компоновать множество шаблонов или отдельных выражений в один объект и выполнять его как скрипт.

Что получилось и как выглядит

FTLDB для Oracle распространяется в виде инсталлятора под Windows batch и *nix shell. Устанавливается он как отдельная схема (так рекомендуется, хотя можно ставить и в существующую по соседству с другими объектами). Все объекты создаются в режиме выполнения c правами вызывающего (invoker's rights), что позволяет использовать его из других схем совершенно прозрачно.

Для работы на клиенте (с любой СУБД) нужны только jar-архивы FreeMarker и FTLDB из инсталлятора, а также JDBC-драйвер, распространяемый производителем СУБД.

Меньше слов — больше примеров! Посмотрите еще раз на демонстрационный фрагмент кода из раздела про DynSQL.

Вот как то же самое делается с помощью FTLDB на серверной стороне.

Сам пакет немного изменился в получении метаданных, а вместо конкатенации скрипта таблицы по кусочкам есть настоящий шаблон:

CREATE OR REPLACE package body generator AS
 
 
 
FUNCTION get_partitions RETURN sys_refcursor
 
IS
 
  l_rc sys_refcursor;
 
BEGIN
 
  OPEN l_rc FOR
 
    SELECT
 
      t.region name,
 
      listagg(t.shop_id, ', ')
 
        WITHIN GROUP (ORDER BY t.shop_id) vals
 
    FROM shops t
 
    GROUP BY t.region
 
    ORDER BY t.region;
 
  RETURN l_rc;
 
END get_partitions;
 
 
 
$if FALSE $then
 
--%begin orders_ftl
 
 
 
<#import "ftldb.sql_ftl" AS SQL/>
 
<#assign partitions = SQL.fetch('generator.get_partitions')/>
 
 
 
CREATE TABLE orders (
 
  order_id INTEGER NOT NULL PRIMARY KEY,
 
  customer_id INTEGER NOT NULL,
 
  shop_id INTEGER NOT NULL,
 
  order_date DATE NOT NULL,
 
  STATUS varchar2(10) NOT NULL
 
)
 
partition BY list(shop_id) (
 
<#list partitions.hash_rows AS p>
 
  partition ${p.NAME} VALUES (${p.VALS})<#if p_has_next>,</#if>
 
</#list>
 
)
 
</>
 
 
 
comment ON TABLE orders IS 'Orders partitioned by region.'
 
</>
 
 
 
--%end orders_ftl
 
$end
 
 
 
FUNCTION gen_orders_ftldb RETURN ftldb.script_ot
 
IS
 
BEGIN
 
  RETURN ftldb.ftldb_api.process('generator%orders_ftl');
 
END gen_orders_ftldb;
 
 
 
END generator;
 
/

Вызов генерации (создать скрипт и запустить его в текущей сессии с выводом в output):

BEGIN
 
  generator.gen_orders_ftldb().exec(TRUE);
 
END;
 
/

А вот так на клиентской.

Шаблон храним в отдельном файле:

<#assign conn = new_connection(template_args[0], template_args[1], template_args[2])/>
 
 
 
<#assign
 
  partitions = conn.query(
 
    "select " +
 
      "t.region name, " +
 
      "listagg(t.shop_id, ', ') within group (order by t.shop_id) vals " +
 
    "from shops t " +
 
    "group by t.region " +
 
    "order by t.region"
 
  )
 
/>
 
 
 
create table orders (
 
  order_id integer not null primary key,
 
  customer_id integer not null,
 
  shop_id integer not null,
 
  order_date date not null,
 
  status varchar2(10) not null
 
)
 
partition by list(shop_id) (
 
<#list partitions.hash_rows as p>
 
  partition ${p.NAME} values (${p.VALS})<#if p_has_next>,</#if>
 
</#list>
 
)
 
/
 
 
 
comment on table orders is 'Orders partitioned by region.'
 
/
 
 
 
<#assign void = conn.close()/>

Вызов генерации и запуск скрипта:

java -cp ../java/* ftldb.CommandLine orders.ftl "jdbc:oracle:oci:@orcl" scott tiger 1> orders.sql
 
sqlplus scott/tiger@orcl @orders.sql

Больше примеров использования доступны в демо проекта. Документация API приложена к дистрибутиву.

Другие варианты применения

Поскольку клиентский режим целиком и полностью работает на абстракции JDBC и не имеет Oracle-специфичных «зашивок», FTLDB можно использовать для клиентской генерации скриптов для любой СУБД, предоставляющей JDBC-драйвер. Вообще говоря, FTLDB подходит для генерации произвольных текстов в любой области применения самого FreeMarker, например, документации или web-страниц.

Настоящее и будущее проекта

FTLDB сейчас используется в нескольких наших промышленных проектах, поддерживается авторами и имеет планы дальнейшего развития.

С удовольствием ждем ваших отзывов, предложений по доработке и pull request'ов.