江西數(shù)據(jù)民政項目開發(fā)規(guī)范 (一)

江西數(shù)字民政項目

開發(fā)規(guī)范

文檔編號：MZ0001

版本信息：V1.0

編寫日期：2013-08-12

文檔控制

日期作者版本更改日志

2013/8/12陳春登1.0草稿

2013/8/19劉成陽1.1草稿

2013/8/21陳炳旭1.2草稿

2013/08/26陳春登1.21.根據(jù)項目組審核意見調(diào)整部分內(nèi)容（含

命名、性能等）；

2.完善2.4節(jié)系統(tǒng)模塊分配表內(nèi)容；

3.完善4.2.8和4.2.9節(jié)數(shù)據(jù)庫對象命名

和注釋規(guī)范；

4.其他：將第5章移至4.1.2.2節(jié)，名稱

變更為“UAP單據(jù)默認(rèn)字段命名規(guī)范”；

2013/08/27陳春登1.21.完善系統(tǒng)模塊分配表；

2.增加2.6節(jié)，業(yè)務(wù)組件命名規(guī)范，對項

目和模塊的命名進(jìn)行規(guī)范；

2013/09/09陳春登1.31.修改4.2.8節(jié)，修改表命名規(guī)范；

2013/09/11陳春登1.31.增加2.4節(jié)，單據(jù)類型命名規(guī)范；

2013/10/10陳春登1.31.調(diào)整2.8節(jié)，增加客戶端和服務(wù)器端交

互策略第四點（強制要求）。

2013/11/06陳春登1.31.刪除4.1.1.2節(jié)“UAP單據(jù)默認(rèn)字段命名

規(guī)范”，公共字段可參考《民政業(yè)務(wù)公

用字段.xls》。

2013/12/5朱龍斌1.31.增加第5章“軟硬件配置”，闡述應(yīng)用

開發(fā)和實際運行中各硬件和軟件的規(guī)格

和版本；

2013/12/19陳春登1.41.增加2.8節(jié)”報表開發(fā)規(guī)范”，規(guī)范在

報表開發(fā)中常見場景；

2.調(diào)整4.2.8節(jié)中表命名規(guī)范，增加報表

類信息主體，為報表開發(fā)提供表或者視

圖命名規(guī)范；

用反政務(wù)軟件

UFGOVQPKHJY0l04-V1.0

目錄

1概述...................................................................3

1.1規(guī)范目的............................................................3

1.2文檔說明............................................................3

2UAP應(yīng)用規(guī)范............................................................4

2.1元數(shù)據(jù)命名規(guī)范......................................................4

2.2模板命名規(guī)范........................................................4

2.3功能注冊規(guī)范........................................................4

2.4單據(jù)類型命名........................................................4

2.5系統(tǒng)模塊分配表......................................................5

2.6菜單注冊規(guī)范........................................................6

2.7業(yè)務(wù)組件命名規(guī)范....................................................6

2.8報表開發(fā)規(guī)范........................................................8

2.8.1數(shù)據(jù)源..........................................................8

2.8.2語義模型設(shè)計....................................................8

2.8.3自由報表設(shè)計.....................................................9

2.8.4數(shù)據(jù)集成設(shè)計....................................................10

2.9UAP開發(fā)參考.......................................................11

3JAVA編碼規(guī)范..........................................................13

3.1命名規(guī)范...........................................................13

3.1.1包的命名........................................................13

3.1.2類的命名........................................................13

3.1.3接口命名........................................................14

3.1.4方法命名........................................................14

3.1.5變量命名........................................................14

3.1.6常量命名........................................................17

3.1.7命名規(guī)范實例....................................................17

3.2注釋規(guī)范...........................................................18

3.2.1注釋分類........................................................18

3.2.2注釋標(biāo)注........................................................19

3.2.3注釋標(biāo)簽的使用..................................................19

3.2.4需要注釋的內(nèi)容.................................................20

基本原則....................................................20

類描述......................................................20

方法描述....................................................21

代碼行注釋..................................................21

成員變量注釋................................................21

3.3代碼風(fēng)格...........................................................21

3.3.1類成員順序.....................................................22

