.NET WebApi 实战第三讲之接口返回Json格式数据

        我们继续我们的这一课时,回顾一下,上一节, 我们做了最重要的事情,就是打通了数据库的读及连接,为我们下面乃至后面的实战打下了坚实的基础,以后的工作和思路不外乎多表联查、服务器性能提升而已!再没有比第二节更多的东西了。

        我们来继续我们的内容,将接口的返回数据进行规范统一。做过前端的都知道,接口返回必须有业务逻辑状态,根据不同的状态跳转不同的页面、做不同的逻辑动作。所以,此时这个业务逻辑状态犹为重要。注意这个是业务逻辑状态,并不是HTTP的连接等状态,HTTP的状态,我们根本不用关心,服务端也不必返回HTTP的状态,客户端到服务端负责通讯的类本身就有这个状态,服务端再勉强返回,就太不专业了。

任何接口都应该返回int status、object data、string msg这三个共同的属性。前端根据状态值做不同的业务逻辑,msg用于在一些情况直接展示接口返回的文本进行提示而不必在前端写死。所以,我们有必要定义一个类,所有接口的返回都必须是这个类。

在项目的Models文件夹上右键,添加->类,命名为ApiModel

我们为此类添加以下字段属性,你也看到了,我开始给代码添加简单又有必要的注释了,这是个很好的习惯,以后写代码,都需要添加注释,有利于你进行业务处理和代码的理解。 

接口返回JSON数据,其实本身就有相应的类,我们改造一下,看看结果:

运行起来看看此时的接口返回数据:

https://localhost:44378/api/User/

可以看到,返回的是已经是一个标准的JSON序列化数据了。如果你够仔细,你应该可以看到数据里多了一些空格!这个后面我们会讲解原因。你先关注格式即可。

现在我们来改造接口,让它返回我们指定格式的数据。参考以下图,全局设置返回格式,我们只需要清除掉默认的XML格式就可以了。

GlobalConfiguration.Configuration.Formatters.XmlFormatter.SupportedMediaTypes.Clear();

保存运行,我们再来看看接口的返回:可以看到,格式已经改过来了。

我们现在来看看,数据的问题。我们期望的接口返回的数据应该是如下格式:

{"status":1,"data":[{"id":"1265984563","name":"Bill","sex":"f ","mobile":null,"nickName":null,"address":null,"headerIcon":null,"birthDay":null,"password":null}],"msg":"查询成功"}

特点:"data":[],而不是"data":"[]",如果你给带个双引号,也没有问题,但是这就导致在前端解析的时候,尤其是APP解析的时候,解析器得工作两次,将data这个字符串取出来再解析一次,才能得到前端期待的数据!这当然是不可以的,也是不允许的!性能为王的今天,怎么可以重复的去做同一个事情呢?但是,我们的接口返回却。。。

第一、上面数据的data节点应该是个对象的,但是却是个字符串?

第二、部分字段出现多余的空格,这又是什么情况?

好,我们来一一处理解决。

为什么会是个字符串,这是因为我们多余的为对象进行序列化导致的!我们只需要将以下所示之处稍作修改即可:

再次运行起来,我们看看效果,是不是已经为"data":[] 正常了?!!!!

第二个问题,出现多余的空格,这简直流氓的不要不要的!产生的原因就是我们数据库表设计的时候,列的属性为nchar类型,这类型的特点与varchar等相比较,同学们自行搜索学习一下就行了,这里不深入去探讨。既然是表的问题,那我们改一下就行了。打开数据库SSMS客户端:重新设计以下表,将列的属性修改为:varchar,保存文件。

保存时,它会提醒你:

点击是即可。什么时候使用nchar,什么时候使用varchar,后面我们再深入学习讨论,此处暂时忽略,你如果自己感兴趣,可以自行搜索学习。

修改完成后,你先别急着去吃灰去运行项目,数据库修改了,我们的EF数据模型还没有更新!你现在运行结果不变,还是一堆空白!!!

选择DataProvider项目,双击Model.edmx文件:

在空白处右键,选择"从数据库更新模型",再次对数据模型更新一下。

因为我们没再增加新表,所以,表区域没有新的的表,直接点击完成即可。

数据问题是因为在第二讲里面插入的时候,就已经因为类型出问题了,所以, 我们把表中的数据更新一下。

再来运行项目,我们看看接口的返回!可以看到,我们面临的问题都已经解决!

{"status":1,"data":[{"id":"1265984563","name":"bills","sex":"f","mobile":null,"nickName":null,"address":null,"headerIcon":null,"birthDay":null,"password":null}],"msg":"查询成功"}

本节教程就到此为止,下一节,我们来继续数据库方面的写操作,会读会写了,基本上教程的内容就涉及的差不多了!。

.NET WebApi 实战第四讲:EF进行数据库的写操作

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 230,578评论 6 544
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 99,701评论 3 429
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 178,691评论 0 383
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 63,974评论 1 318
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 72,694评论 6 413
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 56,026评论 1 329
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 44,015评论 3 450
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 43,193评论 0 290
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 49,719评论 1 336
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 41,442评论 3 360
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 43,668评论 1 374
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 39,151评论 5 365
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 44,846评论 3 351
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 35,255评论 0 28
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 36,592评论 1 295
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 52,394评论 3 400
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 48,635评论 2 380

推荐阅读更多精彩内容