【正文】 用友 U9UBF 應(yīng)用開發(fā)手冊 前言 UAP（ Universal Application Platform）是用友公司為開發(fā)新一代面向服務(wù)（ ServiceOriented Architecture, SOA）的世界級商業(yè)應(yīng)用套件產(chǎn)品（ U9）而精心打造出來的 ERP 軟件生產(chǎn)平臺 。通過 UAP 平臺，使企業(yè)信息資源變得可重用、透明化，并且系統(tǒng)具有高可擴展性，讓業(yè)務(wù)處理更加高效、簡潔、安全。 UAP 平臺為用戶提供了一個統(tǒng)一的集成開發(fā)環(huán)境 ，用戶可以使用包括模型設(shè)計、 UI 設(shè)計、報表設(shè)計、規(guī)則設(shè)計、數(shù)據(jù)庫設(shè)計、 BI 設(shè)計等各方面的設(shè)計器，并通過可視化的界面和友好的交互操作，自動生成用戶所需要的各種功能控件。使得大型的企業(yè)級商業(yè)應(yīng)用軟件第一次實現(xiàn)了技術(shù)與業(yè)務(wù)關(guān)注點的分離，并且通過快速的動態(tài)業(yè)務(wù)建模與服務(wù)組裝技術(shù)，實現(xiàn)了企業(yè)動態(tài)業(yè)務(wù)的快速部署與應(yīng)用，真正實現(xiàn)了“隨需而變”的實時企業(yè)與全球商務(wù)的企業(yè)信息化價值理念。 UAP（ Universal Application Platform）平臺是用友軟件經(jīng)過多年的技術(shù)積累和知識沉淀，在微軟 .NET 相關(guān)規(guī) 范和標(biāo)準(zhǔn)的基礎(chǔ)上，提供完全支持基于領(lǐng)域語言 (DSL)的模型驅(qū)動開發(fā)(MDD)模式，為各種復(fù)雜的企業(yè)級商業(yè)應(yīng)用系統(tǒng)提供專業(yè)、安全、高效、可靠的開發(fā)、部署和運行企業(yè)管理應(yīng)用軟件的開發(fā)工具平臺。它主要包括：應(yīng)用運行平臺（ UBF）、應(yīng)用開發(fā)平臺（ UBF Studio）和組件化發(fā)布平臺。 ? UBF（ UFIDA Business Framework） 實現(xiàn)與操作系統(tǒng)、數(shù)據(jù)庫、 .Net Framework、 Office、 WMI、 .Net Compact Framework、 MSMQ等底層核心技術(shù)的調(diào)用與協(xié)作，通過屏蔽底層 的復(fù)雜實現(xiàn)，提高企業(yè)應(yīng)用軟件的靈活性、可擴展性和開放性。 針對開發(fā) ERP 軟件的特點，提供了一套適用的類庫、框架以及具有擴展性的通用解決 方案。有效地降低了 開發(fā)工作的難度和工作量。 在系統(tǒng)交付、安裝和部署后，支撐業(yè)務(wù)系統(tǒng)的解析和執(zhí)行；提高應(yīng)用軟件的可定制性與可集成性。提供對 OFFCIE、移動商務(wù)、第三方軟件系統(tǒng)等企業(yè)級的集成與應(yīng)用協(xié)同。 ? UBF Studio 提供了統(tǒng)一的集成開發(fā)環(huán)境，其中包括模型設(shè)計、 UI 設(shè)計、報表設(shè)計、規(guī)則設(shè)計、數(shù)據(jù)庫設(shè)計、 BI 設(shè)計等各方面的設(shè)計器，通過可視化的界面和友好的交互自動產(chǎn)生需要的 各種軟件工件，極大地提高了軟件開發(fā)的效率和質(zhì)量。提供對完整產(chǎn)業(yè)鏈的全角色開發(fā)的支撐環(huán)境。 ? 組件化發(fā)布平臺 提供軟件產(chǎn)品的 組件規(guī)劃工具，以定義軟件產(chǎn)品的工藝圖。自動化構(gòu)造工具將依據(jù)該工藝圖，自動地構(gòu)造組件并存入組件庫中。安 裝系統(tǒng)生成工具將按照用戶的意圖從組件庫中提取適當(dāng)?shù)慕M件產(chǎn)生安裝包 。 在本手冊中我們將詳細介紹怎樣使用 UAP 中的 UBF 和 UBF Studio 開發(fā)應(yīng)用。 UBF 概述 UAP 平臺與應(yīng)用系統(tǒng)間的整體邏輯架構(gòu) UAP 平臺是在國際上主流和公認的技術(shù)標(biāo)準(zhǔn)與規(guī)范的基礎(chǔ)上建立的一個開放的企業(yè)級開發(fā)工具平臺 。它采用了元數(shù)據(jù)驅(qū)動的、面向服務(wù)的體系架構(gòu)，并提供了統(tǒng)一的編程抽象模型，是一個適合應(yīng)用軟件開發(fā)及部署的全角色平臺。 UAP 平臺與應(yīng)用系統(tǒng)之間的邏輯關(guān)系與整體架構(gòu)如 下 圖所示。 其中， UAP 平臺提供了模型定義、服務(wù)組裝、應(yīng)用開發(fā)集成環(huán)境（ UBF Studio）、應(yīng)用平臺以及應(yīng)用工具等五個核心的工具集。并通過這五大工具集為應(yīng)用系統(tǒng)以及第三方的其它應(yīng)用提供統(tǒng)一的模型定義、功能開發(fā)與應(yīng)用集成的環(huán)境。 UAP 平臺的技術(shù)體系架構(gòu) UBF 的技術(shù)體系結(jié)構(gòu)采用分層的架構(gòu)模式，主要可以分為數(shù)據(jù)層、業(yè)務(wù)層、表示層，并且通過抽象的控件 模型提供對多種客戶端的應(yīng)用支持。整個架構(gòu)如下圖所示： 其中，在數(shù)據(jù)層中，持久化服務(wù)引擎主要負責(zé)訪問和查詢存儲在數(shù)據(jù)庫中的各種業(yè)務(wù)數(shù)據(jù)，在隔離業(yè)務(wù)層和數(shù)據(jù)存儲管理的同時，實現(xiàn)與業(yè)務(wù)層的實時交互。持久化服務(wù)的這種隔離有以下好處： —— 減少數(shù)據(jù)庫提供者變更帶來的影響； —— 減少因數(shù)據(jù)對象變更帶來的影響（如變更數(shù)據(jù)庫的 schema）； —— 封裝數(shù)據(jù)的處理操作，這將在很大程度上減少測試和維護工作； —— 通過 O/R 映射機制，以維護對象和持久存儲之間的一致性，減少因面向?qū)ο蠛头敲嫦驅(qū)ο筮@兩種技術(shù)存在著阻抗不匹配。 在 業(yè)務(wù)層中，業(yè)務(wù)實體對象封裝了一個業(yè)務(wù)中的元數(shù)據(jù)、存儲過程和觸發(fā)器以及該業(yè)務(wù)的規(guī)則、過程或事件。業(yè)務(wù)實體對象是業(yè)務(wù)中實際存在的事物或概念，是對“ ER”模型中概念的面向?qū)ο蟮臄U展。業(yè)務(wù)實體對象負責(zé)執(zhí)行包括強制的業(yè)務(wù)規(guī)則、應(yīng)用規(guī)則、數(shù)據(jù)有效性、并發(fā)和存儲等所有方面的內(nèi)容。且多個獨立的但有關(guān)聯(lián)關(guān)系的業(yè)務(wù)實體對象可以一起協(xié)作來完成一個應(yīng)用，完成不同的任務(wù)需執(zhí)行很多具有不同特點的業(yè)務(wù)實體對象。 而業(yè)務(wù)服務(wù)則可以定義為一段獨立的邏輯程序，當(dāng)多個服務(wù)組合在一起時可完成不同類型的業(yè)務(wù)需求。服務(wù)描述了貫穿業(yè)務(wù)的工作流程和信息， 同時對業(yè)務(wù)邏輯進行了封裝，實現(xiàn)了對業(yè)務(wù)實體對象的操作，并驅(qū)動業(yè)務(wù)實體完成業(yè)務(wù)功能。服務(wù)可以由工作流系統(tǒng)、業(yè)務(wù)實體對象管理器、面向?qū)ο笳Z言或交互過程定義系統(tǒng)實現(xiàn)。通過 UDDI 服務(wù)網(wǎng)關(guān)來查詢、綁定內(nèi)部或外部相應(yīng)的服務(wù)或應(yīng)用，并調(diào)度相應(yīng)的一個或多個業(yè)務(wù)實體對象來實現(xiàn)業(yè)務(wù)處理。而業(yè)務(wù)流程對象封裝了業(yè)務(wù)處理與業(yè)務(wù)策略過程。例如，一個定單處理工作流組件可能結(jié)合客戶、定單等業(yè)務(wù)實體對象完成定單處理的工作流程。 在表示層中，通過 MVC 的模式建立業(yè)務(wù)模型、視圖以及控制器之間的業(yè)務(wù)連接，并實現(xiàn)對各種客戶端界面（包括基于瀏覽器的 WEB 應(yīng)用方式、用戶交互的窗體以及 Smart Client 等應(yīng)用方式）的支持。每個窗體用來顯示系統(tǒng)提供的信息以及傳遞用戶的輸入信息。這種基于窗體的用戶界面包括兩種類型的組件： —— 用戶界面組件： 基于 .NET Framework 的組件，包括 Smart Client 組件和 Web Form 組件 ,還支持用戶基于 .NET Framework 定制的組件。 —— 用戶界面處理組件： 復(fù)雜的用戶界面通常需要很多非常復(fù)雜的窗體。為了提高其可復(fù)用性、可維護性和可擴展性，需要創(chuàng)建分離用戶界面處理的組件，以封裝窗體和界面導(dǎo)航之間的 相關(guān)邏輯?？梢詫σ粋€窗體中組件之間的依賴、確認和導(dǎo)航應(yīng)用相同的概念。這些 UIP組件通常是一些基于諸如： Front Controller, Application Controller 等設(shè)計模式的定制組件。UI 和 UIP 組件之間的交互通常采用 MVC 模式。 另外， UBF 技術(shù)體系架構(gòu)中還包含基礎(chǔ)服務(wù)層：即提供其它所有層都能使用的一系列基礎(chǔ)服務(wù)。這些服務(wù)分成三類： —— 安全：提供與應(yīng)用和系統(tǒng)安全相關(guān)的服務(wù)集合； —— 執(zhí)行控制管理：這些服務(wù)負責(zé)管理組件或服務(wù)以及相關(guān)的資源，還負責(zé)處理容錯和可擴展性等操作和控制的需求 ； —— 通信：提供組件或服務(wù)之間的通信，包括 .NET Remoting、 SOAP、同步或異步消息等服務(wù)。 UBF 領(lǐng)域模型語言（ DSL） 為了提供對模型驅(qū)動的軟件開發(fā)技術(shù)的有效支持， UBF 臺提供了一種領(lǐng)域特定語言（ DSL），其中包括了業(yè)務(wù)領(lǐng)域語言、表單領(lǐng)域語言、流程領(lǐng)域語言以及報表領(lǐng)域語言等。并針對不同的領(lǐng)域語言采用不同的模型化以及組件化的生成方式，例如通過業(yè)務(wù)領(lǐng)域語言，可以有效地建立實體模型、數(shù)據(jù)模型以及服務(wù)模型，并且根據(jù)模型的關(guān)鍵屬性與特征生成相應(yīng)的軟件組件。通過多種模型生成的各種相關(guān)的軟件組件在應(yīng)用組 裝語言的支持下實現(xiàn)動態(tài)組裝，從而快速形成一個完整的應(yīng)用系統(tǒng)。 其中： ? 版型 是擴展業(yè)務(wù)實體定義的描述方法，是對業(yè)務(wù)對象進行分類識別的工具，主要用來對業(yè)務(wù)模型進行抽象，找出實體間的公共屬性；每個版型可附帶一個代碼片段作為模版， 根據(jù)業(yè)務(wù)需要由設(shè)計人員動態(tài)創(chuàng)建，在實體定義階段進行引用。通過設(shè)置版型，對實體進行標(biāo)識，從而易于識別，并可基于版型進行分類。比如：帳表類實體等樹形實體，可通過建立版型進行識別。 ? 特性 可在不同實體間復(fù)用的屬性集和版型集；可復(fù)用的屬性集和版型集通過實體轉(zhuǎn)存為特性，在維護實體屬性和方法的 時候通過引用特性引入已保存的特性。 ? 模式 : 可在不同組件間復(fù)用的實體集，以及實體間的關(guān)系。 實體模型 實體模型用于描述業(yè)務(wù)數(shù)據(jù)的結(jié)構(gòu)和關(guān)系。實體模型族中包括 實體 組件、實體、屬性 類型、數(shù)據(jù)傳輸對象、動態(tài)枚舉 、 異常、 實體校驗器 、事件 和關(guān)系。 其中關(guān)系分為繼承、組合和關(guān)聯(lián)。 實體 組件 實體 組件 與軟件行業(yè)通常所說的組件的概念并不相同， 實際是 用于描述一組具有強依賴關(guān)系的實體的邊界。在一個實體組件內(nèi)僅能有一個主要實體及其組合的實體。 UBF 的持久化引擎使用實體組件 的 元信息 以 保證 實體組件內(nèi) 主實體與其組合實體的生命周期的一 致性。 實體 實體模型用于開發(fā)者定義應(yīng)用的數(shù)據(jù)模型。 實體模型中包括屬性和方法。 實體分為主實體和非主實體，其中只有主實體才能組合非主實體，而不能被組合。 在 實體模型上需要指定實體在數(shù)據(jù)庫上存儲時的數(shù)據(jù)庫表的表名。如果該實體繼承于其他實體，還需要指定這種繼承關(guān)系在數(shù)據(jù)庫上的存儲方式，目前 UBF 僅支持單表繼承 —— 即基類的數(shù)據(jù)也將存儲在具體的實現(xiàn)類對應(yīng)得表中。為了優(yōu)化實體數(shù)據(jù)的加載和保存效率，開發(fā)者還應(yīng)當(dāng)在實體上建立一個索引 項，并仔細地規(guī)劃索引項中應(yīng)當(dāng)包含的實體的屬性和次序。 實體模型上還有用于通用查詢服務(wù)的標(biāo) 志，如果開發(fā)人員設(shè)置了該標(biāo)志，則通用查詢服務(wù)將可以展現(xiàn)該實體的數(shù)據(jù)。 如果開發(fā)者設(shè)計了一個僅用于繼承的抽象實體，需要設(shè)置抽象類標(biāo)志。 實體的屬性 實體屬性是關(guān)于實體中數(shù)據(jù)項的描述模型。它的基本信息包括名稱、類型、顯示名和缺省值。 實體屬性模型中有一組關(guān)于校驗的信息用于持久化引擎對數(shù)據(jù)的合法性進行校驗，如可空標(biāo)志、 只讀標(biāo)志、字符串的長度以及數(shù)值類型的值范圍等。 實體屬性模型中與持久化有關(guān)的信息包括業(yè)務(wù)主鍵、一旦使用不可修改、國際化、是否敏感日志字段。其中如果聲明為業(yè)務(wù)主鍵則該屬性將成為該實體的唯一約束的一 部分，只有當(dāng)實體對象上所有業(yè)務(wù)主鍵屬性的值組合沒有重復(fù)時，該實體 對象才能成功地增加 。 國際化用于指定字符串類型的屬性是否支持多語編輯和保存。一旦使用不可修改標(biāo)志用于類型為其他實體 —— 引用關(guān)系，被設(shè)置后表明該實體對象所引用的其他實體對象將不能被修改。 是否敏感日志字段標(biāo)志用于指定該屬性的改變是否做系統(tǒng)得變更記錄。 實體屬性還可以被指定為計算列，并能定義計算表達式。計算列不會被存儲到數(shù)據(jù)表中。 關(guān)聯(lián)實體可見和服務(wù)可見標(biāo)志用于指定 屬性的可見性，只有被設(shè)置的屬性才能被關(guān)聯(lián)實體訪問或作為服務(wù)的參數(shù)。 而查詢屬性標(biāo)志 則，表示該屬性是否可以被通用查詢服務(wù)所展示。 實體上可以指定任意數(shù)目的可開發(fā)者設(shè)計的校驗器，以保證業(yè)務(wù)數(shù)據(jù)的合法性。 實體的方法 實體方法是關(guān)于實體中行為的描述模型。開發(fā)者除了可以指定名稱、顯示名稱和返回值類型等基本屬性外，還可以指定可見性 —— 如 public、 protected 等，以及靜態(tài)、虛方法和重載方法。 實體的方法模型上可以聲明任意數(shù)量的異常，以表明該方法將可能拋出這些業(yè)務(wù)異常。 實體的版型 開發(fā)者可以為實體指定一個或多個版型。 屬性類型 屬性類型是一種沒有獨立 生命 周期的特殊實體。它可以有屬性 和方法 ，但沒有校驗器。屬性類型模型沒有持久化相關(guān)的信息，不能被持久化到獨立的表中。它 的數(shù)據(jù)只能被存儲到使用它的實體的表中，相當(dāng)于嵌入在實體中的復(fù)合數(shù)據(jù)。 數(shù)據(jù)傳輸對象 數(shù)據(jù)傳輸對象是可以遠程傳輸?shù)奶厥鈱嶓w。但不能被持久化到數(shù)據(jù)庫中。在數(shù)據(jù)傳輸對象中其屬性的類型如果是實體類型，則應(yīng)當(dāng)指定是實體的類型本身還是實體 Key 類型 。通常應(yīng)當(dāng)指定為實體 Key 類型。 動態(tài)枚舉 動態(tài)枚舉是一種既可以在設(shè)計期指定枚舉值，也可以在運行時動態(tài)增加枚舉值的數(shù)據(jù)類型。 實體校驗器、事件和異常 用于定義實體的業(yè)務(wù)校驗器和業(yè)務(wù)異常信息以及業(yè)務(wù)處 理過程中發(fā)出的業(yè)務(wù)事件。 關(guān)系 關(guān)系的模型用于定義實體間的關(guān)系。這包括繼承關(guān)系、組合關(guān)系和關(guān)聯(lián)關(guān)系 。組合關(guān)系只能用于實體組件內(nèi)部，而關(guān)聯(lián)關(guān)系只能在實體組件間使用。 像數(shù)據(jù)庫的表設(shè)計一樣，組合和關(guān)聯(lián)關(guān)系可以定義為一對多、一對一、多對多關(guān)系。 在關(guān)聯(lián)關(guān)系中需要 定義級聯(lián)刪除規(guī)則。 當(dāng)級聯(lián)刪除標(biāo)志置為 True 時， 表示需要對關(guān)聯(lián)關(guān)系的被引用實體在刪除時做級聯(lián)刪除檢查，否則不做任何控制。 如果級聯(lián)刪除規(guī)則為NoAction，表示如果要刪除的實體被引用，則將不能被刪除；如果級聯(lián)刪除規(guī)則為 SetNull，表示如果實體被引用 ，則當(dāng)它引用的實體被刪除時，引用方改為空值；如果果級聯(lián)刪除規(guī)則為 Cascade，表示如果要刪除的實體已經(jīng)被引用，則連同引用者一起刪除。 當(dāng)是否啟用級聯(lián)校驗置為 True 時，如果將要刪除一個實體 的實例時 時需要將該關(guān)系上引用 被刪除 實體的實體 納入到規(guī)則控制范圍內(nèi)