上海大眾汽車

SHANGHAIVOLKSWAGEN

上海大眾Java軟件平臺(tái)項(xiàng)目

需求定義文檔

RequirementsDefinitionDocument

當(dāng)前版本：〈版本號(hào)1.0>

修改日期：<2014-06-24>

文檔狀態(tài)：正式

作者：上海大眾項(xiàng)目組

上海大眾汽車

SHANGHAIVOLKSWAGEN

項(xiàng)目名稱：上海大眾Java軟件平臺(tái)項(xiàng)目申請(qǐng)?zhí)枺?/p>

BezeichnungdesSoftwares:Nc

會(huì)簽：Unerschrift

需求業(yè)務(wù)部門關(guān)鍵用戶

Key-User

簽名(Unterschrift)

信息系統(tǒng)Cl項(xiàng)目負(fù)責(zé)人

Key-UserCl

簽名(Unterschrift)

部門經(jīng)理審批欄

GenehmigtvonAbteilungsleiter

業(yè)務(wù)部門(K2及以上)

CommentofK2departmentor

above

簽名(Unterschrift)

信息系統(tǒng)(CI?R2)處理意見(jiàn)

StellungnahmevonInformation

System

簽名(Unterschrift)

文檔OARP

姓

序號(hào)分類范圍要求

1Owner

2作者

審核

3

人

審核

4

人

審核

5

人

批準(zhǔn)

6

人

文檔修訂記錄

目錄

上海大眾JAVA軟件平臺(tái)項(xiàng)目1

需求定義文檔1

REQUIREMENTSDEFINITIONDOCUMENT1

BEZEICHNUNGDESSOFTWARES：NR:2

1概述6

LI背景6

1.2目標(biāo)6

i.3非目標(biāo)6

1.4概念模型與術(shù)語(yǔ)表6

2典型用戶6

2.1應(yīng)用背景6

2.2典型用戶6

2.2.1老郭-項(xiàng)目經(jīng)理6

2.2.2小張-設(shè)計(jì)開(kāi)發(fā)人員（供應(yīng)商/C1D）6

2.2.3小李-測(cè)試人員（供應(yīng)商）6

2.2.4小王?項(xiàng)目發(fā)布人員7

2.2.5小趙-系統(tǒng)管理員7

2.2.6小劉-維護(hù)人員（供應(yīng)商）7

2.2.7老孫-管理層人員7

3場(chǎng)景：核心框架7

3.1場(chǎng)景：使用基礎(chǔ)構(gòu)件7

3.1.1特性:使用SDO操作構(gòu)件（DataOhjectUtils）7

3.1.2特性:使用數(shù)據(jù)庫(kù)訪問(wèn)構(gòu)件⑴ASTemplate）15

3.1.3特性:使用數(shù)據(jù)庫(kù)分頁(yè)構(gòu)件（CriteriaUtil）39

3.1.4特性:使用本地文件操作構(gòu)件45

3.1.5特性:使用文件上傳下載構(gòu)件56

3.1.6特性:使用日期處理構(gòu)件(DateUtil)58

3.1.7特性:使用字符串處理構(gòu)件(StringUm)99

3.1.8特性:使用加密/解密構(gòu)件(CrypioUtil)126

3.1.9特性:使用郵件處理構(gòu)件(MailUtil)129

3.1.10特性:使用參數(shù)操作構(gòu)件(ConfigUtil)130

3.1.11特性:使用國(guó)際化構(gòu)件(ResourcesMessageUtil)132

3.1.12特性:使用日志處理構(gòu)件(LogUtil)133

3.1.13特性:使用異常處理構(gòu)件(ResourcesMessageUtil)141

3.L14特性:使用緩存服務(wù)構(gòu)件(CacheUtil)142

3.1.15特性:使用服務(wù)構(gòu)件(SerxuceUtil)146

3.1.16特性:使用業(yè)務(wù)字典構(gòu)件(Bi&nessDictUE)149

3.2場(chǎng)景：使用客戶端接入155

3.2.1特性:使用HTTP和XML接入155

