史俊 沈潔 胡蘊(yùn)珊 張孝慶 周文杰

（1.安徽省建科建設(shè)監(jiān)理有限公司 安徽省合肥市 230000 2.合肥工業(yè)大學(xué) 安徽省合肥市 230000）

1 前言

隨著互聯(lián)網(wǎng)技術(shù)的發(fā)展，信息化與企業(yè)結(jié)合這一趨勢已越發(fā)盛行。目前我國建設(shè)工程監(jiān)理的信息化發(fā)展還處于初級(jí)階段，一些發(fā)展較快的城市中，監(jiān)理信息化系統(tǒng)已經(jīng)在監(jiān)理企業(yè)投入使用，很多企業(yè)仍在探索信息化與公司的具體業(yè)務(wù)和管理的高效結(jié)合。本文從某建筑工程監(jiān)理公司的信息化現(xiàn)狀出發(fā)，分析了其內(nèi)部業(yè)務(wù)需求和管理需求，設(shè)計(jì)了監(jiān)理公司信息化管理系統(tǒng)，利用信息技術(shù)的自動(dòng)化、精確化等特性輔助公司內(nèi)部各方面管理，同時(shí)通過對(duì)監(jiān)理項(xiàng)目監(jiān)管質(zhì)量的分析和統(tǒng)計(jì)，幫助管理層對(duì)監(jiān)理人員的業(yè)績情況、建筑工程施工進(jìn)度進(jìn)行把控，提高公司監(jiān)理水平，從而保證建筑施工的安全穩(wěn)定開展。

監(jiān)理公司管理系統(tǒng)的主要功能可以分成兩部分：圍繞公司內(nèi)各部門日常管理需要，使管理系統(tǒng)能提升各部門管理層的日常工作效率；針對(duì)監(jiān)理服務(wù)的質(zhì)量監(jiān)督，監(jiān)理工作的日常統(tǒng)計(jì)分析，以及監(jiān)理工作質(zhì)量評(píng)定等。

在系統(tǒng)設(shè)計(jì)過程中，考慮到系統(tǒng)功能需求較多，且有近一半的功能是對(duì)數(shù)據(jù)庫的增刪改查操作，如果有一種能自動(dòng)代碼工具來生成重復(fù)性的后臺(tái)服務(wù)代碼，則可大大降低系統(tǒng)實(shí)現(xiàn)的工作量。目前，此類代碼生成工具并不多見，同時(shí)從系統(tǒng)的框架特點(diǎn)分析，我們決定自主設(shè)計(jì)一種基于Java 語言的Spring 后臺(tái)代碼快速生成工具，取名為CAGT（Code Auto Generator Tool）。CAGT 可以通過數(shù)據(jù)庫表結(jié)構(gòu)，利用Java 的發(fā)射特性和預(yù)先設(shè)計(jì)好的代碼模板，自動(dòng)生成Spring 服務(wù)端中的增刪改查功能代碼（主要包括domain 文件、controller 文件和service 文件）。

綜上，本文的主要工作：

（1）深入研究分析了典型監(jiān)理公司的業(yè)務(wù)邏輯，遵循軟件工程開發(fā)規(guī)范設(shè)計(jì)、實(shí)現(xiàn)了監(jiān)理業(yè)務(wù)管理系統(tǒng)，提高了監(jiān)理公司的管理效率和信息化水平；

（2）基于Java 的反射技術(shù)，針對(duì)監(jiān)理業(yè)務(wù)管理系統(tǒng)研發(fā)了一個(gè)代碼生成工具，既提高了系統(tǒng)的開發(fā)效率，又保證了代碼的質(zhì)量。

2 系統(tǒng)需求分析

2.1 功能需求分析

系統(tǒng)基于監(jiān)理日常工作需求，同時(shí)考慮到平臺(tái)的權(quán)限設(shè)置，以監(jiān)理公司內(nèi)部四個(gè)部門為主體，設(shè)計(jì)了四個(gè)主模塊，如圖1：

圖2：代碼自動(dòng)生成工具CAGT 功能流程圖

圖3：項(xiàng)目地理可視化運(yùn)行截圖

