您的位置：首页 > 其它

MicroService.Core简易微服务框架《一、简介》

2017-11-05 08:35 495 查看

MicroService.Core


MicroService.Core
的初衷是为了方便的创建一个微服务， 可作为 Windows Service 或者控制台模式启动。 它底层使用了 OWin 自托管技术，抛弃了微软 Mvc 的那套东 西，进而选择了 Nancy，使得开发过程很顺心，很简单！


快速入门

一、创建控制台项目（需要.net 4.5以上）

二、安装Nuget包

PM> Install-Package MicroService.Core -Version 1.1.1

或在 Nuget 包管理器中搜索 
MicroService.Core
安装。

三、编写 Program.cs，输入以下代码

添加引用：
using MicroService.Core;
Main 方法中写如下代码：

var service = new MicroServiceBase("MyService");
service.Run(args);



这时 Program.cs 文件内容如下

using MicroService.Core;
namespace MicroService.Samples
{
class Program
{
static void Main(string[] args)
{
var service = new MicroServiceBase("MyService");
service.Run(args);
}
}
}



生成项目，然后在生成的 EXE 文件目录下打开一个命令行窗口，执行：


如生成的 EXE 文件为 
MicroService.Samples.exe



1、命令行模式运行：
MicroService.Samples.exe --console

即可看到如下的运行效果：





2、Windows 服务模式
MicroService.Samples.exe --install

运行结果如果出现下面这个情况：





是因为权限不够，无法安装windows服务，以管理员权限运行命令行窗口再次执行以上命令， 截图如下：





查看 
Windows 服务
 列表，可以看到此服务已经正常运行：





四、如何测试此服务是否已经正常运行？
此微服务框架默认提供了服务状态地址 
/health
，如图，默认绑定地址是 
http://127.0.0.1:8080
，从浏览器访问地址http://127.0.0.1:8080/health 可以得到如下的输出：





可以看出服务的一些情况，运行时常，暴露端点等等...

五、是否被惊到？
仅仅3行代码，抛去 using 引用，就只有2行代码，就可以做一个可以运行在命令行 /windows 服务的对外提供 
API
 能力的程序。

原理
通过集成 Owin 使得她有了自托管的能力

通过实现了一个内部的 ServiceBase 类使得她有了能作为 windows 服务运行的能力

通过集成 Nancy （http://nancyfx.org/） 使得她有了很容易开放 Api 服务的能力


有人可能会说，这有个鸟用？先别急，我们来扩展一下，做个什么呢？ 就先来个加法器吧，输入两个数字，返回两个数字之和。


进阶
一、写一个 Nancy 模块：

关于 Nancy 模块的编写，请自行前往链接 http://nancyfx.org/ 学习，作为技术人员，学习是必不可少的技能。当然，你看到这里，先不用着急去学习 Nancy， 继续往下看，很简单的！


1、新增一个类
在项目中新建一个名为 
AddModule
 的 Nancy 模块，代码如下：

using Nancy;
using System.Threading.Tasks;
namespace MicroService.Samples
{
public class AddModule : NancyModule
{
public AddModule()
{
Get["/add", true] = async (_, ctx) =>
{
return await Task.Run(() =>
{
int? num1 = Request.Query.num1;
int? num2 = Request.Query.num2;
if (num1.HasValue && num2.HasValue)
{
return $"{num1} + {num2} = {num1 + num2}";
}
return "Paramters num1 and num2 missing!";
});
};
}
}
}


这段代码可能对没有 Nancy 模块经验的人，稍微有点难度，但是代码通俗易懂，一看就会！


停掉上面运行的 Windows 服务，然后重新生成项目，启动服务。


访问浏览器：http://127.0.0.1:8080/add?num1=1&num2=2





如果不出意外，你的运行结果应该和我无异！


到这里可能你有点想法了，那我不能用 VS 调试吗？ 答案是：可以！


在 VS 项目上右键，进入项目属性页面，在调试选项卡下的启动参数里输入 --console，然后启动项目 如图：





现在重新看看控制台的运行效果：





看红色箭头处，新增了两行，加载刚刚新建的模块成功！


连暴露的URL都列出来了，是否很贴心？


到这里我感觉还是没有体现出他的优势，我们再将这个项目处理处理！

2、再单独新建一个类 RedisService.cs
代码如下：

using System;
namespace MicroService.Samples
{
public class RedisService
{
public string RedisServiceStatus
{
get
{
var rnd = new Random().Next(1, 10);
if (rnd % 3 == 0)
{
return "DOWN";
}
return "UP";
}
}
}
}


代码很简单，只有一个只读属性，获取了 Redis 服务的状态（模拟）。 下面，我们把他加入到上面的 
/health
 端点中，让我们的服务更加直观的展示出整体服务的状态。

修改 Program.cs 类中的代码：

using MicroService.Core;
using Nancy.TinyIoc;
namespace MicroService.Samples
{
class Program
{
static void Main(string[] args)
{
var service = new MicroServiceBase("MyService");
service.OnServiceStarting += Service_OnServiceStarting;
service.OnServiceStatusUpdating += Service_OnServiceStatusUpdating;
service.Run(args);
}
/// <summary>
/// 服务启动之前执行事件
/// </summary>
/// <param name="service"></param>
/// <param name="container"></param>
private static void Service_OnServiceStarting(
MicroServiceBase service,
TinyIoCContainer container)
{
var redisService = new RedisService();
container.Register(redisService);
}
/// <summary>
/// 服务状态更新事件
/// </summary>
/// <param name="service"></param>
/// <param name="serviceStatus"></param>
private static void Service_OnServiceStatusUpdating(
MicroServiceBase service,
ServiceStatus serviceStatus)
{
var redisService = service.GetComponent<RedisService>();
if (redisService != null)
{
serviceStatus.AddOrUpdate("RedisStatus", redisService.RedisServiceStatus);
}
}
}
}



有人可能要骂我了，你 TM 逗我啊，这么多代码这叫简单？其实仔细看看不难！


加了两个事件，服务启动之前执行事件和服务状态更新事件，在服务启动之前执行事件代码中， 使用 Nancy 内置的 TinyIoCContainer IoC容器注册了一个 RedisService 的实例。 在服务状态更新事件中，通过 
service.GetComponent<RedisService>()
 获取到了这个 RedisService 实例，在 serviceStatus 添加进去。

现在，再次运行，看看结果：





这样就完成了一个小型的微服务啦，当然这条路还很长，这只是一个核心框架。 有兴趣的童鞋，可以深入研究一下，欢迎探讨！


QQ: 491217650 邮件：admin@mrhuo.com



现在时间 2017-11-05 03:52:10，夜深了，该睡了！晚点再写其他的教程！


Github 开源地址：https://github.com/mrhuo/MicroService.Core
                                            

                                        

                        
                        内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 点击这里给我发消息 
                    

                    

                    

                        

                         标签： 
                                                

                        

                    


                

            


            

                
相关文章推荐

                

                
            

        

        

            

            
            

                

                    
新的分享

                    

                        
                    

                

            


            

                

                    
章节导航