(495) 925-0049, ITShop интернет-магазин 229-0436, Учебный Центр 925-0049
  Главная страница Карта сайта Контакты
Поиск
Вход
Регистрация
Рассылки сайта
 
 
 
 
 

Введение в одностраничные приложения для .NET-разработчиков

Исходный код можно скачать по ссылке.

Продукты и технологии:

ASP.NET MVC 5, JavaScript, одностраничные приложения, Kendo UI, RequireJS, Entity Framework, Web API, OData

В статье рассматриваются:

• операции, необходимые для преобразования приложения ASP.NET MVC 5 в одностраничное приложение (single-page application, SPA);

• настройка инфраструктуры SPA;

• добавление CRUD-функциональности (create, read, update, delete).

Большинство разработчиков, использующих Microsoft .NET Framework, большую часть своего времени занималось серверной стороной, создавая веб-приложения на C# или Visual Basic .NET. Конечно, JavaScript применяли для простых вещей вроде модальных окон, проверки, AJAX-вызовов и т. д. Однако JavaScript (в основном на клиентской стороне) использовался как вспомогательный язык, а приложения работали главным образом на серверной стороне.

Не так давно проявилась тенденция к миграции кода веб-приложений с серверной стороны на клиентскую (в браузеры), отвечающая ожиданиям в появлении гибких и отзывчивых пользовательских сред. А раз так, то множеству .NET-разработчиков (особенно корпоративных) пришлось резко озаботиться рекомендациями по программированию на JavaScript, архитектурой, модульным тестированием, поддержкой сопровождения и разбираться со всевозможными видами JavaScript-библиотек, которых становится все больше и больше. Отчасти тенденция с переходом на клиентскую сторону связана с растущим использованием одностраничных приложений (single-page applications, SPA). Сказать, что разработка SPA - это будущее, было бы сильным преуменьшением. Именно SPA являются примером некоторых из лучших веб-приложений, которые обеспечивают гибкие и отзывчивые пользовательские среды, в то же время сводя к минимуму объемы данных (трафик) и частоту полных циклов обмена ими между клиентом и сервером.

Сказать, что разработка SPA - это будущее, было бы сильным преуменьшением.

В этой статье я рассмотрю проблемы, которые могут возникнуть при переходе с серверной стороны в царство SPA. Лучший способ справиться с этими проблемами - принять язык JavaScript как полноценный и ничем не уступающий любым другим .NET-языкам, таким как C#, Visual Basic .NET, Python и др.

Ниже перечислены некоторые фундаментальные принципы .NET-разработки, которые иногда игнорируются или упускаются из виду при создании приложений на JavaScript:

  • ваша кодовая база является управляемой в .NET, поскольку вы четко определяете границы классов и то, где именно эти классы находятся в ваших проектах;
  • вы разделяете обязанности, поэтому у вас нет классов, отвечающих за сотни разных вещей с перекрытием обязанностей;
  • вы располагаете повторно используемыми репозитариями, очередями, сущностями (моделями) и источниками данных;
  • вы тщательно продумываете именование своих классов и файлов, чтобы их названия были более понятными;
  • вы практикуете использование проектировочных шаблонов, соглашений по кодированию и четкую организацию кода.

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

Семь основных этапов создания SPA

Рассмотрим семь основных этапов преобразования нового ASP.NET Web Application, созданного с использованием готового шаблона ASP.NET MVC в Visual Studio 2013, в SPA (со ссылками на соответствующие файлы проекта, которые можно найти в сопутствующем этой статье пакете кода).

  1. Скачайте и установите NuGet-пакеты RequireJS, текстовый плагин RequireJS и Kendo UI Web.
  2. Добавьте модуль конфигурации (Northwind.Web/Scripts/app/main.js).
  3. Добавьте модуль приложения (Northwind.Web/Scripts/app/app.js).
  4. Добавьте модуль маршрутизатора (Northwind.Web/Scripts/app/router.js).
  5. Добавьте действие и представление (оба с именами Spa) (Northwind.Web/Controllers/HomeController.cs и Northwind.Web/Views/Home/Spa.cshtml).
  6. Модифицируйте файл _ViewStart.cshtml, чтобы MVC загружала представления без использования файла _Layout.cshtml по умолчанию (Northwind.Web/Views/_ViewStart.cshtml).
  7. Обновите навигационные ссылки (меню) в разметке, чтобы они соответствовали новым URL, дружественным к SPA (Northwind.Web/Views/Shared/_Layout.cshtml).
  8. После выполнения этих семи этапов структура вашего проекта веб-приложения должна выглядеть, как на Рис. 1.

Структура проекта ASP.NET MVC
Рис. 1. Структура проекта ASP.NET MVC

Я покажу, как создать впечатляющее SPA-приложение в ASP.NET MVC с использованием следующих JavaScript-библиотек, доступных через NuGet.

  • RequireJS (requirejs.org) Это JavaScript-файл и загрузчик модулей. RequireJS предоставляет #include/import/require API и возможность загрузки вложенных зависимостей через механизм встраивания зависимостей (dependency injection, DI). Подход к проектированию в RequireJS базируется на Asynchronous Module Definition (AMD) API для JavaScript-модулей, которые помогают инкапсулировать части кода в полезные блоки. Кроме того, он позволяет ссылаться на другие блоки кода (модули) интуитивно понятным способом. RequireJS-модули также следуют шаблону module (bit.ly/18byc2Q). Упрощенная реализация этого шаблона использует для инкапсуляции JavaScript-функции. Позже вы увидите этот шаблон в действии, когда все JavaScript-модули будут обернуты в функцию define или require. Те, кто знаком с концепциями DI и Inversion of Control (IoC), могут рассматривать эту реализацию как инфраструктуру DI на клиентской стороне. Если на данный момент вам ничего не понятно, не волнуйтесь: вскоре мы изучим некоторые примеры кода, где все это будет иметь смысл.
  • Текстовый плагин для RequireJS (bit.ly/1cd8lTZ) Будет использоваться для удаленной загрузки порций HTML (представлений) в SPA.
  • Entity Framework (bit.ly/1bKiZ9I) Здесь и так все понятно, а поскольку эта статья посвящена SPA, я не стану вдаваться в детали Entity Framework. Однако, если вы новичок в работе с этой инфраструктурой, в вашем распоряжении море документации, доступной в сети.
  • Kendo UI Web (bit.ly/t4VkVp) Это обширная инфраструктура JavaScript/HTML5, которая включает Web UI Widgets, DataSources, шаблоны, шаблон Model-View-ViewModel (MVVM), SPA, применение стилей и многое другое, что поможет вам в создании отзывчивого и адаптивного приложения с впечатляющим UI.

