Запуск для трассировки

Платформа предоставляет способ мониторинга действий выполняемого модуля, не запуская его в режиме отладки. Если включить флаги трассировки, то информация трассировки будет выводиться в stdout или (панель Консоль). Эти флаги задаются в файлах ".options" в следующем формате:

   <ИД-модуля>/debug = true/false  (главный ключ)
   <ИД-модуля>/<флаг-трассировки> = <значение>

Первая запись - это главный ключ для трассировки модуля. Метод isDebugging класса модуля возвращает true, если значение этой переменной трассировки равно true. Все остальные флаги задаете вы сами, и их значение получается при вызове

   Platform.getDebugOption(optionName);

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

Динамическая рабочая среда, панель запуска - трассировка

Пример:  Включение трассировки модуля

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

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

Создадим теперь файл шаблона .options и укажем в нем несколько флагов трассировки для нового модуля.

Выберите созданный ранее проект com.example.xyz и создайте новый файл .options. В текстовом редакторе добавьте следующие строки:

   com.example.xyz/debug = true
   com.example.xyz/debug/flag = true
   com.example.xyz/debug/filter = *

Сохраните этот файл и выберите Выполнить > Выполнить.... Откроется окно запуска. В списке будет показан наш модуль. Выбрав его, мы увидим вновь заданные флаги и их значения по умолчанию.

Динамическая рабочая среда, панель запуска - пример трассировки

Файл .options делает флаги доступными другим разработчикам, которые смогут тем самым задавать свойства трассировки.   Поэтому вам необходимо будет определять значения свойств трассировки, вызывая Platform.getDebugOption().