1、1EA實例入門指南樂園研發(fā)部：胡晏秋2012-03-28n EA是一個企業(yè)化的計算機輔助軟件建模工具l支持軟件工程主要活動（需求分析、設計）的團隊協(xié)作l支持軟件模型和文檔的管理和輸出l支持模型和代碼的正反向工程n 本文目標讀者：樂園研發(fā)團隊成員（入門級）揭開面紗 2004 - 2010 UC Mobile2n Windows XP或Windows 7系統(tǒng)n EA 8.0或以上版本n Svn客戶端 CollabNetSubversion-client-1.7.1-1-Win32n EA和Svn軟件下載地址為svn: http:/svn.ucweb.local:8010/svn/prjdocume

2、nt/22.UC樂園/01研發(fā)文檔/0103設計文檔/tools n 使用公司svn用戶名密碼n tools目錄下還包含字體文件和EA文檔模板環(huán)境要求 2004 - 2010 UC Mobile3n 依次安裝EA工具和svn客戶端n 安裝字體，把tools/docFont下面的字體文件解壓出來拷貝到windows字體安裝目錄下（Windows安裝目錄/Fonts）,來代替EA的雅黑字體（EA自帶的雅黑輸出文檔會亂碼）n 請用CollabNetSubversion在命令行環(huán)境（cmd）下載（勿用圖形界面TortoiseSVN）樂園項目文件，避免由于EA和svn版本不一致導致無法導入n 下載命令示

3、例： D:docea-designsvn checkout http:/svn.ucweb.local:8010/svn/prjdocument/22.UC樂園/01研發(fā)文檔/0103設計文檔/working安裝軟件&下載樂園項目 2004 - 2010 UC Mobile4n 新建一個項目（File/New Project），一直按默認確定保存新建EA項目 2004 - 2010 UC Mobile5n 在EA Tools - options下設置以下幾項基礎設置項lGenerallAuthor:設置作者lSource Code Engineering：lDefault Langua

4、ge For Code Generation：phplCode page for source editing：utf8lphp/Default Version:5.0lSource Code Engineering - Code Editors：lDefault DataBase:mysqllDiagram/Appearance:lConfigure Default Fonts/Font Face: YaHei Consolas Hybrid（雅黑）對EA進行基礎設置 2004 - 2010 UC Mobile6n 在頂欄導航里面選擇Settings-General Types-按下面的ne

5、w按鈕，新建一種類型Abandoned-按save-顏色選擇深棕色設置Object類型 2004 - 2010 UC Mobile7n 應用到需求分析圖：在上圖的對話框點Applies to-勾選UseCase-關閉設置Object類型 2004 - 2010 UC Mobile8n 點擊頂部導航Tools Options-點擊Objects-勾選Show status colors on diagrams在圖例上顯示狀態(tài) 2004 - 2010 UC Mobile9n 從project Browser面板中右點根節(jié)點Model，從彈出的菜單中依次選擇Package Control Impor

6、t a Model Branch Find a Model Branch (.EAB) file，然后到樂園項目文件的文件夾目錄中選中uzone.EAB文件)導入樂園項目文件 2004 - 2010 UC Mobile10n 系統(tǒng)提示是否配置版本控制，這時選擇“是”n 在彈出的配置框填寫下列配置項，填寫完后請按“save”保存設置，然后按“close”關閉對話框，開始導入項目，導入過程比較長lunique Id: uzoneltype： Subversionlworking Copy Path: 選擇本地存放項目文件的目錄lSubversion Exe Path: 選擇svn客戶端exe所在路

7、徑配置版本控制相關功能 2004 - 2010 UC Mobile11n 依次從頂部主菜單中選擇（Tools Import Reference Data）,選擇模板文件，按“import”導入模板文件（之前下載的tools文件夾下的EATemplates目錄下的docTemplates.xml和docTemplatesV2.0.xml文件）。n 如果更換了模板或模板被修改了要重新導入模板導入文檔模板 2004 - 2010 UC Mobile12n 最后從Project Browser面板中刪除導入前的Model節(jié)點n 導入完成，如右下圖n 目錄結構介紹：lRequirements Model