Подготовка инфраструктуры SPA

Чтобы показать, как подготовить инфраструктуру SPA, я сначала поясню, как создать модуль конфигурации RequireJS (Northwind.Web/Scripts/app/main.js). Этот модуль будет стартовой точкой входа в приложение. Если вы создали консольное приложение, можете рассматривать его как точку входа Main в Program.cs. В основном он содержит первый класс и метод, вызываемый при запуске SPA. Файл main.js главным образом служит манифестом SPA и является тем местом, где вы определяете все, что будет в SPA, и их зависимости, если таковые есть. Код для конфигурации RequireJS показан на Рис. 2.

Рис. 2. Конфигурация RequireJS

  1. require.config({
  2.   paths: {
  3.     // Пакеты
  4.     'jquery': '/scripts/jquery-2.0.3.min',
  5.     'kendo': '/scripts/kendo/2013.3.1119/kendo.web.min',
  6.     'text': '/scripts/text',
  7.     'router': '/scripts/app/router'
  8.   },
  9.   shim : {
  10.     'kendo' : ['jquery']
  11.   },
  12.   priority: ['text', 'router', 'app'],
  13.   jquery: '2.0.3',
  14.   waitSeconds: 30
  15. });
  16. require([
  17.   'app'
  18. ], function (app) {
  19.   app.initialize();
  20. });

У вас есть два варианта представлений, которые будут загружаться в SPA: стандартные HTML-страницы (*.html) или страницы ASP.NET MVC Razor (*.cshtml).

На Рис. 2 свойство paths содержит список всех модулей с местами их расположения и именами. Shim - это имя ранее определенного модуля. Свойство shim включает любые зависимости, которые могут быть у модуля. В данном случае вы загружаете модуль kendo, и у него есть зависимость от модуля jquery, поэтому, если какой-то модуль требует модуля kendo, сначала загружайте jQuery.

Код "require([], function(){})" на Рис. 2 загрузит следующий модуль, каковым будет модуль с именем app. Заметьте, что я присваиваю модулям осмысленные имена.

Итак, каким образом ваше SPA узнает, какой модуль следует вызвать первым? Вы настраиваете это на первой посадочной странице (landing page) в SPA с помощью атрибута data-main в теге script со ссылкой на RequireJS. Я указал, что это должен быть модуль main (main.js). RequireJS возьмет на себя всю черновую работу, связанную с загрузкой этого модуля; вы просто сообщаете, какой модуль загружать первым.

У вас есть два варианта представлений, которые будут загружаться в SPA: стандартные HTML-страницы (*.html) или страницы ASP.NET MVC Razor (*.cshtml). Так как эта статья адресована .NET-разработчикам (и во многих организациях есть серверные библиотеки и инфраструктуры, которыми они хотели бы по-прежнему использовать в своих представлениях), я выбираю вариант с созданием Razor-представлений.

Начну с добавления представления и назову его Spa.cshtml, как уже упоминалось. Это представление будет в основном загружать оболочку или весь HTML для разметки SPA. Из этого представления я буду загружать другие представления (например, About.cshtml, Contact.cshtml, Index.cshtml и т. д.) с заменой по мере того, как пользователь будет переходить по SPA; при этом очередное представление заменяет весь HTML в теге div контента.

Создание посадочной страницы SPA (разметки) (Northwind.Web/Views/Spa.cshtml) Поскольку представление Spa.cshtml является посадочной страницей SPA, где вы загружаете все остальные представления, в нем не будет особой разметки, кроме ссылки на необходимые таблицы стилей и RequireJS. Обратите внимание на атрибут data-main в следующем коде, который сообщает RequireJS, какой модуль следует загрузить первым:

  1. @{
  2.   ViewBag.Title = "Spa";
  3.   Layout = "~/Views/Shared/_Layout.cshtml";
  4. }
  5. <link href=
  6.   "~/Content/kendo/2013.3.1119/kendo.common.min.css" 
  7.   rel="stylesheet" />
  8. <link href=
  9.   "~/Content/kendo/2013.3.1119/kendo.bootstrap.min.css" 
  10.   rel="stylesheet" />
  11. <script src=
  12.   "@Url.Content("~/scripts/require.js")"
  13.   data-main="/scripts/app/main"></script>
  14. <div id="app"></div>

Добавление действия для SPA Layout (Northwind.Web/Controllers/HomeController.cs) Чтобы создать и загрузить представление Spa.cshtml, добавьте действие (action) и представление:

  1. public ActionResult Spa()
  2. {
  3.   return View();
  4. }

Создание модуля приложения (Northwind.Web/Scripts/app/app.js) Вот модуль приложения, отвечающий за инициализацию и запуск Kendo UI Router:

  1. define([
  2.     'router'
  3.   ], function (router) {
  4.     var initialize = function() {
  5.       router.start();
  6.     };
  7.     return {
  8.       initialize: initialize
  9.     };
  10.   });

Создание модуля router (Northwind.Web/Scripts/app/router.js) Вызывается модулем app.js. Если вы уже знакомы с маршрутами в ASP.NET MVC, то ничего нового для вас здесь нет. Это маршруты SPA для ваших представлений. Я определю все маршруты для всех SPA-представлений, и, когда пользователь будет переходить по SPA, модуль router в Kendo UI будет знать, какие представления надо загружать в SPA (см. листинг 1 в пакете сопутствующего кода).