3.2.2特性:使用HTTP和JSON接入157

3.2.3特性:使用WebService接入158

3.3場(chǎng)景：使用緩存機(jī)制162

3.3.1特性:使用集群緩存163

3.3.2特性:配置謖存164

3.4場(chǎng)景：使用攔截器167

3.4.1特性:使用接入攔截器167

3.4.2特性:使用Spring攔截器170

3.4.3特性:使用數(shù)據(jù)實(shí)體攔截器173

3.5場(chǎng)景：使用事務(wù)176

351特性:配置事務(wù)176

3.5.2特性:使用事務(wù)178

3.6場(chǎng)景：使用業(yè)務(wù)字典180

3.6.1特性:使用業(yè)務(wù)字典180

3.7場(chǎng)景：開(kāi)發(fā)邏輯181

3.7.1特性:開(kāi)發(fā)狗件182

3.7.2特性:開(kāi)發(fā)服務(wù)182

概述

1.1背景

開(kāi)發(fā)人員通過(guò)開(kāi)發(fā)工具使用上海大眾Java軟件平臺(tái)（以下簡(jiǎn)稱平臺(tái)）的

核心框架進(jìn)行項(xiàng)目開(kāi)發(fā)，平臺(tái)核心框架為相關(guān)項(xiàng)目的開(kāi)發(fā)提供基礎(chǔ)構(gòu)件支持

和運(yùn)行狀態(tài)下資源加載、同步和部署的支撐。

1.2目標(biāo)

1.3非目標(biāo)

1.4概念模型與術(shù)語(yǔ)表

2典型用戶

開(kāi)發(fā)人員。

2.1應(yīng)用背景

2.2典型用戶

2.2.1老郭?項(xiàng)目經(jīng)理

項(xiàng)目經(jīng)理老郭具有10年工作經(jīng)驗(yàn)，5年項(xiàng)目管理經(jīng)驗(yàn)，喜歡音樂(lè)、羽毛

球、旅游

222小張.設(shè)計(jì)開(kāi)發(fā)人員（供應(yīng)商/CID）

設(shè)計(jì)開(kāi)發(fā)人員小張具有3年工作經(jīng)驗(yàn)，喜歡看書、籃球、戶外運(yùn)動(dòng)

2.2.3小李.測(cè)試人員（供應(yīng)商）

測(cè)試人員小李具有3年工作經(jīng)驗(yàn)，喜歡音樂(lè)、旅游

2.2.4小王?項(xiàng)目發(fā)布人員

CI-1發(fā)布測(cè)試環(huán)境

CII發(fā)布正式環(huán)境

2.2.5小趙?系統(tǒng)管理員

系統(tǒng)管理員小趙，6年系統(tǒng)管理經(jīng)驗(yàn)，喜歡鉆研技術(shù)，標(biāo)準(zhǔn)的技術(shù)宅男,

對(duì)一切新的技術(shù)感興趣

226小劉.維護(hù)人員(供應(yīng)商)

維護(hù)人員小劉，4年工作經(jīng)驗(yàn)，負(fù)責(zé)系統(tǒng)的日常維護(hù)，做事認(rèn)真細(xì)心，

喜歡下棋，游戲

2.2.7老孫.管理層人員

管理層人員老孫，10年工作經(jīng)驗(yàn)

3場(chǎng)景：核心框架

開(kāi)發(fā)人員小張通過(guò)開(kāi)發(fā)工具使用平臺(tái)核心框架進(jìn)行項(xiàng)目相關(guān)代碼的開(kāi)

發(fā)，平臺(tái)核心框架為相關(guān)代碼的開(kāi)發(fā)提供基礎(chǔ)構(gòu)件支持和運(yùn)行狀態(tài)下資源加

我、同步和部署的支撐。

3.1場(chǎng)景：使用基礎(chǔ)構(gòu)件

開(kāi)發(fā)設(shè)計(jì)人員小張，在項(xiàng)目開(kāi)發(fā)的過(guò)程中，使用平臺(tái)核心框架提供的基礎(chǔ)構(gòu)

