Merge pull request #56 from WebApiContrib/dev

Dev

Author: glennblock

readme.md

@@ -56,16 +56,26 @@ data.Add(new Data { Name = "avatar", Prompt = "Avatar" });
 ```
 
 ## Using extensions
-The `Collection`, `Data`, `Item`, `Link` and `Query` classes are all extensible to allow for using CollectionJson extensions. There are two different methods for working with extensions. 
+The `Collection`, `Data`, `Item`, `Link` and `Query` classes are all extensible to allow for using CollectionJson extensions. There are three different methods for working with extensions. 
 
-### Using dynamic
-Extensions can be set by casting to dynamic and setting arbitrary extension properties. Below is an example setting the Model extension.
+### Using `Extensions`
+Extensions can be set by using the `Extensions` method which returns a dynamic object. Below is an example setting the Model extension*.
+```csharp
+var item = new Item { Href = new Uri(_requestUri, "/friends/" + friend.Id) };
+item.Extensions().Model = "friend";
+```
+
+*Note: `Extensions` is a method rather than a property to avoid from being serialized, and to make it compatible with multiple serializers.
+
+### Casting to Dynamic
+Each of the aforementioned classes can be cast directly to `dynamic`.
 ```csharp
 var item = new Item { Href = new Uri(_requestUri, "/friends/" + friend.Id) };
 dynamic dItem = item;
-item.Model = "friend";
+dItem.Model="friend";
 ```
 
+
 ### Using SetValue
 Extensions can be set by calling the SetValue method.
 ```csharp

samples/friendapi/Infrastructure/FriendDocumentWriter.cs

@@ -26,10 +26,7 @@ public IReadDocument Write(IEnumerable<Friend> friends)
             foreach (var friend in friends)
             {
                 var item = new Item { Href = new Uri(_requestUri, "/friends/" + friend.Id) };
-                dynamic dItem = item;
-
-                //use the model extension
-                dItem.Model = "friend";
+                item.Extensions().Model = "friend";
 
                 item.Data.Add(new Data { Name = "full-name", Value = friend.FullName, Prompt = "Full Name" });
                 item.Data.Add(new Data { Name = "email", Value = friend.Email, Prompt = "Email" });

src/WebApiContrib.CollectionJson/ExtensibleObject.cs

@@ -56,5 +56,10 @@ public void SetValue(string key, object value)
         {
             Members[key] = value;
         }
+
+        public dynamic Extensions()
+        {
+            return this;
+        }
     }
 }