/// <inheritdoc />
protected override void OnApiError(string errorCode, string errorMessage, JToken errorNode, JToken responseNode, WikiResponseParsingContext context)
{
// Possible error: code=stashfailed, info=Invalid chunk offset, offset=xxxx
// We will try to recover.
if (errorCode == "stashfailed" && errorNode["offset"] != null)
{
return;
}
base.OnApiError(errorCode, errorMessage, errorNode, responseNode, context);
}
/// <inheritdoc />
public override Task <object> ParseResponseAsync(HttpResponseMessage response, WikiResponseParsingContext context)
{
var responseCode = (int)response.StatusCode;
if (responseCode >= 300 && responseCode <= 399 || response.IsSuccessStatusCode)
{
return(dummyResult);
}
context.NeedRetry = true;
response.EnsureSuccessStatusCode(); // An exception will be thrown here.
return(dummyResult);
}
/// <inheritdoc />
/// <remarks>
/// <para>This method do not check the HTTP status code, because for certain JSON responses,
/// the status code might has its semantic meanings.</para>
/// <para>Then the content will be parsed as JSON, in <see cref="JToken"/>. If there is
/// <see cref="JsonException"/> thrown while parsing the response, a retry will be requested.</para>
/// <para>The default implementation for this method throws a <see cref="WikiaApiException"/>
/// or one of its derived exceptions when detected <c>exception</c> node in the JSON response.
/// The exception mapping is as follows</para>
/// <list type="table">
/// <listheader>
/// <term><c>exception.code</c> value</term>
/// <description>Mapped exception type</description>
/// </listheader>
/// <item>
/// <term><c>NotFoundApiException</c></term>
/// <description><see cref="NotFoundApiException"/></description>
/// </item>
/// <item>
/// <term>Others</term>
/// <description><see cref="WikiaApiException"/></description>
/// </item>
/// </list>
/// </remarks>
public override async Task <JToken> ParseResponseAsync(HttpResponseMessage response, WikiResponseParsingContext context)
{
if (response == null)
{
throw new ArgumentNullException(nameof(response));
}
if (context == null)
{
throw new ArgumentNullException(nameof(context));
}
// For REST-ful API, we need to parse the content first, to see what happened.
JToken jroot;
try
{
jroot = await MediaWikiHelper.ParseJsonAsync(await response.Content.ReadAsStreamAsync(),
context.CancellationToken);
}
catch (JsonException)
{
context.NeedRetry = true;
throw;
}
if (jroot is JObject obj)
{
// Check for exception node.
var exception = obj["exception"];
if (exception != null)
{
var type = (string)exception["type"];
var message = (string)exception["message"];
var details = (string)exception["details"];
var code = (int?)exception["code"] ?? (int)response.StatusCode;
var traceId = (string)jroot["trace_id"];
switch (type)
{
case "NotFoundApiException":
throw new NotFoundApiException(type, message, code, details, traceId);
default:
throw new WikiaApiException(type, message, code, details, traceId);
}
}
}
return(jroot);
}
/// <inheritdoc />
public override async Task <HtmlDocument> ParseResponseAsync(HttpResponseMessage response, WikiResponseParsingContext context)
{
if (!response.IsSuccessStatusCode)
{
context.NeedRetry = true;
response.EnsureSuccessStatusCode();
}
var doc = new HtmlDocument();
// TODO buffer stream, instead of reading all
var content = await response.Content.ReadAsStringAsync();
doc.LoadHtml(content);
return(doc);
}
