JBMS www. s o f t 8 6 .cn
文档/Doc
JBMS完整案例:客户管理-新增客户

须知一:此篇文档内容基于文档:[客户管理-准备工作],新增客户开发工作是基于已创建好的代码结构上进行局部性的完善即可;;

须知二:此篇文档将以[客户管理]中功能[新增客户]描述说明JBMS中如何基于数据列表开发新增数据功能,页面组件采用Layui,可访问Layui官网了解如何使用,源码中也有完整的代码供参数;

目录

--step 1(jbms.api 完善EOperate)

--step 2(jbms.api 新建客户业务逻辑实现)

--step 3(jbms.web 完成新增客户功能)

--step 4(开发完成,验证)

step 1(jbms.api完善数据载体类-即实体Bean):

1、基于[完整案例:客户管理][准备工作]中编写的M1_02完善配置:param,将api.domain.customer.Customer数据载体内中新建时必须的业务参数添加到M1_02中;

2、完整代码请下载jbms源码包查看,关键代码如下:代码右上角可点击copy按钮复制当前代码段;

api.cons.EOperate


M1_02(EModel.M1,"2",CURD.CREATE,"JBMS新建客户数据","apiAccount,customerName"),

step 2(jbms.api 新建客户业务逻辑实现):

1、api.serviceimpl.customer.CustomerServiceImpl 重写:save(JSONObject jparam)

2、jbms.api中的所有与API层通信的方法都约定参数为:JSONObject,返回数据类型为:HttpResult;

3、完整代码请下载jbms源码包查看,关键代码如下:代码右上角可点击copy按钮复制当前代码段;

api.serviceimpl.customer.CustomerServiceImpl


@Override
public HttpResult save(JSONObject jparam) throws ServiceException {
	//判断客户名称是否存在 
	if(getAssertUtil().isNotNull(getByCustomerName(jparam.getString(EText.customerName.text)))){
		throw new ServiceException(ErrorCode.E0000020);
	}
	
	//判断客户登录账户是否存在 
	if(getAssertUtil().isNotNull(jparam.getString(EText.loginAccount.text)) 
			&& getAssertUtil().isNotNull(getByLoginAccount(jparam.getString(EText.loginAccount.text)))){
		throw new ServiceException(ErrorCode.E0000046);
	}
	
	//持久化数据
	Customer customer = JSONObject.parseObject(jparam.toJSONString(), Customer.class);
	customerMapper.insert(customer);
	
	return HttpResult.success();
}

step 3(jbms.web 完成新增客户功能):

说明:jbms.web 页面组件采用Layui,可访问Layui官网了解如何使用,源码中也有完整的代码供参数;

1、编辑JS:src/main/resources/static/js/add.js

2、编辑处1:pageJsObj.addListener(),修改保存提交的服务,对应api_config.js配置的 save:http_model.customer+"save",

3、编辑处2:pageJsObj.addListener(),修改pageJsObj.cform.verify中表单有效性验证实现;

编辑处1:


$.ajax({
	type:"post",
	url:api_config.customer.save,

编辑处2:请参考源码(特殊符号较多,代码显示组件中不便显示);

step 4(开发完成,验证):

1、登录jbms.web URL:http://localhost:8088/jbms.web/ ;

2、使用超级管理员身份登录(无需配置权限等); 使用其它用户,参考文档:系统用户及权限

3、进入系统后,点击顶部模块栏[客户],加载下左侧菜单,菜单路径:客户管理-客户列表 下右主操作区就打开Tab卡页面;

4、点击表格顶部按钮[加载数据] 分页加载客户数据;

5、点击表格顶部按钮[新增客户] 在弹出窗口中完成即可;