龙空技术网

C# + Blazor Web入门实战:私人笔记(9)打通督脉

自由践行 929

前言:

今天小伙伴们对“netwebapifromuri”大致比较注重,我们都需要知道一些“netwebapifromuri”的相关内容。那么小编同时在网摘上搜集了一些对于“netwebapifromuri””的相关内容,希望兄弟们能喜欢,大家快快来学习一下吧!

上一节我们实现了分类菜单的界面,本节我们通过webapi接口来传递并写入数据。

定义Web接口

我们先来回顾下之前的webapi接口:

    public class api : ControllerBase    {        [HttpGet]        public string Get()        {            List<Model.Category> categories = BAL.Category.query_all();            return Newtonsoft.Json.JsonConvert.SerializeObject(categories);        }    }

事实上这无法称之为接口,因为你无论调用它什么,它返回的都是所有分类数据。

我们期望的web接口应该是可以带参数的,比如:

api?biztype=[biztype]function=[fuction]&p1=x&p2=y&....
biztype代表不同的业务类型,比如分类树、内容、系统设置、权限验证等function代表不同的功能,比如增删改查等后面的p1、p2等根据不同功能需要自行扩展当然为了方便起见,这个接口同时支持Get/Post两种方式。

想要实现上述功能,编码上首先要实现的就是:

根据当前请求的相应参数;如果是Post方式,还应获得Post的数据;

这里有同学可能不太清楚Get方式和Post方式的区别,详细内容在RFC相关的http协议中都有说明,有想一探究竟的可以去参考。我这里只说最关键的因素:二者最大的区别就是传递数据的长度限制。get只能通过地址的方式向服务器传递参数,由于地址长度有限,所以传递的数据也就有限。具体限度是多少?不同浏览器与不同服务器定义的都不一样,一般是不建议超过1024个字符。而Post则没有这个限制,因为它提交的Body实体是基于数据流的形式传输,发多少都可以。通常我们上传文件用的就是Post。既然如此,那就都用Post呗,干嘛还用Get?也不是不可以,据说有公司就是这么要求的。不过Get的方式相对简单,有的时候为了调试方便,直接在浏览器打参数就可以,而Post则需要特定的工具来模拟才行。所以我一般的原则是看数据流向,上行用Post,下行用Get。

好了,接口定义我们大概清楚了,接下来就是编码。

固定请求参数

前面的biztype和function是固定参数,固定参数我们通过指定函数名称就可以,webapi的路由会自动把固定参数以函数名方式传递给我们,如下图:

        public string _(string biztype, string function)        {            string ret = "";            switch (biztype)            {                case "category":                    ret = category(function);                    break;            }            return ret;        }

所以,我们可以通过swtich...case来对api请求进行分流,比如分类方面的调用category函数去处理。

非固定请求参数及Post数据获取

后面的p1、p2是可变参数,对不同的funciton,可能传入的参数会不同,需要做特别的处理。

Post数据的获取同样也需要做特别的处理。

这里我写了个Tools静态类,提供了三个函数,直接调用就可以。

    static public class Tools    {        static public int getQueryInt(this HttpRequest request, string key, int dv = -1)        {            int id = dv;            string rid = request.HttpContext.Request.Query[key];            int.TryParse(rid, out id);            if (id <= 0) return dv;            return id;        }        static public string getQuery(this HttpRequest request, string key, string dv = "")        {            string ret = request.HttpContext.Request.Query[key];            if (string.IsNullOrEmpty(ret))            {                ret = dv;            }            return ret;        }        static public string getPostData(this HttpRequest request)        {            string content = "";            System.IO.StreamReader reader = null;            try            {                reader = new System.IO.StreamReader(request.Body, System.Text.Encoding.UTF8);                Task<string> task = reader.ReadToEndAsync();                content = task.Result;            }            catch (Exception ex)            {            }            finally            {                if (reader != null) reader.Dispose();            }            return content;        }    }
