由于在之前公司业务的发展,需要在基于核心业务的基础上开发其他较为独立的业务系统,所以就有了这个基于Dapper,DDD概念的基础框架,由于个人基于这个框架已经经历过两个系统的开发,也因为其他项目团队需要基于这个框架进行其他系统的一些开发,所以需要对此框架有一些简单介绍和使用说明。
1.主要框架主体介绍
Dapper,DapperExtensions:Dapper框架集成。
Topever.AutoMapper:对象映射扩展,这个项目其实可以集成到公共项目Topevery.Infrastructure项目中。
Topevery.Dapper.Oracle:主要存放实体映射文件、仓储实现类。
Topevery.Infrastructure:框架中跟业务无关的公共类。
Topever.Core:主要存放实体类,仓储接口接口定义,实现对象状态(增删改)
Topevery.Application:应用服务,业务逻辑处理,数据处理
Topevery.Web:web站点,主要采用了webapi提供api接口,mvc模式提供路由以及视图展示。
2.快速开发,自然就需要借助一些代码生成的工具,所以这里使用了同事在之前在弄ABP框架使用的T4模板技术,基于原有的基础代码下,做了一些代码修改,生成相对应的代码逻辑。
因此主要的工作任务的重点就是前台工作的开发,其他一个项目组需要在短时间内开发完成一个系统开发,很荣幸的我被调入到了这个项目组,负责其中两个相对为独立简单的系统开发,10个模块,19张表,大部分的是单表的增删改查,相对复杂一点的主要是其中的两个需要走流程的业务。由于需要在两个星期左右交付这个软件,主要一个人承担这个开发任务,有一个前端配合静态页面处理,又因为客户要求需要第一个星期周末需要发布一个版本的时候,压力其实真的很大,当时自己整理了一下开发思路,第一步,搭建基础框架,把公司之前的基础框架搭建起来,维护其中的人员,角色,权限,菜单配置等基础信息(项目经理搭建了基础数据库),第二步,根据数据库设计word文档建立对应的pd文件,生成数据库实体。第三步,基础上个项目的T4模板项目修改代码,生成其中基础的实体,map映射,仓储接口,仓储实现,业务简单逻辑代码,输入输出DTO类。第四步,集成其他项目中使用到的一些扩展控件,比如文件上传,附件展示...。第五步,就可以正式的开始模块开发了。
简单介绍一些前端开发的一些东西吧,由于需要给负责前端开发的同事介绍这个东西,所以这里讲一下mvc以及webapi
ApiControllers:webapi提供,主要抛出接口给前端调用,这里主要引用Topever.Application项目中定义的服务
App_Start:webapi,MVC,路由配置,以及其他的一些配置存放
Controller:控制器,是应用程序中处理用户交互的部分。通常控制器负责从视图读取数据,控制用户输入,并向模型发送数据。
Views:展示页面的存放。
前端主要使用了bootstrap,layer框架,使用局部视图展示,减少子页面加载的一些公用的东西(子页面加载使用的方法是通过ajax请求页面,返回html然后展示到页面)
$.fn.bindAddBtn = function (url, width, height, title) { $(this).on("click", function () { $.topevery.ajax({ type: "get", url: url, dataType: "html" }, function (data) { layer.open({ type: 1, title: title || "新增", skin: ‘layui-layer-rim‘, //加上边框 area: [width + ‘px‘, height + ‘px‘], //宽高 content: data }); }, true); }); }
主要封装了增删改查这几个基本操作的按钮代码,减少前端js代码的编写。
(function ($) { /** * 设置jgrid的样式 */ $.jgrid.defaults.styleUI = "Bootstrap"; $.fn.jgridInit = function (options) { $.fn.jgridInit.defaults = { datatype: "json", mtype: "POST", shrinkToFit: true, postData: options.postData, autowidth: true, height: options.height == null ? "100%" : options.height, rowNum: options.rowNum ? options.rowNum : 10, rowList: [10, 20, 50, 100], viewrecords: true, rownumbers: true, repeatitems: false, jsonReader: { root: function (obj) { return obj.result.rows; }, page: function (obj) { return obj.result.page; }, total: function (obj) { return obj.result.total; }, records: function (obj) { return obj.result.records; }, repeatitems: false }, sortname: options.sortname ? options.sortname : ‘C_CREATE_TIME‘, sortorder: ‘desc‘, pager: ‘#pager‘, pginput: true, pgbuttons: true, gridComplete: function () { //$(this).setGridHeight($(".content-wrapper").outerHeight(true) - $(".nav-header").outerHeight(true) - 3 - $(".content-header").outerHeight(true) - 31 - 36 - 28 - 20); var header = $(".content-wrapper").outerHeight(true) - $(".nav-header").outerHeight(true) - 3 - $(".content-header").outerHeight(true) - $(this).parent().parent().prev().find(".ui-jqgrid-hbox").outerHeight(true) - 31 - 28 - 20; //var header2 = $(".content-wrapper").outerHeight(true) //内容高度 // - $(".nav-header").outerHeight(true) //导航栏 // - $(".nav-header").parent().next().outerHeight(true) //导航栏和内容之间的分隔符 // - $(".content-header").outerHeight(true) //内容的头部搜索栏 // - $("div.ui-jqgrid-hbox").outerHeight(true) //grid的头 // - $("footer").outerHeight(true) // - $("#pager").outerHeight(true)-18; $(this).setGridHeight(header); } }; var array = $.extend({}, $.fn.jgridInit.defaults, options); $(this).jqGrid(array); } /** * 绑定添加按钮 * @param {} url * @param {} width * @param {} height * @param {} title * @returns {} */ $.fn.bindAddBtn = function (url, width, height, title) { $(this).on("click", function () { $.topevery.ajax({ type: "get", url: url, dataType: "html" }, function (data) { layer.open({ type: 1, title: title || "新增", skin: ‘layui-layer-rim‘, //加上边框 area: [width + ‘px‘, height + ‘px‘], //宽高 content: data }); }, true); }); } /** * 绑定编辑 * @param {} url * @param {} obj * @param {} width * @param {} height * @param {} title * @returns {} */ $.fn.bindEditBtn = function (url, obj, width, height, title, extension) { $(this).on("click", function () { var rowIndex = $(obj).jqGrid(‘getGridParam‘, ‘selrow‘); if (rowIndex != null) { var rowData = $(obj).jqGrid(‘getRowData‘, rowIndex); var extensionUrl = ""; if (extension) { extensionUrl = extension; } /*layer弹出一个html页面或者html片段*/ $.topevery.ajax({ type: "get", url: url + "?Id=" + rowData.id + extensionUrl, dataType: "html" }, function (data) { layer.open({ type: 1, title: title || "修改", skin: ‘layui-layer-rim‘, //加上边框 area: [width + ‘px‘, height + ‘px‘], //宽高 content: data }); }, true); } else { layer.alert("请选择一条记录!"); } }); }, /** * 删除事件 * @param {} url * @param {} obj * @returns {} */ $.fn.bindDelBtn = function (url, obj) { $(this).on("click", function () { var rowIndex = $(obj).jqGrid(‘getGridParam‘, ‘selrow‘); if (rowIndex) { var rowData = $(obj).jqGrid(‘getRowData‘, rowIndex); $.topevery.ajax({ url: url, data: JSON.stringify({ "Id": rowData.id }) }, function (data) { var message = "删除失败"; if (data.success) { if (data.result.success) { $(obj).trigger("reloadGrid"); } message = data.result.message; } layer.msg(message, { icon: 1, title: false, //不显示标题 offset: ‘rb‘, time: 3000, //10秒后自动关闭 anim: 2 }); }); } else { layer.alert("请选择一条记录!"); } }); } /** * 绑定验证属性以及提交按钮 * @param {} options * @returns {} */ $.fn.bootstrapValidatorAndSumbit = function (url, options, validateForm) { if (validateForm == undefined) { validateForm = function () { return true; }; } $(this).bootstrapValidator({ message: ‘输入的值无效‘, feedbackIcons: { valid: ‘glyphicon glyphicon-ok‘, invalid: ‘glyphicon glyphicon-remove‘, validating: ‘glyphicon glyphicon-refresh‘ }, fields: options }).on(‘success.form.bv‘, function (e) { e.preventDefault(); var $form = $(e.target); var bv = $form.data(‘bootstrapValidator‘); if (validateForm() && bv.isValid()) { $.topevery.ajax({ url: url, data: JSON.stringify($.topevery.serializeObject($form)) }, function (data) { var message = "新增失败"; if (data.success) { if (data.result.success) { $(".layui-layer-close").click(); $(‘.query_btn‘).click(); } message = data.result.message; } layer.msg(message, { icon: 1, title: false, //不显示标题 offset: ‘rb‘, time: 3000, //10秒后自动关闭 anim: 2 }); } ); } }); }, } })(jQuery);
页面js代码
$(function () { var getPostDataUrl = ""; var deleteUrl = ""; var addUrl = ""; var grid = $("#tblData"); grid.jgridInit({ url: getPostDataUrl, colNames: [],//列头 colModel: [ ], postData: { }//查询参数 }); $(".add_btn").bindAddBtn(addUrl, 600, 650); $(".edit_btn").bindEditBtn(addUrl, grid, 600, 650); $(".del_btn").bindDelBtn(deleteUrl, grid); $(".query_btn").on("click", function () { $("#tblData").jqGrid(‘setGridParam‘, { url: getPostDataUrl, page: 1, postData: { } }).trigger("reloadGrid"); }); });
页面html代码
<div class="col-xs-12"> <div class="box-header nav-header"> </div> </div> <div class="col-xs-12" style="background-color: #000000; height: 3px;"></div> <div class="col-xs-12 "> <!-- 工具栏 --> <div class="content-header form-inline row"> <div class="form-group"> <input class="btn btn-success add_btn" type="button" value="上报"> <input class="btn btn-info edit_btn" type="button" value="修改"> <input class="btn btn-danger del_btn" type="button" value="删除"> <input class="btn btn-danger del_btn" type="button" value="导出"> </div> <div class="form-group"> <input class="btn btn-success query_btn" type="button" value="查询"> </div> </div> <div class="box-body row"> <table id="tblData"></table> <div id="pager"></div> </div> </div> <script src="~/Views/BudgetManagement/EmergencyIndex.js"></script>
附一个页面效果
总结:这次开发经历,算是对自己的一个挑战。我乐于接受这种挑战。只是下一次挑战面前,自己更加从容一些,事情做得更加规范一些。