3.3.2格式規(guī)范.......................................................23

第1頁共56頁

政務(wù)軟件

UFGOVQPKHJY0l04-V1.0

3.3.3代碼長度.......................................................23

3.3.4局部變量的使用.................................................23

3.3.5可見性規(guī)范.....................................................23

3.4異常應(yīng)用規(guī)范.......................................................24

3.4.1異常捕獲的規(guī)范.................................................24

3.4.2異常拋出的規(guī)范.................................................24

3.5日志規(guī)范...........................................................24

3.6其他注意事項.......................................................25

4數(shù)據(jù)結(jié)構(gòu)規(guī)范..........................................................27

4.1數(shù)據(jù)命名規(guī)范.......................................................27

4.1.1術(shù)語和定義.....................................................27

中文名稱....................................................27

內(nèi)部標(biāo)識符..................................................27

數(shù)據(jù)類型....................................................27

數(shù)據(jù)格式....................................................28

值域........................................................28

信息分類編碼................................................28

4.1.2民政業(yè)務(wù)信息分類編碼...........................................29

通用編碼....................................................29

4.2數(shù)據(jù)庫對象應(yīng)用規(guī)范.................................................29

4.2.1存儲過程.......................................................29

4.2.2觸發(fā)器.........................................................29

4.2.3視圖...........................................................29

4.2.4索引...........................................................30

4.2.5表及外鍵.......................................................30

4.2.6函數(shù)規(guī)范支......................................................31

4.2.7產(chǎn)品配置數(shù)據(jù)庫腳本規(guī)范★.......................................31

4.2.8對象命名規(guī)范...................................................31

4.2.9對象注釋規(guī)范...................................................32

4.3SQL風(fēng)格..........................................................33

4.4性能優(yōu)化...........................................................34

4.5移植性考慮.........................................................53

5軟硬件配置規(guī)范........................................................56

5.1軟硬件版本管理規(guī)范.................................................56

5.2軟件獲取方式.......................................................56

第2頁共56頁

政務(wù)軟件

UFGOVQPKHJY0l04-V1.0

1概述

1.1規(guī)范目的

本規(guī)范旨在規(guī)范代碼（主要是Java和SQL,如存在其他語言則另作說明）開發(fā)，

提高代碼質(zhì)量。制定編碼規(guī)范的首要考慮的目標(biāo)是：

1、規(guī)范代碼的編寫。

2、提高代碼的可讀性。

程序首先是給人讀的，其次才是給機器運行的。引用《重構(gòu)》中的一句話：最糟糕

的程序員都能寫出讓計算機運行的程序，而只有優(yōu)秀的程序員才能寫出讓人看得懂的程

序。沒有誰的代碼是不需要維護的，尤其是現(xiàn)在，而維護代碼的人往往不是最初開發(fā)的

人，在這種情況下，代碼的可讀性就尤為重要了。

3、提高代碼的可維護性。

4、提高代碼的執(zhí)行效率。

5、為代碼審查提供標(biāo)準(zhǔn)。

1.2文檔說明

本規(guī)范盡量與行業(yè)規(guī)范一致，主要是Oracle的java規(guī)范，同時將工作中的實踐經(jīng)驗

融入其中，根據(jù)最佳實踐制定本規(guī)范，如果規(guī)范中存在矛盾的地方，則要根據(jù)實際情況

選擇性處理，規(guī)范不是枷鎖，而是指導(dǎo)性工具。

本文檔所要求的部分附加文件，要求在相關(guān)開發(fā)工具中導(dǎo)入并執(zhí)行，對于代碼檢查

的執(zhí)行標(biāo)準(zhǔn)可參考《江西民政一代碼檢查單.xls》。

第3頁共56頁

用反政務(wù)軟件

UFGOVQPKHJY0104-V1.0

2UAP應(yīng)用規(guī)范

2.1元數(shù)據(jù)命名規(guī)范

元數(shù)據(jù)文件命名

分目錄存放，文件命名為mz_子系統(tǒng)一模塊—組件.bmf。

元數(shù)據(jù)名稱

分級命名，mz_子系統(tǒng)一模塊，且件

2.2模板命名規(guī)范

