Razor - новый движок представлений в ASP.NET

воскресенье, 4 июля 2010, Евгений Жарков

MRK37G

Одним из проектов, над которым работала моя команда, был новый движок представления для ASP.NET.

ASP.NET MVC всегда поддерживал концепцию “движка представлений”, собственно он представляет из себя заменяемые модули, которые реализуют выбор различного синтаксиса шаблона. Сегодня, стандартный движок представлений для ASP.NET MVC использует аналогичные файлы, что и ASP.NET Web Forms - .aspx/.ascx/.master. Существуют и другие популярные ASP.NET MVC движки представлений - Spark и NHaml.

Новый движок представлений, над которым мы работаем, оптимизирован под генерацию HTML-кода, фокусируясь на коде шаблона. Кодовое имя для данного движка – “Razor”, первая бета-версия будет доступна уже скоро.

Цели разработки

Во время того, как мы разрабатывали прототип и оценивали Razor, мы выделили несколько основных целей:

  • Компактный, Выразительный и Гибкий: Razor уменьшает “нагрузку на клавиатуру”, требуемую для работы в файле, предоставляет быстрый и гибкий процесс программирования. В отличии от большинства синтаксиса шаблонов, вам не нужно прерывать написание кода, чтобы явно определить серверные блоки кода в HTML. Парсер достаточно умен, для того чтобы сделать это за вас, основываясь на коде. Вы получаете компактный и выразительный синтаксис, который легко и весело набирать.
  • Легко освоить: Razor прост в освоении и позволяет вам за короткий срок стать более продуктивным с минимальным количеством усилий. Вы используете все существующие навыки языка программирования и HTML.
  • Не новый язык: Мы сознательно выбрали путь, который не основывается на новом императивном языке для Razor. Вместо этого, мы позволили разработчикам использовать уже существующие навыки работы с C#/VB(или другим языком) и предоставили синтаксис разметки шаблона, который дает вам потрясающий процесс построения HTML, оставляя выбор языка за вами.
  • Работает в любом текстовом редакторе: Razor не требует определенного инструмента и позволяет вам быть продуктивным в любом старом текстовом редакторе (даже в блокноте прекрасно работает)
  • Поддержка Intellisense: Не смотря на то, что Razor разрабатывался с учетом отсутствия привязки к определенному инструменту или редактору кода, у него будет отличная поддержка в Visual Studio. Visual Studio 2010 и Visual Web Developer 2010 скоро получат обновления для intellisense.
  • Юнит-тестирование: Новая реализация движка будет поддерживать возможность производить юнит-тесты над представлениями (не требуя контроллера или веб-сервера, можно размещать в любом проекте юнит-тестирования –отсутствует  нужда в специальных доменах приложений)

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

Выбор и Гибкость

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

Со следующей версией у ASP.NET MVC появится новое диалоговое окно “Add->View”, которое позволит вам выбрать синтаксис для нового файла шаблона представления. Оно позволит вам легко выбирать любой доступный движок представления, установленный на локальной машине:

AddView9

Razor будет присутствовать в списке, так как он будет интегрирован непосредственно в ASP.NET MVC. Все вспомогательные методы и модели будут доступны, как в Razor, так и в .ASPX движках представлений.

