/// <summary>
/// Asynchronously writes the json value (primitive, IDictionary or IEnumerable) to the underlying json writer.
/// </summary>
/// <param name="jsonWriter">The <see cref="JsonWriter"/> to write to.</param>
/// <param name="propertyValue">value to write.</param>
/// <returns>A task that represents the asynchronous write operation.</returns>
private static async Task WriteJsonValueAsync(this IJsonWriterAsync jsonWriter, object propertyValue)
{
if (propertyValue == null)
{
await jsonWriter.WriteValueAsync((string)null).ConfigureAwait(false);
}
else if (EdmLibraryExtensions.IsPrimitiveType(propertyValue.GetType()))
{
await jsonWriter.WritePrimitiveValueAsync(propertyValue).ConfigureAwait(false);
}
else
{
IDictionary <string, object> objectValue = propertyValue as IDictionary <string, object>;
if (objectValue != null)
{
await jsonWriter.WriteJsonObjectValueAsync(objectValue, null /*typeName */).ConfigureAwait(false);
}
else
{
IEnumerable arrayValue = propertyValue as IEnumerable;
Debug.Assert(arrayValue != null, "arrayValue != null");
await jsonWriter.WriteJsonArrayValueAsync(arrayValue).ConfigureAwait(false);
}
}
}
/// <summary>
/// Asynchronously writes the odata.type instance annotation with the specified type name.
/// </summary>
/// <param name="typeName">The type name to write.</param>
/// <param name="writeRawValue">Whether to write the raw typeName without removing/adding prefix 'Edm.'/'#'.</param>
/// <returns>A task that represents the asynchronous write operation.</returns>
public async Task WriteODataTypeInstanceAnnotationAsync(string typeName, bool writeRawValue = false)
{
this.AssertAsynchronous();
Debug.Assert(typeName != null, "typeName != null");
// "@odata.type": "#typename"
await WriteInstanceAnnotationNameAsync(ODataAnnotationNames.ODataType)
.ConfigureAwait(false);
if (writeRawValue)
{
await asyncJsonWriter.WriteValueAsync(typeName).ConfigureAwait(false);
}
else
{
await asyncJsonWriter.WriteValueAsync(WriterUtils.PrefixTypeNameForWriting(typeName, odataVersion))
.ConfigureAwait(false);
}
}
/// <summary>
/// Asynchronously writes the error details.
/// </summary>
/// <param name="jsonWriter">JSON writer.</param>
/// <param name="details">The details of the error.</param>
/// <param name="odataErrorDetailsName">The property name for the error details property.</param>
/// <returns>A task that represents the asynchronous write operation.</returns>
private static async Task WriteErrorDetailsAsync(IJsonWriterAsync jsonWriter, IEnumerable <ODataErrorDetail> details,
string odataErrorDetailsName)
{
Debug.Assert(jsonWriter != null, "jsonWriter != null");
Debug.Assert(details != null, "details != null");
Debug.Assert(odataErrorDetailsName != null, "odataErrorDetailsName != null");
// "details": [
await jsonWriter.WriteNameAsync(odataErrorDetailsName).ConfigureAwait(false);
await jsonWriter.StartArrayScopeAsync().ConfigureAwait(false);
foreach (var detail in details.Where(d => d != null))
{
// {
await jsonWriter.StartObjectScopeAsync().ConfigureAwait(false);
// "code": "301",
await jsonWriter.WriteNameAsync(JsonConstants.ODataErrorCodeName).ConfigureAwait(false);
await jsonWriter.WriteValueAsync(detail.ErrorCode ?? string.Empty).ConfigureAwait(false);
if (detail.Target != null)
{
// "target": "$search"
await jsonWriter.WriteNameAsync(JsonConstants.ODataErrorTargetName).ConfigureAwait(false);
await jsonWriter.WriteValueAsync(detail.Target).ConfigureAwait(false);
}
// "message": "$search query option not supported",
await jsonWriter.WriteNameAsync(JsonConstants.ODataErrorMessageName).ConfigureAwait(false);
await jsonWriter.WriteValueAsync(detail.Message ?? string.Empty).ConfigureAwait(false);
// }
await jsonWriter.EndObjectScopeAsync().ConfigureAwait(false);
}
// ]
await jsonWriter.EndArrayScopeAsync().ConfigureAwait(false);
}
/// <summary>
/// Asynchronously writes an error message.
/// </summary>
/// <param name="jsonWriter">JSON writer.</param>
/// <param name="code">The code of the error.</param>
/// <param name="message">The message of the error.</param>
/// <param name="target">The target of the error.</param>
/// <param name="details">The details of the error.</param>
/// <param name="innerError">Inner error details that will be included in debug mode (if present).</param>
/// <param name="instanceAnnotations">Instance annotations for this error.</param>
/// <param name="writeInstanceAnnotationsDelegate">Delegate to write the instance annotations.</param>
/// <param name="maxInnerErrorDepth">The maximum number of nested inner errors to allow.</param>
/// <returns>A task that represents the asynchronous write operation.</returns>
private static async Task WriteErrorAsync(
IJsonWriterAsync jsonWriter,
string code,
string message,
string target,
IEnumerable <ODataErrorDetail> details,
ODataInnerError innerError,
ICollection <ODataInstanceAnnotation> instanceAnnotations,
Func <ICollection <ODataInstanceAnnotation>, Task> writeInstanceAnnotationsDelegate,
int maxInnerErrorDepth)
{
Debug.Assert(jsonWriter != null, "jsonWriter != null");
Debug.Assert(code != null, "code != null");
Debug.Assert(message != null, "message != null");
Debug.Assert(instanceAnnotations != null, "instanceAnnotations != null");
ExceptionUtils.CheckArgumentNotNull(writeInstanceAnnotationsDelegate, "writeInstanceAnnotationsDelegate");
// "error": {
await jsonWriter.StartObjectScopeAsync().ConfigureAwait(false);
await jsonWriter.WriteNameAsync(JsonLightConstants.ODataErrorPropertyName).ConfigureAwait(false);
await jsonWriter.StartObjectScopeAsync().ConfigureAwait(false);
// "code": "<code>"
await jsonWriter.WriteNameAsync(JsonConstants.ODataErrorCodeName).ConfigureAwait(false);
await jsonWriter.WriteValueAsync(code).ConfigureAwait(false);
// "message": "<message string>"
await jsonWriter.WriteNameAsync(JsonConstants.ODataErrorMessageName).ConfigureAwait(false);
await jsonWriter.WriteValueAsync(message).ConfigureAwait(false);
// For example, "target": "query",
if (target != null)
{
await jsonWriter.WriteNameAsync(JsonConstants.ODataErrorTargetName).ConfigureAwait(false);
await jsonWriter.WriteValueAsync(target).ConfigureAwait(false);
}
// Such as, "details": [
// {
// "code": "301",
// "target": "$search",
// "message": "$search query option not supported"
// }]
if (details != null)
{
await WriteErrorDetailsAsync(jsonWriter, details, JsonConstants.ODataErrorDetailsName).ConfigureAwait(false);
}
if (innerError != null)
{
await WriteInnerErrorAsync(jsonWriter, innerError, JsonConstants.ODataErrorInnerErrorName,
/* recursionDepth */ 0, maxInnerErrorDepth).ConfigureAwait(false);
}
await writeInstanceAnnotationsDelegate(instanceAnnotations).ConfigureAwait(false);
// } }
await jsonWriter.EndObjectScopeAsync().ConfigureAwait(false);
await jsonWriter.EndObjectScopeAsync().ConfigureAwait(false);
}
/// <summary>
/// Asynchronously writes the current Json object.
/// </summary>
/// <param name="reader">The Json reader providing the data.</param>
/// <param name="jsonWriter">The Json writer writes data into memory stream.</param>
/// <returns>A task that represents the asynchronous write operation.</returns>
private static async Task WriteCurrentJsonObjectAsync(IJsonReaderAsync reader, IJsonWriterAsync jsonWriter)
{
Stack <JsonNodeType> nodeTypes = new Stack <JsonNodeType>();
do
{
switch (reader.NodeType)
{
case JsonNodeType.PrimitiveValue:
object primitiveValue;
if ((primitiveValue = await reader.GetValueAsync().ConfigureAwait(false)) != null)
{
await jsonWriter.WritePrimitiveValueAsync(primitiveValue)
.ConfigureAwait(false);
}
else
{
await jsonWriter.WriteValueAsync((string)null)
.ConfigureAwait(false);
}
break;
case JsonNodeType.Property:
object propertyName = await reader.GetValueAsync()
.ConfigureAwait(false);
await jsonWriter.WriteNameAsync(propertyName.ToString())
.ConfigureAwait(false);
break;
case JsonNodeType.StartObject:
nodeTypes.Push(reader.NodeType);
await jsonWriter.StartObjectScopeAsync()
.ConfigureAwait(false);
break;
case JsonNodeType.StartArray:
nodeTypes.Push(reader.NodeType);
await jsonWriter.StartArrayScopeAsync()
.ConfigureAwait(false);
break;
case JsonNodeType.EndObject:
Debug.Assert(nodeTypes.Peek() == JsonNodeType.StartObject);
nodeTypes.Pop();
await jsonWriter.EndObjectScopeAsync()
.ConfigureAwait(false);
break;
case JsonNodeType.EndArray:
Debug.Assert(nodeTypes.Peek() == JsonNodeType.StartArray);
nodeTypes.Pop();
await jsonWriter.EndArrayScopeAsync()
.ConfigureAwait(false);
break;
default:
throw new ODataException(Strings.ODataJsonLightBatchBodyContentReaderStream_UnexpectedNodeType(reader.NodeType));
}
await reader.ReadNextAsync()
.ConfigureAwait(false); // This can be EndOfInput, where nodeTypes should be empty.
}while (nodeTypes.Count != 0);
await jsonWriter.FlushAsync()
.ConfigureAwait(false);
}
/// <summary>
/// Asynchronously writes a primitive value.
/// </summary>
/// <param name="jsonWriter">The <see cref="JsonWriter"/> to write to.</param>
/// <param name="value">The value to write.</param>
/// <returns>A task that represents the asynchronous write operation.</returns>
internal static async Task WritePrimitiveValueAsync(this IJsonWriterAsync jsonWriter, object value)
{
if (value is bool)
{
await jsonWriter.WriteValueAsync((bool)value).ConfigureAwait(false);
return;
}
if (value is byte)
{
await jsonWriter.WriteValueAsync((byte)value).ConfigureAwait(false);
return;
}
if (value is decimal)
{
await jsonWriter.WriteValueAsync((decimal)value).ConfigureAwait(false);
return;
}
if (value is double)
{
await jsonWriter.WriteValueAsync((double)value).ConfigureAwait(false);
return;
}
if (value is Int16)
{
await jsonWriter.WriteValueAsync((Int16)value).ConfigureAwait(false);
return;
}
if (value is Int32)
{
await jsonWriter.WriteValueAsync((Int32)value).ConfigureAwait(false);
return;
}
if (value is Int64)
{
await jsonWriter.WriteValueAsync((Int64)value).ConfigureAwait(false);
return;
}
if (value is sbyte)
{
await jsonWriter.WriteValueAsync((sbyte)value).ConfigureAwait(false);
return;
}
if (value is Single)
{
await jsonWriter.WriteValueAsync((Single)value).ConfigureAwait(false);
return;
}
var str = value as string;
if (str != null)
{
await jsonWriter.WriteValueAsync(str).ConfigureAwait(false);
return;
}
byte[] valueAsByteArray = value as byte[];
if (valueAsByteArray != null)
{
await jsonWriter.WriteValueAsync(valueAsByteArray).ConfigureAwait(false);
return;
}
if (value is DateTimeOffset)
{
await jsonWriter.WriteValueAsync((DateTimeOffset)value).ConfigureAwait(false);
return;
}
if (value is Guid)
{
await jsonWriter.WriteValueAsync((Guid)value).ConfigureAwait(false);
return;
}
if (value is TimeSpan)
{
await jsonWriter.WriteValueAsync((TimeSpan)value).ConfigureAwait(false);
return;
}
if (value is Date)
{
await jsonWriter.WriteValueAsync((Date)value).ConfigureAwait(false);
return;
}
if (value is TimeOfDay)
{
await jsonWriter.WriteValueAsync((TimeOfDay)value).ConfigureAwait(false);
return;
}
throw new ODataException(ODataErrorStrings.ODataJsonWriter_UnsupportedValueType(value.GetType().FullName));
}
/// <summary>
/// Asynchronously writes the ODataValue (primitive, collection or resource value) to the underlying json writer.
/// </summary>
/// <param name="jsonWriter">The <see cref="JsonWriter"/> to write to.</param>
/// <param name="odataValue">value to write.</param>
/// <returns>A task that represents the asynchronous write operation.</returns>
internal static async Task WriteODataValueAsync(this IJsonWriterAsync jsonWriter, ODataValue odataValue)
{
if (odataValue == null || odataValue is ODataNullValue)
{
await jsonWriter.WriteValueAsync((string)null).ConfigureAwait(false);
return;
}
object objectValue = odataValue.FromODataValue();
if (EdmLibraryExtensions.IsPrimitiveType(objectValue.GetType()))
{
await jsonWriter.WritePrimitiveValueAsync(objectValue).ConfigureAwait(false);
return;
}
ODataResourceValue resourceValue = odataValue as ODataResourceValue;
if (resourceValue != null)
{
await jsonWriter.StartObjectScopeAsync().ConfigureAwait(false);
foreach (ODataProperty property in resourceValue.Properties)
{
await jsonWriter.WriteNameAsync(property.Name).ConfigureAwait(false);
await jsonWriter.WriteODataValueAsync(property.ODataValue).ConfigureAwait(false);
}
await jsonWriter.EndObjectScopeAsync().ConfigureAwait(false);
return;
}
ODataCollectionValue collectionValue = odataValue as ODataCollectionValue;
if (collectionValue != null)
{
await jsonWriter.StartArrayScopeAsync().ConfigureAwait(false);
foreach (object item in collectionValue.Items)
{
// Will not be able to accurately serialize complex objects unless they are ODataValues.
ODataValue collectionItem = item as ODataValue;
if (item != null)
{
await jsonWriter.WriteODataValueAsync(collectionItem).ConfigureAwait(false);
}
else
{
throw new ODataException(ODataErrorStrings.ODataJsonWriter_UnsupportedValueInCollection);
}
}
await jsonWriter.EndArrayScopeAsync().ConfigureAwait(false);
return;
}
throw new ODataException(
ODataErrorStrings.ODataJsonWriter_UnsupportedValueType(odataValue.GetType().FullName));
}