Программный продукт «QP8.Framework» (стр. 15 )

<DynamicResourceDictionaryContainer xmlns="http:///validation"

  xmlns:sys="clr-namespace:System;assembly=mscorlib"

  xmlns:x="http://schemas. /winfx/2006/xaml">

  <DynamicResourceDictionary Name="Urls">

  <x:Uri x:Key="remote_base" x:Name="remote_base">URL приложения</x:Uri>

  <x:Uri x:Key="marketing_products">

  <x:Arguments>

  <x:Reference>remote_base</x:Reference>

  <x:String>MarketingProductValidator</x:String>

  </x:Arguments>

  </x:Uri>

Пример использования remote-валидации (валидатор указывается названием словаря и ключа):

<ProcessRemoteValidationIf Url="{x:DynamicResource Name=Urls, Key=products}" HttpMethod="POST" SiteId="35" CustomerCode="backend_name" Timeout="30000" >

  <ProcessRemoteValidationIf. Condition>

  <Not>

  <IsNullOrEmpty Source="{x:Definition MarketingProduct}"/>

  </Not>

  </ProcessRemoteValidationIf. Condition>

  <ProcessRemoteValidationIf. DefinitionsToSend>

  <x:Definition Key="MarketingProduct" />

  <x:Definition Key="Type" />

  <x:Definition Key="Regions" />

  <x:Definition Key="Modifiers" />

  <x:Definition Key="Id" /> 

  <x:Definition Key="Parameters" />

  </ProcessRemoteValidationIf. DefinitionsToSend>

</ProcessRemoteValidationIf>

Поддержка ссылок {x:Reference}

x:Reference ссылки позволяют использовать значения элементов, которые уже присутствует в XAML-разметке.

Для того чтобы использовать значение элемента, необходимо:

задать имя элемента атрибутом x:Name; Для того чтобы получить значение элемента: указать значение x:Reference x:Name для атрибута тега, в котором должно выводится запрашиваемое значение. Значение x:Name должно совпадать со значением пункта 1 списка выше; указать значение x:Name в парном теге x:Reference, в котором должно выводится запрашиваемое значение. Значение x:Key должно совпадать со значением пункта 2 списка выше.

Пример задания имени элемента, значение которого можно использовать в разметке:

<If x:Name="condition"> … </If>

Пример вызова:

<ForMember Definition="{x:Definition strings}" Condition="{x:Reference condition}">

Ресурсный словарь

Ресурсный словарь – словарь, содержащий:

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

<XamlValidator. Resources>

  <!--константы-->

  <sys:String x:Key="msg_Null">Не может быть null</sys:String>

  <sys:String x:Key="msg_Empty">Не может быть null</sys:String>

  <sys:String x:Key="msg_Pass">Лица старше 16 лет обязаны указывать паспорт.</sys:String>

  <!--общие для нескольких правил условия-->

  <Sequence x:Key="expr" StopOnFirstFailure="True">

  <!--поддержка последовательных условий c различными сообщениями-->

  <If>

  <IsNull />

  <If. True>

  <WithMessage Text="Не может быть null" />

  </If. True>

  </If>

  <If>

  <IsNullOrEmpty />

  <If. True>

  <WithMessage Text="Не может быть пустой" />

  </If. True>

  </If>

  <If>

  <Not>

  <Length MinLength="5"/>

  </Not>

  <If. True>

  <WithMessage Text="Длина поля должна быть не менее 5 символов." />

  </If. True>

  </If>

  </Sequence>

</XamlValidator. Resources>

<!--к полю Name применяем условия, указанные в ресурсном словаре-->

<ForMember Definition="{x:Definition Name}" Condition="{x:Resource expr}" />

<!--к полю DuplicateName применяем те же условия, что и к Name-->

<ForMember Definition="{x:Definition DuplicateName}" Condition="{x:Resource expr}"/>

<Must>

  <If>

  <And>

  <!--поддержка логических операндов для условий-->

  <GreaterThan Source="{x:Definition Age}" Value="16" />

  <Or>

  <IsNullOrEmpty Source="{x:Definition Passport}" />

  <Not>

  <!--поддержка Regex условий-->

  <Matches Source="{x:Definition Passport}"

  Expression="[0-9]{4} [0-9]{6}"
  RegexOptions="IgnoreCase, CultureInvariant" />

  </Not>

  </Or>

  </And>

  <If. True>

  <WithMessage Text="{x:Resource msg_Pass}" />

  </If. True>

  </If>

</Must>

Динамический ресурсный словарь

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

Пример создания динамического ресурсного словаря:

