DaleCloud（原NFine）介绍三：后台业务功能开发实战演示

最新推荐文章于 2024-04-07 10:00:00 发布
最新推荐文章于 2024-04-07 10:00:00 发布
阅读量5.5k 收藏 11
点赞数 6
分类专栏： DaleCloud框架 文章标签： NFine教程 MVC示例
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/wuyuander/article/details/103698567
版权

目录

前言

示例概述

第一步：根据数据表创建Entity，Mapping和Repository对应的代码文件

第二步：在Application中添加CustomerApp实现客户档案的业务

第三步：Web的Areas文件夹下创建一个区域，并完成控制器创建；

第四步，在控制器Controller和前端cshtml页面中编写业务代码

前言

第一次拿到NFine框架的时候，我也是一脸懵逼，原框架作者黄林大大就写了一篇框架介绍，具体的教程也没有。当时想做一个业务方面的系统，但是研究了半天不知道如何下手。后来求了度娘半天，终于在优快云，博客园等平台上零零散散找到了其他博主的使用心得，于是战战兢兢的摸索了一下午，终于完成了一个页面设计和访问。

原作者黄林大大的博客截图，是不是看着一脸懵逼？没事我重新整理了以下，今天就教大家如何一步一步的完成一个业务功能的实现。就拿建立一个客户资料管理来举例；

示例概述

我需要建立关于客户&&关系（优快云老是说我含广告，他们眼瞎了）的业务大类模块，里面包括客&&户的档案，客&&户拜访，合同&&管理等子业务功能。今天只讲解如何添加客&户&档&案业务功能。

材料准备：客&户&管&理的子目录名为CustomerManage；数据库表名：CRM_Customer；客&户&档&案二级目录为Customer；

在之前写的  DaleCloud（原NFine）介绍一：开发框架源代码解决方案结构介绍  文章中介绍了解决方案中的每个项目的作用。这里要完整的实现一个业务功能，需要用到DaleCloud.Entity，DaleCloud.Mapping，DaleCloud.Repository，DaleCloud.Application以及前端web。

  1. 在Entity，Mapping，Repository添加对应的cs文件，此步骤可以通过工具实现。
  2. 在Application中添加CustomerApp实现业务。
  3. 在Web的Areas文件夹下创建一个区域：CustomerManage；
  4. 在CustomerManage区域的Controllers中添加Customer控制器；
  5. 在CustomerManage区域的Views添加Customer文件夹以及对应的cshtml文件（index，form，detail）。
  6. 至此可以浏览这个页面，然后再一步步实现增删改查。

第一步：根据数据表创建Entity，Mapping和Repository对应的代码文件

1）在Entity项目中新建CustomerManage文件夹，并添加CustomerEntity.cs文件，代码如下；

/*******************************************************************************
 * Copyright © 2018 DaleCloud.Framework 版权所有
 * Author: DaleCloud
 * Description: DaleCloud
 * Website：
*********************************************************************************/

using System; 
using System.Text;
using System.Collections.Generic; 
using System.Data;

namespace DaleCloud.Entity.CustomerManage 
{
    public class CustomerEntity : IEntityV2<CustomerEntity> , ICreationAuditedV2 , IModificationAuditedV2
    { 
	/// <summary>
	/// 主键
        /// </summary>		
        public string T_Id{ get; set; }        
	/// <summary>
	/// 客户编号
        /// </summary>		
        public string T_CustCode{ get; set; }        
	/// <summary>
	/// 客户名称
        /// </summary>		
        public string T_FullName{ get; set; }
        /// <summary>
        /// 客户类型
        /// </summary>		
        public string T_CustType { get; set; } 
        /// <summary>
        /// 备注
        /// </summary>
        public string T_Remark { get; set; }
        /// <summary>
        /// 状态，1正式，0意向,-1删除
        /// </summary>		
        public int T_State{ get; set; }              
	/// <summary>
	/// 用户ID
        /// </summary>		
        public string T_CreatorUserId{ get; set; }          
	/// <summary>
	/// 操作时间
        /// </summary>		
        public DateTime? T_CreateTime { get; set; }        
	/// <summary>
	/// 更新用户
        /// </summary>		
        public string T_ModifyUserId{ get; set; }        
	/// <summary>
	/// 更新时间
        /// </summary>		
        public DateTime? T_ModifyTime{ get; set; }        
		   
    }
}

