元数据使用入门.docx

1、元数据使用入门兀数据一、元数据概念对于元数据的业务模型，开发人员首先需要了解的关键概念包括：模块， 组件，实体，值对象，业务接口，属性，业务操作，方法，参数，元素，容器， IBean 等。模块(IModule)对应目前我们部署环境里modules下的各个目录，比如 uap,uapbd,uapeai等，只是部署环境里的module是平级的，而元数据里模块是一 个属性结构，也就是说模块可以有子模块，比如uap的子模块有uapbd, uapeai, uapportal, uapqe 等。对应数据库表 md_module模块是安装的基本单元，元数据所有产生的脚本是以模块为单位导出初始化 脚本的。组件(

2、IComponent)描述的是一个相对独立和完整的业务块，主要是从业务层 次上进行划分，比如“销售订单”可以作为一个组件，“客商档案”也可以作为 一个组件，划分组件时，注意组件间的重用，且注意不要形成相互依赖。组件属 于模块，一个模块可以包含多个组件。对应数据库表md_component组件是部署的基本单元，一个典型的组件会包含若干个有相互关系的实体 (但只能有一个主实体)，组件内还包括服务和操作，服务可以直接生成usm配置 文件，操作可以直接生成upm配置文件，另外组件里还可以有业务接口，枚举 类型等。实体(IBusinessEntity)是指可以通过一系列连续性(continuity )和

3、标识 (identity ID)来定义的业务对象，NC原有的大部分VO基本上都算得上是实 体。实体属于特定的组件，一个组件可以包含多个实体，组件可以没有任何实体, (比如只有业务接口)，但如果有实体，则必须设置一个主实体。对应数据库表 md_class值对象(IPropertyType)：如果一个对象代表了领域的某种描述性特征，且没 有概念性的标识，比如颜色，地址，但也不能一概而论，有些需要取决于具体的 业务场景。值对象同样定义在组件里，一个组件可以包含多个值对象。对应数据 库表 md_class值对象与实体的另一个差别：值对象可以通过判断其所有的属性是否相等来 判断值对象是否相等，而两个实体

4、即使所有属性都相等，但主键不相等，也不能 说两个实体相等。从这个意义上可以说，值对象是无生命的，而实体是有生命的。自定义实体(ICustomEntity)：表达拥有特定属性的一类实体，对应NC里的 自定义档案，自定义实体是一种特殊的实体。对应数据库表md.class属性(IAttribute)：对应实体里的每个字段，对应数据库表md_property业务操作(IBusinessOperation):表达一个完整的外部服务或者内部服务 (service)o业务操作也定义在组件里。对应数据库表md_busiOperationo业务接口(IBizInterface)：供实体或者值对象实现的接口，接口

5、本身定义了特 定的访问方法。对应数据库表md_class备注:在设讣器上，业务接口只能增加属性，相应会生成get方法，比如增 加一个name属性，会生成一个getName()方法，方法的返回值可以自山选择。 实际上，如果希望灵活运用业务接口，你可以摆脱设计器的限制，你在设讣器上 设计出一个业务接口，生成代码后，可以给业务接口增加任何方法，当然实现类 也山你自己实现，此时只是通过元数据来管理你的业务接口而已。二、NC模型设计器的环境介绍1、 安装模型设计插件插件安装的方法跟普通插件安装的方法一样，检查插件是否安装成功的 方法：Help- About Eclipse Platform-Plugin

6、 Details,如果看到被红线圈住 的插件就说明插件已经安装成功。插件最新版本是1.0.8.7b,以后还会更 新。访问 http:/uapserver03/ncmdp/ncmdp_site 下载插件。About Eclipse fl it for PlufinsSi. 1 bonderVersioaHug-in IdEclipse orgttylyn CVS Iztensicnz3.0.0.v2D：60 .org. eclipse nylyn. te=n. wsEclipse orgWylyn Help3 0.0.v2D：80 .org. edipse nylyn.help.iiEclips

7、e orgHylyn IDE lH3.0.0.v20：B0 .org. eclipse nylyn. ile. mEclipse orgttylyn Java Bridge3 O.O.v2I0O .org. eclipse nylya j ava. liEclipse orgttylyn Java Tash3.0.0.v2D：60 .org. eclipse nylyn. java. lashEclipse orgMyljrn Boni tor Core3 0.0.v2D：80 .org. ed i pse nylyn. n oni i or. core固 Eclipse orgMylyn H

8、onitor HI3.0.0.v20：B0 .org. edipse nylyn. noniior.uiEclipse org妝Lyn Kescnrces HI3 0.0.D：fi0 .org. aclipse nylyn.resources uiEclipse orgttylyn 7 asks Cora3.0.0.D：60 .org. eclipse nylyn. tasks, coreJj Eclipse orgttylyn Tasks III3O.O.v2D：fiO.org. adipse nylyn. iasks.uiEclipse orgHylyn ?e =n HI3.0.0.v20

9、：B0 .org.adipse nylyn. iesn.uiEclipse, orgHsvigator Vorkhanch Conpo.3.3. ICO. 1200.&rg. eclipse., wi gator, r gHIDA Sofivare 03.111nc.uap.nde ?kg1.0.12.11nc.Mp. ndeUPIDA Sofivare DLllDnc.uap.nde. editor 恥F n|T|? Plnr-ir.1.0.4I f ftnc.Mp. nde. e-iitor亠 风 uruA冏 ITIDAllUgTLUOLjgin Ilurin1.0.5.3aWaginSp

10、ring JavaCcntigorg. springfraievcrk javac.L0.0.n3.v20.org. springfraieyork. javaccufigIJ1 Frlins cT7CKfii d h 1 鼬rvinK3 1 o 洌 nrrrjF aNin gi wimuLegu Info |SLov Signi 叱 InfoColvniis.OX2、 打开模型视图(1)、插件安装成功之后，Windows-Open Perspective-Other,选中下 图红线部分Jnl xiOp皀n P erspective禽 CVS Rep o e i t ory Expl or i

11、 ng gDBVieverDebugHmdeG Pl aiming 建|Rl5 ourceg-Teani Synchroni zingOKCaneel（2）、进入模型视图之后，可以选中工程中的某一个口录点右键新建模 型文件，文件的后缀名是bmf, 一个模型文件相当于一个元数据组件， 是部署的基本单元。新建目录删除发布元数据发布元数据溜略版本） 生成程库sql脚本并执行生成逢库宜ql脚本谢刷新重新保存所有元数据立件（3）、然后可以在组件中创建实体、业务接口等等。在模型视图中有业 务组件工具箱和关联关系工具箱，可以通过拖拽的方式创建实体、 业务接口、关联关系等等。A Palette P目值对象扌服

12、务目注释目业务接口巨关联关系工具箱 閃 J依赖小组合关联/注釋关联严业芻接口实现3.制作典型主子表元数据K 创建主实体(1)、给主实体添加属性B |辭|业撫鞠删勰|n 鵬 T8 18 乘難祁翹&014iiSIOmidcharn猟aoString伽varchardetails8pidcnaterialid腓1FITcnsterialid实体创建完之后，要给实体设置主属性，也就是主键。在例子中，主键是id,在一般情况下主键的类型要设置成UFID,类型样 式为 SINGLE-类型样式有四种：SINGLE：单一样式，大部分属性都选择这个样式。REF：引用样式，当属性引用别的实体的时候，设置为应用样式。

13、ARRAY. LIST：当该属性是作为1“关联或者聚合关系的源属性时, 设置成ARRAY. LIST样式。一般情况下，类型样式是会自动设置的，比如：当属性引用了其他的实 体时，类型样式会自动变成REF,某属性被1-n关联关系设置成源属性 时，该属性的类型样式会自动变成ARRAYo但是把REF或者ARRAY 变回SINGLE时要手动设置，比如，当去掉主实体和子实体的组合关系 时，一定要把源属性的类型样式手动从ARRAY设回SINGLEo(2)、设置实体参数。要设置一些参数，就是在后面生成脚本时的表名和 生成java源文件的VO类名2、 创建子实体创建子实体的方法和创建子实体的步骤类似设置实体参数

14、时跟主实体有点不同，主要是访问器类型设置为NCVO, 而且访问器参数没有包装类名那一项。3、 建立主实体和子实体之间关系元数据中实体中有多种关系：继承、依赖、11组合、1F组合等等， 般在设计主-子表关系时，选择组合关系。亍业务接口实现在选中lw组合关系时，必须要给该组合关系设置源属性，这个属性比较 特殊，在进行元数据设计的时候，它是主实体的一个属性，但是在最后 生成数据库表结构的时候它实际上是子表的一个字段，是子表对主表的 外键（关于生成建库脚本后面还会介绍），该属性的访问策略要设置成 BodyOfAggVOAccessor。最后大家确认一下该属性字段名必须与主表主 键名相同，否则保存会丢外

15、键。在把主实体中的属性设置成源属性之后，该属性的类型样式会自动变成 “ARRAY”测试子表 曰？孑表id 客户4、 发布模型在发布模型之前：（1）、把组件的主属性设置成主实体r _ |Cl Properties 52 O戸PropertyValueEl Mi sc连接线路由手动B基本ID3334b869-e6b5-460a-.版本号29创淫人创建时间2009-10-09 15:44:48代码斑格 NC传统样式多语资渡模块名test扩展标签描述名称test名称空间so2是否预加我false所属模块 so2显示名称test修改人修改时间 2009-11-06 08:37:48测试主表 二（2） 、

16、保存（3） 、启动中间件（4） 、发布元数据，发布元数据有两种方式：忽略版本和不忽略版本。如果发布元数据时忽略版本，则完全以本地的模型文件，可能造 成库中新版本的模型被覆盖，非特殊情况不推荐使用。开发环境 的发布只是为了开发人员测试需要，提交产品时只需要将bmf文 件提交到相应模块的METADATA U录下，安装帐套时会自行发布 到数据库中。导入届性删除已发布的组件和数据库表导出为册文件 导出为顷文件 生成陋DL文件导出为晒（说）文件生成upm文件生成建库迪脚本生成建库如脚本并执行导岀为團片5、 生成javaVO源文件总共会生成三个源文件：nc.vo.so2.test.AggTestHVO,

17、nc.vo.so2.test.TestHVO, nc.vo.so2.test.TestBVO （类名是在给实体设置参数的时候设置的），第一个 VO是聚合VO继承了 nc. vo. trade, pub. HYBillVO,后两个VO都继承了 SuperVOo导入属性发布元数据发布元数据溜略版本）删除发布的元数据删除已发布电彎和数据库表U塾粉諜文f厂二导出为3CSD文件生成忖攻件导出为pdm （远mD文件生成upe文件! 生成逹库sql脚本生成逹库脚本并执行.号出为團片6、 生成建库脚本总共会生成两个表:test, test.b （表名是在设置实体参数的时候设置的）和一 个子表对主表的外键约束（外键对应组合关系的源属性）。可以先生成建库脚 本，然后自己手动去检查执行建库脚本。也可以生成sql脚本之后直接执行。 建议直接执行，因为生成的sql脚本是sql server格式，如果自己去执行脚本 的话，可能还要把脚本转化成其他库的脚本。直接执行的话平台会在后台去 把sql脚本转换成其他库的脚本，无需自己去转换。导入属性发布元数据发布元数据胭昭版本）删除发布的元数据删除已发布的组件和数据库表导出为jaw源文件导岀为拓丁文件生成WSD以件导出为Pdm （.湖:L）文件生成UpiTI文件号出为U片