ASP.NET MVC: Переходим с MVC 3 на MVC 4

Задача

Требуется:

  1. Перевести проект "Музей Юмора" с ASP.NET MVC 3 на новую версию ASP.NET MVC 4. При этом .NET Framework пока менять не будем, то есть оставим 4.0.
  2. Отказаться от использования ASP.NET Membership в пользу SimpleMembershipProvider.

Просто или правильно

На официальном сайте asp.net есть статья “Upgrading an ASP.NET MVC 3 Project to ASP.NET MVC 4” которая рассказывает как обновить проект. Описано всё просто и поэтому я останавливаться не буду на этом, а лишь укажу основные пункты:

  • Создаем чистый проект ASP.NET MVC 4
  • Копируем нужные файлы из проекта на MVC 3 во вновь созданный: контролеры, скрипты, представления… Короче всё, что нужно для работы проекта.
  • Копируем web.config и начинаем его править ручками.

1. Меняем строки файла конфигурации:

   1:  System.Web.Mvc, Version=3.0.0.0
   2:  System.Web.WebPages, Version=1.0.0.0
   3:  System.Web.Helpers, Version=1.0.0.0
   4:  System.Web.WebPages.Razor, Version=1.0.0.0

На новые:

   1:  System.Web.Mvc, Version=4.0.0.0
   2:  System.Web.WebPages, Version=2.0.0.0
   3:  System.Web.Helpers, Version=2.0.0.0
   4:  System.Web.WebPages.Razor, Version=2.0.0.0

2. Добавляем новый параметр приложения PreserveLoginUrl:

   1:  <appSettings>
   2:    <add key="webpages:Version"value="2.0.0.0" />
   3:    <add key="PreserveLoginUrl"value="true" />
   4:  </appSettings>

3. Обновляем nuget-пакеты. Благо теперь появилась новая опция  –reinstall, которая при необходимости удалит пакет и потом заново установит его.

4. В файле проекта надо поменять ProjectTypeGuids. Выгружаем проект, открываем файл проекта для редактирования и меняем:

   1:  {E53F8FEA-EAE0-44A6-8774-FFD645390401}

на новый:

   1:  {E3E379DF-F4C6-4180-9B81-6769533ABE47}

После этого сохраняем файл и даем команду перезагрузить проект.

5. И напоследок, если ваше приложение содержит сторонние сборки ссылающиеся на MVC фреймворк, то следует обновить еще и эту часть в файле конфигурации:

   1:  <configuration>
   2:  <!--... элетмены удалены для ясности ...-->
   3:  
   4:  <runtime>
   5:  <assemblyBindingxmlns="urn:schemas-microsoft-com:asm.v1">
   6:  <dependentAssembly>
   7:  <assemblyIdentityname="System.Web.Helpers"
   8:  publicKeyToken="31bf3856ad364e35"/>
   9:  <bindingRedirectoldVersion="1.0.0.0"newVersion="2.0.0.0"/>
  10:  </dependentAssembly>
  11:  <dependentAssembly>
  12:  <assemblyIdentityname="System.Web.Mvc"
  13:  publicKeyToken="31bf3856ad364e35"/>
  14:  <bindingRedirectoldVersion="1.0.0.0-3.0.0.0"newVersion="4.0.0.0"/>
  15:  </dependentAssembly>
  16:  <dependentAssembly>
  17:  <assemblyIdentityname="System.Web.WebPages"
  18:  publicKeyToken="31bf3856ad364e35"/>
  19:  <bindingRedirectoldVersion="1.0.0.0"newVersion="2.0.0.0"/>
  20:  </dependentAssembly>
  21:  </assemblyBinding>
  22:  </runtime>
  23:  </configuration>

После этого ваш проект должен откомпилироваться и запуститься. У меня не получилось с первого раза, мне пришлось еще немного повозиться. В основном с установкой правильных версий nuget-пакетов под новый MVC 4.

Хочется верить, что у вас всё получилось с первого раза и поэтому продолжим.

WebSecurity и  SimpleMembershipProvider

В новом шаблоне сайта для MVC4 используется WebSecurity и SimpleMembershipProvider. WebSecurity официально рекомендован для использования при построении сайтов на ASP.NET:

По умолчанию WebSecurity использует упрощенную схему базы данных членства по сравнению тем, что поддерживает механизм членства в ASP.NET. Это сделано по нескольким причинам. Одна из них — то, что класс SimpleMembershipProvider не реализует все функции членства ASP.NET, и поэтому не приходится отслеживать большой объем информации. Еще один фактор — то, что упрощенная схема удобнее для работы и не требует прямых запросов к базе данных. Наконец, упрощенная схема была разработана специально для упрощения интеграции членства с существующими таблицами базы данных, которые уже содержат имена пользователей и адреса электронной почты.”

