开发者社区> 科技小毛> 正文
阿里云
为了无法计算的价值
打开APP
阿里云APP内打开

WebAPi的可视化输出模式(RabbitMQ、消息补偿相关)——所有webapi似乎都缺失的一个功能

简介:
+关注继续查看

最近的工作我在做一个有关于消息发送和接受封装工作。大概流程是这样的,消息中间件是采用rabbitmq,为了保证消息的绝对无丢失,我们需要在发送和接受前对消息进行DB落地。在发送前我会先进行DB的插入,单表插入,所以在性能上也是能接受的,单表插入做了压测基本上是一到两毫秒的时间,加上消息的发送(有ACK)再加上集群是两个节点的高可用(一个磁盘持久化节点),单台TPS基本上是在2000-3000左右。这对于我们的业务场景来说是够用了。一旦当消息丢失或者由于网络问题、集群问题业务不会中断,消息就算发不出去也没关系,我们会进行消息的补偿或者同步api调用补偿。这是架构设计的必须要考虑的A计划、B计划、C计划,这是敬畏或者危机意识。

你可能又要说两个节点或者三个节点的集群怎么会有问题,那你就错了,大错特错。只能说明你并不了解什么叫分布式系统及分布式系统的特性。你也许不会知道网络抖动、网络闪断导致socket断开如何进行心跳重试已保持有效的Rabbitmq Connection。当你的网络极不稳定,你的linux keepalived VIP 来回漂移,导致你的ARP根本无法成效,可能就连广播都传不出去,而客户端则在一直使用一个无用的IP地址。当你的集群节点之间无法连接成一个整体的时候各种奇葩的问题又来了。这些都是可能导致你的集群出问题的原因,所以不要大意。

(后面我会整理一篇专门讲解“rabbitmq高可用、故障转移集群架构“文章,所以这里我们就不继续介绍了)

这是一个铺垫,本文的重点是介绍下我在尝试使用可视化webapi的输出模式,这比原本json的输出模式看起来会方便许多。如果你的api提供两种输出模式,人性化绝对很好。现在很多后端api都是没有界面的都是只提供了一个json输出。然而,我们其实很需要一个可读性很强的输出模式。

我在开发消息补偿程序的时候,我借鉴了这一思想进行了尝试。先来看下整体架构蓝图:

1

本篇文章要介绍的是有关于这个补偿程序的api的可视化输出内容。不涉及到消息相关太多的东西,只是为了让这个可视化输出看起来容易理解点。这个补偿程序需要对发送的消息和接受的消息进行查询和比较然后输出,用来确定消息的发送是失败了还是成功的。简单逻辑就是比较某个时间段内的消息发送表和接受表,然后进行消息id的匹配。

我在想这个数据反馈到api上是个什么样子的,按照常规设计就是两个字段:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
/// <summary>
/// 接受的消息对象。
/// </summary>
public class ReceiveMessage
{
    /// <summary>
    /// 发送消息ID。
    /// </summary>
    public string SendMessageId { getset; }
 
    /// <summary>
    /// 接受消息ID。
    /// </summary>
    public string ReceiveMessageId { getset; }
}

这表示一个消息从发送到接受的一个过程。如果失败了,可能是只有SendMessageId而没有ReceiveMessageId。然后我才会针对没有ReceiveMessageId的消息进行自动补偿。在开发的时候只有几十条消息,输出到postman中的看起来也还行,但是不直观。

2

GetReceiveMessage是获取接受消息列表,就是查看当前消息发送到接受是个什么状态。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
/// <summary>
/// 处理成功消息对象。
/// </summary>
public class SuccessMessage
{
    /// <summary>
    /// 发送消息ID
    /// </summary>
    public string SendMessageId { getset; }
 
    /// <summary>
    /// 接受消息ID
    /// </summary>
    public string ReceiveMessageId { getset; }
 
    /// <summary>
    /// 处理成功消息ID
    /// </summary>
    public string SuccessMessageId { getset; }
}

SuccessMessage表示处理成功消息情况。此时有可能是有SendMessageId,ReceiveMessageId消息,但是SuccessMessageId可能是没有的。就会针对处理成功的消息进行发送。

3

突然受到ElasticSearch的_cat endpoint 启发。似乎这里我可以尝试下,webapi带有两种输出模式,一种是针对程序使用的json输出模式,另外一种是针对人可以阅读的模式text/plain模式,而第二种模式可以简单的理解为是行列转换缺省模式。

4

是不是看起来会很舒服。这在进行消息的时间段查看非常有帮助,如果还按照原本的json输出模式可能看起来会比较吃力。

来看下基本的api的设计,为了保证你的所有api支持?v可视化模式,需要一定的抽象:

5

需要定义一种ViewModel,所有的数据都输出这种对象,当然我这里也只是简单地封装。如果可以,其实可以专门提取出一个库出来,包括对文本的输出自动化。