Класс Router в Kendo UI отвечает за отслеживание состояния приложения и навигацию между его состояниями. Этот модуль (router) интегрируется в журнал браузера, используя элемент фрагмента в URL (#page), что позволяет создавать закладки и ссылки на состояния приложения. При щелчке маршрутизируемого URL в дело вступает модуль router и сообщает приложению перевести себя обратно в то состояния, которое закодировано в маршруте. Определение маршрута - это строка, представляющая путь для идентификации состояния приложения, которое хочет увидеть пользователь. Когда определение маршрута совпадает с фрагментом хеша URL браузера, вызывается обработчик маршрута (табл. 1).

Табл. 1. Определения зарегистрированных маршрутов и соответствующие URL

Зарегистрированный маршрут (определение) Полный URL (который можно помещать в закладки)
/ localhost:25061/home/spa/home/index
/home/index localhost:25061/home/spa/#/home/index/home/about
/home/about localhost:25061/home/spa/#/home/about/home/contact
/home/contact localhost:25061/home/spa/#/home/contact/customer/index
/customer/index localhost:25061/home/spa/#/customer/index

Что касается виджета разметки Kendo UI, то его название говорит само за себя. По-видимому, вы знакомы с ASP.NET Web Forms MasterPage или MVC-разметкой, включаемой при создании нового проекта ASP.NET MVC Web Application. В проекте SPA разметка помещается в Northwind.Web/Views/Shared/_Layout.cshtml. Разметка в Kendo UI и MVC отличается немного - за исключением того, что разметка Kendo UI выполняется на клиентской стороне. Как и разметка, работающая на серверной стороне, где исполняющая среда MVC заменяет содержимое разметки другими представлениями, разметка в Kendo UI действует точно так же, но на клиентской стороне. Вы выгружаете представление (контент) разметки Kendo UI, используя метод showIn. Содержимое представления (HTML) будет помещаться в div с идентификатором content, который передается в разметку Kendo UI при ее инициализации. После инициализации разметки выполняется ее рендеринг в div с идентификатором app, который является div в посадочной странице (Northwind.Web/Views/Home/Spa.cshtml). Я вкратце опишу это.

Класс Router в Kendo UI отвечает за отслеживание состояния приложения и навигацию между его состояниями.

Вспомогательный метод loadView принимает модель представления, представление и при необходимости обратный вызов, запускаемый, как только происходит связывание представления и модели представления. В методе loadView вы используете библиотеку Kendo UI FX, позволяющую улучшить эстетическое восприятие UI за счет добавления некоторых простых анимаций в процесс замены представлений. Это осуществляется скольжением текущего загруженного представления влево, удаленной загрузкой нового представления и его последующим скольжением обратно в центр. Очевидно, что эту анимацию можно легко заменять на любые другие, используя библиотеку Kendo UI FX. Одно из важнейших преимуществ применения разметки Kendo UI проявляется при вызове метода showIn для выгрузки представлений. Он гарантирует выгрузку представления, его корректное уничтожение и удаление из DOM браузера, что обеспечивает масштабируемость и производительность SPA.

Редактирование представления _ViewStart.cshtml (Northwind.Web/Views/_ViewStart.cshtml) Вот как настроить все представления, чтобы по умолчанию они не использовали разметку ASP.NET MVC:

  1. @{
  2.   Layout = null;
  3. }

К этому моменту SPA должно работать. Щелкнув любую из навигационных ссылок в меню, вы увидите, что текущий контент выгружается через AJAX благодаря модулю router из Kendo UI и RequireJS.

Эти семь этапов, необходимых для преобразования нового ASP.NET Web Application в SPA, не так уж и страшны, не правда ли?

Теперь, когда SPA подготовлено и работает, я займусь тем, что делает большинство разработчиков с такими приложениями, а именно добавлю в него CRUD-функциональность.

Добавление CRUD-функциональности в SPA

Ниже перечислены основные этапы, необходимые для добавления представления сетки Customer в SPA (и связанных файлов кода проекта). Итак, добавьте:

  • MVC-контроллер CustomerController (Northwind.Web/Controllers/CustomerController.cs);
  • контроллер REST OData Customer Web API (Northwind.Web/Api/CustomerController.cs);
  • представление сетки Customer (Northwind.Web/Views/Customer/Index.cshtml);
  • модуль CustomerModel (Northwind.Web/Scripts/app/models/CustomerModel);
  • модуль customerDatasource для сетки Customer (Northwind.Web/Scripts/app/datasources/customerDatasource.js);
  • модуль indexViewModel для сетки Customer (Northwind.Web/Scripts/app/viewModels/indexViewModel.js).

Разметка в Kendo UI и MVC отличается немного - за исключением того, что разметка Kendo UI выполняется на клиентской стороне.

Подготовка структуры решения с помощью Entity Framework На рис. 3 показана структура решения, где выделены три проекта: Northwind.Data (1), Northwind.Entity (2) и Northwind.Web (3). Я вкратце рассмотрю каждый из них наряду с Entity Framework Power Tools.

Рекомендованная структура решения
Рис. 3. Рекомендованная структура решения

  • Northwind.Data Содержит все, что относится к Entity Framework Object-Relational Mapping (ORM), и обеспечивает хранение данных.
  • Northwind.Entity Включает сущности предметной области, состоящие из POCO-классов (Plain Old CLR Object). Здесь находятся все объекты предметной области, ничего не знающие о механизме сохранения.
  • Northwind.Web Содержит ASP.NET MVC 5 Web Application, презентационный уровень, где вы создаете SPA с помощью двух ранее упомянутых библиотек - Kendo UI и RequireJS, и остальной серверный стек: Entity Framework, Web API и OData.
  • Entity Framework Power Tools Чтобы создать все POCO-сущности и сопоставления (модель Database First), я использовал Entity Framework Power Tools от группы Entity Framework (bit.ly/1cdobhk). После генерации кода я лишь скопировал сущности в отдельный проект (Northwind.Entity), чтобы позаботиться о разделении обязанностей.

Примечание SQL-скрипт установки Northwind и резервная копия базы данных включены в пакет сопутствующего кода в папку Northwind.Web/App_Data (bit.ly/1cph5qc).

Теперь, когда решение настроено на доступ к базе данных, напишем MVC-класс CustomerController.cs, который будет обслуживать представления Index и Edit. Поскольку единственная обязанность контроллера - обслуживать HTML-представление для SPA, здесь код будет минимальным.

Создание MVC-контроллера Customer (Northwind.Web/Controllers/CustomerController.cs) Вот как создать контроллер Customer с действиями для представлений Index и Edit:

  1. public class CustomerController : Controller
  2. {
  3.   public ActionResult Index()
  4.   {
  5.     return View();
  6.   }
  7.   public ActionResult Edit()
  8.   {
  9.     return View();
  10.   }
  11. }

Создание представления с сеткой Customers (Northwind.Web/Views/Customers/Index.cshtml) Нарис. 4 показано, как создать представление с сеткой Customers.

Если разметка на Рис. 4 вам не знакома, не паникуйте: это разметка Kendo UI MVVM (HTML). Она просто конфигурирует HTML-элемент, в данном случае - div с идентификатором grid. Позднее, когда вы свяжете это представление с моделью представления, используя инфраструктуру Kendo UI MVVM, эта разметка будет преобразована в виджеты Kendo UI. Подробнее на эту тему см. по ссылкеbit.ly/1d2Bgfj.

Рис. 4. Разметка представления сетки Customer с помощью виджета MVVM и привязки событий

  1. <div class="demo-section">
  2.   <div class="k-content" style="width: 100%">
  3.     <div id="grid"
  4.       data-role="grid"
  5.       data-sortable="true"
  6.       data-pageable="true"
  7.       data-filterable="true"
  8.       data-editable="inline"
  9.       data-selectable="true"
  10.       data-toolbar='[ { template: kendo.template($("#toolbar").html()) } ]'
  11.       data-columns
  12. ='[
  13.         { field: "CustomerID", title: "ID", width: "75px" },
  14.         { field: "CompanyName", title: "Company"},
  15.         { field: "ContactName", title: "Contact" },
  16.         { field: "ContactTitle", title: "Title" },
  17.         { field: "Address" },
  18.         { field: "City" },
  19.         { field: "PostalCode" },
  20.         { field: "Country" },
  21.         { field: "Phone" },
  22.         { field: "Fax" } ]'      data-bind
  23. ="source: dataSource, events:
  24.         { change: onChange, dataBound: onDataBound }">
  25.     </div>
  26.     <style scoped>
  27.     #grid .k-toolbar {
  28.       padding: 15px;
  29.     }
  30.     .toolbar {
  31.       float: right;
  32.     }
  33.     </style>
  34.   </div>
  35. </div>
  36. <script type="text/x-kendo-template" id="toolbar">
  37.   <div>
  38.     <div class="toolbar">
  39.       <span data-role="button" data-bind="click: edit">
  40.         <span class="k-icon k-i-tick"></span>Edit</span>
  41.       <span data-role="button" data-bind="click: destroy">
  42.         <span class="k-icon k-i-tick"></span>Delete</span>
  43.       <span data-role="button" data-bind="click: details">
  44.         <span class="k-icon k-i-tick"></span>Edit Details</span>
  45.     </div>
  46.     <div class="toolbar" style="display:none">
  47.       <span data-role="button" data-bind="click: save">
  48.         <span class="k-icon k-i-tick"></span>Save</span>
  49.       <span data-role="button" data-bind="click: cancel">
  50.         <span class="k-icon k-i-tick"></span>Cancel</span>
  51.     </div>
  52.   </div>
  53. </script>