件能力，進(jìn)行項(xiàng)目的快速開(kāi)發(fā)。

3.1.1特性；使用SDO操作構(gòu)件(DataObjectUtil)

開(kāi)發(fā)人員小張?jiān)陧?xiàng)目代碼的開(kāi)發(fā)過(guò)程中，使用平臺(tái)框架提供的基礎(chǔ)構(gòu)件能

力，對(duì)相關(guān)業(yè)務(wù)數(shù)據(jù)和SDO對(duì)象進(jìn)行相互轉(zhuǎn)換以及相關(guān)類型判斷。

功能點(diǎn)：比較DataObject的實(shí)體名稱

【功能說(shuō)明】

比較DataObject名稱和指定名稱是否相同。

＞方法定義

checkEntityName(DataObjectentity.StringentityName)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)entitycommonj.sdo.DataObjectSDO對(duì)象

參數(shù)entityNamejava.lang.StringSDO對(duì)象對(duì)應(yīng)的實(shí)體名稱

true：實(shí)體名與指定名相等

返回值outOboolean

false：實(shí)體名與指定名不等

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界而元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

功能點(diǎn)：指定屬性拼成字符串

【功能說(shuō)明】

遍歷實(shí)體實(shí)例數(shù)組中每個(gè)實(shí)體實(shí)例，獲取指定屬性的值，然后拼成字符串。

＞方法定義

conca(ProperlyValues(Da(aObjec([lentities,StringproperlyName,StringroundSlring,Siring

joinString,booleanignoreNullValue)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)entitiescommonj.sdo.DataObject口實(shí)體實(shí)例數(shù)組。

參數(shù)propertyNamejava.lang.String指定的屬性名稱。

包裹屬性值字符串。如半角單

引號(hào)“'"，如果該參數(shù)傳遞的數(shù)

參數(shù)roundstringjava.lang.String值為null,則默認(rèn)為‘（半角單

引號(hào)）。例如：該參數(shù)按變量

傳遞，變量未初始化。

多個(gè)屬性值之間用什么字符

串連接。如半角逗號(hào)7,如果

參數(shù)joinStringjava.lang.String

該參數(shù)傳遞的數(shù)值為null,則

默認(rèn)為，（半角逗號(hào)）。

參數(shù)ignoreNullValueboolean是否忽略為null的屬性值。

返回值outOjava.lang.String拼接好的字符串。

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

功能點(diǎn)：轉(zhuǎn)換單個(gè)DataObject的類型

【功能說(shuō)明】

用來(lái)將一種類型的DataObject轉(zhuǎn)換成指定類型的DataObjecto

>方法定義

convcrtDataObjcct（DataObjcctobj,StringcntityNamc,booleanconvcrtAll）

A參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)objcommonj.sdo.DataObject待轉(zhuǎn)換DataObject,即源實(shí)體對(duì)象

參數(shù)entityNamejava.Iang.String實(shí)體名稱，即目標(biāo)對(duì)象的實(shí)體名稱

true：不管目標(biāo)對(duì)象是否有此屬性，

將源對(duì)象的所有屬性都轉(zhuǎn)到目標(biāo)對(duì)

參數(shù)convertAIIboolean

象中去。

false：只轉(zhuǎn)換目標(biāo)對(duì)象和源對(duì)象同名

的屬性值。

fl牯c.與c..一個(gè)指定實(shí)體名稱的DataObject對(duì)

返回值outOcommonj.sdo.DataObject工.?x-

象,即ur目標(biāo)對(duì)象

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

功能點(diǎn)：轉(zhuǎn)換一組DataObject的類型

【功能說(shuō)明】

用來(lái)將一種類型的DataObject數(shù)組轉(zhuǎn)換成指定類型的DataObject數(shù)組。

＞方法定義

convertDataObjects(Objectobjs,StringentityName,booleanconvertAH)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

待轉(zhuǎn)換DataObject數(shù)組或List,即

參數(shù)objsjava.lang.Object

源對(duì)象數(shù)組或List

實(shí)體名稱，即目標(biāo)對(duì)象數(shù)組的實(shí)體

參數(shù)entityNamejava.lang.String

名稱

true：不管目標(biāo)對(duì)象是否有此屬性，

將源對(duì)象的所有屬性都轉(zhuǎn)到目標(biāo)

參數(shù)convertAHboolean對(duì)象中去：

false：只轉(zhuǎn)換目標(biāo)對(duì)象和源南?象同

名的屬性值。

一個(gè)指定實(shí)體名的DataObject對(duì)

返回值outOcommonj.sdo.DataObject[]

象數(shù)組，即目標(biāo)對(duì)象數(shù)組

＞拋出異常說(shuō)明

a)、如果數(shù)據(jù)實(shí)體名稱對(duì)應(yīng)的實(shí)體不存在，會(huì)拋出實(shí)體類型不存在的異常

b)、如果源對(duì)象和目標(biāo)對(duì)象的屬性名稱相同，但類型不同且無(wú)法轉(zhuǎn)換，會(huì)拋