單據(jù)模板

mz+'b'+兩位子系統(tǒng)編號+兩位模塊編號+兩位單據(jù)模板編號

查詢模板

mz+'q'+兩位子系統(tǒng)編號+兩位模塊編號+兩位查詢模板編號

輸出模板

mz+'o'+兩位子系統(tǒng)編號+兩位模塊編號+兩位輸出模板編號

2.3功能注冊規(guī)范

模塊名稱

MZ+兩位子系統(tǒng)編號

功能編號

1、每級兩位，除開始兩位字符外其他都用數(shù)字，如MZ010101

2、每個子系統(tǒng)都要以本系統(tǒng)的模塊為前綴，后面編號可以自行編碼，

但在實際編碼過程中建議，作出預(yù)留，假設(shè)低保系統(tǒng)模塊號為MZ01,

那么低保下可以分多個模塊，如乂20100,]\420102,乂20104,在模塊下

可以繼續(xù)分級，如:MZ010200,MZ0可202,MZ010204等等。

3、如果是字符則均需大寫。

功能名稱

1、以可讀的名稱命名功能，要能充分體現(xiàn)功能的含義并符合用戶的業(yè)

務(wù)習(xí)慣。

2.4單據(jù)類型命名

每一個業(yè)務(wù)單據(jù)又有一個唯一的單據(jù)類型，該單據(jù)類型在整個系統(tǒng)中都是唯一的,

第4頁共56頁

用反政務(wù)軟件

UFGOV_QP_KHJY_0l_04-V1.0

為了便于各業(yè)務(wù)系統(tǒng)對單據(jù)類型進(jìn)行命名這里給出建議規(guī)范，規(guī)范要求如下：

1、單據(jù)類型命名采用四個字符，全部采用英文字母大寫形式；

2、首字母為業(yè)務(wù)類型（參考通用編碼表），第二個字母是業(yè)務(wù)子類，無業(yè)務(wù)子類的

系統(tǒng)已字符“X”代替；

3、第三第四位字符由各自業(yè)務(wù)系統(tǒng)根據(jù)實際需要進(jìn)行分配，這里不做約束；

業(yè)務(wù)類型業(yè)務(wù)子類任意字符任意字符

以社會救助中的低保業(yè)務(wù)業(yè)務(wù)為例，低保申請單單據(jù)類型命名如下:

社會救助業(yè)務(wù)：業(yè)務(wù)類別是“H"

低保業(yè)務(wù)子類：低保代碼是“A"

申請單命名：定義為“AC”

則單據(jù)類型為：“HAAC”

2.5系統(tǒng)模塊分配表

系統(tǒng)代碼模塊代碼示例備注

MZ00（公共）MZ0000（動態(tài)人員）MZ000001公共部分-動態(tài)人員庫

MZ00（公共）MZ0001（計算規(guī)則）MZ000101公共部分-計算規(guī)則

MZ01（社會救助）MZ0101（低保）低保資格管理：社會救助-低保，從模

MZ010101塊代碼向下開始分級，

MZ01010101,申請單兩位一級

MZ01010102,變更單

MZ01010103,年檢單

低保報表管理：

MZ010102

MZ01010201,月報

MZ01010202,季報

MZ01010203,年報

MZ01（社會救助）MZ0102（五保）社會救助-五保

MZ01（社會救助）MZ0103（醫(yī)療救助）社會救助-醫(yī)療救助

MZ0I（社會救助）MZ0104（精簡退職）社會救助-精簡退職

MZ01（社會救助）MZ0105（臨時救助）社會救助-臨時救助

MZ02（慈善捐贈）MZ0201

MZ02（慈善捐贈）MZ0202

MZ03（優(yōu)撫優(yōu)待）MZ0301

MZ03（優(yōu)撫優(yōu)待）MZ0302

MZ04（退役安置）MZ0401

MZ04（退役安置）MZ0402

MZ05（軍休安置）MZ0501

MZ05（軍休安置）MZ0502

MZ06（災(zāi)害救助）MZ0601

MZ06（災(zāi)害救助）MZ0602

MZ07（社會福利）MZ0701

MZ07（社會福利）MZ0702