Создание контроллера Customer MVC (OData) Web API (Northwind.Web/Api/CustomerController.cs) Теперь я покажу, как создать контроллер Customer. OData - это протокол доступа к данным для Web, который предоставляет единообразный способ запроса и манипулирования наборами данных через CRUD-операции. С помощью ASP.NET Web API создать конечную точку OData довольно легко. Вы можете контролировать то, какие OData-операции будут доступны. Вы можете разместить несколько конечных точек OData наряду с конечными точками, не имеющими отношения к OData. Вы получаете полный контроль над своей моделью данных, серверной бизнес-логикой и уровнем данных. Код для контроллера Customer Web API OData приведен на Рис. 5.

Рис. 5. Контроллер Customer Web API OData

  1. public class CustomerController : EntitySetController<Customer, string>
  2. {
  3.   private readonly NorthwindContext _northwindContext;
  4.   public CustomerController()
  5.   {
  6.     _northwindContext = new NorthwindContext();
  7.   }
  8.   public override IQueryable<Customer> Get()
  9.   {
  10.     return _northwindContext.Customers;
  11.   }
  12.   protected override Customer GetEntityByKey(string key)
  13.   {
  14.     return _northwindContext.Customers.Find(key);
  15.   }
  16.   protected override Customer UpdateEntity(string key, Customer update)
  17.   {
  18.     _northwindContext.Customers.AddOrUpdate(update);
  19.     _northwindContext.SaveChanges();
  20.     return update;
  21.   }
  22.   public override void Delete(string key)
  23.   {
  24.     var customer = _northwindContext.Customers.Find(key);
  25.     _northwindContext.Customers.Remove(customer);
  26.     _northwindContext.SaveChanges();
  27.   }
  28. }

Код на Рис. 5 просто создает контроллер OData Web API для предоставления данных Customer из базы данных Northwind. После его создания вы можете запустить проект, а с помощью таких средств, как Fiddler (бесплатный веб-отладчик на fiddler2.com) или LINQPad, можно запрашивать сами данные по клиенту (customer).

