「ASP.NET Web API」を編集中

'''ASP.NET Web API'''とは、[[ASP.NET MVC 4]]で追加される予定のRESTfulなサービスを構築するためのフレームワークである。

== ASP.NET MVC と ASP.NET Web API ==
=== ASP.NET Web API 1.0===
[[ASP.NET Web API]]は、[[ASP.NET MVC 4]]のパッケージに同梱されているだけであり、従来の[[ASP.NET MVC]]とはまったく別物である点に注意すること。

たとえば、[[アクションコントローラー]]の根底にある[[インターフェイス]]も[[ASP.NET MVC]]では[[IController]]だが（[[ASP.NET]]無印と共通）、[[ASP.NET Web API]]ではまったく新規に登場した[[IHttpController]]となっている。また[[アクション]]の戻り値も[[ActionResult]]ではなく[[HttpResponseMessage]]となっているなど、「名前は似ているが全くの別物が用意されている」と認識しておく必要がある。
=== ASP.NET Web API 2.0===
ASP.NET Web API 2.0以降では単体で動くようになり[[NuGet]]から簡単に環境を構築し利用できる。また[[Mono]]でも問題なく利用できるようになり[[Mac OS X]]上の[[Xamarin Studio]]での開発も可能になった。

== RESTful ==
ASP.NET Web API では、新しい強く型付けされた HTTP オブジェクトモデルを使って HTTP リクエストとレスポンスを直接操作できる。 

[[ASP.NET MVC]]のデフォルトの[[ASP.NET MVC/ルーティング|ルーティング]]は以下のようになっている。
<source lang="csharp">
routes.MapRoute(
    "Default", 
    "{controller}/{action}/{id}", 
    new { controller = "Home", action = "Index", id = UrlParameter.Optional } 
);
</source>

一方、ASP.NET Web APIのデフォルトのルーティングは以下のようになっている。
<source lang="csharp">
routes.MapHttpRoute(
    "DefaultApi",
    "api/{controller}/{id}",
    new { id = RouteParameter.Optional }
);
</source>
どちらもcontroller（コントローラー名）とid（引数）をとるのは共通だが、ASP.NET Web APIではactionが無くなっており、[[REST]]のルール（HTTPリクエストメソッドの種類）に応じて強制的にアクションが決定する。従って、[[HttpPost]]などの属性をクラスやメソッドに付加する必要がない（「[[ASP.NET MVC/セレクター]]」も参照）。

{|class="wikitable"
|-
! HTTPリクエストメソッド
! アクション
|-
| GET (idなし)
| 全データを取得する。
|-
| GET (id指定)
| idで指定されたデータ取得する。
|-
| POST
| 新しいデータを追加する。
|-
| PUT
| idで指定されたデータを更新する。
|-
| DELETE
| idで指定されたデータを削除する。
|}

== 関連項目 ==
* [[ASP.NET MVC]]
** [[ASP.NET MVC 1]]
** [[ASP.NET MVC 2]]
** [[ASP.NET MVC 3]]
** [[ASP.NET MVC 4]]
== 参考文献 ==
<references/>
== 外部リンク ==

{{stub}}