Update API and serializer updates

Microsoft.Azure.Cosmos/src/Serializer/CosmosQuerySerializer.cs

@@ -3,28 +3,25 @@
 //------------------------------------------------------------
 namespace Microsoft.Azure.Cosmos.Serializer
 {
-    using System;
     using System.Reflection;
 
     /// <summary>
-    /// This is an interface to allow a custom serializer to be used by the CosmosClient for both CRUD operations and LINQ queries.
+    /// This abstract class can be implemented to allow a custom serializer to be used by the CosmosClient
+    /// for both CRUD operations and LINQ queries.
     /// </summary>
-    #if PREVIEW
+#if PREVIEW
     public
-    #else
+#else
     internal
-    #endif
+#endif
     abstract class CosmosQuerySerializer : CosmosSerializer
     {
         /// <summary>
         /// Convert a MemberInfo to a string for use in LINQ query translation.
         /// This must be implemented when using a custom serializer for LINQ queries.
         /// </summary>
         /// <param name="memberInfo">Any MemberInfo used in the query.</param>
-        /// <returns>A serialized representation of the member</returns>
-        public virtual string SerializeLinqMemberName(MemberInfo memberInfo)
-        {
-            throw new NotImplementedException($"{nameof(CosmosSerializer)}.{nameof(SerializeLinqMemberName)})");
-        }
+        /// <returns>A serialized representation of the member.</returns>
+        public abstract string SerializeLinqMemberName(MemberInfo memberInfo);
     }
 }

Microsoft.Azure.Cosmos/src/Serializer/CosmosSerializer.cs

@@ -7,7 +7,7 @@ namespace Microsoft.Azure.Cosmos
     using System.IO;
 
     /// <summary>
-    /// This is an interface to allow a custom serializer to be used by the CosmosClient for CRUD operations.
+    /// This abstract class can be implemented to allow a custom serializer to be used by the CosmosClient for CRUD operations.
     /// </summary>
     public abstract class CosmosSerializer
     {

Microsoft.Azure.Cosmos/tests/Microsoft.Azure.Cosmos.Tests/Contracts/DotNetPreviewSDKAPI.json

@@ -378,14 +378,20 @@
       "NestedTypes": {}
     },
     "Microsoft.Azure.Cosmos.CosmosSerializer;System.Object;IsAbstract:True;IsSealed:False;IsInterface:False;IsEnum:False;IsClass:True;IsValueType:False;IsNested:False;IsGenericType:False;IsSerializable:False": {
-      "Subclasses": {},
-      "Members": {
-        "System.String SerializeLinqMemberName(System.Reflection.MemberInfo)": {
-          "Type": "Method",
-          "Attributes": [],
-          "MethodInfo": "System.String SerializeLinqMemberName(System.Reflection.MemberInfo);IsAbstract:False;IsStatic:False;IsVirtual:True;IsGenericMethod:False;IsConstructor:False;IsFinal:False;"
+      "Subclasses": {
+        "Microsoft.Azure.Cosmos.Serializer.CosmosQuerySerializer;Microsoft.Azure.Cosmos.CosmosSerializer;IsAbstract:True;IsSealed:False;IsInterface:False;IsEnum:False;IsClass:True;IsValueType:False;IsNested:False;IsGenericType:False;IsSerializable:False": {
+          "Subclasses": {},
+          "Members": {
+            "System.String SerializeLinqMemberName(System.Reflection.MemberInfo)": {
+              "Type": "Method",
+              "Attributes": [],
+              "MethodInfo": "System.String SerializeLinqMemberName(System.Reflection.MemberInfo);IsAbstract:True;IsStatic:False;IsVirtual:True;IsGenericMethod:False;IsConstructor:False;IsFinal:False;"
+            }
+          },
+          "NestedTypes": {}
         }
       },
+      "Members": {},
       "NestedTypes": {}
     },
     "Microsoft.Azure.Cosmos.DedicatedGatewayRequestOptions;System.Object;IsAbstract:False;IsSealed:False;IsInterface:False;IsEnum:False;IsClass:True;IsValueType:False;IsNested:False;IsGenericType:False;IsSerializable:False": {
@@ -592,6 +598,17 @@
         }
       },
       "NestedTypes": {}
+    },
+    "Microsoft.Azure.Cosmos.Serializer.CosmosQuerySerializer;Microsoft.Azure.Cosmos.CosmosSerializer;IsAbstract:True;IsSealed:False;IsInterface:False;IsEnum:False;IsClass:True;IsValueType:False;IsNested:False;IsGenericType:False;IsSerializable:False": {
+      "Subclasses": {},
+      "Members": {
+        "System.String SerializeLinqMemberName(System.Reflection.MemberInfo)": {
+          "Type": "Method",
+          "Attributes": [],
+          "MethodInfo": "System.String SerializeLinqMemberName(System.Reflection.MemberInfo);IsAbstract:True;IsStatic:False;IsVirtual:True;IsGenericMethod:False;IsConstructor:False;IsFinal:False;"
+        }
+      },
+      "NestedTypes": {}
     }
   },
   "Members": {},