Настройка и предоставление OData из таблицы Customer для сетки (Northwind.Web/App_Start/WebApiConfig.cs) На рис. 6 настраивается и предоставляется OData из таблицы Customer для сетки.

Рис. 6. Настройка маршрутов ASP.NET MVC Web API для OData

  1. public static void Register(HttpConfiguration config)
  2. {
  3.   // Конфигурация и сервисы Web API
  4.   ODataModelBuilder modelBuilder = new ODataConventionModelBuilder();
  5.   var customerEntitySetConfiguration =
  6.     modelBuilder.EntitySet<Customer>("Customer");
  7.   customerEntitySetConfiguration.EntityType.Ignore(t => t.Orders);
  8.   customerEntitySetConfiguration.EntityType.Ignore(t =>
  9.      t.CustomerDemographics);
  10.   var model = modelBuilder.GetEdmModel();
  11.   config.Routes.MapODataRoute("ODataRoute", "odata", model);
  12.   config.EnableQuerySupport();
  13.   // Маршруты Web API
  14.   config.MapHttpAttributeRoutes();
  15.   config.Routes.MapHttpRoute(
  16.     "DefaultApi", "api/{controller}/{id}",
  17.     new {id = RouteParameter.Optional});
  18. }

Запросы OData Web API с помощью LINQPad Если вы еще не пользовались LINQPad (linqpad.net), добавьте это средство в свой инструментарий разработки; это необходимый инструмент, доступный в бесплатной версии. На рис. 7 показан LINQPad с подключением к Web API OData (localhost:2501/odata), отображающий результаты LINQ-запроса "Customer.Take (100)".

Запрос контроллера Customer Web API OData через LINQPad
Рис. 7. Запрос контроллера Customer Web API OData через LINQPad

Создание (наблюдаемой) модели Customer (Northwind.Web/Scripts/app/models/customerModel.js) Далее мы создаем модель Customer (Kendo UI Observable). Ее можно считать моделью сущности Customer на клиентской стороне. Я создал такую модель, поэтому ее можно будет повторно использовать в представлениях сетки и редактирования Customer. Код приведен на Рис. 8.

Рис. 8. Создание модели Customer (Kendo UI Observable)

  1. define(['kendo'],
  2.   function (kendo) {
  3.     var customerModel = kendo.data.Model.define({
  4.       id: "CustomerID",
  5.       fields: {
  6.         CustomerID: { type: "string", editable: false, nullable: false },
  7.         CompanyName: { title: "Company", type: "string" },
  8.         ContactName: { title: "Contact", type: "string" },
  9.         ContactTitle: { title: "Title", type: "string" },
  10.         Address: { type: "string" },
  11.         City: { type: "string" },
  12.         PostalCode: { type: "string" },
  13.         Country: { type: "string" },
  14.         Phone: { type: "string" },
  15.         Fax: { type: "string" },
  16.         State: { type: "string" }
  17.       }
  18.     });
  19.     return customerModel;
  20.   });

OData - это протокол доступа к данным для Web, который предоставляет единообразный способ запроса и манипулирования наборами данных через CRUD-операции.

Создание DataSource для сетки Customers (Northwind.Web/Scripts/app/datasources/customersDatasource.js) Если вы знакомы с источниками данных из ASP.NET Web Forms, то знайте, что здесь используется та же концепция, где вы создаете источник данных для сетки Customers (Northwind.Web/Scripts/app/datasources/customersDatasource.js). Компонент Kendo UI DataSource (bit.ly/1d0Ycvd) - это абстракция для использования локальных данных (массивов JavaScript-объектов) или удаленных (XML, JSON или JSONP). Он полностью поддерживает CRUD-операции над данными и предоставляет как локальную, так и серверную поддержку сортировки, разбиения на страницы, фильтрации, группирования и агрегации.

Создание ViewModel для представления сетки Customers Это та же концепция, что и MVVM в Windows Presentation Foundation (WPF) или Silverlight, но на клиентской стороне (находится в этом проекте в Northwind.Web/Scripts/ViewModels/Customer/indexViewModel.cs). MVVM - архитектурный шаблон, отделяющий представление от его данных и бизнес-логики. Вскоре вы увидите, что все данные, бизнес-логика и прочее содержатся в модели представления и что представление является чистым HTML (презентационным уровнем). Код для представления сетки Customer показан на Рис. 9.

Рис. 9. Модель представления сетки Customer

  1. define(['kendo', 'customerDatasource'],
  2.   function (kendo, customerDatasource) {
  3.     var lastSelectedDataItem = null;
  4.     var onClick = function (event, delegate) {
  5.       event.preventDefault();
  6.       var grid = $("#grid").data("kendoGrid");
  7.       var selectedRow = grid.select();
  8.       var dataItem = grid.dataItem(selectedRow);
  9.       if (selectedRow.length > 0)
  10.         delegate(grid, selectedRow, dataItem);
  11.       else
  12.         alert("Please select a row.");
  13.       };
  14.       var indexViewModel = new kendo.data.ObservableObject({
  15.         save: function (event) {
  16.           onClick(event, function (grid) {
  17.             grid.saveRow();
  18.             $(".toolbar").toggle();
  19.           });
  20.         },
  21.         cancel: function (event) {
  22.           onClick(event, function (grid) {
  23.             grid.cancelRow();
  24.             $(".toolbar").toggle();
  25.           });
  26.         },
  27.         details: function (event) {
  28.           onClick(event, function (grid, row, dataItem) {
  29.             router.navigate('/customer/edit/' + dataItem.CustomerID);
  30.           });
  31.         },
  32.         edit: function (event) {
  33.           onClick(event, function (grid, row) {
  34.             grid.editRow(row);
  35.             $(".toolbar").toggle();
  36.           });
  37.         },
  38.         destroy: function (event) {
  39.           onClick(event, function (grid, row, dataItem) {
  40.             grid.dataSource.remove(dataItem);
  41.             grid.dataSource.sync();
  42.           });
  43.         },
  44.         onChange: function (arg) {
  45.           var grid = arg.sender;
  46.           lastSelectedDataItem = grid.dataItem(grid.select());
  47.         },
  48.         dataSource: customerDatasource,
  49.         onDataBound: function (arg) {
  50.           // Проверяем, выбрана ли строка
  51.           if (lastSelectedDataItem == null) return;
  52.           // Получаем все строки
  53.           var view = this.dataSource.view();
  54.           // Перебираем строки в цикле
  55.           for (var i = 0; i < view.length; i++) {
  56.           // Находим строку с lastSelectedProduct
  57.             if (view[i].CustomerID == lastSelectedDataItem.CustomerID) {
  58.               // Получаем сетку
  59.               var grid = arg.sender;
  60.               // Задаем выбранную строку
  61.               grid.select(grid.table.find("tr[data-uid='" + view[i].uid + "']"));
  62.               break;
  63.             }
  64.           }
  65.         },
  66.       });
  67.       return indexViewModel;
  68.   });

