StarUML. Руководство разработчика. Глава 4. Использование API |
46 / 139 |
|
|
|||
|
|
|
|
|
|
|
|
Метод |
|
Описание |
|
|
|
AddListElementsByCollection(A Добавляет элементы указанной коллекции указанного элемента, в список. Model: IModel; CollectionName: Параметр 'ShowInherited' определяет, нужно ли проследить структуру String; ShowInherited: Boolean) наследования указанного элемента и добавить элементы аналогичных
коллекций из элементов верхних уровней в список.
AddListElementsByClass(MetaCl Добавляет элементы типов, определенных параметром, в список. Если |
|
assName: String; |
параметр 'IncludeChildInstances'='true', дочерние элементы выбранного |
IncludeChildInstances: Boolean) |
типа, также добавляются в список. |
Execute(Title: String): Boolean |
Выполняет диалог. Устанавливает указанный заголовок диалога. |
GetSelectedModel: IModel |
Возвращает ссылку на выбранный пользователем элемент. |
Следующий пример вызывает диалог ElementListSelector, и запрашивает у пользователя операцию указанного класса. Так как параметр "ShowInherited" установлен в "true", то любая операция из коллекций родительских классов (если таковые есть у выбранного класса) также может быть выбрана.
var app = new ActiveXObject("StarUML.StarUMLApplication"); var sel_dlg = app.ElementListSelector;
sel_dlg.AllowNull = false; sel_dlg.ClearListElements();
var class = ... // Получение ссылки на класс. sel_dlg.AddListElementsByCollection(class, "Operations", true); if (sel_dlg.Execute("Select an operation element.")){
var selElem = sel_dlg.GetSelectedModel;
...
}
else{
// If canceled, ...
}
Пример выше использовал метод AddListElementsByCollection. Следующий пример использует метод AddListElementsByClass. Так как параметр "IncludeChildInstances" "истинен", элементы выбранных типов, и все их дочерние элементы добавляются в список.
var app = new ActiveXObject("StarUML.StarUMLApplication"); var sel_dlg = app.ElementListSelector;
sel_dlg.AllowNull = false; sel_dlg.ClearListElements(); sel_dlg.AddListElementsByClass("UMLClassifier", true);
if (sel_dlg.Execute("Select a classifier type element.")){ var selElem = sel_dlg.GetSelectedModel;
...
}
else{
// If canceled ...
}
Использование API для метаобъектов
Этот раздел описывает концепцию метамодельных элементов и их использование. Как отмечалось в "Главе 2. Архитектура StarUML" метамодельные элементы - это элементы, которые принадлежат пакету "Non_Modeling Elements:: MetaModeling".
Основные понятия мета модели
Методы метамодели StarUML обеспечивает доступ на метауровне к модельным элементам, описанным в предыдущих разделах. Короче говоря, метамодельные элементы - это элементы, которые определяют эти элементы моделирования. Использование метамодельных элементов
StarUML. Руководство разработчика. Глава 4. Использование API |
47 / 139 |
позволяет получить доступ к номенклатуре каждого элемента моделирования и к информации о модельных элементах открытого проекта. Хотя концепция метамодели может показаться сложной для неопытных пользователей, строго рекомендуется, прочесть следующие описания, поскольку знание метамодели очень важно при использовании StarUML™.
Простой пример использования метамодели
Перед объяснением концепции метамодели, позвольте нам рассмотреть следующий простой пример, в качестве краткого обзора использования метамодельных элементов StarUML™. Сначала, предположим, что мы должны получить через API список всех классов в выполняющемся в настоящее время приложении StarUML™. Хотя поиск можно провести от проектного элемента самого верхнего уровня до всех элементов самого низкого уровня, использование метамодельных элементов может упростить процесс. Посмотрите на следующий код.
var app = new ActiveXObject("StarUML.StarUMLApplication"); var meta = app.MetaModel;
var metaClass = meta.FindMetaClass("UMLClass");
for (var i = 0; i < metaClass.GetInstanceCount(); i++){ var AClassElem = metaClass.GetInstanceAt(i);
...
}
Этот пример использует метамодельные элементы, чтобы получить ссылки на все элементы классов. Модельный элемент называемый "UMLClass", передается как параметр в метод IMetaModel.FindMetaClass чтобы обращаться к элементам-классам. Параметр может быть заменен на "UMLAttribute", если требуется обработать список всех атрибутов. Другими словами, этот подход может быть применен ко всем модельным элементам тем же самым способом.
Обратите внимание: См. "Приложение B. Список модельных элементов UML" для ознакомления с именами элементов.
Второй пример показывает, как обратиться к информации о модельных элементах. Как узнать, какие свойства класса - как модельного элемента UML - присутствуют в коде реализации программы? Это вопрос не о том, какие атрибуты определены в разработанном пользователем классе, а какие атрибуты определены в элементе "Class", который является модельным элементом UML. Например, элемент "Class" имеет свойства "Name", "Visibility" и "IsAbstract".
var app = new ActiveXObject("StarUML.StarUMLApplication"); var meta = app.MetaModel;
var metaClass = meta.FindMetaClass("UMLClass");
for (var i = 0; i < metaClass.GetMetaAttributeCount(); i++){ var metaAttr = metaClass.GetMetaAttributeAt(i);
var attrName = metaAttr.Name;
...
}
Этот пример получает имена всех атрибутов, принадлежащих модельному элементу "UMLClass", т.е. имена свойств класса. Точно так же как в первом примере, параметр для метода IMetaModel.FindMetaClass может быть заменен, чтобы выполнить ту же самую задачу для других элементов UML.
Архитектура метамодели UML
Этот раздел кратко представляет архитектуру метамодели UML. Он нужен, чтобы понять метамодель StarUML™.
StarUML. Руководство разработчика. Глава 4. Использование API |
48 / 139 |
OMG (Ассоциация объектно-ориентированного управления) использует метод, называемый метамоделирование архитектуры, для того, чтобы определить спецификации элементов UML. Эта метамоделирующая архитектура состоит из следующих слоев.
•Meta-metamodel (метаметамодель)
•Metamodel (метамодель)
•Model (модель)
•User Objects (объекты пользователя)
Определения элементов моделирования UML, описанные в Спецификации UML относятся к категории метамодели. Другими словами, обычные элементы UML подобные пакету, классу, варианту использования и актору - элементы метамодели. А элементы UML, которые созданы в процессе моделирования программного обеспечения, то есть, классы, которые называют как "Class1" или "Class2" - инстанции метамодели, которые относятся к категории модели. Более точно выражаясь, "Class1" и "Class2" - это инстанции метаэлемента "класс" ("UMLClass" в StarUML™).
Базовым слоем для того, чтобы определять метаэлементы UML подобные пакету, классу, варианту использования и актору, является метаметамодель; метаэлементы StarUML™ относятся к этому слою метаметамодели. Другими словами, все элементы моделирования могут быть интерпретированы как инстанции типа MetaClass, объясненного ниже. Метамодель StarUML™ облегчает доступ к модельным элементам на метауровне, исключая необходимость их определять.
Организация метамодели
Следующая диаграмма иллюстрирует компоненты и организацию элементов метамодели StarUML™. Некоторые компоненты опущены из-за пространственных ограничений.
Пожалуйста обращайтесь к пакету "::Application Model::Non_Modeling Elements::Metamodeling Elements" модели приложения StarUML для получения полной диаграммы.