Added shared folder endpoints. Code refactoring to improve json parsing performance

Author: qimingyuan

Dropbox.Api/ApiException.cs

@@ -15,13 +15,12 @@ namespace Dropbox.Api
     /// implementation if there is an error processing the request.
     /// </summary>
     /// <typeparam name="TError">The type of the error.</typeparam>
-    public sealed class ApiException<TError> : Exception, IEncodable<ApiException<TError>>
-        where TError : IEncodable<TError>, new()
+    public sealed class ApiException<TError> : Exception
     {
         /// <summary>
         /// Initializes a new instance of the <see cref="ApiException{TError}"/> class.
         /// </summary>
-        /// <remarks>This constructor is only used when deserializing from JSON.</remarks>
+        /// <remarks>This constructor is only used when decoded from JSON.</remarks>
         public ApiException()
             : this(default(TError))
         {
@@ -56,6 +55,7 @@ public ApiException(TError errorResponse, string message, Exception inner)
             : base(message, inner)
         {
             this.ErrorResponse = errorResponse;
+            this.ErrorMessage = message;
         }
 
         /// <summary>
@@ -67,31 +67,78 @@ public ApiException(TError errorResponse, string message, Exception inner)
         public TError ErrorResponse { get; private set; }
 
         /// <summary>
-        /// Encodes the object using the supplied encoder.
+        /// Gets the exception message.
         /// </summary>
-        /// <param name="encoder">The encoder being used to serialize the object.</param>
-        /// <exception cref="System.NotImplementedException"></exception>
-        void IEncodable<ApiException<TError>>.Encode(IEncoder encoder)
+        public override string Message
         {
-            throw new NotSupportedException("Exceptions cannot be encoded");
+            get { return this.ErrorMessage; }
         }
 
         /// <summary>
-        /// Decodes on object using the supplied decoder.
+        /// Gets or sets the error message.
         /// </summary>
-        /// <param name="decoder">The decoder used to deserialize the object.</param>
-        /// <returns>
-        /// The deserialized object. Note: this is not necessarily the current instance.
-        /// </returns>
-        /// <exception cref="System.NotImplementedException"></exception>
-        ApiException<TError> IEncodable<ApiException<TError>>.Decode(IDecoder decoder)
+        private string ErrorMessage { get; set; }
+
+        /// <summary>
+        /// Decode from given json using given decoder.
+        /// </summary>
+        /// <param name="json">The json.</param>
+        /// <param name="errorDecoder">The error json.</param>
+        /// <returns>The <see cref="ApiException{TError}"/></returns>
+        internal static ApiException<TError> Decode(string json, IDecoder<TError> errorDecoder)
+        {
+            return JsonReader.Read(json, new ApiExceptionDecoder(errorDecoder));
+        }
+
+        /// <summary>
+        /// The exception decoder.
+        /// </summary>
+        private class ApiExceptionDecoder : StructDecoder<ApiException<TError>>
         {
-            using (var obj = decoder.GetObject())
+            /// <summary>
+            /// The error decoder.
+            /// </summary>
+            private readonly IDecoder<TError> errorDecoder;
+
+            /// <summary>
+            /// Initializes a new instance of the <see cref="ApiExceptionDecoder"/> class.
+            /// </summary>
+            /// <param name="errorDecoder">The error decoder.</param>
+            public ApiExceptionDecoder(IDecoder<TError> errorDecoder)
             {
-                this.ErrorResponse = obj.GetFieldObject<TError>("error");
+                this.errorDecoder = errorDecoder;
             }
 
-            return this;
+            /// <summary>
+            /// Create a struct instance.
+            /// </summary>
+            /// <returns>The struct instance.</returns>
+            protected override ApiException<TError> Create()
+            {
+                return new ApiException<TError>();
+            }
+
+            /// <summary>
+            /// Set given field.
+            /// </summary>
+            /// <param name="value">The field value.</param>
+            /// <param name="fieldName">The field name.</param>
+            /// <param name="reader">The reader.</param>
+            protected override void SetField(ApiException<TError> value, string fieldName, IJsonReader reader)
+            {
+                switch (fieldName)
+                {
+                    case "error":
+                        value.ErrorResponse = this.errorDecoder.Decode(reader);
+                        break;
+                    case "error_summary":
+                        value.ErrorMessage = StringDecoder.Instance.Decode(reader);
+                        break;
+                    default:
+                        SkipProperty(reader);
+                        break;
+                }
+            }
         }
     }
 }

Dropbox.Api/Async/LaunchEmptyResult.cs

