用C#+XMI技术进行UML模型捕获

有许多不同的方法可用于捕获XML模型数据并且把它放到一个数据存储中,正如你所期望的,包括使用XSLT技术。但是我想使用一种不同的方法-使用C#语言。XSLT是一个用于改变XML文件的好选择,但是对于更广阔的不仅仅是转变数据的应用软件来说,C#或者另外的象Java这样的高级语言提供了更大的灵活性。

  在本文中,我将展示如何通过使用XMI和C#来剖析一个UML发布图。首先,我展示一个该方法的简单的发布图,所在环境为一个虚构的汽车出租公司并使用 C#来捕获一些数据。这种数据可以被容易地加到一个数据库(它已经是ADO调用的相当容易的一部分)上去或者作为更大些的一个基于资产的管理系统的一部分。在每一个示例中,我将逐渐增加原始图和能够获取的信息的复杂性。

  一、 示例1-查找方法的名字

  我要做的第一件事情是捕获来自于汽车出租公司的所有方法的名字。共有五个方法,它们是以UML发布图形描述的(见图1)。在上一篇文章中,我展示了如何用一个XML文档来描述一个发布图。为此,首先要创建该图,然后把它输出到一个XMI文件(企业架构)或解压(MagicDraw)。(在这篇文章中,我再次使用了SparxSystems.com提供的企业架构。)
09c71xtz2o55.jpg
图1.五个方法:图中结点描述了汽车出租公司的方法。每一个结点为一个方法名字。
  我将首先开发一简单main程序-它提示用户输入描述一个有效的XMI文档的XML文档的名字。一旦输入文件名字,它就被传递到一个分析XMI文档的对象并打印输出方法名字。
using System;
using System.Text;
namespace XMI_1{
public class ConsoleUtils{
 public static string ReadString(string msg) {
  Console.Write(msg); return System.Console.ReadLine();
 }
 public static void WriteString(string msg)
 { System.Console.WriteLine(msg); }
 public static void Main(string[] args) {
  string name = ReadString("Please enter the XMI filename : ");
  NodeParse np = new NodeParse(name);
  System.Console.ReadLine();
 }
}
}
   下一步是分析XMI文档。为此,我必须创建一个XMLTextReader的实例并循环操作直到没有结点为止。XMLNodeType.Element 检查每一个XML元素并且在元素是一个结点的情况下把它打印输出到控制台。该元素名字资格为"UML:Node",然而通过使用 _readXMI.LocalName只有元素名字的"Node"被读取。详细代码参见列表1。

   二、 示例2-增加模板

  第二个示例重构了第一个示例来捕获方法的名字和"pc server"模板-这是一个用来决定每个结点是一个方法的UML方法。图3显示增加了模板后的方法的发布图。

  第一步是修改前面的代码以识别新的模板来操纵AddNode()方法。

图3.增加了模板之后:每个模板描述了结点的类型-不管它是一个PC服务器,PC客户端或者是另外一些描述该结点的目标。
private void AddNode(XmlTextReader p_readXMI)
{
 string nodeID;
 string nodeName;
 string stereotypeName;
 nodeID = p_readXMI.GetAttribute("name");
 nodeName = p_readXMI.GetAttribute("xmi.id");
 Console.Write(nodeID);
 Console.Write(" -> ");
 Console.WriteLine(nodeName);
 while (p_readXMI.Read() && (p_readXMI.NodeType == XmlNodeType.Element || 
p_readXMI.NodeType== XmlNodeType.Whitespace))
 {
  switch (p_readXMI.LocalName)
  {
   case "ModelElement.stereotype":
    while (p_readXMI.Read() && (p_readXMI.NodeType == XmlNodeType.Element || 
p_readXMI.NodeType == XmlNodeType.Whitespace))
    {
     if (p_readXMI.LocalName == "Stereotype")
     {
      stereotypeName = p_readXMI.GetAttribute("name");
      Console.WriteLine("Stereotype = " + stereotypeName);
     }
    }
   break;
  }
 }
}
   特别要注意的是一个idiom(对某个语言特有的一个低级别的模式)-我用来查找在另外一些元素内部的XML元素。我在p_readXMI.Read循 环中增加了代码来检查元素或者空格(在XML文档中,这是些空格字符)。只有每个元素结点在XML文档中适当的层次上处理时,这个idiom才工作。

  用这种方式对元素进行封装,结果不很理想。例如,在下面的UML中使用idiom代码将产生所不希望的结果:

<UML:Node name="Leasing">
<UML:TagName name="Test">
</UML:Node name="SmallLeasing">
</UML:TagName>
</UML:Node>

