11月 2013年

ASP.NET MVC における、フォーム認証の実装例を掲載します。 今回は ASP.NET MVC 4 で実装しています…が、 ASP.NET MVC 3 でも似たような実装になるかと思います。

目次

• 概要
• web.config の 設定
• ログイン モデル の 作成
• ログイン ビュー の 作成
• ログイン 処理 の 実装
• [おまけ] ログアウト

認証 ( Authentication )

サービス へ アクセス してきた ユーザー が 「本人であるかどうか」 を検証する。

承認 ( Authorization )

サービス へ アクセス してきた 認証済みユーザー が 「指定した リソース へ アクセスできるかどうか」 を制御する。

ASP.NET Web API における、ルーティング についてまとめます。 WCF と似ているけれど、バインド方法が若干異なるので、注意が必要そうです。

目次

• デフォルト設定 （デフォルト の ルーティング）
• ルーティングテーブル 追加による ルーティング 変更
• カスタム属性 による 変更

リクエスト時 に設定する クエリパラメーター、 メッセージボディー と、リクエストを受け取った関数の引数 がどのような関係にあるかをまとめます。 具体的には、クエリーパラメーター を 引数 へ バインド する方法と、メッセージボディー から モデルクラス へ バインド する方法 についてのまとめです。

目次

• クエリパラメーター と 引数
• メッセージボディー と 引数

データコントラクト（DataContract）を利用することで、JSON と C# で作成した クラス との間の シリアライズ、デシリアライズ を自動的に行えるようにします。 ここでは、メッセージボディー に入れられた JSONオブジェクト を C# で作成した モデルクラス へ バインド する方法について記載します。

目次

• データコントラクト の実装
• データコントラクト を利用した サービス の実装
• テスト 実行

Web API を利用していると、簡単に レスポンスヘッダー を調整することができます。 ほとんどは HttpResponseMessage クラス の設定で処理を行います。 以下に、ケース別の具体例を掲載します。

目次

• Content-Type の書き換え
• ステータスコード の書き換え
• カスタムレスポンスヘッダー

Content-Type の書き換え

何も設定しない場合、application/json になるので、ここでは text/plain に設定する例を掲載します。

namespace WebService
{
    using System.Text;
    using System.Web;
    using System.Web.Http;

    public class SampleController : ApiController
    {
        public string Get()
        {
            var response = this.Request.CreateResponse(HttpStatusCode.OK);

            response.Content = new StringContent("Hello World.", Encoding.UTF8, "text/plain");

            return response;
        }
    }
}

ステータスコード の書き換え

namespace WebService
{
    using System.Web;
    using System.Web.Http;

        public HttpResponseMessage Post()
        {
            try
            {
                // 何か処理

                return this.Request.CreateResponse(HttpStatusCode.OK);
            }
            catch
            {
                return this.Request.CreateErrorResponse(HttpStatusCode.InternalServerError, "エラーメッセージ");
            }
        }
}

カスタムレスポンスヘッダー

namespace WebService
{
    using System.Web;
    using System.Web.Http;

    public class SampleController : ApiController
    {
        public HttpResponseMessage Options()
        {
            var response = this.Request.CreateResponse(HttpStatusCode.OK);

            response.Headers.Add("Access-Control-Allow-Origin", "*");
            response.Headers.Add("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
            response.Headers.Add("Access-Control-Max-Age", "1728000");

            return response;
        }
    }
}

今回、以下のサイトを参考にしました。

• MSDN - HttpResponse クラス
• MSDN - HttpResponseMessage クラス
• Stack Overflow - Is there a way to force ASP.NET Web API to return plain text?
• Stack Overflow - Add Header To Web API Actions on Controller
• Stack Overflow - Returning http status code from ASP.NET MVC 4 Web Api controller
• Stack Overflow - mvc 4 web api add custom response http header

ここでは、 ASP.NET Web API において、独自フィルター を実装する方法を掲載します。 独自フィルター を実装することで、 RESTful アプリケーション内において、ある決まった処理を簡単に実装することができるようになります。 今回は サンプル として「フィルターを実装したアクション（メソッド）のレスポンスをキャッシュさせない」独自フィルターを作成します。

ASP.NET Web API の入門。 ASP.NET Web API を利用して RESTful web サービス を作成します。 ここでは、何も装飾的な処理を考えない、最も基本的な サービス の作成を目指します。