Использование JSON контроллера MVC в Visual Studio на шаблоне Empty Web Site и языке C#

Источник: habrahabr

humblegenius

Речь в этой статье пойдет про подключение библиотеки MVC3 в Visual Studio 2010. Но мы не будем использовать шаблон проекта "ASP.NET MVC3 Web Application", а создадим Веб-сайт (Веб-узел) на основе шаблона "Empty Web Site", то есть с нуля. Мы будем подключать библиотеку к пустому Веб сайту, т.к. шаблона MVC для Веб сайта нет.
В конце статьи будет реализован JSON контроллер на основе библиотеки MVC.
Пояснил бы картинками, но они не вставляются. Поэтому буду пояснять словами.

Предыстория

Недавно меня заинтересовала реализация MVC в Visual Studio. В интернете, и в частности на хабре, есть множество статей как его использовать, но пересмотрев штук 20 инструкций, я обнаружил, что все они основаны только на шаблоне "ASP.NET MVC3 Web Application". Первые два шага в большинстве инструкций сводятся к следующему:

Скачать и установить MVC3.
Выбрать пункт:
File -> New -> Project… -> Installed Templates -> Visual C# -> Web -> "ASP.NET MVC3 Web Application" -> Ok.

Но что, если человек хочет создать "Web site", а не "Web Application". Тогда он нажимает следующие пункты меню:
File -> New -> Web Site -> Installed Templates -> Visual C#
И потом ищет, где же этот MVC3: "Я же его только что скачал и установил".
Если хорошо присмотреться, то все же MVC3 не зря был установлен: появился новый шаблон "ASP.NET Web Site (Razor)". Razor - это конечно круто, но в нем MVC не оказалось.
Итак, получается, что MVC проекта для Веб сайта нет.
Вдобавок признаюсь, что шаблон "ASP.NET MVC3 Web Application" мне особо не понравился, так как он слишком много в себе содержит. Для меня достаточно было бы включить туда необходимые библиотеки и создать структуру каталогов. Мне удобней, когда содержимое проекта контролирую я.
Поэтому мне проще было создать MVC проект с нуля на основе шаблона "Empty Web Site".
Я не буду вдаваться в подробности, что лучше использовать: "Web site" или "Web Application". Я, честно говоря, не уверен, что в полной мере представляю их достоинства и недостатки. Но как бы то ни было вариант нового проекта "Web site" в Visual Studio есть. Следовательно, он используется. Следовательно, кто-то захочет использовать MVC на его основе.
Единственное, что меня смущало, это то, что в шаблоне "ASP.NET MVC3 Web Application" были некоторые возможности, которые я так и не смог реализовать в проекте "Web Site":

Структура каталогов получилась другая, т.к. все классы должны находиться в папке "App_Code"
В "Web Site" не получится нажать правой кнопкой по директории "Controllers" и выбрать Add -> Controller.

Я некоторое время потратил на то, чтобы исправить эти недостатки, пока не наткнулся на статью, где автор просто их проигнорировал. Поэтому я решил, что реализация этих двух пунктов будет сильно затратным процессом и пока что можно обойтись без них.

Предисловие

Собственно все основы изложены тут.
Чтобы не дублировать существующие в интернете статьи, я не буду описывать следующие вопросы: как запустить IIS сервер, как установить MVC3 и как его использовать.
Я лишь кратко расскажу, как в пустой проект добавляется библиотека MVC, создаются роуты и добавляется контроллер, который выдает результаты в JSON формате. То есть будет рассмотрен тот минимум, который позволит затем использовать возможности MVC в своем "Web Site" проекте.
Предполагается, что проект будет расположен на локальном IIS сервере.

Создание проекта

Скачиваем и устанавливаем MVC3.
Перед созданием проекта нужно запустить IIS сервер. Создать там новый сайт. Прописать его в файле hosts.
Открываем Visual Studio от имени администратора (иначе Visual Studio не захочет размещать и редактировать проект на сервере IIS).
Выбираем пункты File -> New -> Web Site -> Installed Templates -> Visual C# -> Empty Web Site
Выбираем .NET Framework 4
Выбираем Web Location: HTTP
Прописываем url к своему сайту нажимаем "OK"

Настройка проекта

Открываем "Solution Explorer". Изначально у нас в проекте только один файл: web.config.
Добавим файл Global.asax, который будет обрабатывать все запросы к сайту:
Правой кнопкой по проекту в "Solution Explorer". Затем пункт "Add New Item…". Выбираем "Global Application Class".
Так как мы собрались использовать библиотеку MVC 3, то добавим ее в проект:
Провой кнопкой по проекту в "Solution Explorer". Затем пункт "Add Reference…". Находим и добавляем System.Web.Mvc версии 3.
Теперь если открыть web.config, то увидим, что тут-то она и прописалась. Чтобы эта библиотека была доступна в веб формах и в файле Global.asax, добавим в тег "system.web" следующий код:

<pages>
    <namespaces>
        <add namespace="System.Web.Mvc"/>
        <add namespace="System.Web.Routing"/>
    </namespaces>
</pages>

Настройка роутов

Открываем Global.asax и вставляем в функцию Application_Start() следующий код:

        AreaRegistration.RegisterAllAreas();
        RouteTable.Routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
        RouteTable.Routes.MapRoute(
            "Default",
            "{controller}/{action}"
        );

Тут важно то, что в URL нужно будет на месте {controller} писать название класса, но без слова "Controller", а на месте {action} - метод класса.
То есть, если URL = "http://site.com/Employeer/List", то будет вызван метод List класса EmployeerController.

Создание контроллера

Добавим директорию для классов "App_Code":
Правой кнопкой по проекту в "Solution Explorer". Затем пункт "Add ASP.NET Folder". Выбираем "App_Code".
В эту директорию добавим класс EmployeeController.cs.
Контроллер должен наследоваться от класса System.Web.Mvc.Controller.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;

public class EmployeeController:Controller{
public ActionResult List()
    {
        return Json(new {ID=123,Name="Name1" });
    }
}

Запуск контроллера

Теперь, если все сделано правильно, и в браузере ввести адрес типа "http://site.com/Employeer/List", то сервер должен выдать ошибку:
This request has been blocked because sensitive information could be disclosed to third party web sites when this is used in a GET request. To allow GET requests, set JsonRequestBehavior to AllowGet.
Это означает, что есть некая защита, чтобы json данные можно было смотреть только с текущего сайта. Можно эту защиту отключить:

public class EmployeeController:Controller{
public ActionResult List()
    {
        return new JsonResult { new {ID=123,Name="Name1" } , JsonRequestBehavior = JsonRequestBehavior.AllowGet };
    }
}

Но лучше такую защиту не отключать, а дать серверу понять, что запрос идет с этого же сайта.
Для этого создадим страницу index.html, добавим jquery.js в папку js и выполним ajax запрос с помощью jquery.
Index.html:

<html>
<head>
<script src=" /js/jquery.js" type="text/javascript"></script>
</head>
<body>
ddddfsf
<script type="text/javascript">
$(function(){
    $.ajax({
        type: "POST",
        contentType: "application/json; charset=utf-8",
        dataType: 'json',
        url: " /Employee/List",
        success: function(data) {alert(data.ID+","+data.Name);}
    });

});
</script>
</body>
</html>

Теперь, если в браузере ввести адрес сайта, то сервер должен показать страницу index.html и затем на экране появится окно со значениями объекта.

Заключение

Надеюсь данная статья будет полезна, тем кто решит использовать MVC библиотеку на Веб сайте и, может быть, кто-то сэкономит некоторое время при создании своего проекта.