ASP.NetでAPIを作ってみた

C#福岡 第三回勉強会にて
API.Net WebAPIの話

Transcript

1. ASP.NetでAPIを作ってみた 2014.01/22 C#福岡 第3回勉強会
2. About me
3. らこ Suguru Inatomi Twitter:@laco0416 学生 C#とかJavaとかPythonとか http://lacolaco.net
4. What ‘s ASP.Net Web API?
5. One ASP.NET (Scott Hanselman氏のブログより）
6. Microsoft ASP.NET Web API 現行バージョン: 4.0.30506 マルチプラットフォームのHTTPサービスフレームワーク 2012年8月に誕生したばかりの新しい技術 なんと20日にWeb API 2.1リリース http://blogs.msdn.com/b/webdev/archive/2014/01/20/announcing-the- release-of-asp-net-mvc-5-1-asp-net-web-api-2-1-and-asp-net-web- pages-3-1.aspx
7. ASP.NET Web API (@ITより）
8. Let’s make it!
9. Step-1 Make Project
12. Step-2 Make Controller
13. ModelsController Controller class -> ValuesController API endpoint -> http://lacolaco.net/api/values コントローラ名からURLルーティングを 自動でやってくれる
16. これだけですでに実行可能 RESTfulなインタフェースが すでに定義済み いたれりつくせり
17. メソッド名とHTTPのメソッド が対応しているので 名前の変更はNG 使わないAPIを消すのはOK
18. Step-3 Receive params
19. 引数無しGet 主にデータストアから 全レコードを返す時など。
20. 引数の規則 ・プリミティブ型はUriから ・それ以外はBodyから ・[FromBody]をつけると プリミティブでもBodyから読む ・[FromUri]をつけると オブジェクトでもUriから読む
21. Uriパラメータ受け取り ・仮引数名がそのままkeyになる api/samples?id=1 ・引数がidだけの時は api/samples/1と api/samples?id=1 は同じ
23. Bodyパラメータ受け取り ・Bodyから受け取れるのは 1つの引数のみ ・モデルクラスを用意して jsonのオブジェクトを受け取る ことができる
24. Body { id : 0 , value : “CSharp”} ↓ C# new Sample() { id = 0, value = “CSharp”};
25. Step-4 Run
27. API仕様のページまで 作ってくれる
28. My product IT Event API
29. 直近1ヶ月のIT系勉強会を返すAPI 文字列で検索も可能 http://api.lacolaco.net/events?query=福岡
30. ここで終わりだったんですが
31. Web API 2.1リリース ASP.Net MVC 5.1とWeb API 2.1が同時に正式リリース。 VS 2013 VS 2013 Update 1へのアプデが必要 VS 2012 ASP.NET and Web Tools 2013.1 for Visual Studio 2012の インストールが必要
32. Web API 2 : VS2013でのみ利用可能だった ↓ Web API 2.1 : VS2012でも利用可能に。 Install-Package Microsoft.AspNet.WebApi -Version 5.1.0 ・ Global Error Handling (エラーハンドリングを一箇所にまとめられるようになった) ・ Attribute Routing Improvements (属性によるルーティングの改善？) ・ Help Page Improvements (APIヘルプページの改善) ・ IgnoreRoute Support ・ BSON Media-Type Formatter (BSONオブジェクトに対応) ・ Better Support for Async Filters ・ Query Parsing for the Client Formatting Library (System.Net.Http.Formattingの拡張) まだ詳細を把握できていないので詳しくは原文を参照してください http://www.asp.net/web-api/overview/releases/whats-new-in-aspnet-web-api-21
33. Thank you for listening