Marcin Wojas
20a45e06cd
SKILL.md odchudzony z 493 do 333 linii: sekcje Serwisy, Tłumaczenia i Log wyciągnięte do nowych referencji, sekcja Session skrócona do fundamentów (szczegóły w session-login.md), dodana Mapa skilla. W examples.md usunięte duplikaty z context.md i datapack-guidedrow.md, dodane spisy treści do dużych referencji. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1.9 KiB
1.9 KiB
Serwisy biznesowe
Serwisy pozwalają tworzyć obiekty (komponenty), których czas życia zależy od scope:
- App (BusApplication.Instance) - cały okres działania aplikacji
- Database - per baza danych
- Login - per zalogowany użytkownik
- Session (default - nie trzeba określać w deklaracji)
Umieszczając deklarację interfejsu serwisu w assembly wspólnym, można udostępniać serwisy między modułami, nawet gdy nie ma między nimi referencji.
Zasady
- Tylko serwisy scope Session są single-threaded, pozostałe są multi-threaded.
- Serwis może być
IDisposable. - Dla serwisów App, Database, Login nie przechowuj obiektów sesyjnych (Session, Row, Module, Table, Context).
[RequireOwnService]tylko dla serwisów, które nie mogą być nadpisywane.
Deklaracja
[assembly: Service<MyNamespace.IRegistry, MyNamespace.Registry>(ServiceScope.Login)]
namespace MyNamespace;
[RequireServiceScope(ServiceScope.Login)]
public interface IRegistry
{
void Method();
}
internal sealed class Registry : IRegistry
{
public void Method() { }
}
Odczyt serwisu
IRegistry registerRequired = login.GetRequiredService<IRegistry>();
IRegistry? registerOptional = login.GetService<IRegistry>();
foreach (IRegistry registers in login.GetServices<IRegistry>())
{
// wiele implementacji
}
Scope odpowiada obiektowi, z którego pobieramy serwis: BusApplication.Instance.GetRequiredService<T>(), database.GetRequiredService<T>(), login.GetRequiredService<T>(), session.GetRequiredService<T>().
Użycie w worker / extender
Obiekt jest tworzony przez Context.CreateObject(), więc zależności są wstrzykiwane automatycznie.
// Rozwiązanie lepsze - constructor injection
class MyWorker1(IRegistry registry)
{
// używaj registry
}
// Alternatywa - atrybut [Context] na property
class MyWorker2
{
[Context]
private IRegistry Registry { get; set; }
}