Встроенные функции - История изменений

Lan: /* Функции для DDL-манипуляций */

2015-11-02T08:31:23Z

‎Функции для DDL-манипуляций

Lan в 10:34, 9 октября 2014

2014-10-09T10:34:02Z

Asko в 07:10, 2 сентября 2014

2014-09-02T07:10:06Z

Asko: Asko переименовал страницу Встроенные функции (BeanExplorer4) в Встроенные функции

2014-09-02T06:54:29Z

Asko переименовал страницу Встроенные функции (BeanExplorer4) в Встроенные функции

Asko в 09:11, 22 августа 2014

2014-08-22T09:11:15Z

Asko: /* Основные функции */

2014-08-22T08:44:24Z

‎Основные функции

Asko в 08:28, 22 августа 2014

2014-08-22T08:28:25Z

Asko: Новая страница: «Для удобства работы предопределены некоторые функции:
* ''''''addDays''': '''создаёт SQL-предлож…»

2014-08-22T07:09:37Z

Новая страница: «Для удобства работы предопределены некоторые функции: * ''''''addDays''': '''создаёт SQL-предлож…»

Новая страница

Для удобства работы предопределены некоторые функции: 
* ''''''addDays''': '''создаёт SQL-предложение для получения даты,
отличающейся от заданной на указанное количество дней. Требуется два
параметра: дата и количество дней
* ''''''addMillis''': '''создаёт SQL-предложение для получения даты,
отличающейся от заданной на указанное количество миллисекунд. Требуется два
параметра: дата и количество миллисекунд.
* '''addMonths''': создаёт SQL-предложение для получения даты, отличающейся от заданной на указанное количество месяцев. Требуется два параметра: дата и количество месяцев. 
* '''chr''': создаёт SQL-предложение для нахождения символа по коду (обычно пригождаться не должно, сейчас используется для идентичных метаданных со старым BE). 
* '''coalesce''': создаёт SQL-предложение COALESCE.
* '''concat''': создаёт SQL-предложения для конкатенации переданных строк. Пример:
** <code>SELECT ${concat('name', ' = '?str, 'value')} FROM myDictionary </code>-> (в MySQL) SELECT CONCAT( name, ' = ', value ) FROM myDictionary
* '''genericRef''': создаётся generic-ссылка. Требуется два аргумента: entity и колонка-идентификатор.
* '''if''': создаёт SQL-предложение IF. Требуется три аргумента: условие, значение, если условие истинно, и значение, если условие ложно. Если третий опущен, предполагается пустая строка.
* '''indexOf''': создаёт SQL-предложение для поиска подстроки в строке. Требуется два аргумента: строка и подстрока. 
* ''''''joinGenericRef'''''': создаёт JOIN-предложение для подключения таблицы
через generic reference. Требудется три аргумента: целевая таблица,
алиас для неё и колонка-идентификатор.
* '''length''': создаёт SQL-предложение для подсчёта количества
символов в строке. Не путайте со стандартным Freemarker-суффиксом
?length, который вычислит длину поданной строки во время выполнения
скрипта.
* '''limit''': создаёт SQL-предложение для ограничения числа строк в запросе (если это позволяет СУБД) 
* '''lpad''': создаёт SQL-предложение LPAD. Требудется три аргумента:
исходная строка, требуемая длина и строка-заполнитель, которая будет
использована для удлиннения исходной строки слева в случае
необходимости.
* '''replace''': создаёт SQL-предложение REPLACE. Требуется три аргумента: исходная строка, искомая подстрока, строка замены. 
* '''substring''': создаёт SQL-предложение SUBSTRING. Требуется три аргумента: исходная строка, номер начального символа, количество символов.

