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