OLD | NEW |
1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | 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 | 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. | 3 // BSD-style license that can be found in the LICENSE file. |
4 | 4 |
5 part of dart.convert; | 5 part of dart.convert; |
6 | 6 |
7 /** | 7 /** |
8 * The [ByteConversionSink] provides an interface for converters to | 8 * The [ByteConversionSink] provides an interface for converters to |
9 * efficiently transmit byte data. | 9 * efficiently transmit byte data. |
10 * | 10 * |
11 * Instead of limiting the interface to one non-chunked list of bytes it | 11 * Instead of limiting the interface to one non-chunked list of bytes it |
12 * accepts its input in chunks (themselves being lists of bytes). | 12 * accepts its input in chunks (themselves being lists of bytes). |
13 * | 13 * |
14 * This abstract class will likely get more methods over time. Implementers are | 14 * This abstract class will likely get more methods over time. Implementers are |
15 * urged to extend or mix in [ByteConversionSinkBase] to ensure that their | 15 * urged to extend or mix in [ByteConversionSinkBase] to ensure that their |
16 * class covers the newly added methods. | 16 * class covers the newly added methods. |
17 */ | 17 */ |
18 abstract class ByteConversionSink extends ChunkedConversionSink<List<int>> { | 18 abstract class ByteConversionSink extends ChunkedConversionSink<List<int>> { |
19 ByteConversionSink(); | 19 ByteConversionSink(); |
20 factory ByteConversionSink.withCallback(void callback(List<int> accumulated)) | 20 factory ByteConversionSink.withCallback(void callback(List<int> accumulated)) |
21 = _ByteCallbackSink; | 21 = _ByteCallbackSink; |
22 factory ByteConversionSink.from(ChunkedConversionSink<List<int>> sink) | 22 factory ByteConversionSink.from(Sink<List<int>> sink) |
23 = _ByteAdapterSink; | 23 = _ByteAdapterSink; |
24 | 24 |
25 /** | 25 /** |
26 * Adds the next [chunk] to `this`. | 26 * Adds the next [chunk] to `this`. |
27 * | 27 * |
28 * Adds the bytes defined by [start] and [end]-exclusive to `this`. | 28 * Adds the bytes defined by [start] and [end]-exclusive to `this`. |
29 * | 29 * |
30 * If [isLast] is `true` closes `this`. | 30 * If [isLast] is `true` closes `this`. |
31 * | 31 * |
32 * Contrary to `add` the given [chunk] must not be held onto. Once the method | 32 * Contrary to `add` the given [chunk] must not be held onto. Once the method |
(...skipping 14 matching lines...) Expand all Loading... |
47 void add(List<int> chunk); | 47 void add(List<int> chunk); |
48 void close(); | 48 void close(); |
49 | 49 |
50 void addSlice(List<int> chunk, int start, int end, bool isLast) { | 50 void addSlice(List<int> chunk, int start, int end, bool isLast) { |
51 add(chunk.sublist(start, end)); | 51 add(chunk.sublist(start, end)); |
52 if (isLast) close(); | 52 if (isLast) close(); |
53 } | 53 } |
54 } | 54 } |
55 | 55 |
56 /** | 56 /** |
57 * This class adapts a simple [ChunkedConversionSink] to a [ByteConversionSink]. | 57 * This class adapts a simple [Sink] to a [ByteConversionSink]. |
58 * | 58 * |
59 * All additional methods of the [ByteConversionSink] (compared to the | 59 * All additional methods of the [ByteConversionSink] (compared to the |
60 * ChunkedConversionSink) are redirected to the `add` method. | 60 * ChunkedConversionSink) are redirected to the `add` method. |
61 */ | 61 */ |
62 class _ByteAdapterSink extends ByteConversionSinkBase { | 62 class _ByteAdapterSink extends ByteConversionSinkBase { |
63 final ChunkedConversionSink<List<int>> _sink; | 63 final Sink<List<int>> _sink; |
64 | 64 |
65 _ByteAdapterSink(this._sink); | 65 _ByteAdapterSink(this._sink); |
66 | 66 |
67 void add(List<int> chunk) => _sink.add(chunk); | 67 void add(List<int> chunk) => _sink.add(chunk); |
68 void close() => _sink.close(); | 68 void close() => _sink.close(); |
69 } | 69 } |
70 | 70 |
71 /** | 71 /** |
72 * This class accumulates all chunks into one list of bytes | 72 * This class accumulates all chunks into one list of bytes |
73 * and invokes a callback when the sink is closed. | 73 * and invokes a callback when the sink is closed. |
(...skipping 35 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
109 v |= v >> 8; | 109 v |= v >> 8; |
110 v |= v >> 16; | 110 v |= v >> 16; |
111 v++; | 111 v++; |
112 return v; | 112 return v; |
113 } | 113 } |
114 | 114 |
115 void close() { | 115 void close() { |
116 _callback(_buffer.sublist(0, _bufferIndex)); | 116 _callback(_buffer.sublist(0, _bufferIndex)); |
117 } | 117 } |
118 } | 118 } |
OLD | NEW |