第5頁共56頁

UFGOVQPKHJY0104-V1.0

MZ08（民間組織）MZ0801

MZ08（民間組織）MZ0802

MZ09（社會事務(wù)）MZ0901

MZ09（社會事務(wù)）MZ0902

MZI0（老齡工作）MZ1001

MZ10（老齡工作）MZ1002

MZ11（社會工作）MZ1101

MZ11（社會工作）MZ1102

MZ12（基層政權(quán)）MZ1201

MZ12（基層政權(quán)）MZ1202

MZ13（政策法規(guī)）MZ1301

MZ13（政策法規(guī)）MZ1302

MZ14（信訪管理）MZ140I

MZ14（信訪管理）MZ1402

MZ15（協(xié)同辦公）MZ1501

MZ15（協(xié)同辦公）MZ1502

MZI6（電子監(jiān)察）MZ1601

MZ16（電子監(jiān)察）MZ1602

MZ20（監(jiān)測預(yù)警）MZ2001

MZ20（監(jiān)測預(yù)警）MZ2002

MZ30（核對平臺）MZ3001

MZ30（核對平臺）MZ3002

2.6菜單注冊規(guī)范

菜單編碼

1、要求與功能編碼保持一致；

菜單名稱

1、要求與功能名稱保持一致；

2.7業(yè)務(wù)組件命名規(guī)范

由于江西民政項目是一個多系統(tǒng)的項目，在開發(fā)過程中難免遇到項目的建立、模塊

建立以及組件建立等問題，這里對項目建立的命名進(jìn)行規(guī)范說明。

江西民政項目業(yè)務(wù)結(jié)構(gòu)如下：

第6頁共56頁

用反政務(wù)軟件

UFGOV_QP_KHJY_0l_04-V1.0

從上圖描述可以看出，民政業(yè)務(wù)分三層，分別是項目、子系統(tǒng)或模塊、業(yè)務(wù)組件或

子模塊，從第二層開始與開發(fā)環(huán)境中的概念進(jìn)行對應(yīng)。其中：

子系統(tǒng)或模塊，與Eclipse中的項目（MDE開發(fā)中的業(yè)務(wù)組件項目）對應(yīng)，在建立

項目時要根據(jù)系統(tǒng)代碼進(jìn)行命名。

業(yè)務(wù)組件或子模塊，與Eclipse中的業(yè)務(wù)組件（MDE開發(fā)中的業(yè)務(wù)組件）對應(yīng)，在

建立業(yè)務(wù)組件時要根據(jù)模塊代碼進(jìn)行命名。

業(yè)務(wù)功能/組，與具體的一個功能或者是一個功能組相關(guān)，如社會救助中的資格管

理或者低保資格申請，這個可以根據(jù)業(yè)務(wù)復(fù)雜度靈活掌握，如果功能較少可以直接與一

個功能對應(yīng)，如果功能較多可以分組管理。

對于簡單的系統(tǒng)，可以建立一個項目，然后在該項目下根據(jù)子模塊建立業(yè)務(wù)組件；

對于復(fù)雜的項目，可以將子模塊建立成為業(yè)務(wù)組件項目，然后在其下建立業(yè)務(wù)組件。下

面以社會救助為例說明。

社會救助屬于一個完整的救助系統(tǒng)，其下可以分為五個子模塊，分別是低保、五

保、醫(yī)療救助、精簡退職和臨時救助，假設(shè)我們將社會救助放在一個項目組中，每一個

子模塊建立一個業(yè)務(wù)組件，那么其項目結(jié)構(gòu)如下左圖（MDE項目視圖）所示，其JAVA

視圖如下右圖所示。

第7頁共56頁

用反政務(wù)軟件

UFGOV_QP_KHJY_0l_04-V1.0

白“JSI今0sa

s?低保救助l號rs/src/public

〔券rs/src/client

日咨精簡退職rs/src/private

:-日文檔rs/resources

rs/src/test

場業(yè)務(wù)模型ts/src/public

:畫源代碼ts/src/client

：-組裝ts/src/private

Ikiuits/resources

由霹模板ts/src/test

ms/src/public

：?模板分配ms/src/client