Я кратко опишу различные компоненты кода на рис. 9.

  • onClick (вспомогательный метод) Этот метод является вспомогательной функцией, которая получает экземпляр сетки Customer, текущую выбранную строку и JSON-модель представления Customer для выбранной строки.
  • save Сохраняет изменения при построчном редактировании Customer.
  • cancel Отменяет режим построчного редактирования.
  • details Переключает SPA на представление редактирования Customer, дописывая идентификатор Customer к URL.
  • edit Активирует построчное редактирование для текущего выбранного Customer.
  • destroy Удаляет текущий выбранный Customer.
  • onChange (событие) Срабатывает при каждом выборе Customer. Вы сохраняете последний выбранный Customer, чтобы можно было поддерживать состояние. После выполнения любых обновлений или ухода из сетки Customer вы вновь выделяете последний выбранный Customer, если возвращаетесь в сетку.

Теперь добавьте модули customerModel, indexViewModel и customersDatasource в свою конфигурацию RequireJS (Northwind.Web/Scripts/app/main.js). Код показан на рис. 10.

Рис. 10. Добавления в конфигурацию RequireJS

  1. paths: {
  2.   // Пакеты
  3.   'jquery': '/scripts/jquery-2.0.3.min',
  4.   'kendo': '/scripts/kendo/2013.3.1119/kendo.web.min',
  5.   'text': '/scripts/text',
  6.   'router': '/scripts/app/router',
  7.   // Модели
  8.   'customerModel': '/scripts/app/models/customerModel',
  9.   // Модели представления
  10.   'customer-indexViewModel': '/scripts/app/viewmodels/customer/indexViewModel',
  11.   'customer-editViewModel': '/scripts/app/viewmodels/customer/editViewModel',
  12.   // Источники данных
  13.   'customerDatasource': '/scripts/app/datasources/customerDatasource',
  14.   // Вспомогательные методы
  15.   'util': '/scripts/util'
  16. }

Добавление маршрута для нового представления сетки Customers Заметьте, что в обратном вызове loadView (в Northwind.Web/Scripts/app/router.js) вы связываете панель инструментов сетки после ее инициализации и выполнения MVVM-привязки. Дело в том, что при первом связывании сетки панель инструментов не инициализируется, поскольку она уже существует в сетке. При первой инициализации сетки через MVVM она будет загружать панель инструментов из шаблона Kendo UI. После ее загрузки в сетку вы связываете панель инструментов только со своей моделью представления, чтобы кнопки на панели инструментов были связаны с методами save и cancel в вашей модели представления. Вот как выглядит код, регистрирующий определение маршрута для представления редактирования Customer:

  1. router.route("/customer/index", function () {
  2.   require(['customer-indexViewModel', 'text!/customer/index'],
  3.     function (viewModel, view) {
  4.       loadView(viewModel, view, function () {
  5.         kendo.bind($("#grid").find(".k-grid-toolbar"), viewModel);
  6.       });
  7.     });
  8. });

Теперь у вас есть полнофункциональное представление сетки Customers. Загрузите localhost:25061/Home/Spa#/customer/index (номер порта на вашем компьютере скорее всего будет другим) в браузер и вы увидите то, что показано на рис. 11.

Представление сетки Customers, где MVVM использует ViewModel с именем index
Рис. 11. Представление сетки Customers, где MVVM использует ViewModel с именем index

Подключение представления редактирования Customer Основные этапы добавления представления редактирования Customer в SPA:

  • создайте представление редактирования клиента, связанное с вашей моделью Customer через MVVM (Northwind.Web/Views/Customer/Edit.cshtml);
  • добавьте модуль модели представления редактирования для этого представления Customer (Northwind.Web/Scripts/app/viewModels/editViewModel.js);
  • добавьте вспомогательный модуль, чтобы получать идентификаторы из URL (Northwind.Web/Scripts/app/util.js).

Поскольку вы используете инфраструктуру Kendo UI, примените стили Kendo UI к своему представлению редактирования. Узнать больше на эту тему можно по ссылке bit.ly/1f3zWuC. На Рис. 12 показана разметка представления редактирования с помощью виджета MVVM и связывания с событиями.