<DynamicResourceDictionaryContainer

  xmlns="http:///validation"

  xmlns:sys="clr-namespace: System;assembly=mscorlib"

  xmlns:x="http://schemas. /winfx/2006/xaml">

<!--Словарь Messages валидационные сообщения-->

<DynamicResourceDictionary Name="Messages">

  …

  <WithMessage x:Key="msg_Required">Не может быть null</WithMessage>

  …

</DynamicResourceDictionary>

<!--Словарь Conditions условия-->

<DynamicResourceDictionary Name="Conditions">

  …

  …

</DynamicResourceDictionary>

</DynamicResourceDictionaryContainer>

Пример использования динамического ресурсного словаря:

<XamlObjectValidator xmlns="http:///validation"

  xmlns:model="clr-namespace: QA. Validation. Xaml. Tests. Model;assembly=QA. Validation. Xaml. Tests"

  xmlns:x="http://schemas. /winfx/2006/xaml"

  xmlns:sys="clr-namespace: System;assembly=mscorlib"

  Type="{x:Type model:Person}">

<!--описание полей-->

<XamlObjectValidator. Definitions>

  …

</XamlObjectValidator. Definitions>

<ForMember Definition="{x:Definition Name}">

  <If True="{x:DynamicResource Name=Messages, Key=msg_Required}">

  <!--установка свойства Condition (оно указано как ContentProperty)-->

  <IsNull />

  </If>

</ForMember>

…

</XamlObjectValidator>

Использование в QP

Создание нового валидатора для статей контента

Валидатор статей контента задается в группе настроек «Custom Validation» свойств контента. Группа настроек содержит следующие элементы:

Флаг «Создать валидацию XAML по умолчанию» (Create Default XAML Validation). Если флаг установлен, то XAML-разметка валидатора статей контента будет сгенерирована по его структуре. По умолчанию флаг не установлен; Текстовое поле «XAML Валидация» (XAML Validation). В поле задается XAML-разметка валидации статей контента. По умолчанию поле не содержит значения и свернуто; Флаг «Запретить XAML валидацию» (Disable XAML Validation). Если флаг установлен, то статьи контента не будут валидироваться. По умолчанию флаг не установлен.

Для генерации разметки по умолчанию необходимо установить флаг «Создать валидацию XAML по умолчанию» и сохранить изменения, нажатием по кнопке «Сохранить». После сохранения в поле «XAML Валидация» будет содержаться разметка.

Для задания валидации необходимо внести XAML-разметку в поле «XAML Валидация» и сохранить изменения, нажатием по кнопке «Сохранить». После сохранения в поле «XAML Валидация» будет содержаться разметка.

Создание нового ресурсного словаря

Ресурсный словарь задается в группе настроек «Custom Validation» свойств сайта. Группа настроек содержит следующие элементы:

Флаг «Создать словарь для валидации XAML по умолчанию» (Create Default XAML Dictionary). Если установить флаг и сохранить настройки сайта, то будет создан пустой словарь. По умолчанию флаг не установлен; Текстовое поле «Словари для валидации XAML» (Dictionaries for XAML Validation). В поле задается XAML-разметка ресурсного словаря. По умолчанию поле не содержит значения и свернуто.

Порядок разработки валидатора Установить пакет QA. Validation. Xaml. Extensions из NuGet (см. Установка пакетов NuGet для QP). Создать класс валидатора, реализующий интерфейс IRemoteValidator2 из пространства имен QA. Validation. Xaml. Extensions. Rules (например, ProductDefinitionValidator). В реализуемом методе Validate доступны экземпляры классов RemoteValidationContext и RemoteValidationResult. Из контекста можно получить данные и метаданные для валидации, в объект-результат следует выполнять запись ошибок и новых значений (если требуется): context. Definitions – список Definition полей, переданных в метод валидации; context. ProvideValueExact<T> – метод для получения конкретного переданного значения по Definition поля; context. SetValue – метод для записи значения в объект-результат по Definition поля; result. Messages – коллекция сообщений об ошибках в объекте-результате. Необходимо реализовать контроллер, сопоставляющий URL и конкретный валидатор и возвращающий результат валидации в виде JSON.

Пример простейшего контроллера:

public class TestValidationController : Controller

{

private readonly Func<string, IRemoteValidator2> _validationFactory;

public TestValidationController(Func<string, IRemoteValidator2> validationFactory)

{

_validationFactory = validationFactory;

}

public ActionResult Validate(string validatorKey, RemoteValidationContext context)

{

var result = new RemoteValidationResult();

try

{

result = _validationFactory(validatorKey).Validate(context, result);

}

catch (Exception ex)

{

result. Messages. Add(ex. Message);