SimpleMembershipProvider на сайте MSDN описан так:

Предоставляет поддержку для задач членства на веб-сайте, например создания учетных записей, удаления учетных записей и управления паролями.

Вспомогательный класс WebSecurity рекомендуется использовать для управления пользовательскими учетными записями, паролями и другими задачами членства. Класс SimpleMembershipProvider также может управлять членством; тем не менее, это не рекомендуется делать ввиду того, что WebSecurity предоставляет более простой способ управления членством. Класс SimpleMembershipProvider предназначен для разработчиков, которым требуется более точно контролировать членство.”

Таким образом, чтобы сайт работал быстрее и управление стало проще – нужно использовать новые возможности. Это я и собираюсь сделать.

Обновление базы данных

Во первой части цикла статей ИОП “Музей Юмора”, в которой речь идет о данных я рассказывал, как при помощи утилиты aspnet_regsql.exe добавить Memebership-функционал. Сейчас я намерен поступить наоборот, то есть удалить этот функционал из базы.

Внимание:Я с легкостью собираюсь удалить данные о пользователях потому что я единственный, кто зарегистрирован на сайте. И значит после создания нового SimpleMembershipProvider, я просто заново зарегистрируюсь. Если у вас сайт содержит информация о пользователях и об их профилях, то последующие действия не следует делать. Ну, в крайнем случае, сделайте архивную копию базы (backup). И попробуйте самостоятельно проделать операцию “переноса” пользователей из старого Membership в новый.

Итак, запустим эту самую утилиту:

ASP.NET MVC: Переходим с MVC 3 на MVC 4

На этот раз я выберу опцию “Remove”.

ASP.NET MVC: Переходим с MVC 3 на MVC 4

Работа утилиты завершилась с ошибкой, выдав сообщение:

Исключение:
Не удается удалить указанные функции, так как таблица SQL 'aspnet_Membership' в базе данных '[museumDb]' не является пустой. Сначала требуется удалить все строки из этой таблицы.”

Придётся сначала “вручную” очистить все связанные таблицы. У меня получилось затратить на чистку не более пяти минут. Вот база “до” чистки:

99-currentview-db

А вот уже после того, как отработала утилита:

99-currentview-db-clear

Обратите внимания, что также все StoredProcedures были удалены. Если вы делаете удаление “вручную”, то есть без использования утилиты, то не забудьте удалить всё что было ей установлено.

Самое интересное

В новом шаблоне сайта для MVC 4 есть папка Filters, в которой есть файл  InitializeSimpleMembershipAttribute.cs. Этот файл содержит класс атрибута, установка которого на контроллере AccountController гарантирует, что перед использованием Membership (вход на сайт или регистрация), если еще нет инфраструктуры для работы Membership, то будут созданы все необходимые для этого таблицы в базе данных. Если вы не будете использовать на своем сайте вход/регистрацию, то эта инфраструктура (таблицы) не появятся в вашей базе.

Теперь посмотрим на что случится, если просто запустить сайт:

