Goldev.Core 8.2.0

Goldev.Core

Пакет c общими элементами внутренних библиотек Goldev

Расширения для конфигурации

В пакете реализованы расширения для конфигурации приложения

конфигурация берётся по следующим приоритетам:

1. Переменные окружения
2. appsettings.json
3. значение по умолчанию

Использование:

1. Создать Класс конфигурации

   [AutoConfiguration]
   public class TestConfiguration
   {
       [FromEnvironment("TEST_CONFIG")]
       public string Test { get; init; } = string.Empty; // по умолчанию string.Empty
   }
   

   • Атрибут AutoConfiguration говорит, что мы не будем регистрировать IOptions вручную
   • Атрибут FromEnvironment помечает свойство как свойство из переменных окружения, без него свойство будет браться только из appsetings.json

2. Зарегистрировать класс IOptions

   • Если мы использовали атрибут AutoConfiguration

     builder.Services.AddConfigurations(builder.Configuration); // Регистрируют все классы помеченные как AutoConfiguration
     

   • Если мы не использовали атрибут AutoConfiguration

     builder.Services.ConfigureWithENV<TestConfiguration>(builder.Configuration) // Регистрирует класс TestConfiguration
     

3. Добавить класс конфигурации в конструктор класса

   public TestHandler(IOptions<TestConfiguration> options)
   {
     _config = options.Value
   }
   

4. Добавить значения в appsettings.json или в переменные окружения

   • appsettings.json

     {
       "TestConfiguration": "test"
     }
     

   • EnvironmentVariables

     TEST_CONFIG = "test"
     

Константы

с версии 8.0.7 добавлена возможность прокидывать статические переменные из appsettings.json

Использование:

1. В классе прописать анотации [TrackedType] для класса и [Constant] для статического поля

   [TrackedType]
   public class TestClass
   {
      [Constant(BlockName = "Test", ConstantName = "Test1")]
      static int _test1;
   
      [Constant(BlockName = "Test", ConstantName = "Test2")]
      static TestEnum _testEnum;
   
      [Constant(BlockName = "Test")]
      static string _test3 { get; set; } = null!;
   
      [Constant(BlockName = "Test", ConstantName = "Test3")]
      static string _test5 = null!;
   
      [Constant(BlockName = "Test")]
      public static string Test4 = null!;
   
      [Constant(BlockName = "Test", ConstantName = "Test4")]
      public static string Test6 { get; set; } = null!;
   }
   

2. В appsettings.json прописать значения

   {
     "Test": {
       "Test1": 123,
       "Test2": 3,
       "Test3": "abacaba",
       "Test4": "hello world"
     }
   }
   

3. В program вызвать метод AddConstants();

   builder.Configuration.AddConstants();