d編碼規(guī)則ms/src/private

:R流程配置ms/resources

ms/src/test

由市應(yīng)用蛆裝ws/src/public

由%配置ws/src/dient

ws/src/private

s島臨時敕助ws/resources

E島五保救助ws/src/test

1:尊Is/src/public

由愿醫(yī)療救助Is/src/client

申飛配置Is/src/private

Is/resources

由&Ant.LibraryIs/src/test

由iJRE系統(tǒng)庫[ire6]

田&Framework_Library

田2s5^Ant_Library

:4Generated_EJB[±]atSkProduct_Common_Library

國

S*JRE系統(tǒng)庫[ire6]HiMiddleware_Library

申Framework_Library

畫曲Middleware_Library由Module_Public_Library

?&Module_Client_Library由Module_Client_Library

由Module_Private_Library

國艙Module_Lang_Library由Module_Lang_Library

國歐Module_Private_Library由US-config

由一Is

由必Module_Public_Library

田—META-INF

1+1SaPrnrliirbCnmmnnIihr^rv國…ms

對于其他項目和模塊的命名，請各自開發(fā)組根據(jù)實際需要向項目管理人員申請標(biāo)

識，這里不做具體規(guī)定。但在命名時要遵守如下規(guī)則：

1、能確切反映項目或者模塊的含義，并且拼寫簡單，不超過8個字符；

2、全部使用英文字母，非特殊情況不允許使用數(shù)字編碼；

3、項目或模塊名稱全部小寫，不允許使用下劃線；

2.8報表開發(fā)規(guī)范

為規(guī)范報表開發(fā)過程，本節(jié)對報表開發(fā)進(jìn)行基本規(guī)范。系統(tǒng)在開發(fā)態(tài)，主要使用

“語義模型-預(yù)制”、“自由報表預(yù)制”和“數(shù)據(jù)集成”三個節(jié)點，本節(jié)就三個節(jié)點中

的設(shè)計和命名進(jìn)行約束。

2.8.1數(shù)據(jù)源

1、除即時報表使用業(yè)務(wù)默認(rèn)的數(shù)據(jù)源以外，月報、季報、半年報和年報要使用獨立

的數(shù)據(jù)源，表空間、用戶和權(quán)限與業(yè)務(wù)數(shù)據(jù)源分開；

2、如有特殊情況，請向公共組申明；

2.8.2語義模型設(shè)計

1、語義模型分類

第8頁共56頁

用反政務(wù)軟件

UFGOV_QP_KHJY_0l_04-V1.0

a）語義模型分類名稱采用有意義的漢字名稱，不能超過15個漢字；

b）數(shù)字民政項目報表根目錄為“數(shù)字民政”，所有民政相關(guān)業(yè)務(wù)的報表均要建立在

該分類之下，如有特殊情況可以向公共組申請；

c）在“數(shù)字民政”根目錄下，需要增加相關(guān)系統(tǒng)的子分類，子分類下可以繼續(xù)分

類，分類最低層次為業(yè)務(wù)組件，以社會救助為例，其目錄層次如下（僅供參

考），子系統(tǒng)和業(yè)務(wù)組件名稱前要冠以“模塊編號”：

數(shù)字民政

--01社會救助管理平臺

--01最低生活保障管理系統(tǒng)

—XXXX月報明細(xì)

—XXXX季報明細(xì)

--02農(nóng)村五保管理系統(tǒng)

2、語義模型編碼

a）編碼字符采用字母和數(shù)字，編碼長度10個字符，均以“MZSM”開頭，后兩個

字符使用模塊代碼，如“01”，一個完整的語義模型編碼如（社會救助）：

MZSM010101,后四個字符的編碼全部使用數(shù)字，可以根據(jù)對應(yīng)業(yè)務(wù)的情況自

行分類；

b）其中，“MZSM”中的“SM”表示“語義模型”，由于一個語義模型可以用在

多個報表設(shè)計中，這里主要是需要和報表設(shè)計中編碼進(jìn)行區(qū)分；

c）語義模型編碼規(guī)范如果存在特殊情況，請向公共組申請；

3、語義模型名稱

