Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(1121)

Side by Side Diff: sdk/lib/convert/converter.dart

Issue 19883003: Add chunked conversion to converters. (Closed) Base URL: https://dart.googlecode.com/svn/branches/bleeding_edge/dart
Patch Set: Improve some typse. Created 7 years, 5 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
OLDNEW
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 * A [Converter] converts data from one representation into another. 8 * A [Converter] converts data from one representation into another.
9 * 9 *
10 * *Converters are still experimental and are subject to change without notice.* 10 * *Converters are still experimental and are subject to change without notice.*
11 * 11 *
12 */ 12 */
13 abstract class Converter<S, T> { 13 abstract class Converter<S, T> {
14 /** 14 /**
15 * Converts [input] and returns the result of the conversion. 15 * Converts [input] and returns the result of the conversion.
16 */ 16 */
17 T convert(S input); 17 T convert(S input);
18 18
19 /** 19 /**
20 * Fuses `this` with [other]. 20 * Fuses `this` with [other].
21 * 21 *
22 * Encoding with the resulting converter is equivalent to converting with 22 * Encoding with the resulting converter is equivalent to converting with
23 * `this` before converting with `other`. 23 * `this` before converting with `other`.
24 */ 24 */
25 Converter<S, dynamic> fuse(Converter<T, dynamic> other) { 25 Converter<S, dynamic> fuse(Converter<T, dynamic> other) {
26 return new _FusedConverter<S, T, dynamic>(this, other); 26 return new _FusedConverter<S, T, dynamic>(this, other);
27 } 27 }
28
29 /**
30 * Starts a chunked conversion.
31 *
32 * The returned [ChunkedConversionSink] supports the interface described by
33 * [inputInterface].
34 *
35 * If the given [sink] supports the methods described by
36 * [outputInterface] then the chunked conversion can take advantage of
37 * the additional methods and provide a more efficient conversion.
38 *
39 * If [sink] does not support the [outputInterface] it is adapted. If
40 * necessary, the adapter buffers all chunks and invokes
41 * `addNonChunked` on [sink].
42 */
43 ChunkedConversionSink<S, dynamic> startChunkedConversion(
Søren Gjesse 2013/07/24 09:26:41 How about just calling this something shorter? May
floitsch 2013/07/24 18:31:15 I'm torn... Will discuss with others to get a feel
44 ChunkedConversionSink sink) {
45 return new _NonChunkedSink<S, T>(this, sink.adaptTo(outputInterface));
46 }
47
48 /** Defines the accepted input interface for chunked conversions. */
49 ChunkedConversionInterface get inputInterface =>
50 ChunkedConversionSink.INTERFACE;
51 /** Defines the accepted output interface for chunked conversions. */
52 ChunkedConversionInterface get outputInterface =>
53 ChunkedConversionSink.INTERFACE;
28 } 54 }
29 55
30 /** 56 /**
31 * Fuses two converters. 57 * Fuses two converters.
32 * 58 *
33 * For a non-chunked conversion converts the input in sequence. 59 * For a non-chunked conversion converts the input in sequence.
34 */ 60 */
35 class _FusedConverter<S, M, T> extends Converter<S, T> { 61 class _FusedConverter<S, M, T> extends Converter<S, T> {
36 final Converter _first; 62 final Converter _first;
37 final Converter _second; 63 final Converter _second;
38 64
39 _FusedConverter(this._first, this._second); 65 _FusedConverter(this._first, this._second);
40 66
41 T convert(S input) => _second.convert(_first.convert(input)); 67 T convert(S input) => _second.convert(_first.convert(input));
68
69 ChunkedConversionSink<S, dynamic> startChunkedConversion(
70 ChunkedConversionSink sink) {
71 return _first.startChunkedConversion(_second.startChunkedConversion(sink));
72 }
73
74 ChunkedConversionInterface get inputInterface => _first.inputInterface;
75 ChunkedConversionInterface get outputInterface => _second.outputInterface;
42 } 76 }
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698