:::: МЕНЮ ::::

Форматирование ABAP кода

Большинство компаний имеют внутренний регламент форматирования ABAP кода. Не смотря на наличие регламента, оформление кода может сильно отличаться даже в приделах одной программы. Это связано со следующими фактами: многие программы разрабатывались до принятия регламентов; регламентируют в основном только наименования переменных и программных объектов.

Одни из самых сложных конструкций в ABAP — это SELECT и READ TABLE. Ниже предложены правила форматирования данных конструкций, а также средство автоматизированного форматирования для уже имеющегося кода.

READ TABLE — index

Последовательность операторов следующая:

Если INDEX указан совместно с оператором USING KEY, то INDEX переносится на новую строку с отступом в два пробела.

Если USING KEY не используется, то оператор пишется в одну строку.

READ TABLE — free_key

Последовательность операторов следующая:

  1. Первая строка – READ TABLE itab result
  2. Вторая и последующие строки — WITH KEY с условием выбора

При использовании BINARY SEARCH, оператор ставится на второй строке, строка с WITH KEY смещается ниже. Дополнения BINARY SEARCH и WITH KEY пишутся с отступом в два символа.

Первое условие в WITH KEY пишется на текущей строки, каждое новое условие с новой строки, при этом отступы таким образом, чтобы поля выбора были на одной позиции. Знак равно «=» выделяется таким образом, чтобы на всех условиях выбора он был на одном уровне.

READ TABLE — table_key

Если используется дополнение FROM без USING KEY, код пишется в одну строку.

При использовании дополнения FROM с USING KEY код пишется в две строки. Вторая строка с отступом в два пробела.

При использовании первичного ключа таблицы, дополнение WITH TABLE KEY пишется на новой строке с отступом в два пробела, при этом отступы таким образом, чтобы поля выбора были на одной позиции. Знак равно «=» выделяется таким образом, чтобы на всех условиях выбора он был на одном уровне.

При использовании вторичного ключа, на второй строке указывается WITH TABLE KEY с названием ключа, на третьей и следующих строках COMPONENTS и условия чтения. Выравнивание условий происходит аналогично предыдущему варианту.

SQL

Каждая ключевая конструкция пишется с новой строки с отступом в 2 символа. Исключение — «UP TO n ROWS» если в качестве выбора поля указана * либо одно поле с коротким названием без алиаса, в этом случае конструкция пишется на первой строке. Порядок ключевых конструкций следующий:

SQL — fields

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

SQL — where

Условия выбора, разделённые оператором AND, должны быть записаны с новой строки и выровнены на одном уровне с оператором WHERE.

SQL — from

При выборе данных из нескольких таблиц, каждый JOIN пишется на новой строке, с отступов в 2 символа. Условия соединений таблиц должны быть выровнены на одном уровне с оператором ON, по аналогии с WHERE.

 


Присоединиться к обсуждению...