OLD | NEW |
(Empty) | |
| 1 // Copyright (c) 2013, 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 barback.asset.asset; |
| 6 |
| 7 import 'dart:async'; |
| 8 import 'dart:io'; |
| 9 import 'dart:convert'; |
| 10 |
| 11 import 'asset_id.dart'; |
| 12 import 'internal_asset.dart'; |
| 13 |
| 14 /// A blob of content. |
| 15 /// |
| 16 /// Assets may come from the file system, or as the output of a [Transformer]. |
| 17 /// They are identified by [AssetId]. |
| 18 /// |
| 19 /// Custom implementations of [Asset] are not currently supported. |
| 20 abstract class Asset { |
| 21 /// The ID for this asset. |
| 22 final AssetId id; |
| 23 |
| 24 factory Asset.fromBytes(AssetId id, List<int> bytes) => |
| 25 new BinaryAsset(id, bytes); |
| 26 |
| 27 factory Asset.fromFile(AssetId id, File file) => |
| 28 new FileAsset(id, file.path); |
| 29 |
| 30 factory Asset.fromString(AssetId id, String content) => |
| 31 new StringAsset(id, content); |
| 32 |
| 33 factory Asset.fromPath(AssetId id, String path) => |
| 34 new FileAsset(id, path); |
| 35 |
| 36 factory Asset.fromStream(AssetId id, Stream<List<int>> stream) => |
| 37 new StreamAsset(id, stream); |
| 38 |
| 39 /// Returns the contents of the asset as a string. |
| 40 /// |
| 41 /// If the asset was created from a [String] the original string is always |
| 42 /// returned and [encoding] is ignored. Otherwise, the binary data of the |
| 43 /// asset is decoded using [encoding], which defaults to [UTF8]. |
| 44 Future<String> readAsString({Encoding encoding}); |
| 45 |
| 46 /// Streams the binary contents of the asset. |
| 47 /// |
| 48 /// If the asset was created from a [String], this returns its UTF-8 encoding. |
| 49 Stream<List<int>> read(); |
| 50 } |
OLD | NEW |