Речь в этой статье пойдет про подключение библиотеки 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 библиотеку на Веб сайте и, может быть, кто-то сэкономит некоторое время при создании своего проекта.
Автор: humblegenius