（1）合同模塊。該模塊是經(jīng)營部門日常工作所使用的模塊，設(shè)計(jì)以下子模塊：1.合同錄入。對(duì)簽訂的合同進(jìn)行記錄，錄入合同關(guān)鍵屬性，并將合同簽訂過程中所產(chǎn)生的紙質(zhì)附件，以照片的形式上傳。2.合同管理。包括對(duì)合同基本信息和合同附件的詳情查看功能，對(duì)合同基本信息的修改功能，以及附件的刪除、重傳功能。3.合同檢索。按照合同關(guān)鍵屬性進(jìn)行的多關(guān)鍵字聯(lián)合檢索。4.付款提醒。合同關(guān)鍵付款節(jié)點(diǎn)的錄入以及到達(dá)關(guān)鍵付款節(jié)點(diǎn)前的提醒。

（2）財(cái)務(wù)模塊。該模塊包括日常財(cái)務(wù)基礎(chǔ)數(shù)據(jù)記錄，財(cái)務(wù)收支分析，人員社保和保證金相關(guān)業(yè)務(wù)功能，主要有以下子模塊：財(cái)務(wù)基礎(chǔ)數(shù)據(jù)錄入，對(duì)監(jiān)理項(xiàng)目的開票到賬以及項(xiàng)目進(jìn)行過程中的開支進(jìn)行錄入登記；財(cái)務(wù)收支分析，根據(jù)錄入的基本數(shù)據(jù)進(jìn)行成本核算，可視化展示統(tǒng)計(jì)分析后的結(jié)果，提供財(cái)務(wù)收支分析報(bào)告；人員社保子模塊，包含人員社保信息按月批量導(dǎo)入，根據(jù)項(xiàng)目人員分配查詢?nèi)藛T社保情況；保證金子模塊，包含單條保證金信息錄入，多條保證金數(shù)據(jù)批量導(dǎo)入，保證金退還維護(hù)和保證金多條件聯(lián)合檢索功能。

（3）人力資源模塊。該模塊對(duì)公司內(nèi)員工基本信息、資格證書進(jìn)行維護(hù)，包含以下子模塊：員工基本信息錄入，錄入員工基本信息，上傳員工照片，登記員工工資結(jié)構(gòu)；資格證書數(shù)據(jù)錄入，錄入員工資格證書，登記基本字段，上傳證書原件照片；員工管理，查看員工詳細(xì)信息，對(duì)員工信息和員工照片進(jìn)行修改，增加員工項(xiàng)目經(jīng)歷，查看員工所獲全部證書及證書附件，查看員工所參加的項(xiàng)目情況；證書過期提醒，對(duì)員工三個(gè)月內(nèi)即將過期的證書和已過期的證書進(jìn)行提醒，便于公司維護(hù)員工資質(zhì)；按資歷人員檢索，根據(jù)員工的學(xué)歷、資質(zhì)證書獲得情況和項(xiàng)目經(jīng)歷進(jìn)行人員檢索，快速選出符合新項(xiàng)目條件的監(jiān)理人員。

（4）監(jiān)理項(xiàng)目監(jiān)管模塊。該模塊是公司管理層分析監(jiān)理服務(wù)質(zhì)量，對(duì)監(jiān)理人員進(jìn)行業(yè)績評(píng)分的輔助工具，包括以下子模塊：項(xiàng)目數(shù)據(jù)批量導(dǎo)入，提供導(dǎo)入接口，從外部業(yè)務(wù)系統(tǒng)中導(dǎo)入監(jiān)理項(xiàng)目的屬性數(shù)據(jù)和監(jiān)理日志、監(jiān)理月報(bào)、在監(jiān)項(xiàng)目進(jìn)度等流程數(shù)據(jù)；項(xiàng)目地理分布可視化，通過地圖展示省內(nèi)各地級(jí)市的項(xiàng)目數(shù)量；監(jiān)理質(zhì)量統(tǒng)計(jì)分析，統(tǒng)計(jì)導(dǎo)入的各種流程數(shù)據(jù)，分析日志上傳情況，生成統(tǒng)計(jì)分析報(bào)告。

