UML软件开发与建模工具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) '''
      ?IF element.isAbstract?
         @MappedSuperclass
      ?ELSE?
         @Entity
         @Table(name = "?element.name?Table")
      ?ENDIF?
      ?super.printClassDeclaration(element)?'''

   // ...
}

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

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

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

结论

现代通用编程语言（例如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正版版权，请

关注下方微信公众号，及时获取产品最新消息和最新资讯