2）在Mapping项目中新建CustomerManage文件夹，并添加CustomerMapping.cs文件，代码如下；

using DaleCloud.Entity.CustomerManage;
using System.Data.Entity.ModelConfiguration;

namespace DaleCloud.Mapping.CustomerManage 
{
    //CRM_Customer
    public class CustomerInfoMap : EntityTypeConfiguration<CustomerEntity>
    {
   		     
	public CustomerInfoMap()
        {
            this.ToTable("CRM_Customer");
            this.HasKey(t => t.T_Id);
        }
    }
}

3）在Repository项目中新建CustomerManage文件夹，并添加CustomerRepository.js文件，代码如下；

using DaleCloud.DataBase;
using DaleCloud.Entity.CustomerManage;

namespace DaleCloud.Repository.CustomerManage 
{
    //CRM_Customer
    public class CustomerInfoRepository : RepositoryBase<CustomerEntity>, IRepositoryBase<CustomerEntity>
    {
   		
    }
}

以上文件，都可以通过工具来实现，我通过动软代码生成器自定义了一个模板，通过模板可以把数据库表生成对应的Entity，Mapping和Repository文件。适合大多数项目使用。需要的可以通过加群（群 号：920900045）在群文件中下载。

第二步：在Application中添加CustomerApp实现客户档案的业务

1）在Application项目中新建CustomerManage文件夹，并添加CustomerApp.cs文件，并完成增删改查代码；

using System;
using System.Collections.Generic;
using System.Linq;
using DaleCloud.Code;
using DaleCloud.Entity.CustomerManage;
using DaleCloud.Repository.CustomerManage;

namespace DaleCloud.Application.CustomerManage
{
    public class CustomerApp
    {
        private CustomerInfoRepository service = new CustomerInfoRepository();

        public List<CustomerEntity> GetList()
        {
            return service.IQueryable().OrderBy(t => t.T_CreateTime).ToList();
        }

        /// <summary>
        /// 获取客户信息
        /// </summary>
        /// <param name="pagination">分页</param>
        /// <param name="startdate">起始时间</param>
        /// <param name="enddate">结束时间</param>
        /// <param name="keyword">关键字</param>
        /// <returns></returns>
        public List<CustomerEntity> GetList(Pagination pagination, string startdate, string enddate,  string keyword = "")
        {
            var expression = ExtLinq.True<CustomerEntity>();
            if(startdate!=null && enddate!=null)
            {
                DateTime sdate = DateTime.Parse(startdate);
                DateTime edate = DateTime.Parse(enddate);
                expression = expression.And(t => t.T_CreateTime > sdate && t.T_CreateTime < edate);
            }
            if (!string.IsNullOrEmpty(keyword))
            {
                expression = expression.And(t => t.T_FullName.Contains(keyword));
                expression = expression.Or(t => t.T_CaliName.Contains(keyword));
                expression = expression.Or(t => t.T_Linkman.Contains(keyword));
                expression = expression.Or(t => t.T_Mobile.Contains(keyword));
            }
            return service.FindList(expression, pagination).OrderBy(t => t.T_CreateTime).ToList();
        }

       /// <summary>
       /// 获取客户实体
       /// </summary>
       /// <param name="keyValue"></param>
       /// <returns></returns>
        public CustomerEntity GetForm(string keyValue)
        {
            return service.FindEntity(keyValue);
        }

        /// <summary>
        /// 删除记录
        /// </summary>
        /// <param name="keyValue"></param>
        public void DeleteForm(string keyValue)
        {
          
            var data = service.IQueryable().Single(t => t.T_Id.Equals(keyValue));
            if (data != null && data.T_State ==1)
            {
                throw new Exception("删除失败！正式客户不允许删除。");
            }
            else
            {
                service.Delete(t => t.T_Id == keyValue);
            }
        }

        /// <summary>
        /// 保存表单
        /// </summary>
        /// <param name="mEntity"></param>
        /// <param name="keyValue">主键</param>
        public void SubmitForm(CustomerEntity mEntity, string keyValue)
        {
            if (!string.IsNullOrEmpty(keyValue))
            {
                mEntity.Modify(keyValue);
                service.Update(mEntity);
            }
            else
            {
                mEntity.Create();
                service.Insert(mEntity);
            }
        }
        
    }
}

第三步：Web的Areas文件夹下创建一个区域，并完成控制器创建；