2.2 非功能性需求分析

管理系統(tǒng)的用戶多為監(jiān)理公司內(nèi)員工，對(duì)計(jì)算機(jī)的掌握程度不高，在以往的工作中，多使用傳統(tǒng)辦公軟件進(jìn)行數(shù)據(jù)交流，考慮到這些實(shí)際情況，平臺(tái)要具備較高的易用性，要滿足界面簡潔、操作簡單，盡量將對(duì)數(shù)據(jù)的各種維護(hù)操作開發(fā)成類似傳統(tǒng)辦公軟件的模樣。

3 系統(tǒng)關(guān)鍵模塊設(shè)計(jì)

針對(duì)系統(tǒng)中的核心功能和關(guān)鍵技術(shù)，以下給出具體實(shí)現(xiàn)思路和方法。

3.1 代碼自動(dòng)生成工具CAGT

CAGT 是實(shí)現(xiàn)監(jiān)理公司管理系統(tǒng)的基礎(chǔ)輔助模塊，通過使用該代碼生成工具，為項(xiàng)目進(jìn)度的推進(jìn)節(jié)省了大量的時(shí)間。該工具的核心思路：事先設(shè)計(jì)好相應(yīng)代碼的模板文件，模板文件中預(yù)設(shè)了代碼的重復(fù)性部分，對(duì)重復(fù)性且與具體數(shù)據(jù)表結(jié)構(gòu)相關(guān)的部分使用占位符暫替，后續(xù)在工具的主方法里使用java 的IO 操作、反射特性，根據(jù)數(shù)據(jù)庫中的表結(jié)構(gòu)對(duì)模板代碼中進(jìn)行自動(dòng)替換，實(shí)現(xiàn)代碼的自動(dòng)生成。

CAGT 功能實(shí)現(xiàn)的流程圖如圖2 所示。

CAGT 不僅能提高編碼效率，更重要的是能通過CAGT 生成統(tǒng)一風(fēng)格的代碼，避免因?yàn)榫幋a人員的失誤導(dǎo)致的功能錯(cuò)誤，能有效提高項(xiàng)目的健壯性和可維護(hù)性。

（1）Domain 文件生成方法。Domain 指的是數(shù)據(jù)庫中的表對(duì)應(yīng)的實(shí)體類，應(yīng)包含數(shù)據(jù)表的所有屬性和參數(shù)的get/set 方法。基于此，我們的模板文件中使用占位符#Domain#替換類名，使用JDBC 技術(shù)，查詢表的meta-column 屬性集，將其作為Domain 類的成員變量寫入實(shí)體類文件。最后通過Eclipse 的generate 工具可自動(dòng)生成Domain 類成員變量的getter 和setter 方法。

（2）Controller 文件生成方法。Controller 文件是服務(wù)端處理前端請(qǐng)求的文件，由于這些重復(fù)性請(qǐng)求處理代碼的相似度很大，我們抽象出四個(gè)方法：增加domainAdd、刪除domainDelete、修改domainEdit、查詢domainQuery，用來完成所有控制器都應(yīng)具有的增刪改查功能，它們的URL 和方法名統(tǒng)一使用占位符的形式設(shè)置，在接受到映射后，會(huì)調(diào)用相應(yīng)的Service 文件對(duì)應(yīng)該請(qǐng)求的具體數(shù)據(jù)庫查詢服務(wù)方法。

對(duì)Controller 模板文件的替換有三部分：第一，將類名占位符替換為前一步生成的Domain 文件的名稱；第二，將增刪改查方法前和URL 前的占位符改為實(shí)例對(duì)象的名稱；第三，將該文件的整體URL 映射名改成該模塊的名稱。

（3）Service 文件生成方法。Service 文件提供請(qǐng)求處理后需調(diào)用的JDBC 操作，對(duì)Controller 中的每一個(gè)模板方法，在Service 文件中都有對(duì)應(yīng)的JDBC 操作方法，在該文件中，主要的占位符是數(shù)據(jù)表名稱。在主方法中修改占位符的參數(shù)值，便能根據(jù)模板文件生成對(duì)應(yīng)具體表結(jié)構(gòu)的Service 文件。