a）語義模型名稱采用漢字命名，語義模型名稱要能確切反應(yīng)語義模型的設(shè)計初衷，

語義模型名稱不能超過30個漢字；

b）對于語義模型名稱不能確切表達(dá)設(shè)計內(nèi)容時，必須在備注中說明；

4、語義模型數(shù)據(jù)源

a）語義模型數(shù)據(jù)源根據(jù)是否是及時報表選擇對應(yīng)數(shù)據(jù)源；

b）對于非即時報表，必須使用獨立數(shù)據(jù)源（與業(yè)務(wù)數(shù)據(jù)源分開）；

2.8.3自由報表設(shè)計

1、自由報表分類

a）自由報表分類名稱采用有意義的漢字名稱，不能超過15個漢字；

b）數(shù)字民政項目報表分類根目錄為“數(shù)字民政”，所有民政相關(guān)業(yè)務(wù)的報表均要建

立在該分類之下，如有特殊情況可以向公共組申請；

c）在''數(shù)字民政”根目錄下，需要增加相關(guān)系統(tǒng)的子分類，子分類下可以繼續(xù)分

類，分類最低層次為業(yè)務(wù)組件，以社會救助為例，其目錄層次如下（僅供參

考），子系統(tǒng)和業(yè)務(wù)組件名稱前要冠以“模塊編號”：

數(shù)字民政

--01社會救助管理平臺

—01最低生活保障管理系統(tǒng)

第9頁共56頁

用反政務(wù)軟件

UFGOVQPKHJY0l04-V1.0

--XXXX月報明細(xì)

—XXXX季報明細(xì)

--02農(nóng)村五保管理系統(tǒng)

2、自由報表編碼

a）編碼字符采用字母和數(shù)字，編碼長度10個字符，均以“MZFR”開頭，后兩個字

符使用模塊代碼，如“01”，一個完整的自由報表編碼如（社會救助XX報

表）：MZFR010101,后四個字符的編碼全部使用數(shù)字，可以根據(jù)對應(yīng)業(yè)務(wù)的情

況自行分類；

b）其中，“MZFR”中的“FR”表示“自由報表”，這里主要是需要和語義中編碼

進(jìn)行區(qū)分；

c）自由報表編碼規(guī)范如果存在特殊情況，請向公共組申請；

3、自由報表名稱

a）自由報表名稱采用漢字命名，名稱要能確切反應(yīng)報表的設(shè)計初衷，名稱不能超過

30個漢字；

b）對于自由報表名稱不能確切表達(dá)設(shè)計內(nèi)容時，必須在備注中說明；

4、自由報表數(shù)據(jù)源

a）自由報表數(shù)據(jù)源根據(jù)是否是即時報表選擇對應(yīng)的數(shù)據(jù)源；

b）對于非即時報表，必須使用獨立數(shù)據(jù)源（與業(yè)務(wù)數(shù)據(jù)源分開）；

2.8.4數(shù)據(jù)集成設(shè)計

數(shù)據(jù)集成主要用來將業(yè)務(wù)數(shù)據(jù)從業(yè)務(wù)生產(chǎn)庫（OLTP：以實時交易為目的）抽取到

業(yè)務(wù)分析庫（OLAP：以數(shù)據(jù)分析為目的），方便后續(xù)分析報表的語義模型和自由報表

的設(shè)計，這里對數(shù)據(jù)集成中常見場景給予規(guī)范。

1、作業(yè)命名

a）作業(yè)名稱采用字母和數(shù)字作為基本命名字符，作業(yè)名稱固定長度12個字符，所

有作業(yè)名稱以“MZJOB”開頭，隨后兩個字符為模塊代碼，后5個字符全部使

用數(shù)字，各業(yè)務(wù)組可以根據(jù)業(yè)務(wù)報表情況進(jìn)行自行分類，如低保月報抽數(shù)作業(yè)

為：MZJOB0101001

b）作業(yè)命名若有特殊情況，請向公共組申請；

2、任務(wù)命名

a）每個作業(yè)下可以有多個任務(wù)，任務(wù)的命名采用可讀的漢字進(jìn)行，名稱要能確切反

