v2.1

Author: mazzy-ax

CHANGELOG.md

@@ -1,6 +1,27 @@
 # SysConfigFile Changelog
 
-see also [Releases on GitHub](https://github.com/mazzy-ax/SysConfigFile/releases)
+see also [Releases on GitHub](https://github.com/mazzy-ax/SysConfigFile/releases) and [Unreleased](https://github.com/mazzy-ax/SysEventLog/compare/2.1.0...main) on GitHub.
+
+## [2.1.0](https://github.com/mazzy-ax/SysConfigFile/compare/2.0.0...2.1.0) - 2021-02-25
+
+Исправлено:
+
+* метод `filePath()` теперь пытается найти конфигурационный файл не в файле с указанным именем и с расширением `.config`,
+  `.config.xml`, `xml`, а также в файле, к имени расширение не добавляется.
+
+  Если ни один конфигурационный файл не найден, то, как и прежде, используется имя с расширением `.config`.
+
+  Если в config-каталоге присутствуют несколько конфигурационных файлов с одинаковым именем, но с разными расширениями,
+  то будет возвращен первый существующий с расширением в порядке `.config`, `.config.xml`, `xml`, без расширения.
+
+* в методе `filePath()` предусмотрен сценарий, когда нужно искать конфигурационные файлы не только с разными расширениями,
+  но и в разных каталогах и даже с разными именами. Теперь это просто реализовать.
+
+* метод `load()` проверяет существование файла перед загрузкой
+
+Добавлено:
+
+* добавлены тестовые методы для тестирования нового поведения в методе `filePath()`
 
 ## CRLF в .xpo-файлах - 2020-02-28
 

README.md

@@ -1,4 +1,4 @@
-# SysConfigFile 2.0
+# SysConfigFile 2.1
 
 [project]:https://github.com/mazzy-ax/SysConfigFile
 [license]:https://github.com/mazzy-ax/SysConfigFile/blob/master/LICENSE
@@ -19,8 +19,8 @@
 
 Класс `SysConfigFile` предполагает:
 
-1. параметры хранятся централизовано на сервере в небольших xml-файлах с расширением `.config`
-1. имя config-файла по умолчанию `Axapta.config` (имя можно задать в `new` или в конструкторе)
+1. параметры хранятся централизовано на сервере в небольших xml-файлах с расширением `.config` или `.config.xml`
+1. имя config-файла по умолчанию `Axapta` (имя можно задать в `new` или в конструкторе)
 1. каталог по умолчанию `%Appl%\Config` (каталог можно задать в `new` или в конструкторе, изменить можно в parm-методе)
 1. параметр хранится как xml-элемент, а значение параметра хранится как текстовое значение xml-элемента. Например, `<name>Microsoft Dynamics AX</name>`
 1. пустые xml-элементы трактуются как `true` методом `getBoolean` и как пустое значение методом `get`. См. [Пример config-файла](#Пример-config-файла)
@@ -114,6 +114,18 @@ SysConfigFile::value('id', 'PrintSrv');
 
 При желании можно указать и каталог, где хранится конфиг (см. тестирующий класс `SysConfigFileTest`). По умолчанию класс использует каталог `Config` внутри каталога приложения. К каталогу приложения `%Appl%` гарантировано имеют доступ все AOS кластера. Если админы не запретили специально доступ к каталогам внутри `%Appl%`, то к подкаталогу `%Appl%\Config` доступ скорее всего будет.
 
+## Расширения config-файлов
+
+Начиная с версии 2.1 класс `SysConfigFile` пытается найти конфигурационный файл в файлах с расширением `.config`, `.config.xml`, `.xml`,
+а также в файле с именем конфигурации.
+
+Если в Config-каталоге присутствует несколько конфигурационных файлов с одинаковым именем, но с разными расширениями,
+то будет возвращен первый существующий в указанном порядке: `.config`, `.config.xml`, `.xml`, пустое расширение.
+
+Если ни один конфигурационный файл не найден, то, как и прежде, используется имя с расширением `.config`.
+
+См. метод `filePath()`
+
 ## Валидация
 
 ### Проверка синтаксиса config-файла