==== Функции для DDL-манипуляций ====
Обычно таблицы задаются в BE4 в декларативном стиле в файле structure.yaml, и новые таблицы добавляются автоматически при синхронизации. DDL-манипуляции из FTL-скриптов могут потребоваться для обновления таблиц, определённых в старых m4-модулях. В целом манипулировать схемой таблиц из FTL не рекомендуется. 
* '''columnDef(columnName, columnDefinition)''': создаёт фрагмент SQL-предложения CREATE TABLE или ALTER TABLE для определения колонки. Первый параметр — имя колонки, второй — хэш с её свойствами. Свойства в точности такие же, как в structure.yaml. Пример:
** <code>ALTER TABLE test ADD COLUMN ${columnDef('myCol', {'type': 'BOOL', 'canBeNull': true})}</code> -> (в Postgres) 
ALTER TABLE test ADD COLUMN mycol VARCHAR(3) CHECK(mycol IN ('no', 'yes') )
* '''tableDef(tableName, columns[, indices])''': создаёт SQL-предложение для создания новой таблицы (если таблица уже существовала, старая удаляется). Первый параметр — имя таблицы, второй — хэш, где ключи — имена колонок, а значения — хэш со свойствами колонок (как в columnDef). Необязательный третий параметр: список индексов (ключи — имена индексов, значения — хэш, описывающий индекс так же, как в structure.yaml). Пример:
** <code>${tableDef('uiSocialBlocks', {</code> 
<code> 'CODE': {'type': 'VARCHAR(2)', 'primaryKey': true},</code> 
<code> 'name': {'type': 'VARCHAR(250)'},</code> 
<code> 'parentCode': {'type': 'VARCHAR(2)', 'canBeNull': true}</code> 
<code>})}</code>
*** Результат в '''Postgres''': 
DROP TABLE IF EXISTS uisocialblocks; 
CREATE TABLE uisocialblocks ( 
code VARCHAR(2) NOT NULL PRIMARY KEY, 
name VARCHAR(250) NOT NULL, 
parentcode VARCHAR(2));
*** Результат в '''Oracle''': 
call drop_if_exists( 'uiSocialBlocks' ); 
CREATE TABLE UISOCIALBLOCKS ( 
CODE VARCHAR2(2 CHAR) NOT NULL PRIMARY KEY, 
NAME VARCHAR2(250 CHAR) NOT NULL, 
PARENTCODE VARCHAR2(2 CHAR));

← Предыдущая		Версия 10:34, 9 октября 2014
Строка 42:		Строка 42:
	NAME VARCHAR2(250 CHAR) NOT NULL,		NAME VARCHAR2(250 CHAR) NOT NULL,
	PARENTCODE VARCHAR2(2 CHAR));<br/>		PARENTCODE VARCHAR2(2 CHAR));<br/>
		+
		+	[[Категория:Freemarker]]

← Предыдущая		Версия 07:10, 2 сентября 2014
Строка 42:		Строка 42:
	NAME VARCHAR2(250 CHAR) NOT NULL,		NAME VARCHAR2(250 CHAR) NOT NULL,
	PARENTCODE VARCHAR2(2 CHAR));<br/>		PARENTCODE VARCHAR2(2 CHAR));<br/>
−	~~----~~
−	~~=== Категории ===~~
−	* [[:Category:BeanExplorer4]]

← Предыдущая		Версия 09:11, 22 августа 2014
Строка 42:		Строка 42:
	NAME VARCHAR2(250 CHAR) NOT NULL,		NAME VARCHAR2(250 CHAR) NOT NULL,
	PARENTCODE VARCHAR2(2 CHAR));<br/>		PARENTCODE VARCHAR2(2 CHAR));<br/>
		+	----
		+	=== Категории ===
		+	* [[:Category:BeanExplorer4]]

@@ Строка 19: / Строка 19: @@
 === Функции для DDL-манипуляций ===