出類型無(wú)法轉(zhuǎn)換的異常

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

功能點(diǎn)：創(chuàng)建DataObject對(duì)象

【功能說(shuō)明】

根據(jù)實(shí)體全名創(chuàng)建一個(gè)SDO對(duì)象

＞方法定義

createDataObject(StringentityName)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)entityNameString數(shù)據(jù)實(shí)體全稱

返回值一個(gè)指定實(shí)體名的

outOcommonj.sdo.DataObject

DataObject對(duì)象

＞拋出異常說(shuō)明

如果數(shù)據(jù)實(shí)體全稱對(duì)應(yīng)的實(shí)體不存在，會(huì)拋出實(shí)體不存在的異常。

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

[UI說(shuō)明]

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

功能點(diǎn)：獲取SD。對(duì)象的實(shí)體名

【功能說(shuō)明】

獲取SDO對(duì)象名稱

＞方法定義

getEntityName(DataObjectentity)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)entitycommonj.sdo.DataObjectSDO對(duì)象

返回值outOjava.lang.StringSDO對(duì)象全名

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

3.1.1.7功能點(diǎn)：獲取數(shù)組或List對(duì)象的長(zhǎng)度

【功能說(shuō)明】

獲取數(shù)組或Lisi對(duì)象的長(zhǎng)度。

＞方法定義

getSizeOrLength(Objectobject)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)xpathjava.Iang.Object數(shù)組對(duì)象或Collection/Map對(duì)象

返回值outOint數(shù)組對(duì)象或Collection/Map對(duì)象的長(zhǎng)度

＞規(guī)則說(shuō)明

Object必須為數(shù)組對(duì)象或Collection/Map對(duì)象，否則返回0

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

功能點(diǎn)：讀取excel將其轉(zhuǎn)化為SDO對(duì)象

【功能說(shuō)明】

將符合格式規(guī)定的excel文件導(dǎo)入成DataObject實(shí)例，excel的每一行將轉(zhuǎn)換

為一個(gè)DataObject實(shí)例。

＞方法定義

importExcelToDataObject(StringfilePath,StringentityName,StringpropertyList,

intstartLine)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)filePathjava.lang.Stringexcel文件絕對(duì)路徑。

DataObject的實(shí)體名稱(必須是實(shí)體

的全稱)，如果為null或者"。則用

參數(shù)entityNamejava.lang.String

com.primeton.das.datatype.AnyType

類型。

excel中的字段映射格式：

[property[:index皿,property[:index]]。

index默認(rèn)從1開(kāi)始，1代表excel中

的A列，

如果沒(méi)有寫index,就表示是上一個(gè)字

參數(shù)propertyListjava.lang.String

段的index+1,第一個(gè)字段中沒(méi)有

index則為1。

property表示當(dāng)前實(shí)體中的定義屬性

名，可以用Xpath,如導(dǎo)入員工中包

含機(jī)構(gòu)編號(hào)，則為"org/orgName"。

數(shù)據(jù)導(dǎo)入起始行，默認(rèn)從1開(kāi)始，

參數(shù)startLineint例如startLine為2,代表從第2行開(kāi)

始讀取數(shù)據(jù)，第1行數(shù)據(jù)將被忽略。

返回值out。commonj.sdo.DataObjectf]轉(zhuǎn)換以后的DataObject實(shí)例數(shù)組。

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