category业务函数处理
        string category(string function)        {            string ret = "";            switch (function)            {                case "get_all":                    {                        List<Model.Category> categories = BAL.Category.query_all();                        ret = Newtonsoft.Json.JsonConvert.SerializeObject(categories);                    }                    break;                case "insert":                    {                        string content = Request.getPostData();                        Model.Category category = Newtonsoft.Json.JsonConvert.DeserializeObject<Model.Category>(content);                        if (category != null)                        {                            if (BAL.Category.Insert(category) != null)                            {                                ret = "ok";                            }                        }                    }                    break;                case "modify":                    {                        string content = Request.getPostData();                        Model.Category category = Newtonsoft.Json.JsonConvert.DeserializeObject<Model.Category>(content);                        if (category != null)                        {                            if (BAL.Category.Modify(category))                            {                                ret = "ok";                            }                        }                    }                    break;                case "delete":                    {                        int id = Request.getQueryInt("id");                        if (id > 0)                        {                            if (BAL.Category.Delete(id))                            {                                ret = "ok";                            }                        }                    }                    break;            }            return ret;        }

分别对Category表进行增删改查的处理。以上代码逻辑都比较简单,跟Diary.Win类似,就不多讲了,大家直接看代码应该就都懂了。

这样webapi中关于Category的接口就基本做完了。接下来我们回到前端的WASM项目,来实现对接口的调用。

增删改查事件

    void CreateNode(MouseEventArgs args)    {        menuStyle = "display:none;";        curCategory = new Model.Category();        curCategory.Id = -1;        curCategory.ParentId = menuTree.SelectedNode.DataItem.Entity.Id;        categoryEditor.toggle();    }    void ModifyNode(MouseEventArgs args)    {        menuStyle = "display:none;";        curCategory = menuTree.SelectedNode.DataItem.Entity;        categoryEditor.toggle();    }    async void DeleteNode(MouseEventArgs args)    {        menuStyle = "display:none;";        string pms = string.Format("id={0}", menuTree.SelectedNode.DataItem.Entity.Id);        string url = Tools.get_api_url("category", "delete", pms);        string category_data = await Http.GetStringAsync(url);        UpdateMenuTree();    }    void SaveCategory()    {        string function = curCategory.Id > 0 ? "update" : "insert";        string post_url = Tools.get_api_url("category", function);        string post_data = Newtonsoft.Json.JsonConvert.SerializeObject(curCategory);        var httpRequestMessage = new HttpRequestMessage        {            Method = HttpMethod.Post, RequestUri = new Uri(post_url), Content = new StringContent(post_data, System.Text.Encoding.UTF8, "application/json")        };        var httpReponseMessage = Http.SendAsync(httpRequestMessage);        UpdateMenuTree();    }

这个阶段的代码比较琐碎,不同操作就要对应不同的处理。所谓的前端就是要大量处理这样的事情,我这还没做界面的美化,就已经觉得相当烦躁了。我一直有个偏见,就是编程最大乐趣在于对事物的抽象,然后不断总结,继续抽象,逐渐复用代码,体会那种搭积木的感觉。而我在做前端的时候完全get不到这种乐趣,技术上没有什么难点,无非就是根据不同的用户行为做不同的处理,翻来覆去的判断、验证、调整,往往时间都花在了这好不好看,那个字体再调大些,图片需要都换成浅色系的等等我认为并不重要的事情。花费大量的时间,技术得不到提高、代码很难复用、轮子变换太快...... 总之,我不喜欢做前端,所以我的原则是过得去就行了。如果是自己用那就更不挑了,满足功能就OK了。

本次修改还稍微做了小优化:ContextMenuPanel组件增加了在空白处点鼠标左键把弹出菜单隐藏,CategoryEdit组件的Id输入框设置为只读属性,增加Tools工具类来生成webapi的url等。

最终效果如下:

本节基本完成了数据由浏览器向数据库写入的过程,到此数据流向的任督二脉已经完全打通了。再往后的数据就都是基于此进行扩充了。

至于界面优化,比如操作提示、显示效果、易用性等等,这些导致了整体界面并不好看,实在不愿意弄了,有兴趣的同学可以自己调一下,我就不再深入了。

到了这里,我们的Web项目最难的部分已经完成了,整体进展也基本过半,你坚持下来了吗?跟上的同学冒个泡,给其他人一些信心。接下来,我们将完成这个项目的核心内容,文章内容编辑,下节继续。

---------------------------------------

本教程项目源码已作为开源项目加入到Gitee,代码内容会随教程实时更新,大家有兴趣的话可以关注我,以获得最及时的更新。私信:

私人日记 可以获取相关链接;

大家阅读过程中有哪些看不懂或未尽兴的地方,可以在评论区留言,我会先记下来在后续的教程中找机会再说。

教程有帮助的话请大家帮忙关注、转发、扩散,能不能开专栏还需要你们的支持!

标签: #netwebapifromuri