powered by simpleCommunicator - 2.0.51     © 2025 Programmizd 02
Форумы / IBExpert [игнор отключен] [закрыт для гостей] / Куда деваются комментарии в параметрах процедур?
6 сообщений из 6, страница 1 из 1
Куда деваются комментарии в параметрах процедур?
    #39266219
Фотография Док
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Саша, привет. Пишу параметры процедуры, комментирую строку, переоткрываю редактор процедуры - закомментированная строка пропадает.

Т.е. редактор убирает мусор, не спрашивая моего согласия. Жутко неудобно при отладке. Может, опции какие есть?
=================
Док.

Win7 Ultim x64/Deb 7.6 i386 (Deb 8.3 i386):
FB 3.0.0.32483, диалект 3, SS(win)/CS(Deb),
Lazarus 1.7; FPC 3.1.1, IBX by -Rik-; IBE 2016.4.29.1
IBE 2016.5.14.1
...
Рейтинг: 0 / 0
Куда деваются комментарии в параметрах процедур?
    #39266229
Фотография Симонов Денис
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Док,

ну ты же знаешь что заголовок процедуры не хранится в FB, поэтому в IBE он собирается из системных таблиц. Параметрам можно задавать комментарии через COMMENT ON, хотя это и не так наглядно.

Кстати было бы прекрасно если бы FB поддерживал указание комментариев по месту, а не только отдельным оператором COMMENT ON, что-то типа

Код: sql
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
CREATE PROCEDURE PROC1(
   A_ID INT COMMENT 'Идентификатор',
   A_NAME VARCHAR(30) NOT NULL COMMENT 'Наименование'
)
RETURNS (
  OUT_PARAM BLOB SUB_TYPE TEXT COMMENT 'Выходной параметр'
)
COMMENT 'Процедура создания ...'
AS
  DECLARE X INT DEFAULT 5 COMMENT 'Локальная переменная';
BEGIN
...
END
...
Рейтинг: 0 / 0
Куда деваются комментарии в параметрах процедур?
    #39266290
Автодок
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Гость
Я бы начал с такой схемы:

Пишу комментарии в коде после as в стиле javadoc и при компиляции текст оттуда автоматически сохраняется в комментариях процедуры и параметров. Ну и обратно, при генерации кода заголовка комментарии показываются у процедуры и параметров.

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

Примерно так:
Код: plsql
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
/*
Тестовая процедура для сохранения комментариев
*/
create or alter procedure TEST (
    I_ID integer -- входной параметр
)
returns (
    O_ID integer -- возвращаемое значение
)
as
/**
*    TEST
*    Тестовая процедура для сохранения комментариев
*   
*    @param i_id входной параметр
*    @return o_id возвращаемое значение
*/
declare variable L_V integer;
begin
  O_ID = I_ID + 1;
end

...
Рейтинг: 0 / 0
Куда деваются комментарии в параметрах процедур?
    #39266310
Фотография Симонов Денис
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Автодок,

в пакетах это делать очень даже удобно.

Код: sql
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
CREATE OR ALTER PACKAGE DATE_UTILS
AS
BEGIN
  -- Возвращает маскированную дату
  FUNCTION DateByMask(ADate DATE, AMask D_DATEMASK) RETURNS CHAR(10);
  -- Возвращает строковое представление даты в формате dd.mm.yyyy
  FUNCTION DateToChar(ADate DATE) RETURNS CHAR(10);
  ...
END

RECREATE PACKAGE BODY DATE_UTILS
AS
BEGIN
  /**
   * Возвращает маскированную дату
   * @param ADate входной параметр
   */
  FUNCTION DateByMask(ADate DATE, AMask D_DATEMASK) RETURNS CHAR(10)
  AS
  BEGIN
    ...
  END

  /**
   * Возвращает строковое представление даты в формате dd.mm.yyyy
   */
  FUNCTION DateToChar(ADate DATE) RETURNS CHAR(10)
  AS
  BEGIN
    ...
  END
END
...
Рейтинг: 0 / 0
Куда деваются комментарии в параметрах процедур?
    #39266331
Фотография Док
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Да меня не комментарии, как таковые, не устраивают, а исчезновение закомментированных параметров после переоткрытия редактора. Приходится писать сразу набело, либо сохранять черновики еще где-нибудь. А комментировать параметры в процессе отладки приходится.

В процессе новых знаний, откуда берутся дети параметры редактором, сдается мне, что Саша в очередной раз скажет, что не будет заморачиваться с сабжем, ибо нефиг ...
...
Рейтинг: 0 / 0
Куда деваются комментарии в параметрах процедур?
    #39266682
IBExpert
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
ДокВ процессе новых знаний, откуда берутся дети параметры редактором, сдается мне, что Саша в очередной раз скажет, что не будет заморачиваться с сабжем, ибо нефиг ...

Так и есть. Как разберешься, откуда дети берутся, так сразу и поймешь, что редактору и лично Саше нафиг не нужно чё-то там вырезать из наваянного тобой.
...
Рейтинг: 0 / 0
6 сообщений из 6, страница 1 из 1
Форумы / IBExpert [игнор отключен] [закрыт для гостей] / Куда деваются комментарии в параметрах процедур?
Целевая тема:
Создать новую тему:
Автор:
Закрыть
Цитировать
Найденые пользователи ...
Разблокировать пользователей ...
Читали форум (0):
Пользователи онлайн (0):
x
x
Закрыть


Просмотр
0 / 0
Close
Debug Console [Select Text]