功能點(diǎn)：是否為基本數(shù)據(jù)類型

【功能說(shuō)明】

用來(lái)判斷SDO對(duì)象屬性的type是否為基本數(shù)據(jù)類型。以便區(qū)分SDO的屬性是

DataObject還是SDO基本類型。

其中，基本類型如下表所示：

類型描述

Boolean布爾型

Byte二進(jìn)數(shù)

Bytes二進(jìn)數(shù)數(shù)組

Char字符

Date日期

Time時(shí)間

Decimal數(shù)組

Double雙精度實(shí)數(shù)

Float單精度實(shí)數(shù)

Int4字節(jié)整數(shù)

Integer4字節(jié)整數(shù)

Long8字節(jié)整數(shù)

Short2字節(jié)整數(shù)

String字符串

＞方法定義

isDataType(DataObjectentity,Stringproperty)

A參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)entitycommon.sdo.DataObjectSDO對(duì)象

參數(shù)propertyjava.lang.String屬性名

true：為SDO基本數(shù)據(jù)類型

返回值outOboolean

false：為其他類型

＞拋出異常說(shuō)明

傳入的屬性名找不到對(duì)應(yīng)屬性的時(shí)候，會(huì)拋找不到屬性的異常。

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【U1說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

3.1.2特性：使用數(shù)據(jù)庫(kù)訪問(wèn)構(gòu)件(DASTemplate)

開(kāi)發(fā)人員小張?jiān)陧?xiàng)目代碼的開(kāi)發(fā)過(guò)程中，使用平臺(tái)框架提供的基礎(chǔ)構(gòu)件能

力，對(duì)數(shù)據(jù)庫(kù)進(jìn)行CRUD操作。

3.1.2.1功能點(diǎn)：新增一條記錄

【功能說(shuō)明】

新增一條記錄

＞方法定義

insertEntity(DataObjectentity)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)entitycommon.sdo.DataObjectSDO對(duì)象

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

功能點(diǎn)：批量插入記錄

【功能說(shuō)明】

批量插入記錄，這些對(duì)象內(nèi)部不應(yīng)該有關(guān)聯(lián)的屬性存在

＞方法定義

insertEntityBatch(DataObject[]entities)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)entitiescommon.sdo.DataObject[]SDO對(duì)象數(shù)組

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

功能點(diǎn)：更新一條記錄

【功能說(shuō)明】

更新指定的一條記錄

＞方法定義

updateEntity(DataObjectentity)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)entitycommon.sdo.DataObjectSDO對(duì)象

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

功能點(diǎn)：批量更新記錄

【功能說(shuō)明】

批量更新記錄，這些對(duì)象內(nèi)部不應(yīng)該有關(guān)聯(lián)的屬性存在，如果有也不處理。

＞方法定義

updateEnlityBatch(DataObject[]entities)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)entitiescommon.sdo.DataObject[]SDO對(duì)象數(shù)組

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

功能點(diǎn)：根據(jù)SD。模板更新記錄

【功能說(shuō)明】

根據(jù)SDO數(shù)據(jù)模板查詢條件更新記錄。

template概念:

如果已經(jīng)定義了一個(gè)BO:cn.svw.sup.En山y(tǒng)A。

那么當(dāng)力巴Entity八當(dāng)作查詢條件使用的時(shí)候,就可以認(rèn)為EntityA是一Template

對(duì)于EnlityA里的已經(jīng)設(shè)置了值的屬性都會(huì)當(dāng)作查詢條件,

設(shè)置了值的屬性就會(huì)生成Reid=Mil叱的sql條件4如果設(shè)直的值為〃皿,則該屬性不會(huì)生成sql條件),

多個(gè)已經(jīng)設(shè)置/值的屬性則會(huì)使用?！╠進(jìn)行連接。

＞方法定義

