Rad工具使用說明

經典word整理文檔，僅參考，轉Word此處可刪除頁眉頁腳。本資料屬于網絡整理，如有侵權，請聯系刪除，謝謝！1背景介紹...............................................................................................................................21.1Asura頁面結構...............................................................................................................21.2Rad工具布局..................................................................................................................22單表實體示例.......................................................................................................................32.1創(chuàng)建項目.........................................................................................................................32.2創(chuàng)建模塊.........................................................................................................................82.3創(chuàng)建實體.......................................................................................................................102.4創(chuàng)建功能......................................................................................................................1611背景介紹Asura架構中的基本頁面布局如下：圖1在上圖中：項目：頁面中就是訪問的地址；模塊：項目中包含模塊，一個模塊通常對應一個以及菜單（也可能不對應）；實體：與數據庫中一個表對應的一個Java類；功能：對應模塊下的一個具體菜單，通常對應一個或多個實體。Rad工具的基本布局如下：菜單欄區(qū)：包括項目、功能、工具、窗口、幫助等各種菜單命令；2工具欄區(qū)：提供一些常用菜單的快捷方式。主要有：新建項目、打開項目、保存、保存全部、新建模塊、新建實體、新建功能、生成代碼等；導航區(qū)：包括模塊、項目、文件三種導航視圖，分別瀏覽模塊信息、項目配置和項目下的文件；主編輯區(qū)：用來查看、編輯各種配置信息；輸出區(qū)：輸出輔助的操作信息，說明相關操作執(zhí)行的具體動作，便于用戶監(jiān)控。圖22單表實體示例下面做一個單表的例子，使用戶可以快速熟悉Rad工具的使用與操作。．1創(chuàng)建項目的過程如下：13>新建項目”（圖4），還可以在導航面板中點右鍵菜單中的“新建項目”（圖5）。3圖3圖4圖52、之后你將看到“新建項目”的導航窗口，它將引導你一步一步創(chuàng)建自己的項目，首先，在第一頁（圖），是項目的基本信息設置，你輸入好相應的代碼后，點擊下一步。需要輸入的項有：項目代碼：在Rad工具中顯示的項目名(不能為中文)項目名稱：項目的名稱（可以為中文）項目描述：頁面上方顯示的項目信息，可簡要說明項目的作用（最好為中文）如圖6。圖6所在路徑：默認為本工具目錄下\workspace（可以點擊瀏覽自己選擇）4圖7testProject3、第二頁數據庫設置，選好“數據庫類型”后，“JDBC”與“數據庫連接串”會有初步的設置，你只需要修改連接串中的IP地址和ID即可，然后繼續(xù)完成下面的設置。數據庫類型：用戶自己的數據庫類型(目前有Oracle10g\Oracle9i\MySQL\SQLServer四項可供選擇，但目前只支持Oracle數據庫)JDBCDriver:JDBC驅動（有默認值、可修改）youroraclehost和yoursid，可修改）UserName:數據庫管理的用戶名5Password:數據庫管理的密碼圖8:OracleJDBCDriver:youroraclehost:3yoursid:c2devdbUserName:166046Password:1660464、點擊下一步后，如果出現圖9的頁面，則顯示創(chuàng)建項目成功。點擊完成則可，否則返回數據庫設置重新設置。6圖95、項目創(chuàng)建成功后，右下角會出現項目代碼的加載進度條（圖），稍等一會，新建的項目下會有四個缺省的系統(tǒng)模塊，提供框架相關功能的實現。用戶也可以手工修改這些模塊的代碼，但不建議用戶在工具上對這些模塊進行維護。圖107圖111、項目創(chuàng)建好后，接著就要創(chuàng)建模塊了，可以選擇菜單欄“功能—>新建模塊”，也可以選擇工具欄快捷按鈕，我們用的是第三種方式，在要創(chuàng)建模塊的項目上點擊右鍵，選擇彈出菜單的“新建模塊”功能（圖12）。圖122、新建模塊的第一頁（圖14），前三項都是要求用戶輸入，“所屬項目”一項默認的是用戶選中的項目，用戶也可以選擇往別的已存在項目中創(chuàng)建模塊。模塊代碼：模塊的代碼，如果該模塊下有功能，則會向TS_Module中填充一條記錄；模塊名稱：模塊的名稱，會對應到頁面的一個以及菜單圖13模塊描述：模塊的簡要描述所屬項目：決定此模塊歸屬哪個項目，默認為當前選中的項目，可選擇。8圖14testModule1113、模塊創(chuàng)建好之后，可以在導航區(qū)的模塊面板中相應的項目下找到它（圖15）。新建好的模塊會包含action\biz\domain\jsp\I18n等默認子節(jié)點。9圖151、同樣有三個選擇：1菜單欄“功能—新建實體”；2工具欄快捷按鈕“新建實體”；3在相應模塊上點擊出右鍵菜單（圖）。圖162、“新建實體”對話框首頁中（圖18），“實體名稱”、“顯示名稱”需按要求輸入，然后選擇所對應的項目和模塊，一般默認即可。最后選擇好對應的表名。點擊下一步。所屬項目：決定此實體歸屬哪個項目，默認為當前選中的項目，可選擇。所屬模塊：選中項目所包含的所有模塊，默認為當前選中的模塊，可選擇。對應表名：選中項目對應數據庫中的所有表名，表與實體只能一一對應，可選擇。10實體名稱：新建實體對象的名稱，對每個實體將生成一個JAVA類。工具會根據表名按照命名規(guī)范生成一個缺省的類名，可修改。顯示名稱：生成頁面上新增和修改頁面中顯示的名稱圖17圖18TT_TEST_USER_SINGLETestUserSingle113、接下來設置的是字段映射，如圖19的表所示：是/否映射——選擇框，選中代表該字段需要被映射屬性名——字段名的映射，可修改，不可為空顯示名——頁面中的顯示名稱，會在查詢、編輯及列表中顯示，若有映射關系，則不可為空字段名——已選表中所有字段名字段類型——字段所對應的類型，只能修改可隱式轉換的類型（如Short可修改為Integer）長度——字段長度，字節(jié)為單位，可修改小數點位數——只有數值型的字段可以修改允許為空——設置字段是否允許為空，不能和表中的設置沖突設置好之后，點擊下一步繼續(xù)設置圖19124、字段映射完成后，即需設置“設置主鍵信息與字段配置”，圖20.主鍵字段——設置主鍵字段，必須是“Long”型字段主鍵生成器——主鍵字段的處理方式，系統(tǒng)對主鍵的處理是可以自動生成的。Sequence選擇——如果采用SEQUENCE主鍵生成，則在此選擇數據庫的Sequence.版本號字段——HibernateMapping中的版本號字段?！皠?chuàng)建人字段”等――實體的一些基本字段，如果設定了這些字段，系統(tǒng)會在用戶修改或新增數據時自動給這些字段賦值；如果沒有，可以為空。設置好之后，點擊下一步圖20testIdSEQUENCE13SequencecreatedEmpCodecreatedTmmodifiedEmpCodemodified5、最后一步是設置關聯實體，如沒有關聯關系直接點擊“完成”。如果有關聯關系，點擊“插入”，輸入相應的代碼即可。實體字段——本實體的關聯字段關聯實體——關聯實體名稱關聯字段——與本實體相關聯的字段關聯類型——關聯字段的類型本例無關聯實體。圖216、點擊“完成”，實體創(chuàng)建成功后則出現在模塊的“domain”子目錄下，圖22.14圖227、現在可以打開實體編輯頁面繼續(xù)修改，也可以進行新建功能操作。圖23151、菜單欄與工具欄的“新建功能”按鈕都可以用，我們繼續(xù)用右鍵菜單中的“新建功能”選項（圖24）。圖242、在彈出的新建功能第一頁，是功能基本信息的設置（圖27）。功能代碼、功能名稱、功能描述需用戶輸入，輸入好后，選擇功能所屬的項目和模塊及對應的實體。完成之后點“下一步”。所屬項目：決定此功能歸屬哪個項目，默認為當前選中的項目，可選擇所屬模塊：決定此功能歸屬哪個模塊，默認為當前選中的模塊，可選擇對應實體：相對應的實體，功能必須與一個實體相對應，且該實體不能已經存在相關的功能，否則會覆蓋已有的代碼；功能代碼：功能對應的功能代碼，對應于TS_Module中的Module_Code，要求功能代碼不能與項目代碼、模塊代碼以及已有功能代碼相同；功能名稱：生成頁面中功能的顯示名（即模塊標簽下的子標簽名）圖25功能描述：功能的簡要描述，會在頁面中出現（下圖中黃色背景中的字符）16圖26圖27TestUserSingle:TT_TEST_USER_SINGLEtestUserSingle328.可任意選擇（如果全導航條——頁面左側的導航區(qū)域查詢表單——查詢頁面區(qū)域17編輯表單——彈出的編輯表單對話框顯示列表——數據顯示區(qū)域圖28對頁面中每一部分的設置方法，以下分別說明：2.4.1導航樹設置Action以及Biz方法暫時不生成，需要用戶自己去添加和實現。數據來源Action：用戶自定義的Action；對應實體名：導航樹節(jié)點對應的對象類；KeyKey值來展開子節(jié)點；節(jié)點顯示字段：導航樹節(jié)點的顯示名稱，可以是節(jié)點對象的任意屬性（目前不支持屬性的組合）；18實體關聯查詢字段：頁面對應實體屬性中的一個字段，會根據該字段對實體進行查詢。比如導航樹的對象類為Department，其Key值為ID，頁面對應的實體為User，選擇的關鍵查詢字段為DeptID，那么當用戶點擊導航樹某個節(jié)點ID＝5時，會使用查詢條件User.deptId=5去查詢數據，并將查詢結果顯示到右側的列表中；根節(jié)點關鍵字段初始值：導航樹根節(jié)點Key的初始值；根節(jié)點顯示字段初始值：導航樹根節(jié)點的顯示值。圖29數據來源ActiondataSource.ActioncorrEntityNamenodeKeynodeNametestId19rootKeyrootNameAction2.4.2查詢表單“查詢表單”設置頁面如圖22所示：實體字段——對應實體中的各個字段列表，不可編輯是否顯示——可選框，選中則會顯示在查詢表單中，至少需選擇一個可顯示輸入方式——可選擇多種輸入方式單行文本輸入:普通的文本框輸入，只能單行輸入圖30日期輸入彈出日歷形式的輸入器，選擇日期即可完成輸入時間輸入同上，也是彈出一個時間選擇框，選擇完成就可以完成輸入日期時間輸入:日期輸入與時間輸入的集合輸入圖31組合框輸入(ComboBox):下拉框式輸入，數據源需用戶自己輸入20圖32復選框輸入(CheckBox):只有兩種值，選擇或不選圖33校驗方式——默認“無校驗”，可選“數字范圍校驗”與“長度校驗”圖34組合框輸入(ComboBox)選中輸入方式中的組合框輸入時，下方會出現一個“數據源”輸入框，用來輸入組合框的數據。此數據源只能有三種形式，示例如下：1：map類型，示例：男女2：list類型，是例：男,女3：action類型，示例：action:findByTestTeam.action,entity=testTeams,key=teamCode,value=teamName其中，action項是action名稱，entity項是action返回的數據屬性名稱，key項是實體的關鍵字段，value項是顯示字段。圖35當有選中“是否顯示”時，下方的“輸入方式”和“校驗方式”選擇框可用（圖36），也可在此設置選中字段的“輸入方式”與“校驗方式”。圖36復選框輸入(CheckBox)對CheckBox輸入，只要需要設定該輸入項的選中值和不選中值（通常為1和0）校驗方式目前工具提供了兩種校驗方式：數字范圍校驗和字符長度校驗?！靶ｒ灧绞健边x中“數字范圍校驗”時，右下方會出現兩個輸入框，分別輸入數字37了“最小長度”與“最大長度”，這時候輸入長度的最小值與最大值即可（圖38）?！皵底址秶ｒ灐迸c“長度校驗”的最大最小值都必須是整型數值。圖3723圖38testId是是是是是是是是否否否codenamegenderbirthdaydiscoverIssuesteamCodecreatedEmpCodecreatedTm24modifiedTmvalidFlag否是map:1=,2=女List:10大于1050大于50個action:findByTestTeam.action,entity=testTeams,key=teamCode,value=teamName111050100圖39設置完成后（圖39），點擊“下一步”。252.4.3編輯表單編輯表單主要用來新增或修改數據，其配置界面如圖40。其中上面的配置項有：表單寬度：彈出的編輯窗口的寬度，單位為象素；表單高度：彈出編輯窗口的高度，單位為象素；表單列數：編輯窗口中每行編輯的屬性數目，輸入多少，每行就有多少個輸入項。設置表中各列含義如下：實體字段：對應實體中的各個字段，不可編輯；是否顯示：可選，選中則在編輯表單中顯示；可否編輯：可選，選中則在編輯表單中允許修改；可否為空：該字段是否可以為空，如果不為空，頁面會做非空校驗；輸入方式與校驗方式同查詢頁面說明。如實體有從表，則可在下方的表中設置從表配置，本例無從表，不再累述。26圖401testId否是是否是是否否否codename是是是gender是是是是是是否否否否是是是是是是是是是是birthdaydiscoverIssues是teamCodecreatedEmpCode否createdTm否組合框輸入（③）無校驗是否modifiedTmvalidFlag否是復選框輸入（④）無校驗完成設置，點擊“下一步”。2.4.4數據表格數據表格用來顯示查詢出來的數據，其設置頁面，默認如圖41：表單每頁記錄數：顯示頁面顯示的最大行數表格中：27實體字段：實體中的各個字段；是否顯示：可選，選中則在列表中顯示；列寬：可輸入，設置該屬性在列表中的列寬，單位為象素；如果是0，則系統(tǒng)會自動分配列寬；允許排序：可選，是否允許列表安指定字段排序；顯示格式：設置屬性的顯示格式，其中文本格式：記錄顯示為普通文本格式復選框顯示：記錄顯示為復選框形式日期格式：記錄顯示為日期格式時間格式：記錄顯示為時間格式日期時間格式：記錄顯示為日期+時間格式數據轉換：選中后，下方會出現轉換的參數輸入框（圖），數據參數格式與ComboBox中的數據源輸入方式相同，具體參見節(jié)。28圖41圖42本例代碼：表單每頁記錄數：20實體字段testId是否顯示列寬允許排序顯示格式文本格式是是是是是是是是是是0000000000否否否是是是否否否否code文本格式name文本格式age文本格式gender文本格式birthdaydiscoverIssuesteamCodecreateEmpCodecreateTm日期時間格式文本格式文本格式文本格式日期時間格式29modifiedEmpCodemodifiedTm是是是000否否是文本格式日期時間格式文本格式validFlag設置完畢后，點擊“完成”。添加完畢后，在jsp部分能看到新建的頁面，如圖43所示，則新建功能成功。圖431、選擇菜單欄“工具—生成代碼”或工具欄上的快捷按鈕（圖）。圖442、出現圖45所示的消息對話框，說明代碼生成成功。30圖453、生成的代碼存放在\workspace\testProject的code目錄下。圖46代碼生成完畢后，即可直接通過工具生成的Ant腳本構建項目，構建出來的項目可以直接在Jboss上運行。前提條件：必須裝有Ant和JBOSS（至少支持JDK1.5的）。1、在\workspace\testProject\build\scripts目錄下中使用Ant命令，即打開build.bat文件。圖47圖472、成功后?？煽吹饺缦聢D的代碼：圖4831圖49生成后的代碼以war包的形式保存在\workspace\testProject\build\dist目錄下，如圖50，xml圖50將生成的war包和配置文件拷貝到JBOSS安裝目錄下的\server\default\deploy中（圖），并啟動。圖51JBOSS啟動完畢后，在瀏覽器中輸入“http://localhost/8080/testProject”,即可出現登錄界面（圖）。輸入登錄賬號：admin密碼：sf123456，應可登錄進入系統(tǒng)。32圖53正常登錄后，即可看到生成的維護界面如下：33圖54其中的權限管理圖55為項目的默認模塊，后面的圖5634測試模塊1、測試模塊2為我們自己建的模塊。本例生成的是“測試模塊1”的“測試單表頁面”圖57打開后如下所示：圖58左側的導航樹，因為需要用戶自己完善，故沒有數據。下圖是點擊查詢后的頁面（圖59）35圖59點擊新增后的彈出頁面（圖60）圖60選中數據后，點擊修改的彈出頁面（圖）36圖61選中數據后，點擊刪除的頁面（）圖62詢頁面設置）。37圖63組合框輸入的結果圖64復選框輸入的結果圖65選擇數字校驗后的結果Eclipse或其他開發(fā)工具中對相關的代碼或頁面進行相應的編輯。3主從表示例下面再做一個主從表的示例：圖6838如上圖所示，先建好兩個實體TestUser.domain與TestUserItem.domain。兩個實體可以不在同一模塊下。打開TestUser.domain的編輯頁面并選擇“與其他實體的關聯