Don't explicitly check for Failed or Cancelled Statuses (#1179)

Between discussion at #1137 and a few rounds of revision at #1159 we
arrived at an optimisation where tasks that are both heavily hit and
very likely to return in a completed state are checked for a status of
either RanToCompletion, Canceled or Faulted and a path is taken where
no await is needed for any of those.

The Canceled and Faulted tasks are returned immediately, allowing that
state to be passed to the caller.

However, these are exceptional cases, and if we just continued the
subsequent await would raise the appropriate exception. Checking for
all three cases instead of just RanToCompletion is optimising for those
execptional conditions at cost (in the form of a larger comparison
segment of code) to the more common cases of the task either being
completed or still running.

Simplify this back to a check just for RanToCompletion.
This commit is contained in:
Jon Hanna
2017-01-15 14:34:37 +13:00
committed by James Newton-King
parent 3b583b886f
commit 0ef9ec292b
4 changed files with 29 additions and 93 deletions
+1 -5
View File
@@ -495,14 +495,10 @@ namespace Newtonsoft.Json
_charPos++; _charPos++;
Task<bool> task = EnsureCharsAsync(1, append, cancellationToken); Task<bool> task = EnsureCharsAsync(1, append, cancellationToken);
switch (task.Status) if (task.Status == TaskStatus.RanToCompletion)
{ {
case TaskStatus.RanToCompletion:
SetNewLine(task.Result); SetNewLine(task.Result);
return AsyncUtils.CompletedTask; return AsyncUtils.CompletedTask;
case TaskStatus.Canceled:
case TaskStatus.Faulted:
return task;
} }
return ProcessCarriageReturnAsync(task); return ProcessCarriageReturnAsync(task);
+10 -54
View File
@@ -186,12 +186,8 @@ namespace Newtonsoft.Json
private Task WriteValueInternalAsync(JsonToken token, string value, CancellationToken cancellationToken) private Task WriteValueInternalAsync(JsonToken token, string value, CancellationToken cancellationToken)
{ {
Task task = InternalWriteValueAsync(token, cancellationToken); Task task = InternalWriteValueAsync(token, cancellationToken);
switch (task.Status) if (task.Status == TaskStatus.RanToCompletion)
{ {
case TaskStatus.Canceled:
case TaskStatus.Faulted:
return task;
case TaskStatus.RanToCompletion:
return _writer.WriteAsync(value, cancellationToken); return _writer.WriteAsync(value, cancellationToken);
} }
@@ -270,12 +266,8 @@ namespace Newtonsoft.Json
private Task WriteIntegerValueAsync(ulong uvalue, bool negative, CancellationToken cancellationToken) private Task WriteIntegerValueAsync(ulong uvalue, bool negative, CancellationToken cancellationToken)
{ {
Task task = InternalWriteValueAsync(JsonToken.Integer, cancellationToken); Task task = InternalWriteValueAsync(JsonToken.Integer, cancellationToken);
switch (task.Status) if (task.Status == TaskStatus.RanToCompletion)
{ {
case TaskStatus.Canceled:
case TaskStatus.Faulted:
return task;
case TaskStatus.RanToCompletion:
return WriteDigitsAsync(uvalue, negative, cancellationToken); return WriteDigitsAsync(uvalue, negative, cancellationToken);
} }
@@ -325,26 +317,14 @@ namespace Newtonsoft.Json
internal Task DoWritePropertyNameAsync(string name, CancellationToken cancellationToken) internal Task DoWritePropertyNameAsync(string name, CancellationToken cancellationToken)
{ {
Task task = InternalWritePropertyNameAsync(name, cancellationToken); Task task = InternalWritePropertyNameAsync(name, cancellationToken);
switch (task.Status) if (task.Status != TaskStatus.RanToCompletion)
{ {
case TaskStatus.Canceled:
case TaskStatus.Faulted:
return task;
case TaskStatus.RanToCompletion:
// Completed synchronously (or very fast!), continue within this rather
// that the default branch which uses async
break;
default:
return DoWritePropertyNameAsync(task, name, cancellationToken); return DoWritePropertyNameAsync(task, name, cancellationToken);
} }
task = WriteEscapedStringAsync(name, _quoteName, cancellationToken); task = WriteEscapedStringAsync(name, _quoteName, cancellationToken);
switch (task.Status) if (task.Status == TaskStatus.RanToCompletion)
{ {
case TaskStatus.Canceled:
case TaskStatus.Faulted:
return task;
case TaskStatus.RanToCompletion:
return _writer.WriteAsync(':', cancellationToken); return _writer.WriteAsync(':', cancellationToken);
} }
@@ -415,12 +395,8 @@ namespace Newtonsoft.Json
internal Task DoWriteStartArrayAsync(CancellationToken cancellationToken) internal Task DoWriteStartArrayAsync(CancellationToken cancellationToken)
{ {
Task task = InternalWriteStartAsync(JsonToken.StartArray, JsonContainerType.Array, cancellationToken); Task task = InternalWriteStartAsync(JsonToken.StartArray, JsonContainerType.Array, cancellationToken);
switch (task.Status) if (task.Status == TaskStatus.RanToCompletion)
{ {
case TaskStatus.Canceled:
case TaskStatus.Faulted:
return task;
case TaskStatus.RanToCompletion:
return _writer.WriteAsync('[', cancellationToken); return _writer.WriteAsync('[', cancellationToken);
} }
@@ -449,12 +425,8 @@ namespace Newtonsoft.Json
internal Task DoWriteStartObjectAsync(CancellationToken cancellationToken) internal Task DoWriteStartObjectAsync(CancellationToken cancellationToken)
{ {
Task task = InternalWriteStartAsync(JsonToken.StartObject, JsonContainerType.Object, cancellationToken); Task task = InternalWriteStartAsync(JsonToken.StartObject, JsonContainerType.Object, cancellationToken);
switch (task.Status) if (task.Status == TaskStatus.RanToCompletion)
{ {
case TaskStatus.Canceled:
case TaskStatus.Faulted:
return task;
case TaskStatus.RanToCompletion:
return _writer.WriteAsync('{', cancellationToken); return _writer.WriteAsync('{', cancellationToken);
} }
@@ -505,12 +477,8 @@ namespace Newtonsoft.Json
internal Task DoWriteUndefinedAsync(CancellationToken cancellationToken) internal Task DoWriteUndefinedAsync(CancellationToken cancellationToken)
{ {
Task task = InternalWriteValueAsync(JsonToken.Undefined, cancellationToken); Task task = InternalWriteValueAsync(JsonToken.Undefined, cancellationToken);
switch (task.Status) if (task.Status == TaskStatus.RanToCompletion)
{ {
case TaskStatus.Canceled:
case TaskStatus.Faulted:
return task;
case TaskStatus.RanToCompletion:
return _writer.WriteAsync(JsonConvert.Undefined, cancellationToken); return _writer.WriteAsync(JsonConvert.Undefined, cancellationToken);
} }
@@ -1086,12 +1054,8 @@ namespace Newtonsoft.Json
internal Task DoWriteValueAsync(string value, CancellationToken cancellationToken) internal Task DoWriteValueAsync(string value, CancellationToken cancellationToken)
{ {
Task task = InternalWriteValueAsync(JsonToken.String, cancellationToken); Task task = InternalWriteValueAsync(JsonToken.String, cancellationToken);
switch (task.Status) if (task.Status == TaskStatus.RanToCompletion)
{ {
case TaskStatus.Canceled:
case TaskStatus.Faulted:
return task;
case TaskStatus.RanToCompletion:
return value == null ? _writer.WriteAsync(JsonConvert.Null, cancellationToken) : WriteEscapedStringAsync(value, true, cancellationToken); return value == null ? _writer.WriteAsync(JsonConvert.Null, cancellationToken) : WriteEscapedStringAsync(value, true, cancellationToken);
} }
@@ -1225,12 +1189,8 @@ namespace Newtonsoft.Json
internal Task WriteValueNotNullAsync(Uri value, CancellationToken cancellationToken) internal Task WriteValueNotNullAsync(Uri value, CancellationToken cancellationToken)
{ {
Task task = InternalWriteValueAsync(JsonToken.String, cancellationToken); Task task = InternalWriteValueAsync(JsonToken.String, cancellationToken);
switch (task.Status) if (task.Status == TaskStatus.RanToCompletion)
{ {
case TaskStatus.Canceled:
case TaskStatus.Faulted:
return task;
case TaskStatus.RanToCompletion:
return WriteEscapedStringAsync(value.OriginalString, true, cancellationToken); return WriteEscapedStringAsync(value.OriginalString, true, cancellationToken);
} }
@@ -1350,12 +1310,8 @@ namespace Newtonsoft.Json
{ {
UpdateScopeWithFinishedValue(); UpdateScopeWithFinishedValue();
Task task = AutoCompleteAsync(JsonToken.Undefined, cancellationToken); Task task = AutoCompleteAsync(JsonToken.Undefined, cancellationToken);
switch (task.Status) if (task.Status == TaskStatus.RanToCompletion)
{ {
case TaskStatus.Canceled:
case TaskStatus.Faulted:
return task;
case TaskStatus.RanToCompletion:
return WriteRawAsync(json, cancellationToken); return WriteRawAsync(json, cancellationToken);
} }
+1 -5
View File
@@ -44,12 +44,8 @@ namespace Newtonsoft.Json.Linq
public override Task WriteToAsync(JsonWriter writer, CancellationToken cancellationToken, params JsonConverter[] converters) public override Task WriteToAsync(JsonWriter writer, CancellationToken cancellationToken, params JsonConverter[] converters)
{ {
Task task = writer.WritePropertyNameAsync(_name, cancellationToken); Task task = writer.WritePropertyNameAsync(_name, cancellationToken);
switch (task.Status) if (task.Status == TaskStatus.RanToCompletion)
{ {
case TaskStatus.Canceled:
case TaskStatus.Faulted:
return task;
case TaskStatus.RanToCompletion:
return WriteValueAsync(writer, cancellationToken, converters); return WriteValueAsync(writer, cancellationToken, converters);
} }
@@ -381,28 +381,16 @@ namespace Newtonsoft.Json.Utilities
bool[] charEscapeFlags, StringEscapeHandling stringEscapeHandling, JsonTextWriter client, char[] writeBuffer, CancellationToken cancellationToken) bool[] charEscapeFlags, StringEscapeHandling stringEscapeHandling, JsonTextWriter client, char[] writeBuffer, CancellationToken cancellationToken)
{ {
Task task = writer.WriteAsync(delimiter, cancellationToken); Task task = writer.WriteAsync(delimiter, cancellationToken);
switch (task.Status) if (task.Status != TaskStatus.RanToCompletion)
{ {
case TaskStatus.Canceled:
case TaskStatus.Faulted:
return task;
case TaskStatus.RanToCompletion:
// Completed synchronously (or very fast!), continue within this rather
// that the default branch which uses async
break;
default:
return WriteEscapedJavaScriptStringWithDelimitersAsync(task, writer, s, delimiter, charEscapeFlags, stringEscapeHandling, client, writeBuffer, cancellationToken); return WriteEscapedJavaScriptStringWithDelimitersAsync(task, writer, s, delimiter, charEscapeFlags, stringEscapeHandling, client, writeBuffer, cancellationToken);
} }
if (!string.IsNullOrEmpty(s)) if (!string.IsNullOrEmpty(s))
{ {
task = WriteEscapedJavaScriptStringWithoutDelimitersAsync(writer, s, charEscapeFlags, stringEscapeHandling, client, writeBuffer, cancellationToken); task = WriteEscapedJavaScriptStringWithoutDelimitersAsync(writer, s, charEscapeFlags, stringEscapeHandling, client, writeBuffer, cancellationToken);
switch (task.Status) if (task.Status == TaskStatus.RanToCompletion)
{ {
case TaskStatus.Canceled:
case TaskStatus.Faulted:
return task;
case TaskStatus.RanToCompletion:
return writer.WriteAsync(delimiter, cancellationToken); return writer.WriteAsync(delimiter, cancellationToken);
} }
} }