8、：需求用例模型lDocument：設計文檔lDomain Model:領域建模lClass model：類模型lData Medel：數(shù)據(jù)模型導入完成 2004 - 2010 UC Mobile13主要功能模塊介紹主界面 2004 - 2010 UC Mobile14n Toolbox：EA各元素的快捷選擇面板n 工作區(qū)：繪制模型和圖例的畫布n Project Browser：項目的目錄結構，可以在上面添加圖例和元件主要功能模塊介紹Project Browser 2004 - 2010 UC Mobile15 創(chuàng)建模型（Model）向導 創(chuàng)建包(Package) 創(chuàng)建圖(Diagram) 創(chuàng)建

9、元件(Element) 查找 文檔生成 代碼及數(shù)據(jù)庫正反向工程 調整元件排序 幫助n 可以在Project Browser（Alt + 0）增加各級元素，可以使用Project Browser上部的導航或者選中包按“右鍵”選“Add”添加EA常規(guī)項目結構 2004 - 2010 UC Mobile16左圖展示EA中 項目、模型、包、圖元件之間的關系項目結構的層次（從大到?。?項目 模型包圖元件項目模型包（package）圖（diagram）元件（element）分割線 2004 - 2010 UC Mobile17n 如果您只有“讀”項目設計的需求，那么看到這一頁基本夠了，后面的主要講述的是

10、“寫”的操作，可以有需要的時候再看實例 2004 - 2010 UC Mobile18n 需求描述顯示和某用戶有相同家鄉(xiāng)的100個人，這個功能需要在一個新類hometown里面進行管理n 假設前提：l獲得一個人的家鄉(xiāng)id在user模塊定義，如下： getHometownByUid（var uid）l通過家鄉(xiāng)id返回同家鄉(xiāng)uid列表在dating模塊定義，如下： getUidsByHometownId（var hometownId，var num）本例操作步驟 2004 - 2010 UC Mobile19n 簽出新手區(qū)根節(jié)點n 在新手區(qū)添加一個包howntownn 把此包加入版本管理n 添加用

11、例圖對此需求進行需求分析n 添加包圖，類圖和重要邏輯序列圖對此類進行設計分析n 把上述設計導出成文檔n 把上述設計中的類正向輸出成代碼n 把結果簽入到版本庫（此步可不做）n 如果您想自己試一下，可以在新手區(qū)（各模型節(jié)點tmp目錄）下另建包測試（里面的howntown包是做好的例子，供參考）簽出新手區(qū)根節(jié)點 2004 - 2010 UC Mobile20n 右擊Requirements Model/tmp-Package Control - Check Outn 要對包下面的元素進行寫操作必須先簽出此包節(jié)點小知識查找包被誰簽出 2004 - 2010 UC Mobile21n 如果簽出失敗，需要

12、先查找到底被誰簽出了n 查詢此包所屬的xml（右鍵選中包-點Package control -點configure）n 查看XMI Filename小知識查找包被誰簽出 2004 - 2010 UC Mobile22n 到此文件所在硬盤目錄下面利用svn客戶端（這個可以用TortoiseSVN）查看被誰簽出新增包howntown 2004 - 2010 UC Mobile23n 單擊Requirements Model/tmp包-點擊Project Browser導航“add a package”-輸入包名howntown-確認把此包加入版本控制 2004 - 2010 UC Mobile24

13、n 添加對這個文件夾的版本控制（加入版本控制后就可以單獨簽出）：右鍵選中howntown包-單擊Package Control -單擊Add Branch to Version Contral-取消勾中Export as Model Branch-點ok在Class model中添加包howntown 2004 - 2010 UC Mobile25n 在Class Model下面的新手區(qū)tmp下面添加包howntownn 用同樣的方法把此包加入版本控制在需求模型howntown包下添加用例圖 2004 - 2010 UC Mobile26n 添加User class圖 diagram（選中需求

