UML軟件開發(fā)與建模工具Enterprise Architect教程：創(chuàng)建項目特定的代碼生成器（下）

---

Enterprise Architect是一個對于軟件系統(tǒng)開發(fā)有著極好支持的CASE軟件（Computer Aided Software Engineering）。EA不同于普通的UML畫圖工具（如VISIO），它將支撐系統(tǒng)開發(fā)的全過程。在需求分析階段，系統(tǒng)分析與設(shè)計階段，系統(tǒng)開發(fā) 及部署等方面有著強大的支持，同時加上對10種編程語言的正反向工程，項目管理，文檔生成，數(shù)據(jù)建模等方面。可以讓系統(tǒng)開發(fā)中各個角色都獲得最好的開發(fā)效率。

點擊下載Enterprise Architect最新試用版

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

讓我們通過使用兩種不同的持久性方法來實現(xiàn)一個產(chǎn)品線，使示例更加令人興奮：一種使用JPA將數(shù)據(jù)存儲在關(guān)系數(shù)據(jù)庫中，另一種使用HBase作為大數(shù)據(jù)存儲。

我建議實現(xiàn)一個可用于加載和保存實例的持久性管理器。只有基于JPA的產(chǎn)品才允許啟動和完成交易。此外，我想將JPA特定的注釋放在Java類中。圖3顯示了持久性管理器提供的方法。

圖3：處理圖1中的域類的PersistenceManager類的概述

現(xiàn)在的結(jié)果是，這兩種產(chǎn)品的所有六個類的實現(xiàn)都略有不同。在Java代碼清單5，  6，  7  和  8示出了代碼的摘錄來實現(xiàn)。

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作為持久性方法

實現(xiàn)該產(chǎn)品線的可行解決方案是：

• 使用繼承。這將需要使用每個類的公共API進行接口定義，并為JPA和HBase實現(xiàn)它。結(jié)果是必須將應(yīng)用程序的其余部分調(diào)整為僅在接口上運行，而不能在具體類上運行。
• 復(fù)制，粘貼和修改這兩種產(chǎn)品的實現(xiàn)將避免修改應(yīng)用程序的其余部分。維護兩個變體聽起來很合理。但是隨著變體數(shù)量的增加，情況依然如此嗎？您應(yīng)該仔細(xì)考慮復(fù)制和粘貼的利弊。
• 使用代碼生成器生成產(chǎn)品特定的代碼。實現(xiàn)代碼生成模板的類可以基于通用實現(xiàn)，并且每個子類可以調(diào)整產(chǎn)品特定的部分。

我更喜歡最后一種解決方案。圖4中的概述顯示了清單1的重構(gòu)的類模板。每個引入的方法都會生成Java類的特定成員。這使我可以在產(chǎn)品特定的模板中覆蓋這些方法。例如，在清單9中，可以看到JPA特定的注釋位于類定義之前。

圖4：重構(gòu)類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用于定義應(yīng)保存生成的代碼的目標(biāo)位置。它有兩個參數(shù)。第一個是應(yīng)為其生成代碼的UML元素。第二個是應(yīng)將生成的代碼存儲在默認(rèn)位置。帶注釋的方法的返回值是調(diào)整后的位置，應(yīng)在該位置存儲生成的代碼。

圖5中的屏幕快照顯示了所有模板。箭頭指向它們各自生成的文件。除了生產(chǎn)代碼外，還會生成測試代碼。

結(jié)論

現(xiàn)代通用編程語言（例如Xtend）非常適合實現(xiàn)復(fù)雜的代碼生成器。輸入可能是UML模型，可能是在Enterprise Architect中建模的。YAKINDU EA-Bridge可以將Enterprise Architect模型背后的關(guān)系數(shù)據(jù)庫即時轉(zhuǎn)換為UML元模型的實例，并且將其完全隱藏。無需學(xué)習(xí)Enterprise Architect提供的專有代碼生成語言或?qū)nterprise Architect的數(shù)據(jù)庫架構(gòu)進行反向工程。

YAKINDU EA-Bridge的Eclipse IDE集成使人們可以在短時間內(nèi)以低成本實現(xiàn)特定于項目的代碼生成器。這樣，您可以節(jié)省許多繁瑣，容易出錯和無意識的實施工作。

如果您想親自查看并運行完整的示例，請嘗試使用YAKINDU EA-Bridge。所提供的示例是YAKINDU EA-Bridge附帶的示例之一。

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

想要了解或購買Enterprise Architect正版版權(quán)，請

關(guān)注下方微信公眾號，及時獲取產(chǎn)品最新消息和最新資訊