lib/src/http_unmodifiable_map.dart

// Copyright (c) 2017, 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.

import 'dart:collection';

import 'package:collection/collection.dart';
import 'package:http_parser/http_parser.dart';

/// A simple wrapper over [UnmodifiableMapView] which avoids re-wrapping itself.
class HttpUnmodifiableMap<V> extends UnmodifiableMapView<String, V> {
  /// `true` if the key values are already lowercase.
  final bool _ignoreKeyCase;

  /// If [source] is a [HttpUnmodifiableMap] with matching [ignoreKeyCase],
  /// then [source] is returned.
  ///
  /// If [source] is `null` it is treated like an empty map.
  ///
  /// If [ignoreKeyCase] is `true`, the keys will have case-insensitive access.
  ///
  /// [source] is copied to a new [Map] to ensure changes to the parameter value
  /// after constructions are not reflected.
  factory HttpUnmodifiableMap(Map<String, V> source,
      {bool ignoreKeyCase: false}) {
    if (source is HttpUnmodifiableMap<V> &&
        //        !ignoreKeyCase: no transformation of the input is required
        // source._ignoreKeyCase: the input cannot be transformed any more
        (!ignoreKeyCase || source._ignoreKeyCase)) {
      return source;
    }

    if (source == null || source.isEmpty) {
      return const _EmptyHttpUnmodifiableMap();
    }

    if (ignoreKeyCase) {
      source = new CaseInsensitiveMap<V>.from(source);
    } else {
      source = new Map<String, V>.from(source);
    }

    return new HttpUnmodifiableMap<V>._(source, ignoreKeyCase);
  }

  /// Returns an empty [HttpUnmodifiableMap].
  const factory HttpUnmodifiableMap.empty() = _EmptyHttpUnmodifiableMap<V>;

  HttpUnmodifiableMap._(Map<String, V> source, this._ignoreKeyCase)
      : super(source);
}

/// A const implementation of an empty [HttpUnmodifiableMap].
class _EmptyHttpUnmodifiableMap<V> extends MapView<String, V>
    implements HttpUnmodifiableMap<V> {
  bool get _ignoreKeyCase => true;
  const _EmptyHttpUnmodifiableMap() : super(const {});
}