OLD | NEW |
1 // Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2014, 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 library shelf.shelf_unmodifiable_map; | 5 library shelf.shelf_unmodifiable_map; |
6 | 6 |
7 import 'dart:collection'; | 7 import 'dart:collection'; |
8 | 8 |
9 import 'package:collection/wrappers.dart' as pc; | 9 import 'package:collection/wrappers.dart' as pc; |
10 | 10 |
11 /// A simple wrapper over [pc.UnmodifiableMapView] which avoids re-wrapping | 11 /// A simple wrapper over [pc.UnmodifiableMapView] which avoids re-wrapping |
12 /// itself. | 12 /// itself. |
13 class ShelfUnmodifiableMap<V> extends UnmodifiableMapView<String, V> { | 13 class ShelfUnmodifiableMap<V> extends UnmodifiableMapView<String, V> { |
14 /// If [source] is a [ShelfUnmodifiableMap] with matching [ignoreKeyCase], | 14 /// If [source] is a [ShelfUnmodifiableMap] with matching [ignoreKeyCase], |
15 /// then [source] is returned. | 15 /// then [source] is returned. |
16 /// | 16 /// |
17 /// If [source] is `null` it is treated like an empty map. | 17 /// If [source] is `null` it is treated like an empty map. |
18 /// | 18 /// |
19 /// If [ignoreKeyCase] is `true`, the keys will have case-insensitive access. | 19 /// If [ignoreKeyCase] is `true`, the keys will have case-insensitive access. |
20 /// | 20 /// |
21 /// [source] is copied to a new [Map] to ensure changes to the paramater value | 21 /// [source] is copied to a new [Map] to ensure changes to the parameter value |
22 /// after constructions are not reflected. | 22 /// after constructions are not reflected. |
23 factory ShelfUnmodifiableMap(Map<String, V> source, | 23 factory ShelfUnmodifiableMap(Map<String, V> source, |
24 {bool ignoreKeyCase: false}) { | 24 {bool ignoreKeyCase: false}) { |
25 if (source is ShelfUnmodifiableMap<V>) { | 25 if (source is ShelfUnmodifiableMap<V>) { |
26 return source; | 26 return source; |
27 } | 27 } |
28 | 28 |
29 if (source == null || source.isEmpty) { | 29 if (source == null || source.isEmpty) { |
30 return const _EmptyShelfUnmodifiableMap(); | 30 return const _EmptyShelfUnmodifiableMap(); |
31 } | 31 } |
(...skipping 11 matching lines...) Expand all Loading... |
43 ShelfUnmodifiableMap._(Map<String, V> source) : super(source); | 43 ShelfUnmodifiableMap._(Map<String, V> source) : super(source); |
44 } | 44 } |
45 | 45 |
46 /// An const empty implementation of [ShelfUnmodifiableMap]. | 46 /// An const empty implementation of [ShelfUnmodifiableMap]. |
47 // TODO(kevmoo): Consider using MapView from dart:collection which has a const | 47 // TODO(kevmoo): Consider using MapView from dart:collection which has a const |
48 // ctor. Would require updating min SDK to 1.5. | 48 // ctor. Would require updating min SDK to 1.5. |
49 class _EmptyShelfUnmodifiableMap<V> extends pc.DelegatingMap<String, V> | 49 class _EmptyShelfUnmodifiableMap<V> extends pc.DelegatingMap<String, V> |
50 implements ShelfUnmodifiableMap<V> { | 50 implements ShelfUnmodifiableMap<V> { |
51 const _EmptyShelfUnmodifiableMap() : super(const {}); | 51 const _EmptyShelfUnmodifiableMap() : super(const {}); |
52 } | 52 } |
OLD | NEW |