pkg/serialization updates

pkg/serialization/lib/serialization.dart

 // Copyright (c) 2012, 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.
 
 /**
  * This provides a general-purpose serialization facility for Dart objects. A
  * [Serialization] is defined in terms of [SerializationRule]s and supports
  * reading and writing to different formats.
  *
  * ## Installing ##
@@ skipping 202 matching lines @@
 part 'src/serialization_rule.dart';
 part 'src/basic_rule.dart';
 part 'src/format.dart';
 
 /**
  * This class defines a particular serialization scheme, in terms of
  * [SerializationRule] instances, and supports reading and writing them.
  * See library comment for examples of usage.
  */
 class Serialization {
+  final List<SerializationRule> _rules;
 
   /**
    * The serialization is controlled by the list of Serialization rules. These
    * are most commonly added via [addRuleFor].
    */
-  final List<SerializationRule> rules = new List<SerializationRule>();
+  final UnmodifiableListView<SerializationRule> rules;
 
   /**
    * When reading, we may need to resolve references to existing objects in
    * the system. The right action may not be to create a new instance of
    * something, but rather to find an existing instance and connect to it.
    * For example, if we have are serializing an Email message and it has a
    * link to the owning account, it may not be appropriate to try and serialize
    * the account. Instead we should just connect the de-serialized message
    * object to the account object that already exists there.
    */
@@ skipping 33 matching lines @@
    * is off by default.
    */
   void set selfDescribing(bool value) {
     _selfDescribing = value;
   }
 
   /**
    * Creates a new serialization with a default set of rules for primitives
    * and lists.
    */
-  Serialization() {
-    addDefaultRules();
-  }
+  factory Serialization() =>
+    new Serialization.blank()
+      ..addDefaultRules();
 
   /**
    * Creates a new serialization with no default rules at all. The most common
    * use for this is if we are reading self-describing serialized data and
    * will populate the rules from that data.
    */
-  Serialization.blank() { }
+  factory Serialization.blank()
+    => new Serialization._(new List<SerializationRule>());
+
+  Serialization._(List<SerializationRule> rules) :
+    this._rules = rules,
+    this.rules = new UnmodifiableListView(rules);
 
   /**
    * Create a [BasicRule] rule for the type of
    * [instanceOfType]. Optionally
    * allows specifying a [constructor] name, the list of [constructorFields],
    * and the list of [fields] not used in the constructor. Returns the new
    * rule. Note that [BasicRule] uses reflection, and so will not work with the
    * current state of dartj2s. If you need to run there, consider using
    * [CustomRule] instead.
    *
@@ skipping 41 matching lines @@
     addRule(new DateTimeRule());
   }
 
   /**
    * Add a new SerializationRule [rule]. The addRuleFor method will probably
    * handle most simple cases, but for adding an arbitrary rule, including
    * a SerializationRule subclass which you have created, you can use this
    * method.
    */
   void addRule(SerializationRule rule) {
-    rule.number = rules.length;
-    rules.add(rule);
+    rule.number = _rules.length;
+    _rules.add(rule);
   }
 
   /**
    * This writes out an object graph rooted at [object] and returns the result.
    * The [format] parameter determines the form of the result. The default
    * format returns a String in [json] format.
    */
   write(Object object, {Format format}) {
     return newWriter(format).write(object);
   }
@@ skipping 130 matching lines @@
 }
 
 /**
  * An exception class for errors during serialization.
  */
 class SerializationException implements Exception {
   final String message;
   const SerializationException(this.message);
   String toString() => "SerializationException($message)";
 }