9i783an2b981.jpg
图4.示例2的输出结果:在示例1中的结点名字/id之后,列出每个模板。

   第一个元素被作为一个结点处理,第二个元素被忽略并在初始循环中退出,而第三个元素被作为在同一级上的第一个正常结点处理。为了修正这个问题,你可以使 用XMLNodetype.Endelement来检查元素的结束标签。在本文中,这不是个问题而保存额外的代码要求检查结尾元素。
XMI中的模板被封装在结点元素中。该示例中的代码检查名字为"ModelElement.Stereotype"的元素并且使用刚才讨论的相同的idiom来处理一个"模板"类型的封装元素,然后把它打印输出到屏幕上(见图4)。(列表3列出了示例2的完全的源码。)
   三、 示例3-添加硬件信息

  从资产管理的角度来看,捕获方法的名字和它们的模板并没有多大用处。当然,另一方面,如果你的图包含了描述正在使用的硬件信息也可能是非常有用的:例如,基于UML发布图把你所有的硬件保存到一个数据库将能够使你跟踪方法、客户及其如何进行彼此联系的。

   在UML中,硬件结点都贴有用来识别它们属性的"标签"。每一个标签都是在建模工具(这里是企业架构)中产生而且由建模器所定义(或者有时保存成一个 UML剖面文件)。在本示例中,我为CPU、磁盘大小、内存大小、目的、注意事项以及卖主等创建了标签(见图5)。每个标签具有一个值-或者被赋予一个基 本类型(字符串,整型……)或者从一个可用值列表中选择其一。无论如何,保持与所用值的一致性是很重要的。如果你把"GHT"用于CPU以描述 "gigahertz hyper-threaded",那么对每个CPU标签,你都要使用相同的约定。

drkr4555mt6s.jpg
图5.示例2的增加硬件到方法/模板图,我添加了描述每个结点的硬件的标签。我把一个客户添加到示例"Mary Machine"来说明还有一个"pc client"模板。

   新的重构的代码与以前的一样,但是增加了读取标签的代码。在此,XMI并没有如你所盼的那样封装结点内的标签。作为代替,每个属性是一个 "TaggedValue"元素-它通过使用"modelElement"属性来参考引用属性的结点标识符(XML.id)。这样做的困难在于结点元素必 须在标签元素之前被读取,并且每个结点元素必须被保存-为使标签元素依附于其上。

  在XML中,存在两种读取文档的方法。第一种是读取 完整的文档并把它以一棵树保存到内存中-这里每个元素是从根元素开始构建的层次结构的一部分。这就是DOM模型,是较佳的适用于小型文档的方法。第二种方 法是,读取文档时,每次分析一个元素。SAX就是这种方法的一个示例并且它被当作推模型,因为由它分析文档并返回分析后的文档(推它)而不需要提示。

   另外一种方法是微软的XMLReaders(XMLTextReader派生于它)-它是一个拉模型,因为当下一个元素被分析时,控制掌握在程序中。我 在此使用的XML文档很小,但是我分析过的一些文件是超过了500,000行的文本文件,这导致我求助于XMLReader方法。这种方法的一个不足是要 求结点应出现在标签元素之前。

  为了保存结点我需要使用一个键/值容器。最易于使用的是Hashtable。在重构主程序中(见下),我使用了Hashtable中的枚举能力以及用IDictionary枚举器来打印方法结点。

public static void Main(string[] args){
Hashtable mainHash;
IDictionaryEnumerator ienum;
Node tNode;
string name = ReadString("Please enter the XMI filename : ");
NodeParse np = new NodeParse(name);
mainHash = np.getNodes();
ienum = mainHash.GetEnumerator();
while (ienum.MoveNext()) {
tNode = (Node)ienum.Value;
System.Console.WriteLine("Node ="+tNode.name+" CPU= "+tNode.CPU);
}
System.Console.ReadLine();
}

  我重构了nodeParse对象以用于检查元素"TaggedValue"并且调用AddAttributeNode-它负责在哈希表中查找正确的结点并且通过一个case语句把标签添加到该结点上。相应的类NodeParse显示于列表4中。

  这个结点类仅仅是一个存储状态的对象。每一个标签都有它自己的属性。注意,这个结点类的构造器要求该对象必须用服务器名字初始化。 