3.2 身份驗(yàn)證功能

監(jiān)理業(yè)務(wù)管理系統(tǒng)中，用戶訪問系統(tǒng)需先經(jīng)過身份驗(yàn)證。系統(tǒng)采用了基于角色的訪問控制策略，主要分為兩部分完成：

（1）在數(shù)據(jù)庫中為不同的用戶按部門賦予角色；

（2）在服務(wù)端編寫過濾器，當(dāng)用戶訪問頁面時(shí)，過濾器會(huì)對(duì)訪問請(qǐng)求進(jìn)行攔截，并按照權(quán)限策略控制用戶的訪問請(qǐng)求。

首先根據(jù)瀏覽器中的session判斷用戶是否登錄，判斷已登錄后，從session 中抽取用戶對(duì)應(yīng)的角色，從而判斷當(dāng)前用戶角色是否擁有對(duì)該資源URL 的訪問權(quán)限。

3.3 項(xiàng)目地理分布可視化功能

圖4：監(jiān)理質(zhì)量統(tǒng)計(jì)分析功能運(yùn)行截圖

為了更加直觀地展示監(jiān)理項(xiàng)目的地理分布，系統(tǒng)設(shè)計(jì)了項(xiàng)目按照地市分布的可視化功能，該功能基于流行的可視化圖表工具Echarts 進(jìn)行設(shè)計(jì)。該功能需要對(duì)地圖中的地級(jí)市進(jìn)行數(shù)據(jù)渲染：首先通過異步數(shù)據(jù)請(qǐng)求，依據(jù)項(xiàng)目所在地分組查詢出項(xiàng)目的數(shù)量，得到以所在地和項(xiàng)目數(shù)量為關(guān)鍵字的多個(gè)Map 數(shù)據(jù)，再將Map 數(shù)據(jù)解析成格式化JSON 數(shù)據(jù)格式異步發(fā)給前端，前端收到數(shù)據(jù)后渲染地圖控件。項(xiàng)目地理分布可視化功能運(yùn)行截圖如圖3 所示：

3.4 監(jiān)理質(zhì)量統(tǒng)計(jì)分析功能

監(jiān)理日志是監(jiān)理公司的核心業(yè)務(wù)，為了讓公司管理層及時(shí)、準(zhǔn)確掌握員工的監(jiān)理日志的上傳記錄，以及基于日志內(nèi)容分析監(jiān)理服務(wù)質(zhì)量，在監(jiān)理信息平臺(tái)中設(shè)置監(jiān)理質(zhì)量統(tǒng)計(jì)分析功能。該功能的實(shí)現(xiàn)需要從外部系統(tǒng)導(dǎo)入的監(jiān)理日志、監(jiān)理月報(bào)、在監(jiān)項(xiàng)目進(jìn)度等流程數(shù)據(jù)。通過分析數(shù)據(jù)上傳的頻率、次數(shù)，得到在監(jiān)項(xiàng)目的負(fù)責(zé)人員是否按時(shí)、按質(zhì)地完成了監(jiān)理工作。監(jiān)理日志數(shù)據(jù)在界面中以柱狀圖的方式，提供分析的結(jié)果。監(jiān)理質(zhì)量統(tǒng)計(jì)分析功能運(yùn)行截圖如圖4 所示。

4 總結(jié)

推動(dòng)信息化發(fā)展對(duì)于提高監(jiān)理企業(yè)的競爭力有著重要的影響，在當(dāng)前互聯(lián)網(wǎng)迅速發(fā)展的前提下，與互聯(lián)網(wǎng)技術(shù)靠攏，對(duì)公司內(nèi)數(shù)據(jù)的維護(hù)和管理有著極大的幫助。本文基于Java 反射技術(shù)，研發(fā)了一種適配Spring MVC 架構(gòu)的代碼自動(dòng)生成工具CAGT，并基于該工具實(shí)現(xiàn)了監(jiān)理業(yè)務(wù)軟件快速開發(fā)，為加速我國監(jiān)理行業(yè)的信息化提供了一種很好的實(shí)踐。