JMS微服務開發示例（一）Hello world

網關部署

1、在網關服務器上，安裝.net 5.0運行環境；

2、到 https://www.cnblogs.com/IWings/p/13354541.html 下載Gateway.zip，解壓到網關服務器

3、打開appsettings.json配置文件，修改里面的配置，我的配置如下所示：

{
  "Port": 7900,
  "UnLockKeyTimeout": 10000, //當微服務掉線后，lockkey有效期（單位：毫秒）
  "DataFolder": "./data", //數據存放目錄
  "AllowIps": [], //允許哪些ip成為微服務，為空表示允許所有ip

  //"SSL": { //SSL為可選項
   // "Cert": "../../../../pfx/gateway_server.pfx",
   // "Password": "123456",
  //  //配置client.pfx的哈希值，僅接受client.pfx證書請求
  //  "AcceptCertHash": [ "ACE9C81C11688415DBFA1B39702450A8590BDB0B" ] //被接受的對方證書的hash值，空數組表示信任所有證書
 // },

  //"Cluster": { //配置集群里的裁判地址，不做集群此項可移除
  //  "Referee": {
  //    "Address": "127.0.0.1",
  //    "Port": 8919
  //  }
  //},

  //"ShareFolder": "./shares",//共享文件目錄

  "ServiceProviderAllocator": {
    "FullName": "JMS.ServiceProviderAllocator",
    "Assembly": "JMS.Gateway"
  },
  "Logging": {
    "LogLevel": {
      "Default": "Debug",
      "System": "Information",
      "Microsoft": "Information"
    }
  }
}

然后運行命令 dotnet JMS.Gateway.dll ，啟動網關程序。（建議用xshell啟動，因為控制台能輸出中文）

看到以下信息，表示啟動成功

  

 創建微服務項目

（題外話）這里有一個封裝性更高的項目模板，可以直接創建一個JMS微服務。

打開vs，新建一個.net core 3.1控制台項目，名稱為：MyHelloworldService

引用下面的 nuget 包：

Microsoft.Extensions.Logging.Console

Microsoft.Extensions.Configuration.Json

JMS.ServiceProvider

然后Program.cs代碼如下： 

using JMS;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
using System;

namespace MyHelloworldService
{
    class Program
    {
        static void Main(string[] args)
        {
            var port = 7902; //提供微服務的端口

            var gateways = new NetAddress[] {
                new NetAddress("192.168.40.131" , 7900) //網關地址
            };

            ServiceCollection services = new ServiceCollection();
            services.AddLogging(loggingBuilder =>
            {
                loggingBuilder.SetMinimumLevel(LogLevel.Debug);
                loggingBuilder.AddConsole(); 
            });

            var msp = new MicroServiceHost(services);
            //自定義微服務地址，默認使用服務器外網地址
            //msp.ServiceAddress = new NetAddress(serviceAddress, port);
            msp.Build(port, gateways)
                .Run();
        }
    }
}

 

運行控制台，如果成功連接網關，會如下顯示：

 

 編寫提供的服務

在項目中，新建一個類，名稱為：HelloworldController，繼承 JMS.MicroServiceControllerBase

namespace MyHelloworldService
{
    class HelloworldController : MicroServiceControllerBase
    {
        public string Hello()
        {
            return $"你好，現在時間是： {DateTime.Now.ToShortDateString()}";
        }
    }
}

然后回到Program.cs代碼中，在 new MicroServiceHost(services) 的后面加入服務注冊語句

            var msp = new MicroServiceHost(services);
            msp.Register<HelloworldController>("Hello world");//服務名稱為Hello world
            msp.Build(port, gateways)
                .Run();

到這里，一個最簡單的微服務就寫完了。

編寫調用端

下面，我們再創建一個控制台項目，用來調用微服務，項目名稱為：TestApplication

引用下面的 nuget 包：

Microsoft.Extensions.Logging.Console

JMS.Invoker

Program.cs代碼如下：

using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
using System;
using System.Threading;

namespace TestApplication
{
    class Program
    {
        static IServiceProvider ServiceProvider;
        static JMSClient CreateMST()
        {
            var logger = ServiceProvider.GetService<ILogger<JMSClient>>();
            return new JMSClient("192.168.40.131", 7900, null, logger);
        }
        static void Main(string[] args)
        {
            Thread.Sleep(3000);//等服務啟動完畢

            ServiceCollection services = new ServiceCollection();
            services.AddLogging(loggingBuilder =>
            {
                loggingBuilder.SetMinimumLevel(LogLevel.Debug);
                loggingBuilder.AddConsole();
            });
            ServiceProvider = services.BuildServiceProvider();

            using ( var client = CreateMST() )
            {
                //找網關分配一個Hello world微服務實例 var api = client.GetMicroService("Hello world");
                //調用服務的Hello函數 var ret = api.Invoke<string>("Hello");
                Console.WriteLine(ret);
            }

        }
    }
}

鼠標右鍵解決方案-》設置啟動項目...

 

F5啟動調試，兩個控制台輸出如下：

 

大家回看調用端的代碼，這個地方：

 

 是用字符串的方式，指明了調用微服務的Hello方法，這種方式，調用者如果沒有一個微服務的api列表（類似 swagger ），很難搞清楚服務端提供的方法有哪些，

下面，我們用另一種方式調用。

給服務端加注釋

我把服務端HelloworldController代碼，加上注釋，並追加一個time參數

    class HelloworldController : MicroServiceControllerBase
    {
        /// <summary>
        /// 哈嘍方法
        /// </summary>
        /// <param name="time">我當前的時間</param>
        /// <returns>中文問候語</returns>
        public string Hello(DateTime time)
        {
            return $"你好，你給的時間是： {time.ToShortDateString()}";
        }
    }

並且指定項目編譯時，需要生成xml文檔

 

調用端代碼改為：

            using ( var client = CreateMST() )
            {
                var api = client.GetMicroService("Hello world");
                var code = api.GetServiceClassCode("TestApplication" , "HelloWorldApi");
                File.WriteAllText("../../../HelloWorldApi.cs", code, Encoding.UTF8);
            }

 api.GetServiceClassCode生成客戶端代碼（服務端必須是debug模式），把代碼寫到HelloWorldApi.cs文件當中

打開生成的HelloWorldApi.cs文件，效果如下：

 然后，調用端代碼，就可以這么寫了： 

            using ( var client = CreateMST() )
            {
                var api = client.GetMicroService<HelloWorldApi>();
                var ret = api.Hello(DateTime.Now);
                Console.WriteLine(ret);
            }

 服務器的方法該怎么用，是一目了然了

 

上一篇 概述    下一篇 編寫分布式事務