應(yīng)任務(wù)的含義，任務(wù)名稱最長30個漢字，中間不允許使用數(shù)字、字母和特殊符

號；

b）任務(wù)名稱力求簡潔和精準(zhǔn)，方便開發(fā)人員理解；

c）任務(wù)命名若有特殊情況，請向公共組申請；

3、語義元數(shù)據(jù)

a）分類命名

i.語義元數(shù)據(jù)分類名稱采用有意義的漢字名稱，不能超過15個漢字，一般采

用系統(tǒng)的名稱或者是模塊的名稱；

第10頁共56頁

用反政務(wù)軟件

UFGOV_QP_KHJY_0l_04-V1.0

ii.數(shù)字民政項目語義元數(shù)據(jù)根目錄為“數(shù)字民政"，所有民政相關(guān)業(yè)務(wù)的語義

元數(shù)據(jù)均要建立在該分類之下，如有特殊情況可以向公共組申請；

b）表相關(guān)命名

i.語義元數(shù)據(jù)的表名遵循4.2.8節(jié)要求，目前已經(jīng)增加“R”類信息主體，用

來表示報表相關(guān)的表，例如社會救助中低保季報可以使用“HR01”，對于

后面的兩位數(shù)字，各業(yè)務(wù)組可以根據(jù)實際情況進(jìn)行分類；

ii.報表相關(guān)的表中字段的名稱規(guī)則和業(yè)務(wù)表相同，這里不做贅述，如果有特殊

的要求可以向公共組申請（大部分字段在都是業(yè)務(wù)表中的字段，部分公共的

可以向公共組申報）；

iii.表的顯示名稱全部使用漢字，最長12個字符，要能確切反應(yīng)表的內(nèi)容；

2.9UAP開發(fā)參考

1、緩存策略

a）對于常用的靜態(tài)數(shù)據(jù)庫表要進(jìn)行數(shù)據(jù)緩存，可以選擇全表緩存，也可以緩存常用

字段，緩存算法支持LRU、FIFO、FILE等；

b）對于所有的參照對象表數(shù)據(jù)要進(jìn)行數(shù)據(jù)緩存；

c）視圖不可緩存，所以在進(jìn)行參照類型的數(shù)據(jù)設(shè)計時，盡量考慮使用物理表，不是

特殊情況不建議使用視圖；

2、客戶端應(yīng)用策略；

a）考慮到業(yè)務(wù)系統(tǒng)客戶端啟動和加載速度，平臺組建議使用客戶端進(jìn)行系統(tǒng)訪問，

但是考慮到客戶端的一致性和實施復(fù)雜度，民政業(yè)務(wù)組以使用IE瀏覽器優(yōu)先；

非特殊情況，不允許使用客戶端；

3、客戶端和服務(wù)器端交互策略；

a）盡量降低遠(yuǎn)程調(diào)用次數(shù)；多次服務(wù)器調(diào)用要合并調(diào)用次數(shù)；

b）減少上下行流量（考慮差異VO形式），上下行流量建議在10K?16K,業(yè)務(wù)就

是說在業(yè)務(wù)單據(jù)保存或者是下載時，盡量不要一次超過16K流量，否則響應(yīng)性

能會下降；

c）客戶端和捻務(wù)器端在一次業(yè)務(wù)交互過程中不得超過3次，若超過三次，需要業(yè)務(wù)

組設(shè)計人員審批；

d）客戶端和服務(wù)器端交互時，在UI（包括模型、按鈕和面板等對象）類里不能直

接調(diào)用服務(wù)器端類和接口，如果需要調(diào)用，需要將調(diào)用方法使用UI代理類進(jìn)行

中轉(zhuǎn)，以保證服務(wù)方法的事務(wù)完整性，例如對待遇計算中先計算人員待遇數(shù)

據(jù)，再保存到數(shù)據(jù)庫中，然后進(jìn)行一定處理后在顯示在界面上，其代碼結(jié)構(gòu)如

下：

〃服務(wù)器端接口

