UML软件开发与建模工具Enterprise Architect教程：创建项目特定的代码生成器（下）

如何轻松为Enterprise Architect创建项目特定的代码生成器。

Enterprise Architect是一个对于软件系统开发有着极好支持的CASE软件（Computer Aided Software Engineering）。EA不同于普通的UML画图工具（如VISIO），它将支撑系统开发的全过程。在需求分析阶段，系统分析与设计阶段，系统开发 及部署等方面有着强大的支持，同时加上对10种编程语言的正反向工程，项目管理，文档生成，数据建模等方面。可以让系统开发中各个角色都获得最好的开发效率。

Enterprise Architect最新试用版

每个模型元素生成一个以上的Artefact

让我们通过使用两种不同的持久性方法来实现一个产品线，使示例更加令人兴奋：一种使用JPA将数据存储在关系数据库中，另一种使用HBase作为大数据存储。

我建议实现一个可用于加载和保存实例的持久性管理器。只有基于JPA的产品才允许启动和完成交易。此外，我想将JPA特定的注释放在Java类中。图3显示了持久性管理器提供的方法。

图3：处理图1中的域类的PersistenceManager类的概述

现在的结果是，这两种产品的所有六个类的实现都略有不同。在Java代码清单5，  6，  7  和  8示出了代码的摘录来实现。

package com.example.orderingsoftware;public class Article extends AbstractIDObject {   private String name;    public String getName() {      return name;   }   public void setName(String name) {      this.name = name;   }}

清单5：使用HBase作为持久性方法的Article类的Java代码

package com.example.orderingsoftware;import javax.persistence.Entity;import javax.persistence.Table;@Entity@Table(name = "ArticleTable")public class Article extends AbstractIDObject {   private String name;    public String getName() {      return name;   }   public void setName(String name) {      this.name = name;   }}

清单6：使用JPA作为持久性方法的Article类的Java代码

public class PersistenceManager implements AutoCloseable {   private final Table articleTable;   public static final byte[] MODEL_FAMILY = "Model".getBytes();   public static final TableName ARTICLE_TABLE_NAME = TableName.valueOf("ArticleTable");   public Article getArticle(UUID id) {      try {         if (id != null) {            Get get = new Get(id.toString().getBytes());            if (articleTable.exists(get)) {               Result r = articleTable.get(get);               Article result = new Article();               result.setId(id);               result.setName(Bytes.toString(r.getValue(MODEL_FAMILY, ARTICLE_NAME_QUALIFIER)));               return result;            }         }         return null;      } catch (Exception e) {         throw new RuntimeException(e.getMessage(), e);      }   }   // ...}

清单7：PersistenceManager类的Java代码的一部分，其中使用HBase作为持久性方法

public class PersistenceManager implements AutoCloseable {   private EntityManager entityManager;    public Article getArticle(UUID id) {      if (id != null) {         return entityManager.find(Article.class, id);      } else {         return null;      }   }   // ...}

清单8：PersistenceManager类的Java代码的摘录，其中JPA作为持久性方法

实现该产品线的可行解决方案是：

• 使用继承。这将需要使用每个类的公共API进行接口定义，并为JPA和HBase实现它。结果是必须将应用程序的其余部分调整为仅在接口上运行，而不能在具体类上运行。
• 复制，粘贴和修改这两种产品的实现将避免修改应用程序的其余部分。维护两个变体听起来很合理。但是随着变体数量的增加，情况依然如此吗应该仔细考虑复制和粘贴的利弊。
• 使用代码生成器生成产品特定的代码。实现代码生成模板的类可以基于通用实现，并且每个子类可以调整产品特定的部分。

我更喜欢最后一种解决方案。图4中的概述显示了清单1的重构的类模板。每个引入的方法都会生成Java类的特定成员。这使我可以在产品特定的模板中覆盖这些方法。例如，在清单9中，可以看到JPA特定的注释位于类定义之前。

图4：重构类ClassTemplate的概述

class JPAClassTemplate extends ClassTemplate {   @EACodegenFile   def IFile path(Class element, IFile ^default) {      val path = "com/example/orderingsoftware/" + ^default.name      return getTargetFilePath("jpa", path)   }   @EACodegen("java")   override generate(Class element) {      return super.generate(element)   }   override printClassDeclaration(Class element) '''      F element.isAbstract        @MappedSuperclass      LSE        @Entity         @Table(name = "lement.nameable")      NDIF     uper.printClassDeclaration(element)''   // ...}

清单9：用Xtend编写的JPA的代码生成模板的摘录

path(Class, IFile)带有注释的模板子类中的方法@EACodegenFile用于定义应保存生成的代码的目标位置。它有两个参数。第一个是应为其生成代码的UML元素。第二个是应将生成的代码存储在默认位置。带注释的方法的返回值是调整后的位置，应在该位置存储生成的代码。

图5中的屏幕快照显示了所有模板。箭头指向它们各自生成的文件。除了生产代码外，还会生成测试代码。

图5：JPA和HBase的代码生成模板以及生成的源文件

结论

现代通用编程语言（例如Xtend）非常适合实现复杂的代码生成器。输入可能是UML模型，可能是在Enterprise Architect中建模的。YAKINDU EA-Bridge可以将Enterprise Architect模型背后的关系数据库即时转换为UML元模型的实例，并且将其完全隐藏。无需学习Enterprise Architect提供的专有代码生成语言或对Enterprise Architect的数据库架构进行反向工程。

YAKINDU EA-Bridge的Eclipse IDE集成使人们可以在短时间内以低成本实现特定于项目的代码生成器。这样，您可以节省许多繁琐，容易出错和无意识的实施工作。

如果您想亲自查看并运行完整的示例，请尝试使用YAKINDU EA-Bridge。所提供的示例是YAKINDU EA-Bridge附带的示例之一。

=====================================================

想要了解或购买Enterprise Architect正版版权，请咨询官方客服