updateEntityByTemplate(DataObjectupdateValue,DataObjecttemplate)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)updateValuecommon.sdo.DataObjectSDO對(duì)象，數(shù)據(jù)實(shí)體值

參數(shù)templatecommon.sdo.DataObjectSDO對(duì)象，BO模板條件

返回值outOint更新條數(shù)

【前置條件】

開(kāi)反人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

功能點(diǎn)：根據(jù)查詢實(shí)體更新記錄

【功能說(shuō)明】

根據(jù)criteriaentity查詢條件更新記錄。

＞方法定義

updateEntityByCriteriaEntity(DataObjectupdateValue,IDASCriteriadasCriteria)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)updateValuecommon.sdo.DataObjectSDO對(duì)象數(shù)組，數(shù)據(jù)實(shí)體值

參數(shù)dasCriteriacom.eos.das.entity.IDASCriteria查詢條件

返回值outOInt更新條數(shù)

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

功能點(diǎn)：保存一條記錄

【功能說(shuō)明】

保存一條記錄。如果當(dāng)前記錄不存在則新增，否則就更新。

＞方法定義

savcEntity(DataObjectentity)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)entitycommon.sdo.DataObjectSDO對(duì)象

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

功能點(diǎn)：批量保存記錄

【功能說(shuō)明】

保存多條記錄。如果當(dāng)前記錄不存在則新增，否則就更新

＞方法定義

saveEntities(DataObject[]entities)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)entitiescommon.sdo.DataObject[]SDO對(duì)象數(shù)組

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

3.129功能點(diǎn)：刪除一條記錄

【功能說(shuō)明】

根據(jù)主鍵刪除一條記錄。

＞方法定義

deleleEntity(DataObjectentity)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)entitycommon.sdo.DataObjectSDO對(duì)象

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

0功能點(diǎn)：批量刪除記錄

【功能說(shuō)明】

根據(jù)主鍵批量刪除多條記錄，采用高效率的jdbc操作，如果實(shí)體定義了級(jí)聯(lián)

關(guān)系也不會(huì)刪除級(jí)聯(lián)表。

＞方法定義

deleteEntityBatch(DataObjectf]entities)

A參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)entitiescommonj.sdo.DataObject[]SDO對(duì)象數(shù)組

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

1功能點(diǎn)：根據(jù)SDO模板刪除記錄

【功能說(shuō)明】

根據(jù)SDO數(shù)據(jù)模板查詢條件刪除記錄，查詢條件不能為空，如果為空將返

回異常。

模板概念請(qǐng)參見(jiàn)3.125根據(jù)SDO模板更新記錄

＞方法定義

deleteByTemplate(DataObjecttemplate)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)templatecommon.sdo.DataObjectSDO對(duì)象，SDO數(shù)據(jù)模板

返回值outOint刪除記錄數(shù)

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

2功能點(diǎn)：根據(jù)查詢實(shí)體刪除記錄

【功能說(shuō)明】

根據(jù)查詢條件實(shí)體刪除記錄，查詢條件不能為空，如果為空將返回異常。

＞方法定義

deleteByCriteriaEntity(IDASCriteriadasCriteria)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)dasCriteriacom.eos.das.entity.lDASCriteria刪除條件

返回值out()int刪除記錄條數(shù)

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

3功能點(diǎn)：根據(jù)主鍵擴(kuò)展查詢一條記錄

【功能說(shuō)明】

根據(jù)主鍵擴(kuò)展查詢一條記錄，如果dataobject中有非主鍵的屬性值，將根據(jù)

主鍵查詢出來(lái)覆蓋原來(lái)的屬性。

＞方法定義

expandEntity(DataObjectentity)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)entityCommon.sdo.DataObject業(yè)務(wù)對(duì)象

返回值outOint1-有記錄0-沒(méi)有記錄

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

4功能點(diǎn)：根據(jù)模板擴(kuò)展查詢一條記錄

【功能說(shuō)明】

使用模板查詢的一條記錄填充dataObject,并返回滿足模板條件的記錄數(shù).

如果模板查詢出多條記錄,則用第一條記錄填充dalaObject。