Рис. 12. Разметка представления редактирования с помощью виджета MVVM Widget и связывания с событиями

  1. <div class="demo-section">
  2.   <div class="k-block" style="padding: 20px">
  3.     <div class="k-block k-info-colored">
  4.       <strong>Note: </strong>Please fill out all of the fields in this form.
  5.     </div>
  6.     <div>
  7.       <dl>
  8.         <dt>
  9.           <label for="companyName">Company Name:</label>
  10.         </dt>
  11.         <dd>
  12.           <input id="companyName" type="text"
  13.             data-bind="value: Customer.CompanyName" class="k-textbox" />
  14.         </dd>
  15.         <dt>
  16.           <label for="contactName">Contact:</label>
  17.         </dt>
  18.         <dd>
  19.           <input id="contactName" type="text"
  20.             data-bind="value: Customer.ContactName" class="k-textbox" />
  21.         </dd>
  22.         <dt>
  23.           <label for="title">Title:</label>
  24.         </dt>
  25.         <dd>
  26.           <input id="title" type="text"
  27.             data-bind="value: Customer.ContactTitle" class="k-textbox" />
  28.         </dd>
  29.         <dt>
  30.           <label for="address">Address:</label>
  31.         </dt>
  32.         <dd>
  33.           <input id="address" type="text"
  34.             data-bind="value: Customer.Address" class="k-textbox" />
  35.         </dd>
  36.         <dt>
  37.           <label for="city">City:</label>
  38.         </dt>
  39.         <dd>
  40.           <input id="city" type="text"
  41.             data-bind="value: Customer.City" class="k-textbox" />
  42.         </dd>
  43.         <dt>
  44.           <label for="zip">Zip:</label>
  45.         </dt>
  46.         <dd>
  47.           <input id="zip" type="text"
  48.             data-bind="value: Customer.PostalCode" class="k-textbox" />
  49.         </dd>
  50.         <dt>
  51.           <label for="country">Country:</label>
  52.         </dt>
  53.         <dd>
  54.           <input id="country" type="text"
  55.           data-bind="value: Customer.Country" class="k-textbox" />
  56.         </dd>
  57.         <dt>
  58.           <label for="phone">Phone:</label>
  59.         </dt>
  60.         <dd>
  61.           <input id="phone" type="text"
  62.             data-bind="value: Customer.Phone" class="k-textbox" />
  63.         </dd>
  64.         <dt>
  65.           <label for="fax">Fax:</label>
  66.         </dt>
  67.         <dd>
  68.           <input id="fax" type="text"
  69.             data-bind="value: Customer.Fax" class="k-textbox" />
  70.         </dd>
  71.       </dl>
  72.       <button data-role="button"
  73.         data-bind="click: saveCustomer"
  74.         data-sprite-css-class="k-icon k-i-tick">Save</button>
  75.       <button data-role="button" data-bind="click: cancel">Cancel</button>
  76.       <style scoped>
  77.         dd
  78.         {
  79.           margin: 0px 0px 20px 0px;
  80.           width: 100%;
  81.         }
  82.         label
  83.         {
  84.           font-size: small;
  85.           font-weight: normal;
  86.         }
  87.         .k-textbox
  88.         {
  89.           width: 100%;
  90.         }
  91.         .k-info-colored
  92.         {
  93.           padding: 10px;
  94.           margin: 10px;
  95.         }
  96.       </style>
  97.     </div>
  98.   </div>
  99. </div>

Создание модуля util для получения идентификатора Customer из URL  Поскольку вы создаете модули с четкими границами, чтобы добиться хорошего разделения обязанностей, я продемонстрирую, как создать модуль util, где будут находиться все ваши вспомогательные функции (методы). Начну с метода, который может извлекать идентификатор клиента из URL для Customer DataSource (Northwind.Web/Scripts/app/datasources/customerDatasource.js), как показано на рис. 13.

Рис. 13. Модуль util

  1. define([],
  2.   function () {
  3.     var util;
  4.     util = {
  5.       getId:
  6.       function () {
  7.         var array = window.location.href.split('/');
  8.         var id = array[array.length - 1];
  9.         return id;
  10.       }
  11.     };
  12.     return util;
  13.   });

Добавление модели представления edit и модулей util в конфигурацию RequireJS (Northwind.Web/Scripts/app/main.js) Код на рис. 14 показывает добавления в конфигурацию RequireJS для модулей редактирования Customer.

Рис. 14. Добавления в конфигурацию RequireJS для модулей редактирования Customer

  1. require.config({
  2.   paths: {
  3.     // Пакеты
  4.     'jquery': '/scripts/jquery-2.0.3.min',
  5.     'kendo': '/scripts/kendo/2013.3.1119/kendo.web.min',
  6.     'text': '/scripts/text',
  7.     'router': '/scripts/app/router',
  8.     // Модели
  9.     'customerModel': '/scripts/app/models/customerModel',
  10.     // Модели представлений
  11.     'customer-indexViewModel': '/scripts/app/viewmodels/customer/indexViewModel',
  12.     'customer-editViewModel': '/scripts/app/viewmodels/customer/editViewModel',
  13.     // Источники данных
  14.     'customerDatasource': '/scripts/app/datasources/customerDatasource',
  15.     // Вспомогательные методы
  16.     'util': '/scripts/util'
  17.     },
  18.   shim : {
  19.     'kendo' : ['jquery']
  20.   },
  21.   priority: ['text', 'router', 'app'],
  22.   jquery: '2.0.3',
  23.   waitSeconds: 30
  24.   });
  25. require([
  26.   'app'
  27. ], function (app) {
  28.   app.initialize();
  29. });

Добавление модели представления для редактирования Customer (Northwind.Web/Scripts/app/viewModels/editViewModel.js) Код на рис. 15 демонстрирует, как добавить модель представления для редактирования Customer.

Рис. 15. Модуль модели представления для редактирования Customer

  1. define(['customerDatasource', 'customerModel', 'util'],
  2.   function (customerDatasource, customerModel, util) {
  3.     var editViewModel = new kendo.data.ObservableObject({
  4.       loadData: function () {
  5.         var viewModel = new kendo.data.ObservableObject({
  6.           saveCustomer: function (s) {
  7.             customerDatasource.sync();
  8.             customerDatasource.filter({});
  9.             router.navigate('/customer/index');
  10.           },
  11.           cancel: function (s) {
  12.             customerDatasource.filter({});
  13.             router.navigate('/customer/index');
  14.           }
  15.         });
  16.         customerDatasource.filter({
  17.           field: "CustomerID",
  18.           operator: "equals",
  19.           value: util.getId()
  20.         });
  21.         customerDatasource.fetch(function () {
  22.           console.log('editViewModel fetching');
  23.           if (customerDatasource.view().length > 0) {
  24.             viewModel.set("Customer", customerDatasource.at(0));
  25.           } else
  26.             viewModel.set("Customer", new customerModel());
  27.         });
  28.         return viewModel;
  29.       },
  30.     });
  31.     return editViewModel;
  32.   });

