前言

在之前鼓捣过一次基础工程april.webapi后,就考虑把常用的类库打包做成一个公共类库,这样既方便维护也方便后续做快速开发使用,仓库地址:april.util_github,april.util_gitee,后续会继续推出基于util的基础工程(包含权限相关)以及如果代码生成器觉得可以了也会推出,先mark不错过。

april.util

首先,我们创建一个类库工程,当然新建之后就是删掉默认的类,我这里的版本是netstandard 2.0。

然后我们先缕下之前我做基础工程时候需要用到的通用型类库(当然后续会一直跟进补充)。

  • 通用配置 aprilconfig,aprilenums
  • 缓存相关 cacheutil,cookieutil,sessionutil,redisutil
  • 日志相关 logutil
  • 路径请求相关 uriutil
  • 回调相关 responseutil
  • 时间处理相关 dateutil
  • 验证码相关 codeutil
  • 管理员相关 tokenutil 整理中
  • 加密相关 encryputil
  • aop相关 aprillogattribute
  • 其他扩展类
  • 未完待续

我们所需要引入的nuget包,尽可能的节省新工程需要引入的类库,这样统一类库环境,方便多工程简单部署问题,当然也可以只引入dll文件,自己在工程中引入需要的环境类库,引入类库列表。

  • log4net
  • microsoft.aspnetcore.http.abstractions
  • microsoft.aspnetcore.http.extensions
  • microsoft.aspnetcore.mvc.abstractions
  • microsoft.aspnetcore.session
  • microsoft.extensions.caching.memory
  • microsoft.extensions.configuration
  • newtonsoft.json
  • qrcoder
  • stackexchange.redis
  • system.drawing.common
  • 未完待续

当然其中可能大多在webapi工程中已经存在或是需要引用,这里存在重复引入的可能,所以需要关注版本问题,但是目前是会根据新版本的稳定版来统一版本问题。

代码可直接从仓库拉取,地址也在开头给出,生成工程之后我们可以得到一个dll文件,就如我前面所说,你可以引入dll文件然后在自己工程打入需要的环境包,也可以发布一个nuget包,直接引入april.util

打包带走

首先,右键util选择属性,切换到打包界面。

之后我们来发布当前类库工程,发布的过程这里就不再多说了,之后我们根据路径来找到我们发布的类库。

本地使用

如果只是本地自己用的话,也不想发布为公开,可以通过配置nuget包的地址来获取我们自己的nuget包。

之后,我们就可以获取我们自己的nuget了。

发布nuget

当然你可以选择发布到nuget仓库,登录nuget官网,如果没有账号需要注册个google账号。

登录之后,在我们头像下选择上传包。

选择文件,拉到最下面(当然你可以一路看看相关的参数),然后最终的submit,之后我们就可以看到已经上传成功,但是检索需要等待个把小时,上传的包应该是没法删除,所以这点儿需要注意

示例

在代码仓库中我连带有个simple的webapi,里面引入了util,包括一些其他的常规使用方法,特别注意下入口文件startup,当然这个工程后续也是会不断的完善的,至于更新的力度以及代码规范度,emm,个人的力量还是有限,希望也能有更多的人可以一起探讨。

startup

        public startup(iconfiguration configuration)
        {
            configuration = configuration;

            aprilconfig.configuration = configuration;
            logutil.initlog();

            redisutil.initredis();
        }
        
        public void configure(iapplicationbuilder app, iwebhostenvironment env)
        {
            aprilconfig.serviceprovider = app.applicationservices;
            
        }

/// <summary>
        /// 示例获取
        /// </summary>
        /// <returns></returns>
        [httpget]
        [aprillog]
        public responsedataentity get()
        {
            var rng = new random();
            var data = enumerable.range(1, 2).select(index => new weatherforecast
            {
                date = datetime.now.adddays(index),
                temperaturec = rng.next(-20, 55),
                summary = summaries[rng.next(summaries.length)],
                timestamp = (int)dateutil.converttounixtimestamp(datetime.now.adddays(index))
            })
            .tolist();
            return responseutil.success("", data);
        }

        /// <summary>
        /// 验证码
        /// </summary>
        /// <param name="type">是否画线</param>
        /// <returns></returns>
        [httpget]
        [route("code")]
        public filecontentresult code(int type)
        {
            string code = codeutil.getsingleobj().createverifycode(codeutil.verifycodetype.mixverifycode, 6);
            //logutil.info($"生成6位验证码:{code}");
            bool isaddlines = false;
            if (type == 1)
            {
                isaddlines = true;
            }
            var bitmap = codeutil.getsingleobj().createbitmapbyimgverifycode(code, 100, 40, isaddlines);
            code = encryptutil.encryptdes(code, aprilconfig.securitykey);
            cookieutil.addstring("code", code, 5);
            memorystream stream = new memorystream();
            bitmap.save(stream, imageformat.gif);
            return file(stream.toarray(), "image/gif");
        }

小结

路漫漫,小半天的整理,但是前前后后的基础工程的路淌了好几版,从netframework到net core,想做一套通用的基础工程以减少开发工作量,但是这种确实没有十全十美的,根据业务来设计才是最合适的,但是规范化这点儿不可缺失,就先从util开始,一点点的领出来,组件化的来开发,相信往后会越来越好,如果有哪些地方不合适,也希望能有大佬给出指点,一人摸索过河,也请见谅