4.2典型服务端Coding

典型的服务端Coding服务端代码的编写主要针对App目录下的PurOrderControllerBean 实现类，典型的代码有新增、修改、检验等操作，下面作分别介绍：提交控制用户在编辑界面上点击‘保存’按钮时应用框架会调用PurOrderControllerBean的submit 方法，通过重载PurOrderControllerBean父类的submit方法，可以对要新增、修改的数据进行校验、修正或做一些相关的判断：protected IObjectPK _submit(Context ctx, IObjectValue model)throws BOSException, EASBizException{PurOrderInfo purOrderInfo = (PurOrderInfo) model;//记录是否是新增，false表示是修改，据此可以作相关操作boolean isAddNew = true;if(purOrderInfo.getId()!=null&&_exists(ctx,new ObjectUuidPK(purOrderInfo.getId()))){isAddNew = false;}//检查是否设置number//checkNumber(ctx, otherBillInfo);//调用父类的方法检查是否有重号//super._checkNumberDup(ctx, null, purOrderInfo );// 设置值对象中的一些默认值setDefaultValue(ctx, purOrderInfo);//校验值对象中的属性是否合法checkV alid(purOrderInfo);//调用框架的提交方法return super._submit(ctx, purOrderInfo);}对于用户在编辑界面上点击‘暂存’按钮时调用_save(Context ctx, IObjectValue model)方法，其操作过程与调用_submit方法类似_update(Context ctx, IObjectPK pk, IObjectValue model)方法供更新操作调用权限检查先了解一下权限接口类提供的有关权限项检查的方法/**** 描述：返回用户是否具有某项功能的权限* @param userPK 验权用户PK* @param orgPK 验权组织PK* @param permItemName 权限项名称* @return true:有权false:无权* @throws BOSException* @throws EASBizException* @author:ryanzhou*/public boolean hasFunctionPermission(IObjectPK userPK,IObjectPK orgPK,String permItemName)throws BOSException, EASBizException;/**** 描述：返回用户是否具有某项功能的权限* @param userPK 验权用户PK* @param orgPK 验权组织PK* @param uiPK UI元数据PK* @param actionPK 业务操作的PK* @return true:有权false:无权* @throws BOSException* @throws EASBizException* @author:ryanzhou*/public boolean hasFunctionPermission(IObjectPK userPK,IObjectPK orgPK,IMetaDataPK uiPK,IMetaDataPK actionPK)throws BOSException, EASBizException;/**** 描述：检查用户是否具有某项功能的权限,* 无权时会抛出包含提示信息的业务异常* @param userPK 验权用户PK* @param orgPK 验权组织PK* @param permItemName 权限项名称* @throws BOSException* @throws EASBizException* @author:ryanzhou*/public void checkFunctionPermission(IObjectPK userPK,IObjectPK orgPK,String permItemName)throws BOSException, EASBizException;/**** 描述：检查用户是否具有某项功能的权限,* 无权时会抛出包含提示信息的业务异常* @param userPK 验权用户PK* @param orgPK 验权组织PK* @param uiPK UI元数据PK* @param actionPK 业务操作的PK* @throws BOSException* @throws EASBizException* @author:ryanzhou*/public void checkFunctionPermission(IObjectPK userPK,IObjectPK orgPK,IMetaDataPK uiPK,IMetaDataPK actionPK)throws BOSException, EASBizException;具体调用方法：com.kingdee.eas.base.permission.IPermission perm= null；perm =PermissionFactory.getLocalInstance(ctx );perm.hasFunctionPermission(userPK, orgPK, uiPK，actionPK);通过返回boolean值确定是否具有相应的权限项，根据不同的应用场景调用不同的应用方法检验操作的功能权限或数据权限。

1）凭证生成前的控制通过重载父类的_createV oucher方法实现其控制，在做凭证生成动作之前进行相关的断或则修改例如：protected void _createV oucher(Context ctx, String billId)throws BOSException, EASBizException{IPurOrder purOrder= PurOrderFactory.getLocalInstance(ctx);//创建pk对象ObjectUuidPK pk = new ObjectUuidPK(billId);//在客户端获取用户信息UserInfo currentUser = (UserInfo) ctx.get(ERINFO)//根据ID返回当前的值对象PurOrderInfo purOrderInfo ;purOrderInfo = get PurOrderInfo (ctx, pk);//作相关判断if (purOrderInfo!= null){Date billDate = purOrderInfo.getBillDate();if (billDate != null){//作相应处里}// 已生成凭证，不能重复生成凭证if (purOrderInfo.isFiV ouchered()){throw new lBizException(‘*****’);}if (BillStatusEnum.AUDITED.equals(purOrderInfo.getBillStatus())){//此过程中自动生成凭证purOrderInfo.setFiV ouchered(true);purOrderInfo.update(pk, otherBillInfo);}}}生成凭证下面是具体生成凭证的典型代码，也可以通过dap平台配置生成凭证protected IObjectValue _genV oucher(Context ctx, String billID)throws BOSException, EASBizException {// 生成凭证，并返回集合IObjectCollection tmpCollection = null;//dap动态会计平台IDAPTransformer iDAPTransformer = DAPTransformerFactory.getLocalInstance(ctx);//CoreBillBaseCollection coreTransCollection = new CoreBillBaseCollection();ObjectUuidPK pk = new ObjectUuidPK(billID);//获取值对象PurOrderInfo model = (PurOrderInfo) this.getValue(ctx, pk);coreTransCollection.add(model);//获取转换后的凭证值对象tmpCollection=iDAPTransformer.transformAuto(coreTransCollection,DAPVoucherTypeEnum.FIV oucher) ;//创建凭证实体对象接口IVoucher vchCtrl = (IV oucher) V oucherFactory.getLocalInstance(ctx);//从集合众取出转换后凭证值对象VoucherInfo vch = (V oucherInfo) tmpCollection.getObject(0);VoucherInfo vch1 = new V oucherInfo();vch1 = vchCtrl.exteriorLazyLoad(vch, V oucherInfo.getDefaultSelector());return vch1;}审核操作通过重载父类的_ audit方法实现审核控制,如下代码所示：protected void _audit(Context ctx, IObjectPK pk) throws BOSException, EASBizException {//对参数的常用判断if ((pk == null)) {throw new IllegalArgumentException();}// 当前用户UserInfo currentUser = (UserInfo) ctx.get(ERINFO);// 当前日期Date currentDate = new Date();// 检查单据是否存在// PurOrderBizException 是用户定义的异常类boolean exist = exists(ctx, pk);if (!exist){throw new PurOrderBizException(PurOrderBizException.BILL_NOTEXIST);}PurOrderInfo purOrderInfo= getPurOrderInfo (ctx, pk);//设置审核人purOrderInfo.setAuditor(currentUser);//设置审核日期purOrderInfo.setAuditDate(currentDate);//设置单据的状态为—已审核purOrderInfo.setBillStatus(BillStatusEnum.AUDITED);//更新实体，完成审核标记update(ctx, pk, purOrderInfo);}编码规则下面是判断是否定义了编码规则：protected boolean isRuleAutoNumber( Context ctx,PurOrderInfo purOrderInfo,String strCompanyID)throws EASBizException, BOSException{//系统工具，判断字符窜是否为‘空’if (StringUtils.isEmpty(strCompanyID)) {CompanyOrgUnitInfo aCompanyOrgUnitInfo = null;if (purOrderInfo.getCompany() != null){//获取公司信息aCompanyOrgUnitInfo = purOrderInfo.getCompany();}Else{//获取当前财务组织// ContextUtil 系统工具类，提供常用信息的获取aCompanyOrgUnitInfo = ContextUtil.getCurrentFIUnit(ctx);}strCompanyID = aCompanyOrgUnitInfo.getId().toString();}//编码规则管理类ICodingRuleManager iCodingRuleManager = null ；iCodingRuleManager =CodingRuleManagerFactory.getLocalInstance(ctx);//调用具体方法判断规则是否存在if (iCodingRuleManager.isExist(otherBillInfo, strCompanyID)){return true;}return false;}扩展开发如图：Bim会添加一个Ex后缀的java类，该类继承自实现类。