publicinterfaceISACalculate{

publicBillResultdoCalcu!ate（BusinessObject[]bizObj）throwsBusinessException;

）

〃服務(wù)器端實現(xiàn)類

PublicclassSACalculatelmplimplementsISACalculate{

第11頁共56頁

用反政務(wù)軟件

UFGOV_QP_KHJY_0l_04-V1.0

publicBillResultdoCalculate(BusinessObjectl]bizObj)throwsBusinessException{

IIstep1計算待遇

BillResultresult=...

//step2保存計算結(jié)果

saveResul((result);

//step3處理計算結(jié)果

result=process(result);

returnresult;

)

〃客戶端代理類

PublicclassSACalculateProxyextendsBaseServiceProxyimplementsISACalculate{

publicBillResultdoCalculate(BusinessObject[]bizObj)throwsBusinessException{

returnNCLocaltor.getInstance().lookup(ISACalculate.class).doCalculate(bizObj);

)

)

〃UI類

PublicclassvoiddoAction(Actione){

〃其他邏輯

result=proxy.doCalculate(bills);

〃其他邏輯

)

4、大數(shù)據(jù)參照策略；

a）對于大量數(shù)據(jù)的參照盡量考慮樹形參照或者其他分類形式的參照，若性能不能保

證建議業(yè)務(wù)組采用其他策略；

b）大數(shù)據(jù)參照對應(yīng)的表，要進(jìn)行數(shù)據(jù)緩存配置（表級緩存或者是全文檢索緩存模式

【不支持視圖】）；

c）參照窗口顯示盡量不要超過5歹I；

5、分頁策略；

a）業(yè)務(wù)單據(jù)要進(jìn)行分頁處理，考慮到UAP的分頁原理（查詢?nèi)恐鞅碇麈I，然后

進(jìn)行分頁，查詢數(shù)據(jù)記錄條數(shù)上限100000條），業(yè)務(wù)單據(jù)在查詢時要控制查詢

條件，盡量縮小查詢范圍；

6、壓力測試

a）對于日常業(yè)務(wù)單據(jù)操作，要進(jìn)行壓力測試，保證其響應(yīng)性能：一般不超過3秒；

7、發(fā)布原則/增量部署；

a）功能開發(fā)要遵循增量部署的要求，否則在增量部署時，模塊無法打包發(fā)布；

b）增量部署模塊開發(fā)規(guī)范，詳見相關(guān)文檔；

第12頁共56頁

用反政務(wù)軟件

UFGOVQPKHJY0104-V1.0

3Java編碼規(guī)范

3.1命名規(guī)范

3.1.1包的命名

包的名稱要求確切反映此包的功能意義。包的名稱用多個字構(gòu)成，字之間用間

隔。

1.Java標(biāo)準(zhǔn)包的命名以java打頭，例如：java.util；

2.程序包分發(fā)給多個組織使用，要保證與其他同一容器下部署的應(yīng)用上的包不重名，

且包含公司標(biāo)志。所以一般使用公司的URL的倒序作為包名。

3.ufgov的全局包的前綴是：com.ufgov.grp

例：com.通ov.grp.pd

4.包名采用英文全拼或簡拼，全部小寫字母，必要時可以使用數(shù)字及下劃線，建議不

要使用下劃線。

5.測試用的包名以"test"開頭。：.ufgov.grp.pdo

3.1.2類的命名

1.類的名稱要求確切反映此類的功能意義。

2.類名必須是名詞，表示某一類對象的名稱。

3.英文全拼或簡拼，大小寫混用，所有單詞的首字母大寫，其余字母小寫，必要時可以

使用數(shù)字及下劃線。

4.采用某種設(shè)計模式的類名要求使用相關(guān)設(shè)計模式的通用類名后綴，規(guī)范如下：

(1)職責(zé)鏈，后綴processor,例：MemoryProcessor

(2)輔助類，后綴Util,例：BillMappingUtil

(3)工廠類，后綴factory,例：DaoFactory

(4)Proxy模式，后綴proxy,例：XmlProxy

(5)Adapter模式，后綴adapter,例：LightAdapter

(6)Mediator模式，后綴mediator,例：QuickEntryMediator

第13頁共56頁

政務(wù)軟件

UFGOV_QP_KHJY_0l_04-V1.0

3.1.3接口命名

1.接口名