@@ -0,0 +1,202 @@
+// <auto-generated>
+// Auto-generated by BabelAPI, do not modify.
+// </auto-generated>
+
+namespace Dropbox.Api.Async
+{
+    using sys = System;
+    using col = System.Collections.Generic;
+    using re = System.Text.RegularExpressions;
+
+    using enc = Dropbox.Api.Babel;
+
+    /// <summary>
+    /// <para>Result returned by methods that may either launch an asynchronous job or complete
+    /// synchronously. Upon synchronous completion of the job, no additional information is
+    /// returned.</para>
+    /// </summary>
+    public class LaunchEmptyResult
+    {
+        #pragma warning disable 108
+
+        /// <summary>
+        /// <para>The encoder instance.</para>
+        /// </summary>
+        internal static enc.StructEncoder<LaunchEmptyResult> Encoder = new LaunchEmptyResultEncoder();
+
+        /// <summary>
+        /// <para>The decoder instance.</para>
+        /// </summary>
+        internal static enc.StructDecoder<LaunchEmptyResult> Decoder = new LaunchEmptyResultDecoder();
+
+        /// <summary>
+        /// <para>Initializes a new instance of the <see cref="LaunchEmptyResult" />
+        /// class.</para>
+        /// </summary>
+        public LaunchEmptyResult()
+        {
+        }
+
+        /// <summary>
+        /// <para>Gets a value indicating whether this instance is Complete</para>
+        /// </summary>
+        public bool IsComplete
+        {
+            get
+            {
+                return this is Complete;
+            }
+        }
+
+        /// <summary>
+        /// <para>Gets this instance as a Complete, or <c>null</c>.</para>
+        /// </summary>
+        public Complete AsComplete
+        {
+            get
+            {
+                return this as Complete;
+            }
+        }
+
+        #region Encoder class
+
+        /// <summary>
+        /// <para>Encoder for  <see cref="LaunchEmptyResult" />.</para>
+        /// </summary>
+        private class LaunchEmptyResultEncoder : enc.StructEncoder<LaunchEmptyResult>
+        {
+            /// <summary>
+            /// <para>Encode fields of given value.</para>
+            /// </summary>
+            /// <param name="value">The value.</param>
+            /// <param name="writer">The writer.</param>
+            public override void EncodeFields(LaunchEmptyResult value, enc.IJsonWriter writer)
+            {
+                if (value is Complete)
+                {
+                    WriteProperty(".tag", "complete", writer, enc.StringEncoder.Instance);
+                    Complete.Encoder.EncodeFields((Complete)value, writer);
+                    return;
+                }
+                throw new sys.InvalidOperationException();
+            }
+        }
+
+        #endregion
+
+        #region Decoder class
+
+        /// <summary>
+        /// <para>Decoder for  <see cref="LaunchEmptyResult" />.</para>
+        /// </summary>
+        private class LaunchEmptyResultDecoder : enc.UnionDecoder<LaunchEmptyResult>
+        {
+            /// <summary>
+            /// <para>Create a new instance of type <see cref="LaunchEmptyResult" />.</para>
+            /// </summary>
+            /// <returns>The struct instance.</returns>
+            protected override LaunchEmptyResult Create()
+            {
+                return new LaunchEmptyResult();
+            }
+
+            /// <summary>
+            /// <para>Decode based on given tag.</para>
+            /// </summary>
+            /// <param name="tag">The tag.</param>
+            /// <param name="reader">The json reader.</param>
+            /// <returns>The decoded object.</returns>
+            protected override LaunchEmptyResult Decode(string tag, enc.IJsonReader reader)
+            {
+                switch (tag)
+                {
+                    case "complete":
+                        return Complete.Decoder.DecodeFields(reader);
+                    default:
+                        throw new sys.InvalidOperationException();
+                }
+            }
+        }
+
+        #endregion
+
+        /// <summary>
+        /// <para>The job finished synchronously and successfully.</para>
+        /// </summary>
+        public sealed class Complete : LaunchEmptyResult
+        {
+            #pragma warning disable 108
+
+            /// <summary>
+            /// <para>The encoder instance.</para>
+            /// </summary>
+            internal static enc.StructEncoder<Complete> Encoder = new CompleteEncoder();
+
+            /// <summary>
+            /// <para>The decoder instance.</para>
+            /// </summary>
+            internal static enc.StructDecoder<Complete> Decoder = new CompleteDecoder();
+
+            /// <summary>
+            /// <para>Initializes a new instance of the <see cref="Complete" /> class.</para>
+            /// </summary>
+            private Complete()
+            {
+            }
+
+            /// <summary>
+            /// <para>A singleton instance of Complete</para>
+            /// </summary>
+            public static readonly Complete Instance = new Complete();
+
+            #region Encoder class
+
+            /// <summary>
+            /// <para>Encoder for  <see cref="Complete" />.</para>
+            /// </summary>
+            private class CompleteEncoder : enc.StructEncoder<Complete>
+            {
+                /// <summary>
+                /// <para>Encode fields of given value.</para>
+                /// </summary>
+                /// <param name="value">The value.</param>
+                /// <param name="writer">The writer.</param>
+                public override void EncodeFields(Complete value, enc.IJsonWriter writer)
+                {
+                }
+            }
+
+            #endregion
+
+            #region Decoder class
+
+            /// <summary>
+            /// <para>Decoder for  <see cref="Complete" />.</para>
+            /// </summary>
+            private class CompleteDecoder : enc.StructDecoder<Complete>
+            {
+                /// <summary>
+                /// <para>Create a new instance of type <see cref="Complete" />.</para>
+                /// </summary>
+                /// <returns>The struct instance.</returns>
+                protected override Complete Create()
+                {
+                    return new Complete();
+                }
+
+                /// <summary>
+                /// <para>Decode fields without ensuring start and end object.</para>
+                /// </summary>
+                /// <param name="reader">The json reader.</param>
+                /// <returns>The decoded object.</returns>
+                public override Complete DecodeFields(enc.IJsonReader reader)
+                {
+                    return Complete.Instance;
+                }
+            }
+
+            #endregion
+        }
+    }
+}