arcane/arcane_framework
1
0
Fork 0
mirror of https://github.com/hanskokx/arcane_framework.git synced 2026-08-12 06:10:55 +02:00
Code Issues Packages Projects Releases Wiki Activity

v2.0.5: Add typed service lookup entrypoint and tests for Arcane.service

Browse Source 
Signed-off-by: Hans Kokx <hans.d.kokx@gmail.com>
This commit is contained in:
Hans Kokx
2026-06-03 19:37:14 +02:00
parent fe42eac0dc
commit cbb1a78473
7 changed files with 83 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+4
View File
@@ -169,6 +169,8 @@ services:
`ArcaneService` instances. **Note**: This widget is already part of the
_`ArcaneApp`_ widget, however if you are not using the `ArcaneApp` widget you
can instead use this widget directly.
- `Arcane.service`: Typed service lookup entrypoint with
`ofType<T>(context)` and `requiredOfType<T>(context)`.
- The `service<T>` and `requiredService<T>` extensions on `BuildContext`:
nullable and non-nullable getters used to locate a given `ArcaneService` via
`BuildContext`. **Note**: For app-defined services, these lookups require an
@@ -255,11 +257,13 @@ whatever method you prefer:
```dart
// If a service of the given type is not registered, `null` is returned.
final FavoriteColorService? nullableService = ArcaneService.ofType<FavoriteColorService>(context);
final FavoriteColorService? nullableViaArcane = Arcane.service.ofType<FavoriteColorService>(context);
final FavoriteColorService? nullableViaContext = context.service<FavoriteColorService>();
final FavoriteColorService? nullableViaProvider = ArcaneServiceProvider.serviceOfType<FavoriteColorService>(context);
// If a service of the given type is not registered, an exception is thrown.
final FavoriteColorService nonNullableService = ArcaneService.requiredOfType<FavoriteColorService>(context);
final FavoriteColorService nonNullableViaArcane = Arcane.service.requiredOfType<FavoriteColorService>(context);
final FavoriteColorService nonNullableViaContext = context.requiredService<FavoriteColorService>();
final FavoriteColorService nonNullableViaProvider = ArcaneServiceProvider.requiredServiceOfType<FavoriteColorService>(context);
```