1）在Areas文件夹下右键添加一个区域，名称为：CustomerManage。VS2015会自动创建一个对应的文件夹，下面包含Controllers，Models，Views文件夹和一个CustomerManageAreaRegistration.cs的区域注册器文件。

2）打开CustomerManageAreaRegistration.cs文件，编写代码如下（其实你也可以从其他已有的区域注册器中把代码复制拷贝过来，然后改一下AreaName方法中的返回名称就行）：

using System.Web.Mvc;

namespace DaleCloud.Web.Areas.CustomerManage
{
    public class CustomerManageAreaRegistration : AreaRegistration
    {
        public override string AreaName
        {
            get
            {
                return "CustomerManage";
            }
        }

        public override void RegisterArea(AreaRegistrationContext context)
        {
            context.MapRoute(
              this.AreaName + "_Default",
              this.AreaName + "/{controller}/{action}/{id}",
              new { area = this.AreaName, controller = "Home", action = "Index", id = UrlParameter.Optional },
              new string[] { "DaleCloud.Web.Areas." + this.AreaName + ".Controllers" }
            );
        }
    }
}

3）在CustomerManage文件夹下右键添加一个空白的MVC5控制器-，名称为：CustomerController。VS2015会自动在Controllers创建一个CustomerController.cs文件，在Views文件夹中创建Customer文件夹。请将你的页面文件放入到Customer文件夹。

一般情况下我们常用到的页面包括：Index.cshtml（列表页）、Form.cshtml（表单页）、Details.cshtml（详细页）

第四步，在控制器Controller和前端cshtml页面中编写业务代码

1）开始编写CustomerController控制器中的编写视图模板输出代码和增删改查后台接收的代码。

在CustomerController类中可以通过继承ControllerBasev2或ControllerBase类来实现对Index，Form，Details页面模板输出和Json格式数据输出。ControllerBasev2是我自己单独定义的，目的是去除登陆超时验证，因为我的项目中不需要；

using System;
using System.Web;
using System.Web.Mvc;
using DaleCloud.Code;
using DaleCloud.Application.CustomerManage;
using DaleCloud.Entity.CustomerManage;

namespace DaleCloud.Web.Areas.CustomerManage.Controllers
{
    public class CustomerController : ControllerBasev2
    {
        private CustomerApp app = new CustomerApp();

        [HttpGet]
        [HandlerAjaxOnly]
        public ActionResult GetGridJson(Pagination pagination, string fromdate, string todate,string keyword)
        {
            try
            {
                var data = app.GetList(pagination, fromdate, todate, keyword);
                return DataGrid(pagination.records, data);
            }
            catch (Exception ex)
            {
                return Content(ex.ToJson());
            }
        }
        
        [HttpGet]
        [HandlerAjaxOnly]
        public ActionResult GetFormJson(string keyValue)
        {
            var data = app.GetForm(keyValue);
            return Content(data.ToJson());
        }
        
        [HttpPost]
        [ValidateAntiForgeryToken]
        public ActionResult SubmitForm(CustomerEntity uEntity, string keyValue)
        {
            app.SubmitForm(uEntity, keyValue);
            return Success("操作成功。");
        }

        [HttpPost]
        [HandlerAjaxOnly]
        [HandlerAuthorize]
        [ValidateAntiForgeryToken]
        public ActionResult DeleteForm(string keyValue)
        {
            app.DeleteForm(keyValue);
            return Success("删除成功。");
        }
    }
}

一般，我们习惯在Index页面中通过调用GetGridJson来获取数据列，通过DeleteForm来删除一条记录。在Form页面中通过GetFormJson获取表单数据，通过SubmitForm来接收前端提交表单数据。当然你们根据个人喜好以及实际业务需求来自定义输出。

在控制器代码中，其中值得注意的，每个方法前都会有一些特征代码，很多人搞不清楚有什么意思，然后出现无法正确提交表单等情况：

[HttpGet] // 表示该方法仅处理来自get的请求。如果你是使用easyUI等前端框架，那么在调用该方法的时候必须指明method为get类型；

[HttpPost]// 表示该方法仅处理来自post的请求。如果你用easyUI的表单提交，请在<form id="form1" >加上method="post"，否则无法提交表单；

[HandlerAjaxOnly] // 表示指定前端页面的请求只能为Ajax请求，建议你们使用过程可以去除该代码

[HandlerAuthorize] // 表示该方法是否需要判断用户角色的权限，这就需要涉及到菜单的按钮中URL地址配置了，如果不会配置，请移除该代码。