-Обычно таблицы задаются в BE4 в декларативном стиле в файле structure.yaml, и новые таблицы добавляются автоматически при синхронизации. DDL-манипуляции из FTL-скриптов могут потребоваться для обновления таблиц, определённых в старых m4-модулях. В целом манипулировать схемой таблиц из FTL не рекомендуется.
+Обычно таблицы задаются в BE4 в декларативном стиле в файлах [[entity|сущностей]], и новые таблицы добавляются автоматически при синхронизации. DDL-манипуляции из FTL-скриптов могут потребоваться для обновления таблиц, определённых в старых m4-модулях. В целом манипулировать схемой таблиц из FTL не рекомендуется.
 * '''columnDef(columnName, columnDefinition)''': создаёт фрагмент SQL-предложения CREATE TABLE или ALTER TABLE для определения колонки. Первый параметр — имя колонки, второй — хэш с её свойствами. Свойства в точности такие же, как в structure.yaml. Пример:

← Предыдущая	Версия 06:54, 2 сентября 2014
(нет различий)

@@ Строка 1: / Строка 1: @@
 === Основные функции ===
 Для удобства работы предопределены некоторые функции:
-* '''addDays''': создаёт SQL-предложение для получения даты,
+* '''addDays''': создаёт SQL-предложение для получения даты, отличающейся от заданной на указанное количество дней. Требуется два параметра: дата и количество дней
-отличающейся от заданной на указанное количество дней. Требуется два
+* '''addMillis''': создаёт SQL-предложение для получения даты, отличающейся от заданной на указанное количество миллисекунд. Требуется два параметра: дата и количество миллисекунд.
 параметра: дата и количество дней
 * '''addMillis''': создаёт SQL-предложение для получения даты,
 отличающейся от заданной на указанное количество миллисекунд. Требуется два
 параметра: дата и количество миллисекунд.
 * '''addMonths''': создаёт SQL-предложение для получения даты, отличающейся от заданной на указанное количество месяцев. Требуется два параметра: дата и количество месяцев.
 * '''chr''': создаёт SQL-предложение для нахождения символа по коду (обычно пригождаться не должно, сейчас используется для идентичных метаданных со старым BE).
@@ Строка 15: / Строка 11: @@
 * '''if''': создаёт SQL-предложение IF. Требуется три аргумента: условие, значение, если условие истинно, и значение, если условие ложно. Если третий опущен, предполагается пустая строка.
 * '''indexOf''': создаёт SQL-предложение для поиска подстроки в строке. Требуется два аргумента: строка и подстрока.
-* '''joinGenericRef''': создаёт JOIN-предложение для подключения таблицы
+* '''joinGenericRef''': создаёт JOIN-предложение для подключения таблицы через generic reference. Требудется три аргумента: целевая таблица, алиас для неё и колонка-идентификатор.
-через generic reference. Требудется три аргумента: целевая таблица,
+* '''length''': создаёт SQL-предложение для подсчёта количества символов в строке. Не путайте со стандартным Freemarker-суффиксом ?length, который вычислит длину поданной строки во время выполнения скрипта.
 алиас для неё и колонка-идентификатор.
 * '''length''': создаёт SQL-предложение для подсчёта количества
 символов в строке. Не путайте со стандартным Freemarker-суффиксом
 ?length, который вычислит длину поданной строки во время выполнения
 скрипта.
 * '''limit''': создаёт SQL-предложение для ограничения числа строк в запросе (если это позволяет СУБД)
-* '''lpad''': создаёт SQL-предложение LPAD. Требудется три аргумента:
+* '''lpad''': создаёт SQL-предложение LPAD. Требудется три аргумента: исходная строка, требуемая длина и строка-заполнитель, которая будет использована для удлиннения исходной строки слева в случае необходимости.
 исходная строка, требуемая длина и строка-заполнитель, которая будет
 использована для удлиннения исходной строки слева в случае
 необходимости.
 * '''replace''': создаёт SQL-предложение REPLACE. Требуется три аргумента: исходная строка, искомая подстрока, строка замены.
 * '''substring''': создаёт SQL-предложение SUBSTRING. Требуется три аргумента: исходная строка, номер начального символа, количество символов.