Перейти к основному содержимому

Модульная разработка

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

Для выделения изолированных частей используйте подсистемы (свойства) и пакеты. Внутрь подсистем и пакетов добавляйте элементы: HTTP-сервисы, процессы интеграции, общие модули и т. д.

Стандартно внутри одной подсистемы вы можете использовать только элементы этой подсистемы. Элементы других подсистем недоступны вам без дополнительных действий.

Чтобы элементы подсистемы Б использовать в подсистеме А, выполните следующие действия:

Область видимости элемента проекта​

У любого элемента проекта есть свойство ОбластьВидимости со значениями:

  • ВПодсистеме — элемент виден внутри своей подсистемы во всех пакетах. Значение по умолчанию;
  • ВПроекте — элемент виден во всех подсистемах своего проекта;
  • Глобально — элемент виден в других проектах.

Стандартно элемент виден только внутри своей подсистемы (ВПодсистеме) и недоступен в других подсистемах. Если вам хочется использовать этот элемент в других подсистемах или в других проектах, нужно установить у него область видимости в значение ВПроекте или Глобально.

ВидЭлемента: ОбщийМодуль
Имя: ОбщиеМетоды
Id: 76eb6f8f-e340-42ed-8dad-7a1104a6da02
ОбластьВидимости: ВПроекте

Тем самым вы сделаете элемент публичным, т. е. он может быть доступен в других подсистемах.

Видимость языковых конструкций​

Переменным, методам, перечислениям, структурам, исключениям вы тоже можете задать в модуле область видимости. Для этого используйте аннотации видимости, которые могут принимать следующие значения:

  • @Локально — конструкция видна только в своем модуле (значение по умолчанию);
  • @ВПодсистеме — конструкция видна только в подсистеме, которой принадлежит модуль;
  • @ВПроекте — конструкция видна только в проекте, которому принадлежит модуль;
  • @ВТипе — конструкция видна в данном типе и его наследниках;
  • @Глобально — конструкция видна в других проектах.

Например:

@Локально
конст СЕКУНД_В_ДНЕ = 60 * 60 * 24

@ВПодсистеме
структура УчетнаяЗапись
    пер Ид: Uuid
    пер Код: Строка?
;

@ВПроекте
метод ПолучитьОписание()
    ...
;

Квалифицированное имя элемента​

Все элементы проекта порождают типы встроенного языка. Данные типы принадлежат пространству имен, совпадающему с именем подсистемы и пакета, в которых они были созданы.

Для обращении к типу вы можете использовать следующие форматы имен:

  • Полное квалифицированное имя: Поставщик::ИмяПроекта::Подсистема[::Пакет]::ИмяТипа.
  • Частичное квалифицированное имя: Подсистема[::Пакет]::ИмяТипа.
  • Краткое, неквалифицированное, имя: ИмяТипа.

Частичные квалифицированные имена используются при обращении к типам из используемых подсистем текущего проекта. Для обращения к типу из другого проекта или библиотеки необходимо указать полное квалифицированное имя. Например, для типа ПолучателиСообщений из библиотеки Рассылки и уведомления полное имя будет выглядеть следующим образом: e1c::РассылкиИУведомления::Основное::ПолучателиСообщений. Если вы хотите обращаться к типам по их краткому имени, необходимо выполнить импорт пространств имен.

Рассмотрим пример. Пусть у нас есть проект вида:

Структура проекта в навигаторе проекта

Тогда частичные квалифицированные имена типов, порождаемых элементами проекта, будут выглядеть следующим образом:

  • Магазины::Пакет::InformationSystems,
  • Магазины::ОбменСоСкладом,
  • Основной::ОбменСоСкладом,
  • Основной::ПриемЗапросов.
примечание

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

Разрешение имен​

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

Если какое-либо имя доступно в нескольких пространствах (в том числе в стандартном, собственном или импортируемом) без указания пространства имен, то при разрешении имени используются приоритеты пространств имен. Пространства имен перечислены в порядке убывания приоритета:

  • пространства имен пакетов текущей подсистемы;

    примечание

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

  • пространства имен текущего проекта;

  • пространства имен остальных проектов;

  • стандартное пространство имен (Стд).

Использование подсистем​

У подсистемы есть свойство Использование. В этом свойстве вы можете перечислить подсистемы, публичные элементы которых вы хотите использовать в данной подсистеме. К типам таких элементов вы сможете обращаться по квалифицированному имени, например:

Реквизиты:
   -
      Имя: Владелец
      Тип: Магазины::InformationSystems.Ссылка

Импорт пространств имен​

В любые элементы проекта и в модули вы можете импортировать другие пространства имен.

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

Например в процессе интеграции:

ВидЭлемента: ПроцессИнтеграции
Имя: ОбменСоСкладом
Id: a79bd05e-800d-4d9c-a292-eeec023d3f07
ОбластьВидимости: ВПроекте
Импорт:
  - ОбщиеМетоды
  - КонвертацияФайлов

Например, в некотором модуле:

импорт ОбщиеМетоды
импорт КонвертацияФайлов

метод ПередЗаписью()
   // ...
;

После того как вы выполнили импорт пространств имен, вы можете использовать элементы проекта и конструкции языка с областью видимости @ВПроекте или @Глобально по их неквалифицированному имени, как будто это собственные элементы текущей подсистемы.

Импорт, выполненный в элементе проекта, не влияет на его модули. То есть пространства имен, импортированные в элемент проекта, не становятся автоматически доступны в модулях этого элемента. Если эти же пространства имен нужны вам и в модулях, то в каждый модуль их нужно импортировать отдельно.

См. также​

Последнее обновление