OLD | NEW |
---|---|
(Empty) | |
1 // Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file | |
2 // for details. All rights reserved. Use of this source code is governed by a | |
3 // BSD-style license that can be found in the LICENSE file. | |
4 | |
5 library resource.loader; | |
6 | |
7 import "dart:async" show Future, Stream; | |
8 import "dart:convert" show Encoding; | |
9 import "io.dart" as io; // TODO: make this import configuration dependent. | |
10 | |
11 /// Resource loading strategy. | |
12 /// | |
13 /// An abstraction of the functionality needed to load resources. | |
14 /// | |
15 /// An implementation decides which URI schemes it supports. | |
16 abstract class ResourceLoader { | |
17 /// Reads the file located by [uri] as a stream of bytes. | |
floitsch
2015/10/13 12:47:50
I wouldn't use the term "file".
| |
18 Stream<List<int>> openRead(Uri uri); | |
19 | |
20 /// Reads the file located by [uri] as a list of bytes. | |
21 Future<List<int>> readAsBytes(Uri uri); | |
22 | |
23 /// Reads the file located by [uri] as a [String]. | |
24 /// | |
25 /// The file bytes are decoded using [encoding]. | |
26 /// If [encoding] is omittted, it defaults to UTF-8. | |
floitsch
2015/10/13 12:47:50
omitted
| |
27 Future<String> readAsString(Uri uri, { Encoding encoding }); | |
28 } | |
29 | |
30 /// Default implementation of [ResourceLoader]. | |
31 /// | |
32 /// Uses the system's available loading functionality to implement the | |
33 /// loading functions. | |
34 class DefaultLoader implements ResourceLoader { | |
35 const DefaultLoader(); | |
36 | |
37 Stream<List<int>> openRead(Uri uri) => io.readAsStream(uri); | |
38 | |
39 Future<List<int>> readAsBytes(Uri uri) => io.readAsBytes(uri); | |
40 | |
41 Future<String> readAsString(Uri uri, { Encoding encoding }) => | |
42 io.readAsString(uri, encoding); | |
43 } | |
OLD | NEW |