差分
編集の要約なし
[[ASP.NET Web APIのユニットテストをAPI]]の[[ユニットテスト]]を[[NUnit]]で行えると[[Xamarin Studio]]での開発が捗る。での[[開発]]が捗る。
==概要==
[[Xamarin.iOS]]や[[Xamarin.Android]]は[[ユーザーインターフェース]]と[[ビジネスロジック]]の分離が売り文句である。
==実装1==
（２）動作検証用のAPIコントローラーを作る。
: Controllers/HelloController.cs
<source lang="csharp">
using System.Web.Http;
namespace SampleWebApi.Controllers
{
public class HelloController : ApiController
{
public string Get()
{
return "hello";
}
public string Post([FromBody] string name)
{
return "hello, " + name;
}
}
}
</source>
この例のPostメソッドでは単純な１個の[[引数]]のみを想定しているが、複数個になる場合はパラメータ用のクラスを作る、もしくはNewtonsoft.Json.LinqのJTokenクラスを使うのが望ましい。[[Xamarin]]系リッチクライアントとASP.NET Web APIの組み合わせの場合は、パラメータ用のクラス群を格納する共有用のライブラリプロジェクトを作り、それぞれのプロジェクトから参照して利用することで、[[インテリセンス]]などにより変数名のタイプミスなどの発見しづらい[[バグ]]を防ぐことができる。当然ながら[[JavaScript]]などから呼ぶ場合はタイプミスを防ぐ方法はないので手軽なJTokenを使う方法でも構わないと思う。
===手順2===
まず「NUnitライブラリプロジェクト」を作る。
[[Xamarin Studio]]の「新しいプロジェクト」ダイアログであれば「その他」「.NET」の中にある。
次に以下の手順を行う。
* このプロジェクトに[[NuGet]]からASP.NET Web APIを追加する
* 手順1で作成したASP.NETプロジェクトを参照する
** プロジェクトツリーの「参照」を右クリックし参照アセンブリの編集を選ぶ
** Edit Referencesダイアログが開くので「Projects」タブを選ぶ
** ソリューション内のプロジェクトの一覧が表示されるので手順1で作ったプロジェクトにチェックを入れる
===手順3===
インメモリサーバーの準備をする。
なんでもいいのでNUnitライブラリプロジェクトからASP.NETプロジェクトのメソッドを呼び出す。
これがとても重要。重要。
なんでもいいがASP.NETプロジェクトにWebApiを初期化するコードを静的クラス・静的メソッドとして用意し、両方のプロジェクトで共有すると捗る。
WebApiを初期化するコードの例
:App_Startup/WebApiConfig.cs
<source lang="csharp">
using System.Web.Http;
namespace SampleWebApi
{
public static class WebApiConfig
{
public static void Register(HttpConfiguration config)
{
// Attribute routing.
config.MapHttpAttributeRoutes();
// Convention-based routing.
config.Routes.MapHttpRoute(
name: "DefaultApi",
routeTemplate: "api/{controller}/{id}",
defaults: new { id = RouteParameter.Optional }
);
}
}
}
</source>
ASP.NETプロジェクトはGlobal.asax.csから呼び出す。
<source lang="csharp">
using System.Web.Mvc;
using System.Web.Routing;
using System.Web.Http;
namespace SampleWebApi
{
public class MvcApplication : System.Web.HttpApplication
{
protected void Application_Start()
{
AreaRegistration.RegisterAllAreas();
GlobalConfiguration.Configure(WebApiConfig.Register);
}
}
}
</source>
NUnitプロジェクトはTestFixtureSetUp属性を付けたメソッドから呼び出す。
<source lang="csharp">
[TestFixtureSetUp]
public void Setup()
{
var config = new HttpConfiguration();
SampleWebApi.WebApiConfig.Register(config); // ←←←これ重要
config.IncludeErrorDetailPolicy = IncludeErrorDetailPolicy.Always;
}
</source>
===手順4===
NUnitライブラリプロジェクトにインメモリサーバー関連のコードを記述する。
<source lang="csharp">
using NUnit.Framework;
using System;
using System.Net;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Net.Http.Formatting;
using System.Web.Http;
namespace SampleWebApi.Tests
{
[TestFixture]
public class InMemoryTests
{
private const string UrlBase = "http://127.0.0.1:8080/";
private HttpServer _server;
[TestFixtureSetUp]
public void Setup()
{
var config = new HttpConfiguration();
// ASP.NETプロジェクトの何かしらのメソッドを呼び出す。
// 初期化コードを共通化しておくのが間違いないと思われる。
SampleWebApi.WebApiConfig.Register(config);
// エラーをいっぱいだす
config.IncludeErrorDetailPolicy = IncludeErrorDetailPolicy.Always;
// 重要
// ASP.NETプロジェクトの何かしらのメソッドを呼び出した後にインメモリサーバーのインスタンスを作ること
_server = new HttpServer(config);
}
public void Dispose()
{
if (_server != null)
{
_server.Dispose();
_server = null;
}
}
[Test]
public void Get()
{
using (var client = new HttpClient(_server))
{
var request = CreateRequest(
"api/Hello",
"application/json",
HttpMethod.Get);
using (var response = client.SendAsync(request).Result)
{
Assert.IsNotNull(response);
Assert.AreEqual(HttpStatusCode.OK, response.StatusCode);
Assert.NotNull(response.Content);
}
}
}
[Test]
public async void Post()
{
using (var client = new HttpClient(_server))
{
var request = CreateRequest(
"api/Hello",
"application/json",
HttpMethod.Post,
"monobook" ,
new JsonMediaTypeFormatter());
using (var response = client.SendAsync(request).Result)
{
Assert.IsNotNull(response);
Assert.AreEqual(HttpStatusCode.OK, response.StatusCode);
Assert.NotNull(response.Content);
}
}
}
private HttpRequestMessage CreateRequest(string url, string mthv, HttpMethod method)
{
var request = new HttpRequestMessage();
request.RequestUri = new Uri(UrlBase + url);
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue(mthv));
request.Method = method;
return request;
}
private HttpRequestMessage CreateRequest<T>(string url, string mthv, HttpMethod method, T content, MediaTypeFormatter formatter) where T : class
{
HttpRequestMessage request = CreateRequest(url, mthv, method);
request.Content = new ObjectContent<T>(content, formatter);
return request;
}
}
}
</source>
===おわり===
==関連項目==
{{stub}}
[[category:.NET Framework]][[category: Xamarin.Studio]]