14、模型howntown package-點上部導航 “new diagram”按鈕,選擇UML Behavioral/Use Case圖-點ok ）n 在左邊的Toolbox/User case Common中把Actor和User Case等實體拉到工作區(qū)并雙擊，在Name文本框設置名字n 單擊左邊的Toolbox/Common中的“Dependency”關系，然后把這個關系加到工作區(qū)的實體上（先選中一個，然后拖向另一個，放手）n 完成作圖在類模型howntown包下添加包圖 2004 - 2010 UC Mobile27n 添加包圖 diagram（選中類模型howntown package

15、-點上部導航 “new diagram”按鈕,選擇UML Structural/Package圖-點ok ）n 把howntown包以及同目錄下和它相關的dating、user兩個包拉到工作區(qū)上n 單擊左邊的Toolbox/Common中的“Dependency”關系，然后把這個關系加到工作區(qū)的實體上建立howntown下面的目錄結構 2004 - 2010 UC Mobile28n 在howntown包下添加service和web子包，在service子包下再建立impls子包（不添加版本控制，權限受到howntown包控制）添加接口類 2004 - 2010 UC Mobile29n 選中

16、service包-在導航處點Create element-填入名字Ihowntown，選擇Type為InterFace，然后點create添加接口類接口方法 2004 - 2010 UC Mobile30n 右鍵點擊接口類-選擇operation按鈕n 添加方法（點new,填入下列參數(shù)，點save，依次添加，都填完后點close）lName:方法名稱lParmeters:參數(shù)lScope:作用域lReturn:返回值lNotes:方法描述添加howntown實現(xiàn)類和web控制類 2004 - 2010 UC Mobile31n 添加howntown實現(xiàn)類: 添加選中impls包-在導航處點Cr

17、eate element-填入名字howntown，選擇Type為Class-點okn 添加web控制類: 添加選中web包-在導航處點Create element-填入名字howntownControl，選擇Type為Class-點ok添加類圖 2004 - 2010 UC Mobile32n 添加類圖 diagram（選中howntown package-點上部導航 “New diagram”按鈕,選擇UML Structural/class圖-點ok ）n 把howntown的接口類和實現(xiàn)類用左健拖到工作區(qū)圖上（彈出的對話框選擇“as a simple link ”）n 選中左邊的Too

18、lbox/Common中的“Generalize”關系，然后把這個關系連到工作區(qū)的實體上設置在實現(xiàn)類實現(xiàn)的函數(shù) 2004 - 2010 UC Mobile33n 在添加“Generalize”關系時，會彈出對話框問是否把接口定義的接口函數(shù)在這個實現(xiàn)類實現(xiàn)，勾選表示“是”，然后點ok，接口函數(shù)自動加到實現(xiàn)類添加類圖 2004 - 2010 UC Mobile34n 完成作圖添加關鍵邏輯序列圖獲得同家鄉(xiāng)的用戶列表 2004 - 2010 UC Mobile35n 添加序列圖 diagram（選中howntown package-點上部導航 “new diagram”按鈕,選擇UML Behavio

19、ral/sequency圖-點ok ）n 把howntown的頁面控制類howntownControl、實現(xiàn)類howntown、dating的接口類IMeet和user模塊的接口類IUser按住左鍵拖到工作區(qū)添加關鍵邏輯序列圖獲得同家鄉(xiāng)的用戶列表 2004 - 2010 UC Mobile36n 單擊Toolbox/Interaction Relations第一個按鈕“Message”,拖到hownTownControl和howntown之間添加關鍵邏輯序列圖獲得同家鄉(xiāng)的用戶列表 2004 - 2010 UC Mobile37n 雙擊這個關系，在彈出的對話框中按需設置下列一些項：lMessag

