Mario是一个基于.NETCore的简单快速开发框架

Mario .NET Core简单快速开发框架

Mario是一个基于.NET Core的简单快速开发框架

GitHub:https://github.com/deeround/Mario

技术特点

基于.NET Core 2.2 集成常用三方组件
AutoMapper
FluentValidation
Newtonsoft.Json
NLog
Swashbuckle

支持jwt认证、支持API资源权限验证
支持swagger中API分组显示
所有服务自动注入,无需手动注入

......

使用场景

中小型项目有时候并不需要各种复杂的驱动设计,复杂的分层设计,只需简单业务逻辑开发。Mario框架就是为了简化我们开发,减少各种繁琐的配置注入,只需关注于业务逻辑开发本身。

框架结构

mario

项目 说明
Mario.Core   底层核心库  
Mario.Data   数据封装库  
Mario.Mvc   WebApi封装库  
Mario.Web   WebApi业务库  
WangSql   数据底层库  
业务模块开发 简单模块

mario

当我们业务非常简单,我们连实体类都不写的应用场景,就是简单直接干,只用写API,直接在控制器写业务就行了。

分为以下几步即可完成: 1、模块相关配置

mario

配置swagger信息,每个模块都是配置swagger信息(需要开启API分组功能)

配置数据库信息,可以配置多个多种数据库(支持很多数据库的)

2、添加模块目录

mario

Test就是模块

Test\Controllers就是API,在控制器里面写业务逻辑就行了

Test\ApiModule.cs为模块启动初始化类,可以在里面写模块初始化逻辑

3、添加测试控制器

在Test\Controllers下添加Test控制器

public class TestController : ApiController { /// <summary> /// 演示使用原始方法和扩展方法查询数据 /// </summary> /// <returns></returns> [HttpGet()] public IList<Dictionary<string, object>> GetList() { return SqlMapper.Query<Dictionary<string, object>>("select * from T_SYS_USER", null).ToList(); //原始方法 //return SqlMapper.ListSod("select * from T_SYS_USER"); //扩展方法 } /// <summary> /// 分页查询 /// </summary> /// <returns></returns> [HttpGet()] public PageData<StrObjDict> GetPage(string name) { string sql = "select * from T_SYS_USER where 1=1"; StrObjDict sod = new StrObjDict(); if (!string.IsNullOrEmpty(name)) { sql += $" and USERNAME like '%$USERNAME$%'"; sod.Add("USERNAME", name); } //排序设置 sql += $" order by USERNAME desc"; return SqlMapper.PageSod(sql, sod, 1, 20, out int total); } /// <summary> /// 定义好入参,但不定义出参格式 /// 方便扩展入参,也可使用swagger直接测试,但是前端无法通过swagger查看接口出参格式,只有请求后才知道出参格式 /// </summary> /// <param></param> /// <returns></returns> [HttpGet()] public IList<StrObjDict> GetByName(string name) { //return SqlMapper.ListSod("select * from T_SYS_USER where USERNAME like '%$USERNAME$%'", name); //写法1 return SqlMapper.ListSod("select * from T_SYS_USER where USERNAME like '%$USERNAME$%'", new StrObjDict() { { "USERNAME", name } }); //写法1 } /// <summary> /// 这个是上面方法另一种写法 /// 这种方法不固定入参,可随时添加删除入参,但是无法使用swagger直接测试,可使用postman等其他接口工具测试 /// 这种方法前端入参和出参都不知道格式,需要前后端提前约定好出入参 /// </summary> /// <returns></returns> [HttpGet()] public IList<StrObjDict> GetByNameNoParam() { var param = ApiContext.GetRequestParam(); string name = param.GetString("name"); //return SqlMapper.ListSod("select * from T_SYS_USER where USERNAME like '%$USERNAME$%'", name); //写法1 return SqlMapper.ListSod("select * from T_SYS_USER where USERNAME like '%$USERNAME$%'", new StrObjDict() { { "USERNAME", name } }); //写法1 } } 4、使用swagger测试API

访问 :4567/swagger/index.html

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/zyyjjx.html