[ValidateAntiForgeryToken] // 表示阻止伪造请求的特征验证。用来验证表单提交的，原框架提交表单的方法和现在使用easyUI提交表单的方法都支持了特征验证。为了安全起见可以使用。

 

至此，你就可以编译，访问页面了。

以上就是一如何新建一个业务功能的实战说明，有什么阐述不清楚的地方，请加群交流，也欢迎留言指正拍砖。

关于Entity实体类中如的继承以及ICreationAuditedV2, IModificationAuditedV2接口使用说明，请看后续文章

DaleCloudNetFramework:DaleCloud.Framework是一款基于NFine团队出品的"NFine.Framework" C#.NET框架 WEB + ORM 框架）改进而成的新框架，去除了后门，将原版jqgrid改为easyUI，支持微信公众号及钉钉平台接口
04-15
DaleCloud.Framework框架介绍： DaleCloud.Framework是一款基于NFine.Framework 改进而成的新C#.NET WEB框架，而NFine.Framework又是一套基于ASP.NET MVC+EF6+Bootstrap开发出来的框架，其核心版权最终解释权归《NFine团队》所有，但该团队好像对该框架放弃了，不再更新。 原项目地址： 原开发者博客： 新项目demo： 新项目文档： DaleCloud.Framework改进说明： 针对原框架诟病的cookie后门，现在已经去除； 将原版jqgrid数据列表风格改为easyUI—Bootstrap风格，除系统核心功能表单以外，其他form表单改为easyUI框架； 将项目名及空间名前缀NFine改为DaleCloud； 核心类code进行了重新整理并拓展了许多公共方法； 引入Senparc.Weixi
DaleCloud.NetFramework20200229.rar
02-29
DaleCloud.NetFramework2020-02-29的最新代码，我自已本人没有测试。测试过的代码本人的其它下载资源。
DaleCloud（原NFine）介绍一：开发框架源代码解决方案结构介绍
小小德尔(C#)
12-25 5885
目录 前言 开发框架解决方案结构 开发框架后台技术应用 前言 言归正传，众所周知NFine框架是NFine团队出品的一款.NET MVC框架，前端用的Bootstrap。但是由于NFine框架夭折了，团队也没出过什么教程文档之类的。于是我拿来改了改，改成了现在的DaleCloud框架，前端主框架依然沿用Bootstrap，表单和表格用了easyUI。 很多人拿到这套框架不知道怎么用，我...
DaleCloud（原NFine）介绍：使用easyui实现主从表提交（单据业务）
小小德尔(C#)
03-09 2739
很多使用DaleCloud（原NFine）框架的同学一直在问，如何实现一对多的主从表业务数据提交。起始这是大部分做业务系统人的常见问题。比如我们的采购订单，入库单，出库单，等常见业务单据都存在主表+明细表的业务逻辑。 那么如何实现一个页面完成主表和明细表的增删改查呢？ 给大家举个例子： 前端样式 使用这套框架的都知道Form页面的表单如何提交，其实就是在Form页增加一个easyUI的...
DaleCloud（原NFine）介绍：前端framework-UI之对话框使用分享
小小德尔(C#)
03-19 3481
目录 前言 一、对话框（alert，confirm，prompt)使用 1.2 alert消息提示框 1.2 confirm确认对话框 1.3 prompt输入对话框 1.4 message消息框 二、弹出层Model使用方法 2.2 关闭弹出层 2.3 多个弹出层交互应用 三、后台交互Ajax操作请求 3.1 Form表单提交$.submitForm 3.2 普通数据提交...
Nfine框架初用说明
03-15
Nfine框架是一个非常强大的系统，非常适合ERP系统框架的运用，为了能快速入门Nfine系统框架，特收集了一些Nfine框架说明。
DaleCloudNetFramework下载地址及说明.txt
02-29
将项目名及空间名前缀NFine改为DaleCloud； 核心类code进行了重新整理并拓展了许多公共方法； 引入Senparc.Weixin开源SDK，支持微信公众号接口（目前仅支持自定义菜单，自定义回复，模板消息，粉丝用户获取，...
NFine快速开发框架
04-23
NFine快速开发框架是一款基于.Net技术栈，集成了Entity Framework（EF）、MVC与Bootchart的通用后台管理系统框架。这个框架旨在提供一个高效、便捷的开发环境，帮助开发者快速构建企业级应用，节省时间和精力，提高...
NFine框架: .net通用后台系统开发源码
最后，NFine框架是一个快速开发框架，它基于.NET平台，集成了上述的技术，并提供了丰富的功能来加速后台管理系统的开发。框架可能包括用户管理、权限控制、数据字典管理等常见后台管理系统的功能模块，同时可能还...
NFine数据库说明.docx
06-16
NFine数据库设计文档详细解析 NFineBase是一个数据库系统，其中包含了多个用于管理不同功能的表，如行政区域、数据库备份、IP过滤以及选项主表和明细表。这些表的设计旨在提供高效的数据存储和管理机制。 1. Sys_...
.net(EF+MVC+Bootchart)通用后台管理系统框架源码带数据库(NFine框架)
01-06
来源于开源框架，界面漂亮，用用于学习或者参考。
DaleCloudNetFramework能运行的代码和数据库备份.rar
02-29
说明： 1、网上下载的DaleCloudNetFramework总是会出现各种DLL不全，数据库与源码不一致不配套，导致新用户不知如何下手。 为方便初始使用者下载后即可使用，这个代码包括全套代码、DLL和数据库。 2、下载后，附加数据库，然后修改DaleCloudNetFramework\DaleCloud.Web\Configs中的database.config文件中的数据库链接即可使用。 说明 ：我使用的数据库是：SQL Server 2014 环境：VS 2019
(新)NFine+说明
11-11
NFine 是基于 C# 语言的极速 WEB + ORM 框架，其核心设计目标是开发迅速、代码量少、学习简单、功能强大、轻量级、易扩展，让Web开发更迅速、简单。能解决60%重复工作。为您节约更多时间，去陪恋人、家人和朋友。轻松开发，专注您的业务，从NFine开始。
C#.NET快速开发框架_Nfine 源码、数据库及详细的介绍文档
01-29
（文档是数据库说明）C#.NET快速开发框架_Nfine 源码、数据库及详细的介绍文档。NFine 是基于 C# 语言的极速 WEB + ORM 框架，其核心设计目标是开发迅速、代码量少、学习简单、功能强大、轻量级、易扩展，让Web开发更迅速、简单。能解决60%重复工作。为您节约更多时间，去陪恋人、家人和朋友。轻松开发，专注您的业务，从NFine开始。
NFine菜鸟使用说明.rar
06-19
包含Nfine框架小白使用、Nfine框架初次上手、NFine框架学习笔记等
DaleCloud（原NFine）介绍二：系统菜单及菜单按钮权限控制
小小德尔(C#)
12-25 5278
第一次写这种技术性博客，写的不好请多包含。 言归正传，众所周知NFine框架是NFine团队出品的一款.NET MVC框架，前端用的Bootstrap。但是由于NFine框架夭折了，团队也没出过什么教程文档之类的。于是我拿来改了改，改成了现在的DaleCloud框架，前端主框架依然沿用Bootstrap，表单和表格用了easyUI。 很多人拿到这套框架不知道怎么用，我摸索了一段时间后搞懂了设计...
DaleCloudNetFramework：构建高效、安全的云应用新框架
最新发布
gitblog_00042的博客
04-07 398
DaleCloudNetFramework：构建高效、安全的云应用新框架 去发现同类优质开源项目:https://gitcode.com/ 在快速发展的云计算时代，一个强大且灵活的开发框架对于开发者来说至关重要。DaleCloudNetFramework 是这样一款专为构建高效、安全的云应用而设计的开源框架，它集成了多种先进技术和最佳实践，以帮助开发者更快地实现他们的创新想法。 项目简介 Dale...
基于NFine快速开发平台（.Net Core版本）
04-04
项目使用 ASP.NET CORE 开发(src/DotNetCore目录)，需要使用 vs2017 打开
NFine - 一款高效、灵活的企业级框架，赋能你的开发工作
gitblog_00058的博客
04-01 724
NFine - 一款高效、灵活的企业级框架，赋能你的开发工作 去发现同类优质开源项目:https://gitcode.com/ 项目简介 是一个由AkonCoder开发并维护的开源企业级框架，旨在简化.NET开发流程，提高开发效率。它基于ASP.NET MVC与EF Core，集成了权限管理、工作流引擎和数据可视化等多个功能模块，为开发者提供了一站式的解决方案。 技术分析 NFine的核心特性包括...
评论 12
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值