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 part of dart.convert; | |
6 | |
7 /** | |
8 * A [Converter] converts data from one representation into another. | |
9 * | |
10 * It is recommended that implementations of `Converter` extend this class, | |
11 * to inherit any further methods that may be added to the class. | |
12 */ | |
13 abstract class Converter<S, T> implements StreamTransformer/*<S, T>*/ { | |
14 const Converter(); | |
15 | |
16 /** | |
17 * Converts [input] and returns the result of the conversion. | |
18 */ | |
19 T convert(S input); | |
20 | |
21 /** | |
22 * Fuses `this` with [other]. | |
23 * | |
24 * Encoding with the resulting converter is equivalent to converting with | |
25 * `this` before converting with `other`. | |
26 */ | |
27 Converter<S, dynamic/*=TT*/> fuse/*<TT>*/( | |
28 Converter<T, dynamic/*=TT*/> other) { | |
29 return new _FusedConverter<S, T, dynamic/*=TT*/>(this, other); | |
30 } | |
31 | |
32 /** | |
33 * Starts a chunked conversion. | |
34 * | |
35 * The returned sink serves as input for the long-running conversion. The | |
36 * given [sink] serves as output. | |
37 */ | |
38 Sink/*<S>*/ startChunkedConversion(Sink/*<T>*/ sink) { | |
39 throw new UnsupportedError( | |
40 "This converter does not support chunked conversions: $this"); | |
41 } | |
42 | |
43 Stream/*<T>*/ bind(Stream/*<S>*/ stream) { | |
44 return new Stream/*<T>*/.eventTransformed( | |
45 stream, | |
46 (EventSink sink) => new _ConverterStreamEventSink(this, sink)); | |
47 } | |
48 } | |
49 | |
50 /** | |
51 * Fuses two converters. | |
52 * | |
53 * For a non-chunked conversion converts the input in sequence. | |
54 */ | |
55 class _FusedConverter<S, M, T> extends Converter<S, T> { | |
56 final Converter<S, M> _first; | |
57 final Converter<M, T> _second; | |
58 | |
59 _FusedConverter(this._first, this._second); | |
60 | |
61 T convert(S input) => _second.convert(_first.convert(input)); | |
62 | |
63 Sink/*<S>*/ startChunkedConversion(Sink/*<T>*/ sink) { | |
64 return _first.startChunkedConversion(_second.startChunkedConversion(sink)); | |
65 } | |
66 } | |
OLD | NEW |