DragonECS - Auto Injections Extension

Расширение призвано сократить объем кода, упростив инбъекцию зависимостей, делая их автоматическими.

Оглавление

• Установка
  • Зависимости
  • Unity-модуль
  • В виде иходников
• Инъекция зависимостей
• Фабрикаа субъектов
• Пример кода
• Не null инъекции

Установка

Зависимости

Убдитесь что в проекте установлен фреймворк DragonECS.

• Unity-модуль

Поддерживается установка в виде Unity-модуля в при помощи добавления git-URL в PackageManager или ручного добавления в Packages/manifest.json:

https://github.com/DCFApixels/DragonECS-AutoInjections.git

• В виде иходников

Фреймворк так же может быть добавлен в проект в виде исходников.

Интеграция

Добавте вызов метода AutoInject() для фабрики Pipeline. Пример:

_pipeline = EcsPipeline.New()
    .Inject(world)
    .Inject(_timeService)
    .Add(new TestSystem())
    .Add(new VelocitySystem())
    .Add(new ViewSystem())
    .AutoInject()
    .BuildAndInit();

Инъекция зависимостей

Аттрибут [EcsInject] убирает необходимость использования интерфейса IEcsInject<T>, поля помеченные таким атрибутом автоматически подхватят зависимости внедренные в Pipeline.

Фабрикаа субъектов

Так же AutoInjections упрощает построение субъектов. Для работы наследйте субъекты не от EcsSubject, а от EcsSubjectDI.

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

• [Inc] - добавит тип компонента в включающее ограничение, аналог метода Include;
• [Exc] - добавит тип компонента в исключающее ограничение, аналог метода Exclude;
• [Opt] - только кеширует пул, аналог метода Optional;

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

• [IncImplicit(type)] - добавит в включающее ограничение тип указанный в конструкторе type, аналог метода Include;
• [ExcImplicit(type)] - добавит в исключающее ограничение тип указанный в конструкторе type, аналог метода Exclude;

Пример кода

class VelocitySystemDI : IEcsRunProcess
{
    class Subject : EcsSubjectDI
    {
        [ExcImplicit(typeof(FreezedTag))]
        [Inc] public EcsPool<Pose> poses;
        [Inc] public EcsPool<Velocity> velocities;
    }

    [EcsInject] EcsDefaultWorld _world;
    [EcsInject] TimeService _time;

    public void Run(EcsPipeline pipeline)
    {
        foreach (var e in _world.Where(out Subject s))
        {
            s.poses.Write(e).position += s.velocities.Read(e).value * _time.DeltaTime;
        }
    }
}

Тот же код но без AutoInjections

class VelocitySystem : IEcsRunProcess, IEcsInject<EcsDefaultWorld>, IEcsInject<TimeService>
{
    class Subject : EcsSubject
    {
        public EcsPool<Pose> poses;
        public EcsPool<Velocity> velocities;
        public Subject(Builder b)
        {
            b.Exclude<FreezedTag>();
            poses = b.Include<Pose>();
            velocities = b.Include<Velocity>();
        }
    }

    EcsDefaultWorld _world;
    TimeService _time;

    public void Inject(EcsDefaultWorld obj) => _world = obj;
    public void Inject(TimeService obj) => _time = obj;

    public void Run(EcsPipeline pipeline)
    {
        foreach (var e in _world.Where(out Subject s))
        {
            s.poses.Write(e).position += s.velocities.Read(e).value * _time.DeltaTime;
        }
    }
}

Не null инъекции

Чтобы поле помеченное [EcsInject] было проинициализированно даже в случае отстувия инъекции, в конструктор атрибута можно передать тип болванку. В примере ниже поле foo получит экземпляр класса Foo из инъекции или экземпляр FooDummy : Foo если инъекции небыло.

[EcsInject(typeof(FooDummy))] Foo foo;

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

Расширение так же сообщит если по заврешению предварительной инъекции, остались непроинициализированные поля с [EcsInject].