Объясняет, что такое столбцы, производные от кода, и как их использовать, с упором на столбцы, производные от событий.
Объясняет, что такое столбцы, производные от кода, и как их использовать.
В центре внимания этой статьи будут «столбцы, производные от событий». Ян Норден (Borland) недавно указал мне на эти вещи, когда я спросил у него, как решить возникшую у меня проблему с GUI. Когда я использовал Bold for Delphi, был один очень удобный GUI-компонент под названием BoldSelectionListBox. Этот компонент позволял мне показывать список элементов с CheckBox рядом с каждой строкой; установка / снятие флажка добавляла / удаляла элемент связи между выбранным элементом и каким-либо другим объектом на мой выбор. Это не лучшее объяснение в мире, поэтому взгляните на следующую UML-диаграмму:

Эта диаграмма — то, над чем я недавно работал в ECO II. Это моя интерпретация информации, необходимой для создания индуктивного пользовательского интерфейса. Внимательно посмотрев на UML-диаграмму, вы увидите, что каждая задача (Task) имеет ноль или множество ссылок PermittedRoles (Role). Идея в том, что, указав роль (Role) текущего пользователя, я могу легко получить список задач, которые ему разрешено выполнять.
Используя этот BoldSelectionListBox, я мог бы указать задачу (Task) в качестве контекста, а затем получить список всех ролей (Roles) в своего рода CheckListBox. Флажки появлялись бы во всех CheckBox, где роли разрешено выполнять указанное действие, и отсутствовали бы там, где это не разрешено. Особенно удобная часть, конечно, в том, что при установке флажка в CheckBox Bold создавал бы объект связи, необходимый для привязки роли (Role) к задаче (Task), и добавлял бы его в Role.AllowedTasks (и, конечно, в Task.PermittedRoles).
Поскольку ECO II не предоставляет никаких собственных GUI-элементов управления (вместо этого он предлагает интерфейсы .NET DataBinding, чтобы вы могли использовать стандартные элементы управления), я подозревал, что не смогу добиться того же эффекта. Ян любезно прислал мне небольшую демонстрацию, показывающую, как добиться этого, используя только DataGrids. Вскоре я реализовал эту логику в своём собственном приложении, и она работала прекрасно!
Я добавил expression handles для своих ролей (ehRoles) и задач (ehTasks), связал каждый из них с отдельной сеткой (grid) и добавил кнопки Add / Delete. Для каждого из этих expression handles я задал получение всех экземпляров: «Roles.allInstances» и «Tasks.allInstances».
В левой части моего GUI были перечислены все мои задачи (Tasks), а в правой — все мои роли (Roles). Теперь я хотел добавить CheckBox рядом с каждой ролью, чтобы можно было указать, разрешено ли роли выполнять текущую выбранную задачу или нет. Первая проблема, которую нужно решить, — это узнать, какая задача является «текущей выбранной». Для этого я добавил CurrencyManagerHandle с именем «chTasks», задал его RootHandle равным ehTasks, а BindingContext — равным TasksDataGrid. Теперь chTasks хранит текущую задачу (Task) — просто и легко.
Далее мне нужно было получить столбец CheckBox в моём RolesDataGrid и задать AllowNull равным False. Для этого я добавил фиктивный столбец TaskPermitted в ehRoles и задал его тип System.Boolean. Примечание: у кнопки «Add» в редакторе Columns есть значок DropDown рядом с ней — нажмите его и выберите EventDerivedColumn. Затем я добавил дополнительный столбец в мой RolesDataGrid; чтобы убедиться, что это CheckBox, я выбрал выпадающий список на кнопке Add и выбрал DataGridBoolColumn. Я задал MappingName равным TaskPermitted.
До сих пор у нас есть всё необходимое, чтобы видеть CheckBox'ы, но нет способа сообщить DataGrid, должен ли флажок быть установлен или нет. Для этого нам нужно написать немного кода в событии DeriveValue у ehRoles, но сначала я хочу добавить кое-что, чтобы код было немного проще писать. Я добавил новый ExpressionHandle ehTasksPermittedRoles; его RootHandle был CurrencyHandle (chTasks), а выражение — «self.PermittedRoles». Это позволило бы мне легко проверять, каким ролям разрешено выполнять «текущую задачу».
Теперь напишем немного кода для вычисления значения ehRoles.TaskPermitted. Это делается в событии ehRoles.DeriveValue следующим образом:
private void ehRoles_DeriveValue(object sender, Borland.Eco.Handles.DeriveEventArgs e)
{
switch (e.Name) //Одно событие для всех производных столбцов
{
case "TaskPermitted":
//Получить список разрешённых ролей для этой задачи
IElementCollection roles = ehTasksPermittedRoles.Element as IElementCollection;
//Избежать исключения из-за null-ссылки
if (roles == null)
{
//вернуть элемент, представляющий константу "false"
e.ResultElement = EcoSpace.VariableFactoryService.CreateConstant(false);
return;
}
//Наблюдать за элементом ehTaskPermittedRoles; это сообщает нам, когда элемент
//изменяется, чтобы мы могли перерисовать GUI
ehTasksPermittedRoles.SubscribeToElement(e.ResubscribeSubscriber);
//Также наблюдать за элементами внутри списка
roles.SubscribeToValue(e.ValueChangeSubscriber);
//Если разрешённые роли содержат текущую роль, то вернуть
//элемент, представляющий константу "true"
if (roles.Contains(e.RootElement))
e.ResultElement = EcoSpace.VariableFactoryService.CreateConstant(true);
else
//Иначе вернуть элемент, представляющий константу "false"
e.ResultElement = EcoSpace.VariableFactoryService.CreateConstant(false);
break;
default:
throw new Exception(e.Name + " not derived properly");
}
}
И наконец, нам нужен способ позволить пользователю устанавливать / снимать флажок в CheckBox, чтобы соответствующая связь добавлялась в Task.PermittedRoles или удалялась из него. Это делается в событии ehRoles.ReverseDeriveValue следующим образом
private void ehRoles_ReverseDeriveValue(object sender, Borland.Eco.Handles.ReverseDeriveEventArgs e)
{
switch(e.Name) //Одно событие для всех производных столбцов
{
case "TaskPermitted":
//Получить список разрешённых ролей для текущей задачи
IElementCollection roles = (IElementCollection) ehTasksPermittedRoles.Element;
//Избежать исключения из-за null-ссылки
if (roles == null)
return;
//Привести устанавливаемое значение к типу Boolean (из CheckBox в сетке данных)
if ( (Boolean) e.Value)
{
//Если флажок установлен, а отмеченная роль отсутствует в
//списке Task.PermittedRoles, то добавить её
if (!roles.Contains(e.RootElement))
roles.Add(e.RootElement);
}
else
{
//Если флажок снят, а отмеченная роль присутствует в
//списке Task.PermittedRoles, то удалить её
if (roles.Contains(e.RootElement))
roles.Remove(e.RootElement);
}
break;
}
}
К этому может потребоваться немного привыкнуть, но если вы прочитаете это несколько раз, то сможете уловить суть. По сути, это даёт разработчику возможность использовать обратные производные атрибуты исключительно в рамках GUI. Это означает, что мы можем делать некоторые изощрённые вещи с объектами ECO II, не включая обратные производные атрибуты в модель, чтобы удовлетворить требования GUI.
Столбцы, производные от кода, в ECO II
Объясняет, что такое столбцы, производные от кода, и как их использовать, с упором на столбцы, производные от событий.
Объясняет, что такое столбцы, производные от кода, и как их использовать.
В центре внимания этой статьи будут «столбцы, производные от событий». Ян Норден (Borland) недавно указал мне на эти вещи, когда я спросил у него, как решить возникшую у меня проблему с GUI. Когда я использовал Bold for Delphi, был один очень удобный GUI-компонент под названием BoldSelectionListBox. Этот компонент позволял мне показывать список элементов с CheckBox рядом с каждой строкой; установка / снятие флажка добавляла / удаляла элемент связи между выбранным элементом и каким-либо другим объектом на мой выбор. Это не лучшее объяснение в мире, поэтому взгляните на следующую UML-диаграмму:

Эта диаграмма — то, над чем я недавно работал в ECO II. Это моя интерпретация информации, необходимой для создания индуктивного пользовательского интерфейса. Внимательно посмотрев на UML-диаграмму, вы увидите, что каждая задача (Task) имеет ноль или множество ссылок PermittedRoles (Role). Идея в том, что, указав роль (Role) текущего пользователя, я могу легко получить список задач, которые ему разрешено выполнять.
Используя этот BoldSelectionListBox, я мог бы указать задачу (Task) в качестве контекста, а затем получить список всех ролей (Roles) в своего рода CheckListBox. Флажки появлялись бы во всех CheckBox, где роли разрешено выполнять указанное действие, и отсутствовали бы там, где это не разрешено. Особенно удобная часть, конечно, в том, что при установке флажка в CheckBox Bold создавал бы объект связи, необходимый для привязки роли (Role) к задаче (Task), и добавлял бы его в Role.AllowedTasks (и, конечно, в Task.PermittedRoles).
Поскольку ECO II не предоставляет никаких собственных GUI-элементов управления (вместо этого он предлагает интерфейсы .NET DataBinding, чтобы вы могли использовать стандартные элементы управления), я подозревал, что не смогу добиться того же эффекта. Ян любезно прислал мне небольшую демонстрацию, показывающую, как добиться этого, используя только DataGrids. Вскоре я реализовал эту логику в своём собственном приложении, и она работала прекрасно!
Я добавил expression handles для своих ролей (ehRoles) и задач (ehTasks), связал каждый из них с отдельной сеткой (grid) и добавил кнопки Add / Delete. Для каждого из этих expression handles я задал получение всех экземпляров: «Roles.allInstances» и «Tasks.allInstances».
В левой части моего GUI были перечислены все мои задачи (Tasks), а в правой — все мои роли (Roles). Теперь я хотел добавить CheckBox рядом с каждой ролью, чтобы можно было указать, разрешено ли роли выполнять текущую выбранную задачу или нет. Первая проблема, которую нужно решить, — это узнать, какая задача является «текущей выбранной». Для этого я добавил CurrencyManagerHandle с именем «chTasks», задал его RootHandle равным ehTasks, а BindingContext — равным TasksDataGrid. Теперь chTasks хранит текущую задачу (Task) — просто и легко.
Далее мне нужно было получить столбец CheckBox в моём RolesDataGrid и задать AllowNull равным False. Для этого я добавил фиктивный столбец TaskPermitted в ehRoles и задал его тип System.Boolean. Примечание: у кнопки «Add» в редакторе Columns есть значок DropDown рядом с ней — нажмите его и выберите EventDerivedColumn. Затем я добавил дополнительный столбец в мой RolesDataGrid; чтобы убедиться, что это CheckBox, я выбрал выпадающий список на кнопке Add и выбрал DataGridBoolColumn. Я задал MappingName равным TaskPermitted.
До сих пор у нас есть всё необходимое, чтобы видеть CheckBox'ы, но нет способа сообщить DataGrid, должен ли флажок быть установлен или нет. Для этого нам нужно написать немного кода в событии DeriveValue у ehRoles, но сначала я хочу добавить кое-что, чтобы код было немного проще писать. Я добавил новый ExpressionHandle ehTasksPermittedRoles; его RootHandle был CurrencyHandle (chTasks), а выражение — «self.PermittedRoles». Это позволило бы мне легко проверять, каким ролям разрешено выполнять «текущую задачу».
Теперь напишем немного кода для вычисления значения ehRoles.TaskPermitted. Это делается в событии ehRoles.DeriveValue следующим образом:
private void ehRoles_DeriveValue(object sender, Borland.Eco.Handles.DeriveEventArgs e)
{
switch (e.Name) //Одно событие для всех производных столбцов
{
case "TaskPermitted":
//Получить список разрешённых ролей для этой задачи
IElementCollection roles = ehTasksPermittedRoles.Element as IElementCollection;
//Избежать исключения из-за null-ссылки
if (roles == null)
{
//вернуть элемент, представляющий константу "false"
e.ResultElement = EcoSpace.VariableFactoryService.CreateConstant(false);
return;
}
//Наблюдать за элементом ehTaskPermittedRoles; это сообщает нам, когда элемент
//изменяется, чтобы мы могли перерисовать GUI
ehTasksPermittedRoles.SubscribeToElement(e.ResubscribeSubscriber);
//Также наблюдать за элементами внутри списка
roles.SubscribeToValue(e.ValueChangeSubscriber);
//Если разрешённые роли содержат текущую роль, то вернуть
//элемент, представляющий константу "true"
if (roles.Contains(e.RootElement))
e.ResultElement = EcoSpace.VariableFactoryService.CreateConstant(true);
else
//Иначе вернуть элемент, представляющий константу "false"
e.ResultElement = EcoSpace.VariableFactoryService.CreateConstant(false);
break;
default:
throw new Exception(e.Name + " not derived properly");
}
}
И наконец, нам нужен способ позволить пользователю устанавливать / снимать флажок в CheckBox, чтобы соответствующая связь добавлялась в Task.PermittedRoles или удалялась из него. Это делается в событии ehRoles.ReverseDeriveValue следующим образом
private void ehRoles_ReverseDeriveValue(object sender, Borland.Eco.Handles.ReverseDeriveEventArgs e)
{
switch(e.Name) //Одно событие для всех производных столбцов
{
case "TaskPermitted":
//Получить список разрешённых ролей для текущей задачи
IElementCollection roles = (IElementCollection) ehTasksPermittedRoles.Element;
//Избежать исключения из-за null-ссылки
if (roles == null)
return;
//Привести устанавливаемое значение к типу Boolean (из CheckBox в сетке данных)
if ( (Boolean) e.Value)
{
//Если флажок установлен, а отмеченная роль отсутствует в
//списке Task.PermittedRoles, то добавить её
if (!roles.Contains(e.RootElement))
roles.Add(e.RootElement);
}
else
{
//Если флажок снят, а отмеченная роль присутствует в
//списке Task.PermittedRoles, то удалить её
if (roles.Contains(e.RootElement))
roles.Remove(e.RootElement);
}
break;
}
}
К этому может потребоваться немного привыкнуть, но если вы прочитаете это несколько раз, то сможете уловить суть. По сути, это даёт разработчику возможность использовать обратные производные атрибуты исключительно в рамках GUI. Это означает, что мы можем делать некоторые изощрённые вещи с объектами ECO II, не включая обратные производные атрибуты в модель, чтобы удовлетворить требования GUI.
Столбцы, производные от кода, в ECO II
By russiatips
Объясняет, что такое столбцы, производные от кода, и как их использовать, с упором на столбцы, производные от событий.