Prototype sketching JSON Merge Patch convenience APIs

sdk/core/Azure.Core/Azure.Core.sln

@@ -45,6 +45,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Samples", "Samples", "{13A0
 		samples\README.md = samples\README.md
 		samples\RequestContext.md = samples\RequestContext.md
 		samples\Response.md = samples\Response.md
+		samples\Serialization.md = samples\Serialization.md
 	EndProjectSection
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Azure.Core.Expressions.DataFactory", "..\Azure.Core.Expressions.DataFactory\src\Azure.Core.Expressions.DataFactory.csproj", "{7723BA5F-0017-45B4-B584-7D11AA069735}"

sdk/core/Azure.Core/api/Azure.Core.net461.cs

@@ -538,6 +538,7 @@ protected internal virtual void SetHeader(string name, string value) { }
     public abstract partial class RequestContent : System.IDisposable
     {
         protected RequestContent() { }
+        public static Azure.Core.RequestContent Create(Azure.Core.SequenceWriter writer) { throw null; }
         public static Azure.Core.RequestContent Create(Azure.Core.Serialization.DynamicData content) { throw null; }
         public static Azure.Core.RequestContent Create(System.BinaryData content) { throw null; }
         public static Azure.Core.RequestContent Create(System.Buffers.ReadOnlySequence<byte> bytes) { throw null; }
@@ -549,6 +550,7 @@ protected RequestContent() { }
         public static Azure.Core.RequestContent Create(object serializable, Azure.Core.Serialization.ObjectSerializer? serializer) { throw null; }
         public static Azure.Core.RequestContent Create(System.ReadOnlyMemory<byte> bytes) { throw null; }
         public static Azure.Core.RequestContent Create(string content) { throw null; }
+        public static Azure.Core.RequestContent CreatePatch(Azure.Core.Serialization.DynamicData content) { throw null; }
         public abstract void Dispose();
         public static implicit operator Azure.Core.RequestContent (Azure.Core.Serialization.DynamicData content) { throw null; }
         public static implicit operator Azure.Core.RequestContent (System.BinaryData content) { throw null; }
@@ -718,6 +720,18 @@ internal RetryOptions() { }
         public Azure.Core.RetryMode Mode { get { throw null; } set { } }
         public System.TimeSpan NetworkTimeout { get { throw null; } set { } }
     }
+    public sealed partial class SequenceWriter : System.Buffers.IBufferWriter<byte>, System.IDisposable
+    {
+        public SequenceWriter(int bufferSize = 4096) { }
+        public void Advance(int bytesWritten) { }
+        public void Dispose() { }
+        public System.Memory<byte> GetMemory(int sizeHint = 0) { throw null; }
+        public System.Buffers.ReadOnlySequence<byte> GetReadOnlySequence() { throw null; }
+        public System.Span<byte> GetSpan(int sizeHint = 0) { throw null; }
+        public bool TryComputeLength(out long length) { throw null; }
+        public void WriteTo(System.IO.Stream stream, System.Threading.CancellationToken cancellation) { }
+        public System.Threading.Tasks.Task WriteToAsync(System.IO.Stream stream, System.Threading.CancellationToken cancellation) { throw null; }
+    }
     public partial class StatusCodeClassifier : Azure.Core.ResponseClassifier
     {
         public StatusCodeClassifier(System.ReadOnlySpan<ushort> successStatusCodes) { }
@@ -1105,10 +1119,24 @@ public void Dispose() { }
         System.Dynamic.DynamicMetaObject System.Dynamic.IDynamicMetaObjectProvider.GetMetaObject(System.Linq.Expressions.Expression parameter) { throw null; }
         public override string ToString() { throw null; }
     }
+    public partial interface IJsonModelSerializable : Azure.Core.Serialization.IModelSerializable
+    {
+        object Deserialize(ref System.Text.Json.Utf8JsonReader reader, Azure.Core.Serialization.ModelSerializerOptions options);
+        void Serialize(System.Text.Json.Utf8JsonWriter writer, Azure.Core.Serialization.ModelSerializerOptions options);
+    }
     public partial interface IMemberNameConverter
     {
         string? ConvertMemberName(System.Reflection.MemberInfo member);
     }
+    public partial interface IModelSerializable
+    {
+        object Deserialize(System.BinaryData data, Azure.Core.Serialization.ModelSerializerOptions options);
+        System.BinaryData Serialize(Azure.Core.Serialization.ModelSerializerOptions options);
+    }
+    public partial interface IXmlModelSerializable : Azure.Core.Serialization.IModelSerializable
+    {
+        void Serialize(System.Xml.XmlWriter writer, Azure.Core.Serialization.ModelSerializerOptions options);
+    }
     public partial class JsonObjectSerializer : Azure.Core.Serialization.ObjectSerializer, Azure.Core.Serialization.IMemberNameConverter
     {
         public JsonObjectSerializer() { }
@@ -1127,6 +1155,52 @@ public enum JsonPropertyNames
         UseExact = 0,
         CamelCase = 1,
     }
+    public partial class ModelJsonConverter : System.Text.Json.Serialization.JsonConverter<Azure.Core.Serialization.IJsonModelSerializable>
+    {
+        public ModelJsonConverter() { }
+        public ModelJsonConverter(Azure.Core.Serialization.ModelSerializerFormat format) { }
+        public Azure.Core.Serialization.ModelSerializerOptions Options { get { throw null; } }
+        public override bool CanConvert(System.Type typeToConvert) { throw null; }
+        public override Azure.Core.Serialization.IJsonModelSerializable Read(ref System.Text.Json.Utf8JsonReader reader, System.Type typeToConvert, System.Text.Json.JsonSerializerOptions options) { throw null; }
+        public override void Write(System.Text.Json.Utf8JsonWriter writer, Azure.Core.Serialization.IJsonModelSerializable value, System.Text.Json.JsonSerializerOptions options) { }
+    }
+    public static partial class ModelSerializer
+    {
+        public static object Deserialize(System.BinaryData data, System.Type typeToConvert, Azure.Core.Serialization.ModelSerializerOptions options = default(Azure.Core.Serialization.ModelSerializerOptions)) { throw null; }
+        public static T Deserialize<T>(System.BinaryData data, Azure.Core.Serialization.ModelSerializerOptions options = default(Azure.Core.Serialization.ModelSerializerOptions)) where T : class, Azure.Core.Serialization.IModelSerializable { throw null; }
+        public static System.BinaryData Serialize(object model, Azure.Core.Serialization.ModelSerializerOptions options = default(Azure.Core.Serialization.ModelSerializerOptions)) { throw null; }
+        public static System.BinaryData Serialize<T>(T model, Azure.Core.Serialization.ModelSerializerOptions options = default(Azure.Core.Serialization.ModelSerializerOptions)) where T : Azure.Core.Serialization.IModelSerializable { throw null; }
+    }
+    [System.Runtime.InteropServices.StructLayoutAttribute(System.Runtime.InteropServices.LayoutKind.Sequential)]
+    public readonly partial struct ModelSerializerFormat : System.IEquatable<Azure.Core.Serialization.ModelSerializerFormat>
+    {
+        private readonly object _dummy;
+        private readonly int _dummyPrimitive;
+        public static readonly Azure.Core.Serialization.ModelSerializerFormat Json;
+        public static readonly Azure.Core.Serialization.ModelSerializerFormat Wire;
+        public ModelSerializerFormat(string value) { throw null; }
+        public bool Equals(Azure.Core.Serialization.ModelSerializerFormat other) { throw null; }
+        [System.ComponentModel.EditorBrowsableAttribute(System.ComponentModel.EditorBrowsableState.Never)]
+        public override bool Equals(object obj) { throw null; }
+        [System.ComponentModel.EditorBrowsableAttribute(System.ComponentModel.EditorBrowsableState.Never)]
+        public override int GetHashCode() { throw null; }
+        public static bool operator ==(Azure.Core.Serialization.ModelSerializerFormat left, Azure.Core.Serialization.ModelSerializerFormat right) { throw null; }
+        public static implicit operator string (Azure.Core.Serialization.ModelSerializerFormat value) { throw null; }
+        public static implicit operator Azure.Core.Serialization.ModelSerializerFormat (string value) { throw null; }
+        public static bool operator !=(Azure.Core.Serialization.ModelSerializerFormat left, Azure.Core.Serialization.ModelSerializerFormat right) { throw null; }
+        public override string ToString() { throw null; }
+    }
+    [System.Runtime.InteropServices.StructLayoutAttribute(System.Runtime.InteropServices.LayoutKind.Sequential)]
+    public partial struct ModelSerializerOptions
+    {
+        private object _dummy;
+        private int _dummyPrimitive;
+        public static readonly Azure.Core.Serialization.ModelSerializerOptions AzureServiceDefault;
+        public ModelSerializerOptions() { throw null; }
+        public ModelSerializerOptions(Azure.Core.Serialization.ModelSerializerFormat format) { throw null; }
+        public Azure.Core.Serialization.ModelSerializerFormat Format { get { throw null; } }
+        public System.Collections.Generic.Dictionary<System.Type, Azure.Core.Serialization.ObjectSerializer> Serializers { get { throw null; } }
+    }
     public abstract partial class ObjectSerializer
     {
         protected ObjectSerializer() { }

sdk/core/Azure.Core/api/Azure.Core.net5.0.cs

@@ -538,6 +538,7 @@ protected internal virtual void SetHeader(string name, string value) { }
     public abstract partial class RequestContent : System.IDisposable
     {
         protected RequestContent() { }
+        public static Azure.Core.RequestContent Create(Azure.Core.SequenceWriter writer) { throw null; }
         public static Azure.Core.RequestContent Create(Azure.Core.Serialization.DynamicData content) { throw null; }
         public static Azure.Core.RequestContent Create(System.BinaryData content) { throw null; }
         public static Azure.Core.RequestContent Create(System.Buffers.ReadOnlySequence<byte> bytes) { throw null; }
@@ -549,6 +550,7 @@ protected RequestContent() { }
         public static Azure.Core.RequestContent Create(object serializable, Azure.Core.Serialization.ObjectSerializer? serializer) { throw null; }
         public static Azure.Core.RequestContent Create(System.ReadOnlyMemory<byte> bytes) { throw null; }
         public static Azure.Core.RequestContent Create(string content) { throw null; }
+        public static Azure.Core.RequestContent CreatePatch(Azure.Core.Serialization.DynamicData content) { throw null; }
         public abstract void Dispose();
         public static implicit operator Azure.Core.RequestContent (Azure.Core.Serialization.DynamicData content) { throw null; }
         public static implicit operator Azure.Core.RequestContent (System.BinaryData content) { throw null; }
@@ -718,6 +720,18 @@ internal RetryOptions() { }
         public Azure.Core.RetryMode Mode { get { throw null; } set { } }
         public System.TimeSpan NetworkTimeout { get { throw null; } set { } }
     }
+    public sealed partial class SequenceWriter : System.Buffers.IBufferWriter<byte>, System.IDisposable
+    {
+        public SequenceWriter(int bufferSize = 4096) { }
+        public void Advance(int bytesWritten) { }
+        public void Dispose() { }
+        public System.Memory<byte> GetMemory(int sizeHint = 0) { throw null; }
+        public System.Buffers.ReadOnlySequence<byte> GetReadOnlySequence() { throw null; }
+        public System.Span<byte> GetSpan(int sizeHint = 0) { throw null; }
+        public bool TryComputeLength(out long length) { throw null; }
+        public void WriteTo(System.IO.Stream stream, System.Threading.CancellationToken cancellation) { }
+        public System.Threading.Tasks.Task WriteToAsync(System.IO.Stream stream, System.Threading.CancellationToken cancellation) { throw null; }
+    }
     public partial class StatusCodeClassifier : Azure.Core.ResponseClassifier
     {
         public StatusCodeClassifier(System.ReadOnlySpan<ushort> successStatusCodes) { }
@@ -1105,10 +1119,24 @@ public void Dispose() { }
         System.Dynamic.DynamicMetaObject System.Dynamic.IDynamicMetaObjectProvider.GetMetaObject(System.Linq.Expressions.Expression parameter) { throw null; }
         public override string ToString() { throw null; }
     }
+    public partial interface IJsonModelSerializable : Azure.Core.Serialization.IModelSerializable
+    {
+        object Deserialize(ref System.Text.Json.Utf8JsonReader reader, Azure.Core.Serialization.ModelSerializerOptions options);
+        void Serialize(System.Text.Json.Utf8JsonWriter writer, Azure.Core.Serialization.ModelSerializerOptions options);
+    }
     public partial interface IMemberNameConverter
     {
         string? ConvertMemberName(System.Reflection.MemberInfo member);
     }
+    public partial interface IModelSerializable
+    {
+        object Deserialize(System.BinaryData data, Azure.Core.Serialization.ModelSerializerOptions options);
+        System.BinaryData Serialize(Azure.Core.Serialization.ModelSerializerOptions options);
+    }
+    public partial interface IXmlModelSerializable : Azure.Core.Serialization.IModelSerializable
+    {
+        void Serialize(System.Xml.XmlWriter writer, Azure.Core.Serialization.ModelSerializerOptions options);
+    }
     public partial class JsonObjectSerializer : Azure.Core.Serialization.ObjectSerializer, Azure.Core.Serialization.IMemberNameConverter
     {
         public JsonObjectSerializer() { }
@@ -1127,6 +1155,52 @@ public enum JsonPropertyNames
         UseExact = 0,
         CamelCase = 1,
     }
+    public partial class ModelJsonConverter : System.Text.Json.Serialization.JsonConverter<Azure.Core.Serialization.IJsonModelSerializable>
+    {
+        public ModelJsonConverter() { }
+        public ModelJsonConverter(Azure.Core.Serialization.ModelSerializerFormat format) { }
+        public Azure.Core.Serialization.ModelSerializerOptions Options { get { throw null; } }
+        public override bool CanConvert(System.Type typeToConvert) { throw null; }
+        public override Azure.Core.Serialization.IJsonModelSerializable Read(ref System.Text.Json.Utf8JsonReader reader, System.Type typeToConvert, System.Text.Json.JsonSerializerOptions options) { throw null; }
+        public override void Write(System.Text.Json.Utf8JsonWriter writer, Azure.Core.Serialization.IJsonModelSerializable value, System.Text.Json.JsonSerializerOptions options) { }
+    }
+    public static partial class ModelSerializer
+    {
+        public static object Deserialize(System.BinaryData data, System.Type typeToConvert, Azure.Core.Serialization.ModelSerializerOptions options = default(Azure.Core.Serialization.ModelSerializerOptions)) { throw null; }
+        public static T Deserialize<T>(System.BinaryData data, Azure.Core.Serialization.ModelSerializerOptions options = default(Azure.Core.Serialization.ModelSerializerOptions)) where T : class, Azure.Core.Serialization.IModelSerializable { throw null; }
+        public static System.BinaryData Serialize(object model, Azure.Core.Serialization.ModelSerializerOptions options = default(Azure.Core.Serialization.ModelSerializerOptions)) { throw null; }
+        public static System.BinaryData Serialize<T>(T model, Azure.Core.Serialization.ModelSerializerOptions options = default(Azure.Core.Serialization.ModelSerializerOptions)) where T : Azure.Core.Serialization.IModelSerializable { throw null; }
+    }
+    [System.Runtime.InteropServices.StructLayoutAttribute(System.Runtime.InteropServices.LayoutKind.Sequential)]
+    public readonly partial struct ModelSerializerFormat : System.IEquatable<Azure.Core.Serialization.ModelSerializerFormat>
+    {
+        private readonly object _dummy;
+        private readonly int _dummyPrimitive;
+        public static readonly Azure.Core.Serialization.ModelSerializerFormat Json;
+        public static readonly Azure.Core.Serialization.ModelSerializerFormat Wire;
+        public ModelSerializerFormat(string value) { throw null; }
+        public bool Equals(Azure.Core.Serialization.ModelSerializerFormat other) { throw null; }
+        [System.ComponentModel.EditorBrowsableAttribute(System.ComponentModel.EditorBrowsableState.Never)]
+        public override bool Equals([System.Diagnostics.CodeAnalysis.AllowNullAttribute] object obj) { throw null; }
+        [System.ComponentModel.EditorBrowsableAttribute(System.ComponentModel.EditorBrowsableState.Never)]
+        public override int GetHashCode() { throw null; }
+        public static bool operator ==(Azure.Core.Serialization.ModelSerializerFormat left, Azure.Core.Serialization.ModelSerializerFormat right) { throw null; }
+        public static implicit operator string (Azure.Core.Serialization.ModelSerializerFormat value) { throw null; }
+        public static implicit operator Azure.Core.Serialization.ModelSerializerFormat (string value) { throw null; }
+        public static bool operator !=(Azure.Core.Serialization.ModelSerializerFormat left, Azure.Core.Serialization.ModelSerializerFormat right) { throw null; }
+        public override string ToString() { throw null; }
+    }
+    [System.Runtime.InteropServices.StructLayoutAttribute(System.Runtime.InteropServices.LayoutKind.Sequential)]
+    public partial struct ModelSerializerOptions
+    {
+        private object _dummy;
+        private int _dummyPrimitive;
+        public static readonly Azure.Core.Serialization.ModelSerializerOptions AzureServiceDefault;
+        public ModelSerializerOptions() { throw null; }
+        public ModelSerializerOptions(Azure.Core.Serialization.ModelSerializerFormat format) { throw null; }
+        public Azure.Core.Serialization.ModelSerializerFormat Format { get { throw null; } }
+        public System.Collections.Generic.Dictionary<System.Type, Azure.Core.Serialization.ObjectSerializer> Serializers { get { throw null; } }
+    }
     public abstract partial class ObjectSerializer
     {
         protected ObjectSerializer() { }