OLD | NEW |
1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2012, 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 /** | |
6 * Encapsulates the field [TreeElementMixin._element]. | |
7 * | |
8 * This library is an implementation detail of dart2js, and should not | |
9 * be imported except by resolution and tree node libraries, or for | |
10 * testing. | |
11 * | |
12 * We have taken great care to ensure AST nodes can be cached between | |
13 * compiler instances. Part of this requires that we always access | |
14 * resolution results through TreeElements. | |
15 * | |
16 * So please, do not add additional elements to this library, and do | |
17 * not import it. | |
18 */ | |
19 library dart2js.resolution.secret_tree_element; | 5 library dart2js.resolution.secret_tree_element; |
20 | 6 |
21 import '../common.dart'; | 7 // The code in this library was moved to ../tree/nodes.dart to satisfy extra |
| 8 // restrictions on overriding private members. |
| 9 // |
| 10 // [See issue for more details](https://github.com/dart-lang/sdk/issues/28809). |
22 | 11 |
23 /// Interface for associating | 12 export '../tree/nodes.dart' show getTreeElement, setTreeElement; |
24 abstract class TreeElementMixin { | |
25 Object get _element; | |
26 void set _element(Object value); | |
27 } | |
28 | |
29 /// Null implementation of [TreeElementMixin] which does not allow association | |
30 /// of elements. | |
31 /// | |
32 /// This class is the superclass of all AST nodes. | |
33 abstract class NullTreeElementMixin implements TreeElementMixin, Spannable { | |
34 // Deliberately using [Object] here to thwart code completion. | |
35 // You're not really supposed to access this field anyways. | |
36 Object get _element => null; | |
37 set _element(_) { | |
38 assert(invariant(this, false, | |
39 message: "Elements cannot be associated with ${runtimeType}.")); | |
40 } | |
41 } | |
42 | |
43 /// Actual implementation of [TreeElementMixin] which stores the associated | |
44 /// element in the private field [_element]. | |
45 /// | |
46 /// This class is mixed into the node classes that are actually associated with | |
47 /// elements. | |
48 abstract class StoredTreeElementMixin implements TreeElementMixin { | |
49 Object _element; | |
50 } | |
51 | |
52 /** | |
53 * Do not call this method directly. Instead, use an instance of | |
54 * TreeElements. | |
55 * | |
56 * Using [Object] as return type to thwart code completion. | |
57 */ | |
58 Object getTreeElement(TreeElementMixin node) => node._element; | |
59 | |
60 /** | |
61 * Do not call this method directly. Instead, use an instance of | |
62 * TreeElements. | |
63 */ | |
64 void setTreeElement(TreeElementMixin node, Object value) { | |
65 node._element = value; | |
66 } | |
OLD | NEW |