У вас будет возможность сочетать и сравнивать шаблоны представлений, написанные с использованием различных движков в рамках одного приложения или сайта. Например, вы можете создать одни представления, используя .aspx, другие с .cshtml или .vbhtml (расширения Razor файлов, для C# и VB соответственно), третьи со Spark или NHaml. Мало того, у вас может быть шаблон представления на одном движке, используя частичное представление, написанное на другом движке. Вы капитан и выбираете то, что вам нужно.

Hello World и Razor

Razor позволяет вам начать со статического HTML (или любого текстового содержимого), далее делая его динамическим, добавляя серверный код. Одна из основных целей проектирования Razor’a, была предоставить гибкий процесс кодирования и позволить быстро интегрировать серверный код в HTML-разметку с минимумом усилий.

Чтобы увидеть простой пример, давайте создадим “hello world” пример и выведем следующее сообщение:

image

Как это выглядит при использовании .ASPX кода

Если мы собираемся построить, представленный выше “hello world” пример, используя ASP.NET и существующую разметку синтаксиса .ASPX, нам потребуется использовать <%= %> блоки, для определения областей кода внутри HTML-разметки:

image

Хотелось бы поделится одним наблюдением для данного примера – каждая область кода, требует 5 символов (<%= %>) для начала и конца последовательности кода. Некоторые из данных символов (в особенности клавиша %, которая на большинстве клавиатур располагается в верхней центральной части) не совсем просто набирать.

Как это выглядит с Razor синтаксисом

Обратите внимание на начало области кода в Razor, где используется символ @. В отличии от <% %>, Razor не требует от вас явно закрывать область кода:

image

Парсер Razor умеет семантически анализировать C#/VB в  областях кода, вот почему нам не нужно явно закрывать блок кода выше. Razor может определить выше указанные утверждения, как самостоятельные области кода и неявно закрыть их для нас.

Даже в таком тривиальном “hello world” примере мы уберегли себя от 12 лишний нажатий клавиш, которые нам пришлось бы делать раньше. Набрать символ @ на клавиатуре гораздо проще, чем символ %.

Циклы и вложенный HTML

Давайте рассмотрим другой случай, когда вам нужно вывести список продуктов (и цену напротив каждого):

image

Создаем пример с .ASPX

Если мы собираемся реализовать пример, используя ASP.NET и существующую разметку синтаксиса .ASPX, нам потребуется код, который будет динамически генерировать

    список с элементами
  • для каждого продукта:

    image

    Создаем пример с Razor

    Ниже я покажу, как сгенерировать эквивалентное представление, используя Razor:

    image

    Обратите внимание, как мы начали цикл foreach, используя символ @, а далее разместили строку HTML содержимого с блоками кода внутри. Так как парсер Raptor понимает семантику C# в наших блоках, он может определить, что содержимое

  • должно быть внутри foreach и рассматривает его, как содержимое, которое должно быть зациклено. Он также распознает закрывающую } и останавливает foreach.

    Razor так же достаточно умен, чтобы распознать @p.Name и @p.Price выражения внутри элемента

  • , как серверный код и выполнить его для каждого прохода цикла. Обратите внимание, Razor автоматически закрывает области кода @p.Name и @p.Price основываясь на совместном использовании HTML и кода.

    Возможность писать код таким образом, не требуя добавлять множество открывающих и закрывающих меток по всему шаблону делает весь процесс разработки реально быстрым.

    Блоки if и многострочные выражения

    Ниже представлено несколько примеров распространенных ситуаций:

    If выражения

    Как и в foreach примере, вы можете располагать содержимое внутри if выражений (или других языковых структур C# или VB), при этом явно не указывая начало/конец областей кода. Например:

    image

    Многострочные выражения

    Вы можете обозначать несколько строчек кода обвернув их в блок @{ код } следующим образом:

    image

    Обратите внимание, что переменные могут быть разбиты на несколько серверных блоков кода, переменная “message” объявлена в многострочном блоке @{ }, а также использована в блоке кода @message. Точно так же, как и в синтаксисе .aspx файлах <% %> и <%= %>.

    Комплексные выражения

    Синтаксис @( ) позволяет размещать комплексные выражения. Например, мы можем переписать выше указанный код для конкатенации строки и числа вместе, внутри блока @ ( код ):

    image

    Интеграция содержимого и кода

    Парсер Razor знает множество особенностей языка, позволяя полностью доверится ему, а не проводить время за собственной реализацией.

    Конфликтует ли он с email-адресами и другими местами использования @ в HTML?

    Парсер Razor достаточно умен, чтобы в большинстве случаев определить, используется ли символ @ в коде или в статическом содержимом. Например, ниже я используя символ @, как часть email-адреса:

    image

    Во время парсинга файла, Razor анализирует содержимое справа от символа @ и пытается определить, является ли эта часть C# кодом (если это CSHTML файл)  или VB (если это VBHTML файл), или же это статические данные. Приведенный выше код, выведет следующий HTML (где email-адрес выведется, как статическое содержимое, а @DateTime.Now определится, как код):

    image

    В случае, где содержимое валидно, как код, а вы хотите вывести его как статическое, достаточно явно указать два символа @@ вместо одного.

    Определение вложенного содержимого

    Размещая HTML-содержимое внутри if/else, foreach или других блочных выражений, следует обвернуть внутреннее содержимое HTML или XML элементов для лучшего определения начала области содержимого.

    Например, ниже, я обвернул многострочный блок содержимого (который включает в себя фигурные скобки) в тег :

    image

    Это сгенерирует следующий код для клиента, включая элемент :

    image

    По желанию, вы можете обвернуть вложенное содержимое в блок в случаях, когда ваши данные должны сгенерироваться для клиента без тега обвертки:

    image

    Данный код сгенерирует ниже представленное содержимое для клиента, обратите внимание – никаких обворачивающих тегов:

    image

    Кодирование HTML

    По умолчанию содержимое, использующее блок @ автоматически HTML-кодированно для улучшенной защиты против XSS атак.

    Макет/MasterPage - Основы

    Очень важно иметь единообразный вид на всех страницах вашего веб-сайта или приложения. ASP.NET 2.0 представил концепцию “мастер страниц”, которые могут помочь добиться данного результата, когда используем .aspx страницы или шаблоны. Razor так же поддерживает данную концепцию, используя “layout pages”(страницы макета), которые позволяют вам определять шаблон сайта, а далее наследовать от него представления/страницы.

    Простейший пример макета

    Ниже представлен простой пример страницы макета, которое мы сохраним под названием “SiteLayout.cshtml”. Он может содержать любой статический HTML, а также любой динамический серверный код. Далее добавим вызов вспомогательного метода “RenderBody()” в том месте, где мы хотим вывести определённое тело содержимого для запрашиваемого URL:

    image

    Далее мы можем создать шаблон представления, назвав его “Home.cshtml”, которое содержит только нужный код или содержимое для построения определенного тела запрашиваемой страницы и основывается на шаблоне макета:

    image

    Заметьте, как вы явно задали свойство “LayoutPage” в коде нашего Home.cshtml файла. Это означает, что мы хотим использовать шаблон SiteLayout.cshtml, как макет для данного представления. Мы можем так же задать файл макета непосредственно в контроллере ASP.NET MVC, указывая Home.cshtml, как шаблон представления или же настроив его стандартным макетом для сайта (в данном случае мы определяем его в одном файле проекта и все шаблоны представлений подхватывают его автоматически)

    Когда мы сгенерируем Home.cshtml, как шаблон представления, он объединит содержимое макета и под-страницы, и отошлет содержимое клиенту:

    image

    Компактный, чистый и выразительный код

    Хотелось бы обратить внимание на код выше и заметить, что определение макета и его использование из представлений/страниц имеет маленький размер. Код на скриншоте содержит все содержимое SiteLayout.cshtml и Home.cshtml файлов, нет никаких дополнительных настроек или тегов, нет префикса %@Page % и другой различной разметки или заданных свойств.

    Мы стараемся держать код, который вы пишете, в наиболее компактном и простом виде. Мы также хотим позволить любому открывать файлы в сторонних текстовых редактора и изменять код. Не требуется никакой дополнительной генерации кода или intellisense.

    Макет/MasterPage – Добавляем заменяемые части

    Макет страниц поддерживает возможность определять внутри различные “секции”, которые могут изменять представления собственным содержимым. Это позволяет вам с легкостью изменять/заполнять прерывающиеся секции содержимого на странице макета и предоставляет гибкость макета для вашего сайта.

    Например, мы можем вернуться к нашему SiteLayout.cshtml и определить две секции внутри макета, которые могут изменять представления. Назовем эти части “menu” и “footer” и укажем, что заполнять из необязательно, передав параметр optional=true помощнику RenderSection() (делаем мы это, используя новые необязательные параметры в C#, о которых я уже рассказывал)

    image

    Так как две секции помечены, как “optional”, я не обязан определять их в моем Home.cshtml файле. Мой сайт продолжает прекрасно работать, даже если их там нет.

    Давайте вернемся обратно в Home.cshtml и объявим собственные части Menu и Footer. Скриншот ниже, содержит весь код Home.cshtml, больше ничего не потребуется. Однако, я перенес настройки LayoutPage на глобальный уровень, так что их здесь больше нет.

    image

    Наши собственные секции перезаписывают “menu” и “footer” с помощью объявленных в файле блоков @section. Мы решили не требовать обвертывать содержимое “main/body” внутри секции, а вместо этого просто оставить её в строковом виде (это позволяет сократить количество нажатий и позволит с легкостью добавлять секции на страница макета, не требуя пробегаться по всем страницам изменяя их синтаксис)

    Когда мы снова сгенерируем Home.cshtml как шаблон представления, он объединит содержание макета и под-страницы, интегрируя две новых части страницы и вернет клиенту следующее:

    image

    Инкапсуляция и повторное использование HTML-помощников

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

    Программные HTML-помощники

    Сегодня у ASP.NET MVC в наличии есть вспомогательные методы, которые можно вызвать в блоках кода и которые инкапсулируют генерацию HTML. И реализованы они только в виде кода (чаще всего, как методы расширений). Все существующие методы расширения HTML, созданные с ASP.NET MVC, будут так же работать при использовании “Razor”:

    image

    Декларативные HTML-помощники

    Генерация HTML на основе одного класса кода работает, но не является идеальной.

    Одной из возможностей в Razor является простой путь для создания повторно используемых HTML-помощников, используя более декларативный подход. Наш план заключается в том, чтобы дать вам возможность объявлять повторно используемые помощники с помощью декларативного синтаксиса @helper { }, как показано ниже.

    image

    Вы сможете размещать .cshtml файлы, которые содержат данные помощники в директории Views\Helpers и в последствии заново использовать их в любом представлении или странице на вашем сайте (никаких дополнительных действий не потребуется):

    image

    Обратите внимание, как помощник ProductListing() определяет аргументы и параметры. Вы можете передавать любые параметры, какие захотите (включая необязательные параметры, типы допускающие значения NULL, генерики и т.п.). Вы так же сможете отлаживать данный код в Visual Studio.

    Важно: @helper синтаксис не будет доступен в первой бета-версии Razor, мы надеемся он будет доступен в следующих версиях. Вспомогательные методы оформленные в виде кода, будут работать сразу.

    Передача строковых шаблонов, как параметров

    Другая полезная (и нереально мощная) возможность, которую мы предоставляем с Razor – это возможность передавать “строковые шаблонные” параметры во вспомогательные методы. Данные “строковые шаблоны” могут содержать в себе, как HTML, так и код, и могут быть вызваны по требованию вспомогательного метода.

    Ниже вы видите пример данной функциональности в действии, я использую HTML-помощник “Grid”, который генерирует DataGrid для клиента:

    image

    Вызов метода Grid.Render – это C#. Мы используем новые именуемые параметры в C# для передачи строго типизированных аргументов в метод Grid.Render, данная возможность дает нам полное завершение выражений с instellisense и проверку во время компиляции.

    Параметр “format”, который мы передаем, когда объявляем столбец, является “строчным шаблоном”, он содержит и html и код, мы также можем настроить под себя формат данных.  А самое прекрасное – это что помощник Grid’a может вызывать наш строчный шаблон, как метод делегата, и может вызывать его, когда нужно и сколько раз хочет. В данном случае он будет вызывать каждый раз, когда он генерирует строку грида и передает в “элемент”, который может использовать наш шаблон для отображения результата.

    Данная возможность позволит разрабатывать более мощные HTML-вспомогательные методы. Вы сможете реализовывать их, как в коде (так вы это делаете сегодня), так и используя декларативный подход @helper{ }.

    Поддержка в Visual Studio

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

    Не смотря на это, мы спроектировали Razor таким образом, чтобы вы смогли получить все удобства редактирования кода в Visual Studio. Мы предоставим полную поддержку HTML, JavaScript и C#/VB кода в intellisense в Razor-файлах:

    image

    Обратите внимание, каким образом отработал intellisense для объекта Product на “@p.”, внутри элемента

  • . Заметьте, в Solution Explorer в папке \Views присутствуют оба шаблона представлений .aspx и .cshtml. Вы можете использовать различные движки представлений в одном приложении, давая возможность прочувствовать, какой синтаксис вам по душе.

    Выводы

    Мы думаем “Razor” предоставляет новый изящный движок представлений для ориентированных на код шаблонов. Процесс программирования станет быстрым и веселым. Синтаксис является компактным и уменьшает количество нажатий клавиш, в то же время улучшая читабельность вашей разметки и кода. В следующей версии ASP.NET MVC движок будет встроен в систему. Вы сможете удалить файлы .cshtml/.vbhtml в своем приложении и запустить их, как отдельные страницы, что также позволяет вам использовать их в ASP.NET Web Forms приложениях.

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

    Источник – Scott Gu


Ищите нас в интернетах!

Комментарии

Свежие вакансии