mirror of
https://github.com/DCFApixels/DragonECS-AutoInjections.git
synced 2026-04-21 23:15:54 +08:00
Update README.md
This commit is contained in:
parent
431f0b873c
commit
541233c237
66
README.md
66
README.md
@ -41,6 +41,14 @@ The extension is designed to reduce the amount of code by simplifying dependency
|
|||||||
>
|
>
|
||||||
> While the English version of the README is incomplete, you can view the [Russian version](https://github.com/DCFApixels/DragonECS-AutoInjections/blob/main/README-RU.md).
|
> While the English version of the README is incomplete, you can view the [Russian version](https://github.com/DCFApixels/DragonECS-AutoInjections/blob/main/README-RU.md).
|
||||||
|
|
||||||
|
# Оглавление
|
||||||
|
- [Installation](#Installation)
|
||||||
|
- [Integration](#Integration)
|
||||||
|
- [Dependency Injection](#Dependency-Injection)
|
||||||
|
- [Auto Builder for aspects](#Auto-Builder-for-aspects)
|
||||||
|
- [Auto Runners](#Auto-Runners)
|
||||||
|
- [Code Example](#Code-Example)
|
||||||
|
- [Non-null injections](#Non-null-injections)
|
||||||
|
|
||||||
</br>
|
</br>
|
||||||
|
|
||||||
@ -108,7 +116,53 @@ EcsDefaultWorld _world;
|
|||||||
|
|
||||||
> Aggressive injection (without the `[DI]` attribute) is enabled by calling `.AutoInject(true)`.
|
> Aggressive injection (without the `[DI]` attribute) is enabled by calling `.AutoInject(true)`.
|
||||||
|
|
||||||
|
</br>
|
||||||
|
|
||||||
|
# Auto Builder for aspects
|
||||||
|
AutoInjections also simplifies building aspects. The following attributes are available:
|
||||||
|
|
||||||
|
Attributes for initializing pool fields:
|
||||||
|
* `[Inc]` - caches the pool and adds the component type to the include constraint of the aspect (equivalent to `Include<T>()`);
|
||||||
|
* `[Exc]` - caches the pool and adds the component type to the exclude constraint (equivalent to `Exclude<T>()`);
|
||||||
|
* `[Opt]` - only caches the pool (equivalent to `Optional<T>`);
|
||||||
|
*
|
||||||
|
Attribute for combining aspects:
|
||||||
|
* `[Combine(order)]` - caches the aspect and merges constraints from aspects (equivalent to `Combine<TOtherAspect>(int)`); order sets combine order (default 0);
|
||||||
|
|
||||||
|
Additional attributes for specifying aspect constraints. They can be applied to the aspect itself or any field inside:
|
||||||
|
* `[IncImplicit(type)]` - adds Type from the constructor to the include constraint (equivalent to `Include<T>()`);
|
||||||
|
* `[ExcImplicit(type)]` - adds Type from the constructor to the exclude constraint (equivalent to `Exclude<T>()`);
|
||||||
|
|
||||||
|
</br>
|
||||||
|
|
||||||
|
# Auto Runners
|
||||||
|
|
||||||
|
To obtain runners without adding them manually, use `[BindWithRunner(type)]` and `GetRunnerAuto<T>()`.
|
||||||
|
|
||||||
|
```c#
|
||||||
|
[BindWithRunner(typeof(DoSomethingProcessRunner))]
|
||||||
|
interface IDoSomethingProcess : IEcsProcess
|
||||||
|
{
|
||||||
|
void Do();
|
||||||
|
}
|
||||||
|
//Реализация раннера. Пример реализации можно так же посмотреть в встроенных процессах
|
||||||
|
sealed class DoSomethingProcessRunner : EcsRunner<IDoSomethingProcess>, IDoSomethingProcess
|
||||||
|
{
|
||||||
|
public void Do()
|
||||||
|
{
|
||||||
|
foreach (var item in Process) item.Do();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
//...
|
||||||
|
// Если в пайплайн не был добавлен раннер, то GetRunnerAuto автоматически добавит экземпляр DoSomethingProcessRunner.
|
||||||
|
_pipeline.GetRunnerAuto<IDoSomethingProcess>().Do();
|
||||||
|
```
|
||||||
|
|
||||||
|
</br>
|
||||||
|
|
||||||
# Code Example
|
# Code Example
|
||||||
|
|
||||||
```c#
|
```c#
|
||||||
class VelocitySystemDI : IEcsRun
|
class VelocitySystemDI : IEcsRun
|
||||||
{
|
{
|
||||||
@ -131,8 +185,11 @@ class VelocitySystemDI : IEcsRun
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
<summary>Same code but without AutoInjections</summary>
|
<summary>Same code but without AutoInjections</summary>
|
||||||
|
|
||||||
|
|
||||||
```c#
|
```c#
|
||||||
class VelocitySystem : IEcsRun, IEcsInject<EcsDefaultWorld>, IEcsInject<TimeService>
|
class VelocitySystem : IEcsRun, IEcsInject<EcsDefaultWorld>, IEcsInject<TimeService>
|
||||||
@ -165,4 +222,13 @@ class VelocitySystem : IEcsRun, IEcsInject<EcsDefaultWorld>, IEcsInject<TimeServ
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
|
|
||||||
|
# Non-null injections
|
||||||
|
To ensure a field marked with `[DI]` is initialized even if injection does not occur, pass a fallback type to the attribute constructor. In the example below the field `Foo` will receive the injected `Foo` instance or an instance of `FooDummy : Foo` if injection was not performed.
|
||||||
|
|
||||||
|
> The provided type must have a parameterless constructor and be either the same type as the field or derived from it.
|
||||||
|
|
||||||
|
The extension will also report if any `[DI]`-marked fields remain uninitialized after the pre-injection phase.
|
||||||
Loading…
Reference in New Issue
Block a user