NC开发基本技术.pdf

N C 开发 基本 技 术 1 创 建 测 试 项 目 1.1 下 载 行 业 平 台 框架 项 目 代 码 S v n 地址 ： ht t p: / / 172.16.3.20 4: 8080/ s v n/ m m pub/ m m pub 1.2 导 入 行 业 平 台 框架 项 目 创建一 个新 项目 ， 选 择创 建项目 所在 目录 时 ， 按照 图示选 择 从 s v n 下载 的代 码所在 目录 变更日 期 功能点 变更内 容 提出人 变更人 201 1 - 4 - 10 初版 初版 周君 1.3 创 建 测 试 项 目 按 照 之 前 文 档中 示 例 ， 创建 一 个 新 项 目并 设 置 相 应的 依 赖 关 系 ， 此 处 我 们 创建 了 一 个 名为N C 57T E S T 的项 目 对 该 项目右 键 - > P r oper t i es ， 在 左边 的 J av a B ui l d P at h 目 录中 N C 的 代码 结构 主要 分为 p ubl i c 、 pr i v at e 、 cl i ent 三个包 ， 分 别存 放公 共类 、 后 台业务 类以 及前台 U I 相关类 。

P ubl i c 中主 要存 放接 口 、 V O 类 ； C l i ent 中主 要存 放前 台的 U I 类 ； P r i v at e 中主 要存 放后 台的 业务以 及持 久化 相关 类 2 功 能 注 册 功能注 册及 权限 分配 部分 请参考 \ \ 172.16.3.1 75 \ c$ \ 3. 开发 资 料 \ N C V 5 制 造知 识库 \软 件 开发基 础知 识 \ N C 开发 环 境搭建 \如何 新建一个 节点 此处建 立了 新节 点 “ 测 试 B O M 维 护 ” 节点 功能注 册信 息存 放在 表 s m _f uncr egi s t er 中 3 数 据 库 以 及 V O 设 计 3.1 数 据 库 设 计 设计了 主子 表结 构 ， 分别 为 B O M 表头 以及 B O M 表 体 1 ） 通 过 P ow er D es i gn er 设 计表 ， 并保 存 为 pdm 文档 d e m o _ b d _ b o m物 料 清 单 父 项 主 键公 司 编 码备 注是 否 默 认B O M 类 型建 立 者状 态数 量版 本 类 型版 本 号物 料 P K物 料 编 码 I D工 厂c h a r ( 2 0 )c h a r ( 4 )v a r c h a r 2 ( 1 0 0 )c h a r ( 1 )s m a llin tv a r c h a r 2 ( 2 8 )v a r c h a r 2 ( 2 )n u m b e r ( 2 0 , 8 )s m a llin tv a r c h a r 2 ( 1 0 )c h a r ( 2 0 )c h a r ( 2 0 )c h a r ( 2 0 )d e m o _ b d _ b o m _ b物 料 清 单 子 项 主 键物 料 清 单 父 项 主 键工 厂公 司 编 码子 项 编 码 主 键数 量损 耗 系 数子 项 类 型是 否 可 选 件备 注物 料 P K是 否 委 外 发 料失 效 日 期生 效 日 期c h a r ( 2 0 )c h a r ( 2 0 )c h a r ( 2 0 )c h a r ( 4 )c h a r ( 2 0 )n u m b e r ( 2 0 , 8 )n u m b e r ( 9 , 6 )s m a llin tc h a r ( 1 )v a r c h a r 2 ( 1 0 0 )c h a r ( 2 0 )c h a r ( 1 )c h a r ( 1 0 )2 ） 导 出为 脚本 注意组 中需 要在 脚本 中增 加如下 字段 ： C r ea t e t abl e xx xx ( … t s cha r ( 19) def aul t t o_cha r ( s y s dat e, ' yy yy - m m - dd hh24: m i : s s ' ) , dr num ber ( 10) def aul t 0 ) 其中 t s 字段 为时 间戳 ， 表 示当前 单据 的修 改 、 新增 的时间 。

D r 字段 为删 除标 志位 ， 有些 数据 3.2 实 现 V O 类 两种类 型 ： 聚 合 V O ： 代 表 一 张 单 据 ， 包 含 一 个 表 头 以 及 多 个 表 体 可 以 继 承 自M M A g gr ega t ed V al ue O bj ec t 样例 节点 中为 类 表头 V O 、 表体 V O ： 代 表 一个表 头或 者某 一条 表体 数据 ， 可继 承自 M M Sup er V O （ 有时 也会继承 自 M M C i r cul ar l y A cc es s i bl eV al ueO bj ec t） 4 前 台 界 面 及 单 据 模 板 4.1 前 台 界 面 简 介 根据单 据类 型 ， 可以 简单 的分为 如下 几种 界面 ： 1 ） 卡 片型 ： 2 ） 列 表型 3 ） 卡 片列 表管 理型 ： 初始界 面为 列表 型 ， 查询 结 果显示 在列 表界 面中 当 选 中列表 中的 某列 数据 后 ， 点 击 “ 浏览 ” 按 钮后切 换至 卡片 界 面 ， 并 显示当 前选 中单 据 。

点击 “ 新增 ”、“ 修 改 ” 按钮也 会自 动切换至卡 片界 面进 行操 作 4 ） 树 卡性 界面 （ 略 ） 在本课 程中 以创 建一 个最 常见的 管理 型界 面为 例 4.2 前 台 界 面 类 Clie n t UI 建立前 台界 面的 主要 几个 步骤如 下 ： 1 ） 首 先创 建必 要的 C l i ent U I 类 （ 注 ： 此 处的 类名 已 经在功 能注 册中 注册 过 ） C l i ent U I 继承自 nc.ui .m m p ub.M M T of t P ane l 类 ， 作为 节点的 入口 类 主要分 为如 下几 个部 分 ： I ni t i al i ze ： 初始化部 分 ， 用 于构造 界面 布局 ， 利 用懒 加载方 式来 实例 化界 面元 素 I ni t B ut t ons 子方 法 ： 按 钮初 始化部 分 ， 由于 有 U I 状态 这个概 念 （ 见 nc.ui .m m pub . I U I S t at e 类 ） ，所以此 处为 每个 按钮 设置 能够操 作 的 U I 状态 最 后 通过 s et B ut t ons 方 法 get B i l l L i s t P ane l 子方 法 ： 构造列 表界 面 ， 利 用 l oad T em pl at e 来加载 单 据模 板 l i s t . l o a d T e m p l e t ( " A 1 ( 单据类型 ) " , n u l l , t h i s . g e t U s e r ( ) . g e t P r i m a r y K e y ( ) , t h i s . g e t U n i t C o d e ( ) ) ; g e t B i l l C a r d P a n e l 子方 法 ： 构造 卡片界 面 ， 利 用 l o a d T e m p l a t e 来加载单 据 模板 onB ut t on C l i cke d 子方 法 ： 覆写父 类的 方法 ， 当 界面 点击按 钮后 会回 调本 方法 。

pos t I ni t 方法 ： 初始 化后 调 用 ， 用 于设 置精 度 ， 增加 监听等 具体的 按钮 处理 方 法 ： on Q uer y 、 onA d d 、 o nD el 等 方法 ， 参考 具体 样例 节点 的处理 方法 4.3 导 入 数 据 字 典 打开 “ 客 户化 ” - > “ 二次 开发工 具 ” - > “ 系统 管理 工具 ” - > “ 数据 字典 管理 ” 节 点 ， 左树中选 中 “ 生产 制造 ” 目 录 ， 并 在菜 单中 选择 “ 导 入数据 字典 ” p u b l i c v o i d o n B u t t o n C l i c k e d ( B u t t o n O b j e c t b o ) { i f ( b o = = t h i s . b t n Q u e r y ) { o n Q u e r y ( ) ; } e l s e i f ( b o = = t h i s . b t n A d d ) { o n A d d ( ) ; } e l s e i f ( b o = = t h i s . b t n D e l ) { o n D e l ( ) ; } … … … … 4.4 单 据 模 板 初 始 化 为了能 够使 得界 面的 展现 变得更 加人 性化 ， 在 N C 中提出 了单 据模 板的 概念 ， 即提供了一 个界 面 “ 客 户化 ” - > “ 二 次开 发工 具 ” - > “ 模 板管理 ” - > “ 单 据模 板初 始化 ” 节点 ， 来 自定 义界 面上 表头 表体的 字段 名 。

首先在 界面 中的 右上 部分 单据模 板类 型中 输入 单据 类型或 者节 点 号 （ 可以 输入 任意值 ， 但 按照 惯例 ， 一 般为 单据类 型或 节点 号 ）； 在 左 侧点击 “ 列 表显 示 ” ， 会列 出数据 库表 ， 将 dem o_bd_b om 加入 主表中 ， 将 dem o_bd_b om _b 加入 子表 列表 中 （ 如果 不 出现请重启服 务端 ） ； 点击 右边 的 增加按 钮 4.5 前 台 列 表 界 面 懒加 载 1 ） 实现监 听 器 L i s t Sel ec t i on L i s t ene r ， 监 听表 头行 选择事 件 ， 增加监 听器 ， 实 现监 听 v oi d v al ueC hange d( L i s t Sel ec t i o nE v ent e) 方法 ； 在 p os t I ni t 方法中添加监 听器 注册 语句 g e t B i l l L i s t P a n e l ( ) . g e t H e a d T a b l e ( ) . g e t S e l e c t i o n M o d e l ( ) . a d d L i s t Se l e c t i o n L i s t e n e r ( t h i s ) ; 查询后 台 （ 或前 台缓 存 ）， 加载表 体 注 ： 如 何使 用前 台缓 存 ， 参考 n c.ui .pd. pd40 10.v 5.B o m D at a 类的实 现 5 后 台 业 务 类 以 及 持 久 化 5.1 后 台 业 务 类 主要提 供了 两部 分 ， 接口 以及其 实现 。

接口放 置 于 publ i c 中 ， 例 如 nc.i t f .m m .dem o. I D em oB om 需要注 意如 下几 点 ： 1 、 方 法中 必须 抛。