我们看下BaseApiController:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
public class BaseApiController : ApiController
   {
       public class ViewModel
       {
           public string Content { getset; }
           public object JsonObject { getset; }
           public bool Success = true;
       }
 
       protected bool IsView;
       private const string ViewQuerystring = "?v";
       public ViewModel ResultModel;
       private const string CheckToken = "CheckToken";
       private const string Token = "49BBD022-CDBF-4F94-80E4-5BCACB1192EC";
       private bool _checkStatus;
 
       public override Task<HttpResponseMessage> ExecuteAsync(HttpControllerContext controllerContext, CancellationToken cancellationToken)
       {
           //验证token
           if (controllerContext.Request.Headers != null && controllerContext.Request.Headers.Contains(CheckToken))
           {
               var requestToken = controllerContext.Request.Headers.GetValues(CheckToken).FirstOrDefault();
               if (requestToken != null && requestToken.Equals(Token))
               {
                   this._checkStatus = true;
               }
           }
 
           if (!_checkStatus)
           {
               var checkResult = new Task<HttpResponseMessage>(() => new HttpResponseMessage
               {
                   Content = new StringContent("非法访问,缺少token", Encoding.UTF8, "text/plain")
               }, cancellationToken);
 
               checkResult.Start();
               return checkResult;
           }
 
           if (controllerContext.Request.RequestUri.Query.Equals(ViewQuerystring))
               this.IsView = true;
 
           base.ExecuteAsync(controllerContext, cancellationToken);
 
           //text模式
           if (this.IsView)
           {
               var textResult = new Task<HttpResponseMessage>(() => new HttpResponseMessage
               {
                   Content = new StringContent(this.ResultModel.Content, Encoding.UTF8, "text/plain")
               }, cancellationToken);
 
               textResult.Start();
               return textResult;
           }
 
           //json模式
           var resultData = new Result<object>
           {
               Data = this.ResultModel.JsonObject,
               Type = this.ResultModel.Success ? ResultType.Successfully : ResultType.Failure
           };
 
           var jsonResult = new Task<HttpResponseMessage>(() => new HttpResponseMessage
           {
               Content = new ObjectContent(typeof(Result), resultData, new JsonMediaTypeFormatter(), "application/json")
           }, cancellationToken);
 
           jsonResult.Start();
 
           return jsonResult;
       }
   }

  

代码很简单,这里给我们一个启发,webapi是不是真的缺少了一个可视化模式。

 

 

出处:http://www.cnblogs.com/wangiqngpei557/

分类: 软件设计
 
 
本文转自左正博客园博客,原文链接:http://www.cnblogs.com/soundcode/p/7156727.html,如需转载请自行联系原作者
 

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
BTC API | NFT API | web3 API 联盟活动进行中
拓展开发者社区,共建开发者生态
30 0
最后3天,优惠低至3折起:云真机、WEB前端监控、APP监控、自动化测试
UC研发效能 岩鼠云真机面向企业免费开放活动即将于5.1号结束。 为继续支持企业全面复工,我们将于2020.4.29号~2020.5.31号推出第二波福利【暖春行动】。 云真机、WEB前端监控、自动化测试、APP监控等多种服务推出暖春礼包,重磅好礼低至3折起!
665 0
AMQP-RabbitMQ/5/主题模式
5. 主题模式 Topics 根据主题接收消息 routing_key - 它必须是由英文点.分隔的单词列表 *可以替代一个单词。 #可以替换零个或多个单词。 图示 个人理解 与路由模式基本相同,不同的点只是路由模式需要Queue订阅的路由键与消息的路由键完全匹配,Exchange才会将消息发送给Queue。
839 0
阿里云弹性AI服务 -- 基于Docker和EGS一键创建高性能Tensorflow分布式训练
Tensorflow是目前使用最为广泛的深度学习框架之一,但是目前搭建分布式多机多卡训练比较困难,而且Tensorflow原生的分布式的性能很差。为了解决这个问题,我们创建了一个容器镜像:registry.
4290 0
消息中间件(Kafka/RabbitMQ)收录集
本篇主要整理工作中遇到的一些消息中间件的相关知识,包括Kafka, RabbitMQ, RocketMQ, ActiveMQ等,不排除收录其他消息中间件的可能。 这里会持续收录相关知识,包括安装、部署、使用示例、监控、运维、原理等。
1940 0
web标准化设计:常用的CSS命名规则手册
(一)常用的CSS命名规则   头:header   内容:content/container   尾:footer   导航:nav   侧栏:sidebar   栏目:column   页面外围控制整体布局宽度:wrapper   左右中:left right center   ...
806 0
+关注
580
文章
0
问答
文章排行榜
最热
最新
相关电子书
更多
低代码开发师(初级)实战教程
立即下载
阿里巴巴DevOps 最佳实践手册
立即下载
冬季实战营第三期:MySQL数据库进阶实战
立即下载