模板概念請(qǐng)參見(jiàn)3.J.2.5根據(jù)SDO模板更新記錄

＞方法定義

expandEntityByTemplate(DataObjecttemplate,DataObjectentity)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)templatecommonj.sdo.DataObject查詢模板

參數(shù)entitycommonj.sdo.DataObject業(yè)務(wù)對(duì)象

返回值outOint滿足模板條件的記錄數(shù)

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

5功能點(diǎn)：根據(jù)主鍵擴(kuò)展記錄，并且將當(dāng)前記錄鎖定

【功能說(shuō)明】

根據(jù)主鍵擴(kuò)展記錄，并且將當(dāng)前記錄鎖定，如果dataobject中有非主鍵的屬

性值，將根據(jù)主鍵查詢出來(lái)覆蓋原來(lái)的屬性。

＞方法定義

expandEntityWithLock(DataObjectentity)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)entitycommonj.sdo.DataObject業(yè)務(wù)對(duì)象

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

3.1.2.16功能點(diǎn)：擴(kuò)展一個(gè)數(shù)據(jù)實(shí)體對(duì)象的一個(gè)關(guān)聯(lián)屬性

【功能說(shuō)明】

擴(kuò)展一個(gè)數(shù)據(jù)實(shí)體對(duì)象的一個(gè)關(guān)聯(lián)屬性（如對(duì)一個(gè)懶加載的屬性），會(huì)進(jìn)行

數(shù)據(jù)庫(kù)的查詢。

＞方法定義

expandRelation(DataObjectdataObject.Stringproperty)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)dataObjectcommonj.sdo.DataObject數(shù)據(jù)實(shí)體值

參數(shù)propertyjava.lang.String數(shù)據(jù)實(shí)體的關(guān)聯(lián)實(shí)體的屬性名稱

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

7功能點(diǎn)：擴(kuò)展一個(gè)數(shù)據(jù)實(shí)體數(shù)組中每個(gè)實(shí)體對(duì)象的一個(gè)關(guān)

聯(lián)屬性

【功能說(shuō)明】

擴(kuò)展一個(gè)數(shù)據(jù)實(shí)體數(shù)組中每個(gè)實(shí)體對(duì)象的一人關(guān)聯(lián)屬性(如對(duì)一個(gè)懶加載的

屬性)，會(huì)進(jìn)行數(shù)據(jù)庫(kù)的查詢。

＞方法定義

expandEntitiesRelation(DataObject[]dataObjects,Stringproperty)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)dataObjectscommonj.sdo.DataObject[]實(shí)體數(shù)組

參數(shù)propertyjava.lang.String數(shù)據(jù)實(shí)體的關(guān)聯(lián)實(shí)體的屬性名稱

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

8功能點(diǎn)：根據(jù)數(shù)據(jù)實(shí)體對(duì)象的關(guān)聯(lián)屬性獲得關(guān)聯(lián)實(shí)體對(duì)象

【功能說(shuō)明】

根據(jù)數(shù)據(jù)實(shí)體對(duì)象的關(guān)聯(lián)屬性獲得關(guān)聯(lián)實(shí)體對(duì)象，返回關(guān)聯(lián)實(shí)體對(duì)象。如果

是多對(duì)一或一對(duì)一關(guān)聯(lián)關(guān)系時(shí)候，返回關(guān)聯(lián)的實(shí)體對(duì)象。如果是一對(duì)多關(guān)聯(lián)關(guān)系

時(shí)候，返回關(guān)聯(lián)的實(shí)體對(duì)象的第一個(gè)對(duì)象值。

＞方法定義

getRelationEntity(DataObjectdataObject,Stringproperty)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)dataObjectcommonj.sdo.DataObject數(shù)據(jù)實(shí)體值

參數(shù)propertyjava.lang.String數(shù)據(jù)實(shí)體的關(guān)聯(lián)實(shí)體的屬性名稱

返回值outOT關(guān)聯(lián)實(shí)體對(duì)象

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

3.1.2.19功能點(diǎn)：根據(jù)數(shù)據(jù)實(shí)體對(duì)象的關(guān)聯(lián)屬性獲得關(guān)聯(lián)實(shí)體對(duì)象

數(shù)組

【功能說(shuō)明】

根據(jù)數(shù)據(jù)實(shí)體對(duì)象的關(guān)聯(lián)屬性獲得關(guān)聯(lián)實(shí)體對(duì)象數(shù)組，返回關(guān)聯(lián)實(shí)體對(duì)象。

如果是多對(duì)一或一對(duì)一關(guān)聯(lián)關(guān)系時(shí)候，將關(guān)聯(lián)的實(shí)體對(duì)象構(gòu)造為數(shù)組返回。如果

是一對(duì)多關(guān)聯(lián)關(guān)系時(shí)候，返回關(guān)聯(lián)的實(shí)體對(duì)象數(shù)組U

＞方法定義

gctRclationEntities(Class<T>componentTypc,DataObjectdataObject,String

property)

A參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)componentTypejava.lang.Class關(guān)聯(lián)實(shí)體類型Class

參數(shù)dataObjectcommonj.sdo.DataObject數(shù)據(jù)實(shí)體值

參數(shù)propertyjava.lang.String數(shù)據(jù)實(shí)體的關(guān)聯(lián)實(shí)體的屈性名稱

返回值outOT[]關(guān)聯(lián)實(shí)體對(duì)象數(shù)組

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

0功能點(diǎn)：根據(jù)SDO數(shù)據(jù)模板查詢條件查詢所有記錄

【功能說(shuō)明】

根據(jù)SDO數(shù)據(jù)模板查詢條件查詢所有記錄，會(huì)查詢Entity的所有字段。

模板概念請(qǐng)參見(jiàn)3.125根據(jù)SDO模板更新」，己錄

＞方法定義

queryEntitiesByTeniplate(Class<T>componentType,DataObjecttemplate)

>參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)componcntTypcjava.lang.Class返回結(jié)果類型Class

參數(shù)templatecommonj.sdo.DataObject數(shù)據(jù)實(shí)體值

返回值out()T[]符合查詢模板的所有結(jié)果

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

3.1.2.21功能點(diǎn)：根據(jù)SDO數(shù)據(jù)模板查詢條件查詢部分記錄

【功能說(shuō)明】

根據(jù)SDO數(shù)據(jù)模板查詢條件查詢部分記錄，會(huì)查詢Entity的所有字段,，

模板概念請(qǐng)參見(jiàn)根據(jù)SDO模板更新紀(jì)錄

＞方法定義

queryEntitiesByTemplate(Class＜T＞componentType,DataObjecttemplate,int

begin,intlength)

＞參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)componentTypejava.lang.Class返回結(jié)果類型Class

參數(shù)templatecommonj.sdo.DataObject數(shù)據(jù)實(shí)體值

參數(shù)beginint開(kāi)始記錄編號(hào)

參數(shù)lengthint查詢記錄數(shù)量

返回值outOT[]符合查詢模板的所有結(jié)果

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件導(dǎo)入當(dāng)前開(kāi)發(fā)環(huán)境中。

【后置條件】

【UI說(shuō)明】

【界面元素】

【流程】

【文件規(guī)格】

【功能規(guī)則】

3.1.2.22功能點(diǎn)：根據(jù)查詢條件實(shí)體查詢所有記錄

【功能說(shuō)明】

根據(jù)查詢條件實(shí)體查詢所有記錄，根據(jù)查詢條件實(shí)體指定查詢Entity的字段

＞方法定義

queryEntitiesByCriteriaEntity(Class<T>componentType,IDASCriteria

dasCriteria)

>參數(shù)說(shuō)明

類型名稱數(shù)據(jù)類型參數(shù)描述

參數(shù)componentTypejava.lang.Class返網(wǎng)結(jié)果類型Class

參數(shù)dasCriteriacommonj.sdo.DataObject查詢條件

返回值outOT[]符合查詢條件的所有結(jié)果

【前置條件】

開(kāi)發(fā)人員小張將平臺(tái)基礎(chǔ)構(gòu)件