The model backing the 'MuseumContext' context has changed since the database was created. Consider using Code First Migrations to update the database (http://go.microsoft.com/fwlink/?LinkId=238269).”

Собственно этого я и ждал. Запустим процесс обновления базы, я это делаю из Package Manager Console:

PM> Update-Database
Specify the '-Verbose' flag to view the SQL statements being applied to the target database.
No pending code-based migrations.
Applying automatic migration: 201210120304152_AutomaticMigration.
Running Seed method.
PM>

Запускаю еще раз сайт - работает, но только теперь сайт и понятия не имеет, что такое Membership. Вернемся к ранее упомянутому атрибуту InitializeSimpleMembershipAttribute.

Я его немного доработал, чтобы сразу при создании базы данных запускался процесс создания пользователя (меня).

   1:  [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method,
   2:      AllowMultiple = false, Inherited = true)]
   3:  publicsealedclass InitializeSimpleMembershipAttribute : ActionFilterAttribute {
   4:  privatestatic SimpleMembershipInitializer _initializer;
   5:  privatestaticobject _initializerLock = newobject();
   6:  privatestaticbool _isInitialized;
   7:   
   8:  publicoverridevoid OnActionExecuting(ActionExecutingContext filterContext) {
   9:   
  10:  // Ensure ASP.NET Simple Membership is initialized only once per app start
  11:          LazyInitializer.EnsureInitialized(ref _initializer, ref _isInitialized, ref _initializerLock);
  12:      }
  13:   
  14:  privateclass SimpleMembershipInitializer {
  15:   
  16:  public SimpleMembershipInitializer() {
  17:              Database.SetInitializer<MuseumContext>(null);
  18:   
  19:  try {
  20:  using (var context = new MuseumContext()) {
  21:  if (!context.Database.Exists()) {
  22:   
  23:  // Create the SimpleMembership database without 
  24:  // Entity Framework migration schema
  25:                          ((IObjectContextAdapter)context).ObjectContext.CreateDatabase();
  26:                      }
  27:                  }
  28:   
  29:                  WebSecurity.InitializeDatabaseConnection("DefaultConnection",
  30:  "Users", "UserId", "UserName", autoCreateTables: true);
  31:   
  32:  // получаем провайдер ролей на сайте.
  33:                  var roles = (SimpleRoleProvider)Roles.Provider;
  34:   
  35:  //Получаем провайдер членства
  36:                  var membership = (SimpleMembershipProvider)Membership.Provider;
  37:   
  38:  // проверяю наличие роли Administrator
  39:  bool isExists = roles.GetAllRoles().Contains("Administrator");
  40:   
  41:  // добавляю, если роли нет
  42:  if (!isExists) {
  43:                      roles.CreateRole("Administrator");
  44:                  }
  45:   
  46:  // проверяю наличие зарегистрированного пользователя
  47:                  MembershipUser user = membership.GetUser("Calabonga", false);
  48:   
  49:  //создаю, если пользователя не найдено
  50:  if (user == null) {
  51:                      membership.CreateUserAndAccount("Calabonga", "123123");
  52:                  }
  53:   
  54:  //добавляю пользователю права администратора
  55:  if (!roles.GetRolesForUser("Calabonga").Contains("Administrator")) {
  56:                      roles.AddUsersToRoles(
  57:  newstring[] { "Calabonga" },
  58:  newstring[] { "Administrator" });
  59:                  }
  60:              }
  61:  catch (Exception ex) {
  62:  thrownew InvalidOperationException(
  63:  @"The ASP.NET Simple Membership database could 
  64:                  not be initialized. 
  65:                  For more information, 
  66:                  please see http://go.microsoft.com/fwlink/?LinkId=256588", ex);
  67:              }
  68:          }
  69:      }
  70:  }

Все изменения начинаются в строке 32 и заканчиваются в строке 59. Я постарался всё описать в комментариях. Запустил, проверил – да, действительно работает. Остается только перейти на страницу смены пароля и поменять на более “правильный”.

После первого входа на сайт в базе данных добавилось немного таблиц:

99-afterlogin-db-view

Заключение

Для того чтобы сайт начала работать с новыми провайдерами, надо указать в файле конфигурации (web.config) следующие параметры:

   1:  <roleManagerenabled="true"
   2:  defaultProvider="SimpleRoleProvider">
   3:  <providers>
   4:  <clear/>
   5:  <add
   6:  name="SimpleRoleProvider"
   7:  type="WebMatrix.WebData.SimpleRoleProvider, WebMatrix.WebData"/>
   8:  </providers>
   9:  </roleManager>
  10:  <membership
  11:  defaultProvider="SimpleMembershipProvider">
  12:  <providers>
  13:  <clear/>
  14:  <add
  15:  name="SimpleMembershipProvider"
  16:  type="WebMatrix.WebData.SimpleMembershipProvider, WebMatrix.WebData"/>
  17:  </providers>
  18:  </membership>

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

   1:  @{
   2:  if (!WebSecurity.Initialized) {
   3:          WebSecurity.InitializeDatabaseConnection("DefaultConnection",
   4:  "Users", "UserId", "UserName", autoCreateTables: true);
   5:      }
   6:  }

Вот теперь точно всё - поставленная задача успешно выполнена.

Подробнее: http://feedproxy.google.com/~r/blogmusor/~3/KfUHrpzU2zg/99

Читать комменты и комментировать

Добавить комментарий / отзыв



Защитный код
Обновить

ASP.NET MVC: Переходим с MVC 3 на MVC 4 | | 2012-10-13 08:53:10 | | Программирование | | ЗадачаТребуется:Перевести проект Музей Юмора с ASP.NET MVC 3 на новую версию ASP.NET MVC 4. При этом .NET Framework пока менять не будем, то есть оставим 4.0. Отказаться от использования ASP.NET | РэдЛайн, создание сайта, заказать сайт, разработка сайтов, реклама в Интернете, продвижение, маркетинговые исследования, дизайн студия, веб дизайн, раскрутка сайта, создать сайт компании, сделать сайт, создание сайтов, изготовление сайта, обслуживание сайтов, изготовление сайтов, заказать интернет сайт, создать сайт, изготовить сайт, разработка сайта, web студия, создание веб сайта, поддержка сайта, сайт на заказ, сопровождение сайта, дизайн сайта, сайт под ключ, заказ сайта, реклама сайта, хостинг, регистрация доменов, хабаровск, краснодар, москва, комсомольск |
 
Поделиться с друзьями: