NC65在日常开发中常用的代码写法

标题	NC65开发相关代码
版本	1.0.1
作者	walton
说明	收集NC在日常开发中常用的代码写法，示例展示

1.查询

1.1 通过BaseDAO查询结果集并转换

//通过BaseDAO进行查询，并将查询结果转换为列表
SqlBuilder sql = new SqlBuilder();
sql.append(" select ");
sql.append(" account.code,accasoa.name,accasoa.name2,accasoa.name3,accasoa.name4,accasoa.name5,accasoa.name6,account.balanorient,accasoa.pk_accasoa,accasoa.endflag");
sql.append(" from BD_ACCASOA accasoa");
sql.append(" inner join BD_ACCOUNT account on accasoa.PK_ACCOUNT = account.PK_ACCOUNT ");
if(subjType != null && subjType.equals(1)){// 查询往来类科目
	sql.append(" and account.TRAFFICSIGNS = 'Y' ");
}
sql.append(" inner join BD_ACCCHART accchart on accasoa.PK_ACCCHART = accchart.PK_ACCCHART ");
sql.append(" inner join BD_ACCTYPE acctype on account.PK_ACCTYPE = acctype.PK_ACCTYPE ");
if(subjType != null && subjType.equals(2)){ // 查询损益类科目
	sql.append(" and acctype.TYPE = 1  ");
}
sql.append(" inner join ORG_ACCOUNTINGBOOK book on accchart.PK_ACCCHART = book.PK_CURRACCCHART and book.PK_ACCOUNTINGBOOK =?");
SQLParameter param = new SQLParameter();
param.addParam(pk_accountbook);
// BeanListProcessor 的参数VO不需要元数据，保证Sql查询出的列名与字段名一致即可（处理器可在同包下查看）
List<DiffAccasoaVO> result = (List<DiffAccasoaVO>)this.getBaseDAO().executeQuery(sql.toString(), param, new BeanListProcessor(DiffAccasoaVO.class));
return result;

1.2 通过VOQuery查询单表对象

//查询条件以and开头,(String)null参数是order的语句，可为空
SqlBuilder sql = new SqlBuilder();
sql.append(" and ");
sql.append(ICPubMetaNameConst.PK_ORG, pk_org); 
sql.append(" and ");
sql.append(ICPubMetaNameConst.CMATERIALVID,cmaterialvids);
VOQuery<OnhandDimVO> query = new VOQuery<OnhandDimVO>(OnhandDimVO.class);
query.query(sql.toString(), (String)null);

1.3 通过EfficientBillQuery查询聚合对象

SqlBuilder headCond = new SqlBuilder();
 headCond.append(" from drugic_priceadjust_h where ");
 String pkGroup = (String) bgwc.getKeyMap().get("pk_group");
 headCond.append("pk_group", pkGroup);
 headCond.append(" and ");
 String pkOrg = (String) bgwc.getKeyMap().get("pk_org");
 headCond.append("pk_org", pkOrg);
 headCond.append(" and ");
 headCond.append("approvestatus", BillStatusEnum.APPROVED.valueIndex());
 headCond.append(" and ");
 headCond.append("dr", 0);
 EfficientBillQuery<AggPriceAdjustHeadVO> query = new EfficientBillQuery<AggPriceAdjustHeadVO>(AggPriceAdjustHeadVO.class);
 AggPriceAdjustHeadVO[] vos = (AggPriceAdjustHeadVO[]) query.query(headCond.toString());

1.4 通过IUAPQueryBS查询结果集

IUAPQueryBS iquery = (IUAPQueryBS)NCLocator.getInstance().lookup(IUAPQueryBS.class);
ArrayList list = null;
String sql =" select pk_dept from bd_psnjob where ismainjob ='Y' and pk_psndoc ='"+pk_psndoc+"' and dr = 0 ";
list = (ArrayList) iquery.executeQuery(sql, new ArrayListProcessor());

1.5 通过IOnhandQry查询现存量信息

OnhandQryCond onhandQryCond = new OnhandQryCond();//构造查询条件
if(cond.getByBatch()){//可以根据条件来选择要查询的现存量维度字段
	onhandQryCond.addAllSelectFields();
}else{
	onhandQryCond.addSelectFields(new String[]{"pk_group", "pk_org",
			"cwarehouseid", "cmaterialvid", "cmaterialoid", "castunitid",
			"clocationid", "vchangerate",
			"cvmivenderid", "ctplcustomerid", "cstateid", "cvendorid",
			"cprojectid", "casscustid", "cproductorid", "cffileid", "vfree1",
			"vfree2", "vfree3", "vfree4", "vfree5", "vfree6", "vfree7",
			"vfree8", "vfree9", "vfree10"});
}
onhandQryCond.setISSum(true);//设置现存量是否求和
StringBuilder sbSelFields = new StringBuilder();
sbSelFields.append(OnhandDimVO.ALIASNAME + ".").append(ICPubMetaNameConst.CWAREHOUSEID).append("='")
		.append(cond.getInvWh()).append("' AND ");// 仓库
sbSelFields.append(OnhandDimVO.ALIASNAME + ".").append(ICPubMetaNameConst.PK_ORG).append("='")
		.append(cond.getPk_org()).append("' ");// 库存组织
if (!cond.getZeroOnhand()) {//添加现存量是否需要大于0的查询条件
	sbSelFields.append(" AND (").append(OnhandNumVO.TABLENAME).append(".nonhandnum <> 0 or ")
			.append(OnhandNumVO.TABLENAME).append(".nonhandastnum <> 0 ) ");
}
onhandQryCond.setWhere(sbSelFields.toString());
onhandQryCond.setBinnerWhere(true);
try {
	OnhandVO[] onhandVOs = NCLocator.getInstance().lookup(IOnhandQry.class).queryOnhand(onhandQryCond);
	if (ValueCheckUtil.isNullORZeroLength(onhandVOs)) {
		return null;
	}
	return onhandVOs;//返回查询到的现存量信息
} catch (BusinessException e) {
	ExceptionUtils.wrappException(e);
}

1.6 客户端Client端查询（不建议使用）

SqlBuilder whereSql = new SqlBuilder();
whereSql.append(MaintensDrugVO.PK_STOCK,this.m_sWhID);
whereSql.append(" and ");
whereSql.append(MaintensDrugVO.PRODUCTNAME, CollectionUtils.setToArray(set));
MaintensDrugVO[] MaintensDrugVOs = (MaintensDrugVO[])HYPubBO_Client.queryByCondition(MaintensDrugVO.class,whereSql.toString());

2.更新

2.1 通过VOUpdate更新单表对象

//VO中的status必须设置为更新态 ，可以更新指定字段 
VOUpdate<OnhandNumVO> updateOnhand = new VOUpdate<OnhandNumVO>();
onhandNum.setStatus(VOStatus.UPDATED);
updateOnhand.update(onhandNumVOs, new String[]{"nnum1"});

2.1 通过BillUpdate更新单据（聚合对象）

BillUpdate<AggPriceAdjustHeadVO> billUpd = new BillUpdate<>();
billUpd.update(new AggPriceAdjustHeadVO[]{aggVO},new AggPriceAdjustHeadVO[]{originBill});

2.1 通过IOnhandUpdate更新现存量

IOnhandUpdate update = NCLocator.getInstance().lookup(IOnhandUpdate.class);
update.modifyOnhandNum(onhandVOs);

3.界面操作

3.1 根据model获取当前选中的表头表体数据

AggPriceAdjustHeadVO aggVO = (AggPriceAdjustHeadVO)this.model.getSelectedData();
PriceAdjustHeadVO parentVO = aggVO.getParentVO();
CircularlyAccessibleValueObject[] childVOs = aggVO.getChildrenVO();

3.2 根据model获取当前选中数据的审批状态

if(null != getModel().getSelectedData()){
    NCObject obj = NCObject.newInstance(getModel().getSelectedData());
    if (obj != null) {
        Integer status = nc.bs.pubapp.pf.util.ApproveFlowUtil.getBillStatus(obj);
    }
}

3.3 根据条件控制按钮是否可操作性

//按钮的Action中，继承NCAction并重写isActionEnable方法是控制按钮是否可操作的方法，默认返回true（可以操作）
@Override
protected boolean isActionEnable() {return true}
//----------------------------------------------------------------------
//点击新增，自动增行（在新增事件--addhandler实现implements IAppEventHandler<AddEvent>）
public void handleAppEvent(AddEvent e) {
    BillCardPanel panel = e.getBillForm().getBillCardPanel();
    Action action = panel.getBodyPanel().getBillTableAction(0);
    if (action instanceof AbstractBodyTableExtendAction) {
       AbstractBodyTableExtendAction addAction = (AbstractBodyTableExtendAction)action;
       ActionEvent ae = null;
       ae = new ActionEvent(panel.getBodyPanel().getTable(), 1234, "AutoLine");
       addAction.actionPerformed(ae);
    }
}

3.4 根据BillCardPanel动态设置表头表体字段是否为必输项（固定则在单据模板中配置）

getBillCardPanel().getHeadItem(DrugBDInfoVO.PRICE_SALE).setNull(true);
getBillCardPanel().getBodyItem("code").setNull(true);

3.5 根据BillCardPanel获取当前页签及其billModel

String tableCode = getBillCardPanel().getCurrentBodyTableCode();

BillModel billModel = getBillCardPanel().getBillModel(tableCode);

3.6 根据BillCardPanel获取界面的聚合对象，返回AggregatedValueObject

需要传入三个VO的名字，返回值类型可强制转换
AggregatedValueObject bill = e.getBillCardPanel().getBillValueVO(aggClassName, headClassName, bodyClassName);

3.7 根据BillListPanel或者BillCardPanel处理界面精度

//列表界面（在界面InitUI中加入）
ListPaneScaleProcessor scaleProcessor = new ListPaneScaleProcessor(AppContext.getInstance().getPkGroup(),this.getBillListPanel());
String[] pricekeys = new String[]{"localdebitamount","localcreditamount","debitamount","creditamount"};
PosEnum pos = PosEnum.head;
scaleProcessor.setPriceCtlInfo(pricekeys, pos, (String)null, "pk_currtype", pos, (String)null);
scaleProcessor.process();
//卡片界面（在界面InitUI中加入）
CardPaneScaleProcessor scaleProcessor = new              CardPaneScaleProcessor(AppContext.getInstance().getPkGroup(),this.getBillCardPanel());
String[] pricekeys = new String[]{"amount"};
PosEnum pos = PosEnum.body;
scaleProcessor.setPriceCtlInfo(pricekeys, pos, (String)null, "currtype", pos, (String)null);
scaleProcessor.process();

3.8 根据BillCardPanel设置表体数据及加载参照显示信息（不加载则显示主键）

DiffAdjustVO headVO = ((AggDiffAdjustVO)agg).getParentVO();
DiffAdjustBodyVO bodyVO = new DiffAdjustBodyVO();
bodyVO.setPk_org(headVO.getPk_org());
bodyVO.setPk_accountbook(headVO.getPk_accountingbook());
bodyVO.setPk_voucher(headVO.getPk_voucher());
bodyVO.setPk_detail(headVO.getPk_detail());
bodyVO.setPk_accasoa(headVO.getPk_accasoa());
int row = getCardPanel().getBillModel().getRowCount()-1;
this.getCardPanel().getBillModel().setBodyRowVO(bodyVO, row);
this.getCardPanel().getBillModel().loadLoadRelationItemValue();

3.9 禁止列表表头排序

//重写列表界面的初始化方法，移除监听
nc.ui.pubapp.uif2app.view.ShowUpableBillListView
public void initUI() {
	super.initUI();
	getBillListPanel().getHeadTable().removeSortListener();
}

3.10 根据BillCardPanel控制某个单元格是否可编辑

getBillCardPanel().getBillModel().setCellEditable(int row,String key,Boolean editable);

3.11 获取当前屏幕尺寸

Dimension screen=Toolkit.getDefaultToolkit.getScreenSize();

4.窗口提示

4.1 界面弹窗（成功、失败、警告等）

//弹框提示，可以选择多种，根据自己的需求选择(提示界面标志flag：{是：4，否：8，取消：2})
nc.ui.pub.beans.MessageDialog.showWarningDlg(null, "选择提示", "请选择单据后再点击执行");

4.2 界面底部提示信息

//在界面底部提示信息
ShowStatusBarMsgUtil.showStatusBarMsg("执行成功！", getModel().getContext());
//在界面底部弹出异常信息，中断当前操作(会出现失效情况，可配合上面提示信息使用，终止操作)
nc.vo.pubapp.pattern.exception.ExceptionUtils.wrappBusinessException("表体数据为空时，不能保存。");

4.3 自定义档案编码和名称的唯一性校验

//可以在[基础数据管控模式]节点，配置规则，如果无法新增规则，可在数据库中插入数据
select * from bd_uniquerule ;
select * from bd_uniquerule_item;
可以在[基础数据管控模式]节点中新增一条规则点击保存后，然后在此方法中进行断点调试，获取需要插入的VO信息
nc.impl.bd.config.uniquerule.BDUniqueruleManageServiceImpl.insert(BDUniqueruleVO)

5.单据模板公式

5.1 单据模板根据公式获取值

//公式可以直接获取返回值并赋值给下一条语句
pk_onhandim->getcolvalue(IC_ONHANDDIM ,PK_ONHANDDIM ,CMATERIALVID ,code_pd.pk_source );
num1->getcolvalue(IC_ONHANDNUM ,NNUM1 ,PK_ONHANDDIM ,pk_onhandim );//(表名，查询字段，条件字段，条件值)
price->getcolvalue(drugic_priceadjust_b ,price_before ,pk_priceadjust_b ,pk_priceadjust_b );
iif(price>0 ,price ,num1 );

6.参照

6.1 根据BillCardPanel获取界面参照类型字段并设置是否可多选

BillItem item = e.getBillCardPanel().getBodyItem(e.getKey());
 if (item == null)
    return;
 JComponent componen = item.getComponent();
 if (componen instanceof UIRefPane){
    UIRefPane refPane = (UIRefPane) componen;
    refPane.setMultiSelectedEnabled(true);
 }

6.2 获取参照的值

UIRefPane measdocRef = (UIRefPane) getBillCardPanel().getHeadItem(MaterialVO.PK_MEASDOC).getComponent();
measdocRef.getRefPK(); //主键 
measdocRef.getRefName(); //名称
measdocRef.getRefCode(); //编码

6.3 设置参照过滤条件

//可以添加在编辑前事件中
UIRefPane refPane=(UIRefPane)billForm.getBillCardPanel().getHeadItem("def2").getComponent();
AbstractRefModel refModel=(AbstractRefModel) refPane.getRefModel();
String wherePart=" and def5='1001H2100000004MJ7SV' ";//Sql以and开头
refModel.addWherePart(wherePart, false);//第二个参数为是否刷新该数据
refPane.setMultiCorpRef(false);//设置不能跨组织

6.4 参照选择后显示主键或编码，不显示名称

- 进入单据模板初始化节点，选择对应节点的模板并点击修改
- 进入节点模板，点击要显示名称的参照字段，在左侧界面选择高级属性
- 选中‘类型设置’行，双击值的位置会有一个参照按钮，点击参照会弹出一个界面
- 在界面中勾选‘焦点离开后显示名称’

7.其他

7.1 查找多语信息

在NCHOME中找到langlib文件夹，内部有多语jar;
根据所属模块，在功能注册节点中找到对应的编码（如库存管理为ic）;
根据模块编码找到对应的多语jar;
根据代码中的resdir信息，找到jar中对应的文件夹;