DefaultAssetPathResource class final

Default implementation of AssetPathResource that resolves assets from the runtime environment using a path or filename.

This class attempts to locate an asset in multiple ways:

1. Exact path match – Compares against each asset’s full path.
2. Filename match – Matches only the filename if the full path fails.
3. Normalized path match – Handles platform-specific differences like file:// prefixes and \ vs /.
4. Suffix match – Matches by the tail end of the path if needed.
5. Single filename candidate – If exactly one candidate matches the filename.

Once resolved, the asset is cached internally for efficient access.

Example

final resource = DefaultAssetPathResource("assets/config/settings.yaml");

if (resource.exists()) {
  print("Found: ${resource.getFileName()}");
  final bytes = resource.getContentBytes();
  print("Content length: ${bytes.length}");
} else {
  print("Asset not found");
}