Add chunked conversion to converters.

sdk/lib/convert/converter.dart

 // Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 part of dart.convert;
 
 /**
  * A [Converter] converts data from one representation into another.
  *
  * *Converters are still experimental and are subject to change without notice.*
  *
  */
 abstract class Converter<S, T> {
   /**
    * Converts [input] and returns the result of the conversion.
    */
   T convert(S input);
 
   /**
    * Fuses `this` with [other].
    *
    * Encoding with the resulting converter is equivalent to converting with
    * `this` before converting with `other`.
    */
   Converter<S, dynamic> fuse(Converter<T, dynamic> other) {
     return new _FusedConverter<S, T, dynamic>(this, other);
   }
+
+  /**
+   * Starts a chunked conversion.
+   *
+   * The returned [ChunkedConversionSink] supports the interface described by
+   * [inputInterface].
+   *
+   * If the given [sink] supports the methods described by
+   * [outputInterface] then the chunked conversion can take advantage of
+   * the additional methods and provide a more efficient conversion.
+   *
+   * If [sink] does not support the [outputInterface] it is adapted. If
+   * necessary, the adapter buffers all chunks and invokes
+   * `addNonChunked` on [sink].
+   */
+  ChunkedConversionSink<S, dynamic> startChunkedConversion(

[Søren Gjesse, 2013/07/24 09:26:41]

How about just calling this something shorter? Maybe just start.

[floitsch, 2013/07/24 18:31:15]

I'm torn...
Will discuss with others to get a feeling.

+      ChunkedConversionSink sink) {
+    return new _NonChunkedSink<S, T>(this, sink.adaptTo(outputInterface));
+  }
+
+  /** Defines the accepted input interface for chunked conversions. */
+  ChunkedConversionInterface get inputInterface =>
+      ChunkedConversionSink.INTERFACE;
+  /** Defines the accepted output interface for chunked conversions. */
+  ChunkedConversionInterface get outputInterface =>
+      ChunkedConversionSink.INTERFACE;
 }
 
 /**
  * Fuses two converters.
  *
  * For a non-chunked conversion converts the input in sequence.
  */
 class _FusedConverter<S, M, T> extends Converter<S, T> {
   final Converter _first;
   final Converter _second;
 
   _FusedConverter(this._first, this._second);
 
   T convert(S input) => _second.convert(_first.convert(input));
+
+  ChunkedConversionSink<S, dynamic> startChunkedConversion(
+      ChunkedConversionSink sink) {
+    return _first.startChunkedConversion(_second.startChunkedConversion(sink));
+  }
+
+  ChunkedConversionInterface get inputInterface => _first.inputInterface;
+  ChunkedConversionInterface get outputInterface => _second.outputInterface;
 }