OData (少なくとも v3 以降) は、特定の jsonを使用してエラーを表します。
{
"error": {
"code": "A custom error code",
"message": {
"lang": "en-us",
"value": "A custom long message for the user."
},
"innererror": {
"trace": [...],
"context": {...}
}
}
}
Microsoft .Net には、サーバー側で OData エラーを形成するMicrosoft.Data.OData.ODataErrorおよびMicrosoft.Data.OData.ODataInnerErrorクラスが含まれています。
エラーの詳細を含む適切な OData エラー応答 ( HttpResponseMessage ) を形成するには、次のことができます。
1) System.Web.OData.Extensions.HttpRequestMessageExtensions.CreateErrorResponseメソッドを使用して、コントローラーのアクションで HttpResponseMessage を形成して返す
return Request.CreateErrorResponse(HttpStatusCode.Conflict, new ODataError { ErrorCode="...", Message="...", MessageLanguage="..." }));
2) HttpResponseMessage の作成と同じメソッドを使用して HttpResponseException をスローする
throw new HttpResponseException(
Request.CreateErrorResponse(HttpStatusCode.NotFound, new ODataError { ErrorCode="...", Message="...", MessageLanguage="..." }));
3) カスタムの型指定された例外をスローし、Web Api アクション フィルターを使用して変換する
public class CustomExceptionFilterAttribute : ExceptionFilterAttribute
{
public override void OnException(HttpActionExecutedContext context)
{
if (context.Exception is CustomException)
{
var e = (CustomException)context.Exception;
var response = context.Request.CreateErrorResponse(e.StatusCode, new ODataError
{
ErrorCode = e.StatusCodeString,
Message = e.Message,
MessageLanguage = e.MessageLanguage
});
context.Response = response;
}
else
base.OnException(context);
}
}