using System;
using System.Text;
namespace XMI_1
{
class Node{
string _name,_id = "",_CPU,_MemorySize,_DiskSize,_Note,_Purpose, _Stereotype,Vendor;
public Node(string p_id) {this._name = p_id;}
public string id {get { return _id;}
public string name{get {return _name;} set {_name = value;}}
public string CPU {get { return _CPU;} set {_CPU = value;}}
public string MemorySize{get {return _MemorySize;}
set {_MemorySize = value;}}
public string DiskSize {get {return _DiskSize;}set {_DiskSize = value;}}
public string Notes{get {return _Notes;}set {_Notes = value;}}
public string Purpose{get {return _Purpose;} set {_Purpose = value;}}
public string Stereotype {get {return _Stereotype;} set {_Stereotype = value;}}
public string Vendor {get {return _Vendor;} set {_Vendor = value;}}
}
}

  我并没有提供示例3和输出结果,因为它几乎和示例4的完全相同。(列表5列出了示例3的完整的源代码。)
  四、 示例4-添加继承

  在最后的示例中,我从一个Node类继承了结点实例。以前,我们每次只分析一个结点并对其进行遍历。Node实例描述了存在于UML结点和硬件之间的关系。Nodes给了我们一种从实例中抽象出公共元素的方法。

   为此,有两种不同的方法。第一种方法是使用Nodes来描述一个通用硬件平台。可以设想这样的情形:我为一家公司工作,该公司想针对它们所有的方法(多 么奇怪!)订购相同的计算机配置。可以用一个结点来描述典型的计算机配置,然后该结点又会有多个结点实例。这将节省大量的输入时间!另外一种方法是在软件 架构师通知基础构件小组怎样分发组件的情形。该结点用针对于每个层的本地名字来描述不同的层。至于这些如何映射到实际的硬件是由结点实例所决定的而且由基 础构件小组所创建。 

  在该示例中(见图6),我展示了一个通用结点-"Fleet Management",它具有可以添加到它上面的组件。在一个多层系统中,Fleet Management是由软件架构师来定义成一个分离的层。为了说明问题,我可能还要应用"Purpose"标签。我有两个结点实例,"Trucks"和 "Persons",它们由基础构件小组来定义以把该层分成两个方法。既然"Trucks"和"Persons"是完全不同的两个域,那么架构师介入其中 并分解之是十分安全的。方法名字上还标记有":Fleet Management",以指明它们是在Fleet Management结点中实现的。

1nnx53333994.jpg
图6.Trucks与Persons结点实例都继承自Fleet Management结点。

   在这个示例中,没有用于继承的标签,但是可能在另外的图上存在一些其它关系-它们会连接到该结点实例上。

  我又一次重构了main程序以打印出所有的,包括每一个结点实例派生的(tNode.classname)结点标签,还有结点的ID(tNode.classifier)。

public static void Main(string[] args)
{
Hashtable mainHash;
IDictionaryEnumerator ienum;
Node tNode;
string name = ReadString("Please enter the XMI filename : ");
NodeParse np = new NodeParse(name);
mainHash = np.getNodes();
ienum = mainHash.GetEnumerator();
while (ienum.MoveNext()){
tNode = (Node)ienum.Value;
System.Console.WriteLine("Node = " + tNode.name);
//Add "if (tNode. != null)" for each Writeline() 
System.Console.WriteLine(" CPU = " + tNode.CPU);
System.Console.WriteLine(" DiskSize = " + tNode.DiskSize);
System.Console.WriteLine(" MemorySize = " + tNode.MemorySize);
System.Console.WriteLine(" Purpose = " + tNode.Purpose);
System.Console.WriteLine(" Notes = " + tNode.Notes);
System.Console.WriteLine("Node refers to = " + tNode.classname);
System.Console.WriteLine("Node addr is " + tNode.classifier);
System.Console.WriteLine();
}
System.Console.ReadLine();
}

  类名和类标志符指明该结点实例继承自哪些结点。在XMI中,这是被象一个模板(就象一个封装在结点元素中的元素)一样描述的。

   现在我将使用一个开关语句来检查"ModelElement.taggedValue",而代之以ModelElement.Stereotype,查 找"TaggedValue"元素(存在类名和类标志符上皆独立的元素),并把它们添加到结点对象上。在此,我再次使用了分析idiom。这些代码可以在 列表3中找到。

pn10c03gz6df.jpg
图7.Trucks和Persons:示例4的最后输出,Trucks和Persons各有一个它们可以参考的结点并且每个结点都有一个唯一的ID。

  图7显示示例4最后的输出。

  五、 总结

  在本文中,我讨论了可以从图中读取硬件资产的方法。还讨论了读取名字、模板、属性以及读取结点之间及结点实例(继承)之间的关系。尽管我没有给出把这种信息放入数据库中的显式代码,我将在后面的文章中讨论这些技术-当然不止是添加信息到数据库中。



















本文转自朱先忠老师51CTO博客,原文链接: http://blog.51cto.com/zhuxianzhong/60100,如需转载请自行联系原作者



  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值