20、e：調用消息名字（方法，任務等），可以下拉選擇或手工填入，如果是返回消息可以不填lParameters：參數(shù)列表lReturnType：返回值lSynch：是否同步lis Return：勾上表示 這是返回消息完成構建關鍵邏輯序列圖 2004 - 2010 UC Mobile38n 加上其他調用消息和返回消息，完成構圖擴展知識主要圖例介紹 2004 - 2010 UC Mobile39圖例介紹包圖描述系統(tǒng)中包之間的關系類圖定義類本身以及類之間的關系順序圖描述了對象間的交互順序活動圖活動之間的控制流數(shù)據(jù)結構圖定義數(shù)據(jù)庫和nosql數(shù)據(jù)領域模型圖描述系統(tǒng)邏輯數(shù)據(jù)模型用例圖表達系統(tǒng)的需求或用例原理介紹

21、輸出文檔 2004 - 2010 UC Mobile40數(shù)據(jù)模板文檔+ =n數(shù)據(jù)：來源于模型中的元素都可以作為文檔的輸入數(shù)據(jù)n模板：定義文檔內(nèi)容的展示方式、文檔風格、過濾規(guī)則等n主文檔（Master Document）：是一個文檔的集合，定義文件的整體結構n模版文檔（Model Document）：帶模板的文檔，一個文檔為主文檔的一部分輸出文檔添加主文檔 2004 - 2010 UC Mobile41n 在Document的tmp新手目錄下加入howntown包n 生成過渡圖例：點擊此包-點導航 “new diagram”按鈕,選擇Extended/Documentation圖-點okn 把左

22、邊Toolbox里面的Documentation的Master Document圖標拖到工作區(qū)并命名為“設計文檔”n 刪除上兩步生成的過渡圖例輸出文檔添加主文檔 2004 - 2010 UC Mobile42n 點擊主文檔圖例n 把它的父包拖到工作區(qū)里面輸出文檔把Model Document加到主模板 2004 - 2010 UC Mobile43n 把Toolbox/Documentation里面的Model Document拖四個到工作區(qū)并命名為業(yè)務需求、模塊關系、接口設計和關鍵邏輯輸出文檔把Model Document加到主模板 2004 - 2010 UC Mobile44n 按Pro

23、ject Browser導航的按鈕調整這四個Model Document的順序，這個順序和后續(xù)文檔輸出章節(jié)順序一致輸出文檔把數(shù)據(jù)加到Model Document 2004 - 2010 UC Mobile45n 在howntown目錄下添加三個Package“模塊關系”，“接口分析”和“關鍵邏輯”n 把前面做的howntown包圖，類圖和關鍵邏輯圖按住左鍵分別拉到上述Package當中（相當于剪切、粘貼）輸出文檔把數(shù)據(jù)加到Model Document 2004 - 2010 UC Mobile46n 把需求分析的package（需求模型下的howntown包）以及上一步的三個Package按左

24、鍵拖到工作區(qū)對應的Model Document輸出文檔選擇模板 2004 - 2010 UC Mobile47n打開頂部主菜單View/Tagged Values選項卡n在工作區(qū)按左鍵選中主文檔和模板文檔，在右邊的選項卡上的“RTFTemplate”上分別選擇合適的模板l主文檔： uc 樂園概要設計文檔-主模板l需求分析：uc 樂園功能清單-功能列表l模塊關系：uc 樂園概要設計文檔-模塊關系l接口設計：uc 樂園概要設計文檔-接口設計（圖）l關鍵邏輯：uc 樂園概要設計文檔-關鍵邏輯關系輸出文檔切換回Project Browser 2004 - 2010 UC Mobile48n切換回Pro

25、ject Browser輸出文檔輸出成概設文檔 2004 - 2010 UC Mobile49n右鍵點擊howntown主文檔包-選擇Documentation-Rich Text Format (RTF) report(快捷鍵：F8)-填寫文檔地址-生成文檔把howntown package的設計模型正向輸出成代碼 2004 - 2010 UC Mobile50n 右鍵點擊ClassModel/tmp下的howntown包- 點擊 Source Code Engineering - 點擊Generate Package Source Code-勾選輸出“包含子目錄”和“自動生成文件”-選擇輸出地址-按Generate輸出n 在EA8.0里面輸出的代碼需要補充命名空間把結果簽入到版本庫 2004 - 2010 UC Mob