Я кратко опишу различные компоненты кода на рис. 15.

  • saveCustomer Этот метод отвечает за сохранение любых изменений в Customer. Кроме того, он сбрасывает фильтр DataSource, чтобы сетка снова заполнялась всеми Customer.
  • cancel Этот метод выполняет переход в SPA обратно в представление сетки Customers. Кроме того, он сбрасывает фильтр DataSource, чтобы сетка снова заполнялась всеми Customer.
  • filter Вызывает метод фильтра DataSource и запрашивает конкретный Customer по идентификатору в URL.
  • fetch Вызывает метод fetch объекта DataSource после настройки фильтра. В обратном вызове fetch вы записываете в свойство Customer своей модели представления тот Customer, который был возвращен методом fetch объекта DataSource и который будет использоваться для связывания с вашим представлением редактирования Customer.

Когда RequireJS загружает какой-то модуль, код в теле метода define будет вызван только раз, поэтому вы предоставляете некий метод (loadData) в своей модели представления редактирования, чтобы иметь механизм загрузки данных после того, как модуль модели представления редактирования уже загружен (это можно увидеть в Northwind.Web/Scripts/app/router.js).

Добавление маршрута для нового представления редактирования Customer (Northwind.Web/Scripts/app/router.js) Вот как добавляется маршрут:

  1. router.route("/customer/edit/:id",
  2.         function () {
  3.     require(['customer-editViewModel',
  4.           'text!/customer/edit'],
  5.       function (viewModel, view) {
  6.       loadView(viewModel.loadData(), view);
  7.     });
  8.   });

Заметьте: когда модель представления редактирования Customer запрашивается от RequireJS, вы можете извлечь Customer, вызвав метод loadData из этой модели представления. Это позволяет загружать корректные данные Customer по идентификатору в URL всякий раз, когда загружается представление редактирования Customer. Маршрут не обязательно "зашивать" в код как строку. Кроме того, он может содержать параметры, такие как серверный маршрутизатор (Ruby on Rails, ASP.NET MVC, Django и др.). Для этого укажите в сегменте маршрута двоеточие перед именем нужной переменной.

Теперь вы можете загрузить представление редактирования Customer в браузер (localhost:25061/Home/Spa#/customer/edit/ANATR) и увидеть экран, как на рис. 16.

Представление редактирования Customer
Рис. 16. Представление редактирования Customer

Примечание Хотя функциональность delete в представлении сетки Customer была подключена, при щелчке кнопки Delete на панели инструментов (рис. 17) появится исключение, показанное на Рис. 18.

Представление сетки Customer
Рис. 17. Представление сетки Customer

Ожидаемое исключение при удалении Customer из-за ссылочной целостности внешнего ключа CustomerID
Рис. 18. Ожидаемое исключение при удалении Customer из-за ссылочной целостности внешнего ключа CustomerID

Это исключение так и задумано, поскольку большинство идентификаторов Customer являются внешними ключами в других таблицах, например Orders, Invoices и т. д. Вы должны были бы подключить каскадное удаление, которое удаляло бы все записи изо всех таблиц, где данный Customer ID является внешним ключом. И хотя вы не в состоянии удалить что-либо, я все же хотел показать этапы создания функциональности удаления и ее код.

Ну, вот и все. Я продемонстрировал, как легко и быстро преобразовывать готовое ASP.NET Web Application в SPA с помощью RequireJS и Kendo UI. Затем я показал, насколько легко добавить CRUD-подобную функциональность в SPA.

Вы можете увидеть активную демонстрацию этого проекта по ссылке bit.ly/1bkMAlK и скачать код с сайта проектов CodePlex на easyspa.codeplex.com.

Удачи в кодировании!

Лонг Ле  (Long Le) - главный архитектор .NET-разработок в CBRE Inc. и обладатель звания Telerik/Kendo UI MVP. Большую часть времени занимается разработкой инфраструктур и блоков приложений, руководит внедрением передового опыта и шаблонов, а также отвечает за стандартизацию корпоративного стека технологий. Более десяти лет работает с технологиями Microsoft. В свободное время ведет блог (blog.longle.net) и играет в Call of Duty. Также следите за его заметками в twitter.com/LeLong37.

Выражаю благодарность за рецензирование статьи экспертам Дерику Бэйли (Derick Bailey) из Telerik и Майку Уоссону (Mike Wasson) из Microsoft.



 Распечатать »
 Правила публикации »
  Написать редактору 
 Рекомендовать » Дата публикации: 28.04.2014 
 

Магазин программного обеспечения   WWW.ITSHOP.RU
Microsoft Office 365 Профессиональный Плюс. Подписка на 1 рабочее место на 1 год
Microsoft Office для дома и учебы 2019 (лицензия ESD)
Microsoft 365 Apps for business (corporate)
Microsoft Windows Professional 10, Электронный ключ
Microsoft Office 365 Бизнес. Подписка на 1 рабочее место на 1 год
 
Другие предложения...
 
Курсы обучения   WWW.ITSHOP.RU
 
Другие предложения...
 
Магазин сертификационных экзаменов   WWW.ITSHOP.RU
 
Другие предложения...
 
3D Принтеры | 3D Печать   WWW.ITSHOP.RU
 
Другие предложения...
 
Новости по теме
 
Рассылки Subscribe.ru
Информационные технологии: CASE, RAD, ERP, OLAP
Безопасность компьютерных сетей и защита информации
Новости ITShop.ru - ПО, книги, документация, курсы обучения
Программирование на Microsoft Access
CASE-технологии
Утиль - лучший бесплатный софт для Windows
Каждый день новые драйверы для вашего компьютера!
 
Статьи по теме
 
Новинки каталога Download
 
Исходники
 
Документация
 
 



    
rambler's top100 Rambler's Top100