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 startChunkedConversion(ChunkedConversionSink sink) {
+    throw new UnsupportedError(
+        "This converter does not support chunked conversions: $this");
+  }
+
+  /**
+   * Defines the accepted input interface for chunked conversions.
+   *
+   * Is `null` if `this` does not support chunked conversions.
+   */
+  ChunkedConversionInterface get inputInterface => null;
+
+  /**
+   * Defines the accepted output interface for chunked conversions.
+   *
+   * Is `null` if `this` does not support chunked conversions.
+   */
+  ChunkedConversionInterface get outputInterface => null;
 }
 
 /**
  * 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 startChunkedConversion(ChunkedConversionSink sink) {
+    return _first.startChunkedConversion(_second.startChunkedConversion(sink));
+  }
+
+  ChunkedConversionInterface get inputInterface {
+    // Don't advertise a chunked conversion if the _second converter doesn't
+    // support it.
+    if (_second.inputInterface != null) return _first.inputInterface;
+  }
+  ChunkedConversionInterface get outputInterface {
+    // Don't advertise a chunked conversion if the _first converter doesn't
+    // support it.
+    if (_first.outputInterface != null) return _second.outputInterface;
+  }
 }