| OLD | NEW |
| 1 Serialization | |
| 2 ============= | |
| 3 | |
| 4 A general-purpose serialization facility for Dart Objects. | 1 A general-purpose serialization facility for Dart Objects. |
| 5 | 2 |
| 6 This provides the ability to save and restore objects to pluggable | 3 This provides the ability to save and restore objects to pluggable |
| 7 Formats using pluggable Rules. | 4 Formats using pluggable Rules. |
| 8 These rules can use mirrors or be hard-coded. The main principle | 5 These rules can use mirrors or be hard-coded. The main principle |
| 9 is using only public APIs on the serialized objects, so changes to the | 6 is using only public APIs on the serialized objects, so changes to the |
| 10 internal representation do not break previous serializations. It also handles | 7 internal representation do not break previous serializations. It also handles |
| 11 cycles, different representations, filling in known objects on the | 8 cycles, different representations, filling in known objects on the |
| 12 receiving side, and other issues. It is not as much intended for | 9 receiving side, and other issues. It is not as much intended for |
| 13 APIs using JSON to pass acyclic structures without class information, | 10 APIs using JSON to pass acyclic structures without class information, |
| 14 and is fairly heavweight and expensive for doing that compared to simpler | 11 and is fairly heavweight and expensive for doing that compared to simpler |
| 15 approaches. | 12 approaches. |
| 16 | |
| 17 For more detailed descriptions and examples of use, see the comment on | |
| 18 the [serialization][serialization] library. | |
| 19 | |
| 20 [serialization]: https://api.dartlang.org/docs/channels/stable/latest/serializat
ion.html | |
| OLD | NEW |