.NET分散式Orleans - 2 - Grain的通信原理與定義

来源:https://www.cnblogs.com/chenyishi/p/18091260
-Advertisement-
Play Games

Grain 是 Orleans 框架中的基本單元,代表了應用程式中的一個實體或者一個計算單元。 每個Silo都是一個獨立的進程,Silo負責載入、管理和執行Grain實例,並處理來自客戶端的請求以及與其他Silo之間的通信。 通信原理 在相同的Silo中,Grain與Grain之間的通信通過直接的方 ...


Grain 是 Orleans 框架中的基本單元,代表了應用程式中的一個實體或者一個計算單元。

每個Silo都是一個獨立的進程,Silo負責載入、管理和執行Grain實例,並處理來自客戶端的請求以及與其他Silo之間的通信。

通信原理

在相同的Silo中,Grain與Grain之間的通信通過直接的方法調用實現。每個Silo都維護了一個Grain的運行時環境,當一個Grain需要調用另一個Grain時,它可以直接調用目標Grain的方法,無需經過網路傳輸,示意圖如下所示:

在不同的Silo中,Grain與Grain之間的通信需要通過消息傳遞的方式實現。當一個Grain需要與另一個Silo中的Grain通信時,它會將消息發送給目標Grain所在的Silo,目標Silo接收到消息後,將其路由到目標Grain,然後目標Grain處理消息並返回結果。示意圖如下所示:

外部客戶端與Silo之間的通信是通過網路消息傳輸實現的。客戶端需要使用Orleans提供的客戶端庫與Silo建立連接,併發送請求消息到目標Silo,目標Silo接收到消息後,進行處理並返回結果。在Orleans中,客戶端與Silo之間的通信使用了一種名為Orleans Messaging Protocol (OMP)的自定義協議,用於保證通信的可靠性和效率。示意圖如下所示:

 

內置埠

預設情況下,Orleans 將偵聽埠 11111 用於silo之間通信,在埠 30000 上進行客戶端到接收器通信。可以通過以下方式設置這些埠

siloBuilder.Configure<EndpointOptions>(options =>
{
    // Port to use for silo-to-silo
    options.SiloPort = 11_111;
    // Port to use for the gateway
    options.GatewayPort = 30_000;
    // IP Address to advertise in the cluster
    options.AdvertisedIPAddress = IPAddress.Parse("172.16.0.42");
    // The socket used for client-to-silo will bind to this endpoint
    options.GatewayListeningEndpoint = new IPEndPoint(IPAddress.Any, 40_000);
    // The socket used by the gateway will bind to this endpoint
    options.SiloListeningEndpoint = new IPEndPoint(IPAddress.Any, 50_000);
})

在內部,silo 將偵聽 0.0.0.0:40000 和 0.0.0.0:50000,但在持久化提供程式中發佈的值將是 172.16.0.42:11111 和 172.16.0.42:30000

 

GrainKey類型

在 Orleans 中,可以使用不同類型的鍵來標識 Grain。下麵是幾種常用的 GrainKey 介面:

  • IGrainWithStringKey: 使用字元串作為鍵的介面。適用於需要以字元串形式標識的場景,比如用戶名稱、訂單號等。
  • IGrainWithGuidKey: 使用 Guid 作為鍵的介面。適用於需要全局唯一標識的場景,比如唯一的實體對象、全局唯一的標識符等。
  • IGrainWithIntegerKey: 使用整數作為鍵的介面。適用於需要連續遞增或遞減的序列標識的場景,比如自增主鍵、序列號等。
  • IGrainWithGuidCompoundKey: 使用複合的 Guid 作為鍵的介面。
  • IGrainWithIntegerCompoundKey: 使用複合的整數作為鍵的介面。
  • IGrainWithGuidCompoundKey: 使用複合的字元串作為鍵的介面。

 

下麵是使用 IGrainWithStringKey 定義的 IPlayerGrain 介面,併為其增加了買裝備的動作,並將買完的裝備保存至記憶體中:

public interface IPlayerGrain : IGrainWithStringKey
{
    Task BuyEquipment(string equipmentName);
    Task<List<string>> GetOwnedEquipments();
}

public class PlayerGrain : Grain, IPlayerGrain
{
    private IPersistentState<List<string>> _ownedEquipments;

    public PlayerGrain([PersistentState("ownedEquipments", "playerGrainStorage")] IPersistentState<List<string>> ownedEquipments)
    {
        _ownedEquipments = ownedEquipments;
    }


    public async override Task OnActivateAsync(CancellationToken cancellationToken)
    {
        await base.OnActivateAsync(cancellationToken);

        // 在激活時從持久化狀態中載入數據
        await _ownedEquipments.ReadStateAsync();
        if (_ownedEquipments.State == null)
        {
            _ownedEquipments.State = new List<string>();
            await _ownedEquipments.WriteStateAsync(); // 將空列表持久化到存儲中
        }
    }

    public async Task BuyEquipment(string equipmentName)
    {
        _ownedEquipments.State.Add(equipmentName);
        await _ownedEquipments.WriteStateAsync(); // 將更新後的裝備列表持久化到存儲中
    }

    public Task<List<string>> GetOwnedEquipments()
    {
        return Task.FromResult(_ownedEquipments.State);
    }
}

 

調用時使用IGrainFactory.GetGrain方法即可

var host = Host.CreateDefaultBuilder()
    .ConfigureServices((context, services) =>
    {
        services.AddOrleans(builder =>
        {
            builder
                .UseLocalhostClustering()
                .Configure<ClusterOptions>(options =>
                {
                    options.ClusterId = "dev";
                    options.ServiceId = "OrleansExample";
                })
                .AddMemoryGrainStorage("playerGrainStorage");
        });
    })
    .ConfigureLogging(l => l.AddConsole())
    .Build();

await host.StartAsync();

var client = host.Services.GetRequiredService<IGrainFactory>();

var palyer = client.GetGrain<IPlayerGrain>(Guid.NewGuid().ToString());
await palyer.BuyEquipment("Sword");
(await palyer.GetOwnedEquipments()).ForEach(Console.WriteLine);

 

IGrainFactory 和 IClusterClient

在 Orleans 中,IGrainFactory 和 IClusterClient 都是用於創建和獲取 Grains 的介面,但它們的作用和使用場景略有不同。

IGrainFactory:

IGrainFactory 是 Orleans 用於集群中創建 Grains 的工廠介面。 它通常用於在 Orleans Silo 或者 Orleans Client 中創建 Grains 實例。

  • 在 Silo 中,您可以通過依賴註入或者直接實例化一個 IGrainFactory 對象來創建 Grains。
  • 在 Silo 外部,比如 Orleans Client 中,您也可以通過依賴註入或者直接實例化一個 IGrainFactory 對象來創建 Grains。
// 通過依賴註入或直接實例化一個 IGrainFactory 對象
IGrainFactory grainFactory = serviceProvider.GetRequiredService<IGrainFactory>();
var grain = grainFactory.GetGrain<IMyGrain>(grainId);

 

IClusterClient:

IClusterClient 是 Orleans 中用於與 Orleans 集群進行通信的客戶端介面。 它通常在 Orleans Client 中使用,用於與 Orleans Silo 進行通信,以調用 Grains 的方法或者獲取 Grains 的引用。

IClusterClient 是 IGrainFactory 的一個超集,除了可以創建 Grains,還可以執行其他集群相關的操作,比如管理 Silo 的生命周期、訂閱集群中的事件等。

// 通過依賴註入或直接實例化一個 IClusterClient 對象
IClusterClient clusterClient = serviceProvider.GetRequiredService<IClusterClient>();
var grain = clusterClient.GetGrain<IMyGrain>(grainId);

 

總的來說,IGrainFactory 主要用於在應用程式內部直接創建 Grains,而 IClusterClient 則更適合用於外部Client與 Orleans 集群進行通信,包括創建 Grains 和執行其他集群操作。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 概述:上述C#示例演示瞭如何在同步方法中調用非同步方法。通過使用`async`和`await`關鍵字,實現了同步方法對非同步方法的調用。建議使用`await`而不是`Result`來避免潛在的死鎖問題。這種模式在處理非同步任務時能夠提高代碼的可讀性和性能。 在C#中,從同步方法調用非同步方法的過程涉及到使用 ...
  • 一:背景 1. 講故事 前些天有一位朋友在公眾號上找到我,說他們的WinForm程式部署在20多台機器上,只有兩台機器上的程式會出現崩潰的情況,自己找了好久也沒分析出來,讓我幫忙看下怎麼回事,就喜歡這些有點調試基礎的,dump也不需要我指導怎麼去抓,接下來我們就上windbg開始分析吧。 二:Win ...
  • 構建類型是動態代碼生成過程中的關鍵一環,通過靈活運用 TypeBuilder 和相關工具,我們可以實現各種複雜類型的動態生成,為程式的靈活性和可擴展性提供有力支持。總的來說,本章節通過演示如何使用 Emit 來動態創建類型,包括定義欄位、方法、屬性和事件等, 幫助讀者理解如何在運行時生成和操作類型信... ...
  • 前言 本文的主題是 Visual Studio 調試 NuGet 包,以及符號包的概念,如何去發佈一個 NuGet 包,讓我們的 NuGet 包支持 SouceLink,這些都是我們開發中比較容易忽視的內容,但是熟悉了以後可以讓我們在調試中得心應手,也是開源項目開發的基礎篇。 demo 源代碼在文末 ...
  • 在Orleans 7中,Grain放置是指確定將Grain對象放置在Orleans集群中的哪些物理節點上的過程。 Grain是Orleans中的基本單位,代表應用程式中的邏輯單元或實體。Grain放置策略是一種機制,用於根據不同的因素,將Grain對象放置在合適的節點上,以實現負載均衡、最小化網路延 ...
  • 在之前的WPF示例中,都會用到一個MVVM框,也是一個比較常的MVVM框架,就是MVVM工具包【CommunityToolkit.Mvvm】,今天專門以一個簡單的小例子,簡述一下MVVM工具包的常見用法,僅供學習分享使用,如有不足之處,還請指正。 ...
  • 概述:通過對數組進行排序,代碼更好地利用了緩存,從而提高了程式的性能。這種現象通常被稱為"緩存友好"(cache-friendly)或"空間局部性"(spatial locality) 今天做一個數組數據計算時,發現一個效率問題,給大家分享一下 一個數組排序和不排序時同樣的邏輯處理速度是不一樣的。排 ...
  • // Stream MS HelpManual: https://learn.microsoft.com/zh-cn/dotnet/api/system.io.stream?view=net-8.0 // FileStream 官方手冊: https://learn.microsoft.com/zh ...
一周排行
    -Advertisement-
    Play Games
  • PasteSpider是什麼? 一款使用.net編寫的開源的Linux容器部署助手,支持一鍵發佈,平滑升級,自動伸縮, Key-Value配置,項目網關,環境隔離,運行報表,差量升級,私有倉庫,集群部署,版本管理等! 30分鐘上手,讓開發也可以很容易的學會在linux上部署你得項目! [從需求角度介 ...
  • SQLSugar是什麼 **1. 輕量級ORM框架,專為.NET CORE開發人員設計,它提供了簡單、高效的方式來處理資料庫操作,使開發人員能夠更輕鬆地與資料庫進行交互 2. 簡化資料庫操作和數據訪問,允許開發人員在C#代碼中直接操作資料庫,而不需要編寫複雜的SQL語句 3. 支持多種資料庫,包括但 ...
  • 在C#中,經常會有一些耗時較長的CPU密集型運算,因為如果直接在UI線程執行這樣的運算就會出現UI不響應的問題。解決這類問題的主要途徑是使用多線程,啟動一個後臺線程,把運算操作放在這個後臺線程中完成。但是原生介面的線程操作有一些難度,如果要更進一步的去完成線程間的通訊就會難上加難。 因此,.NET類 ...
  • 一:背景 1. 講故事 前些天有位朋友在微信上丟了一個崩潰的dump給我,讓我幫忙看下為什麼出現了崩潰,在 Windows 的事件查看器上顯示的是經典的 訪問違例 ,即 c0000005 錯誤碼,不管怎麼說有dump就可以上windbg開幹了。 二:WinDbg 分析 1. 程式為誰崩潰了 在 Wi ...
  • CSharpe中的IO+NPOI+序列化 文件文件夾操作 學習一下常見的文件、文件夾的操作。 什麼是IO流? I:就是input O:就是output,故稱:輸入輸出流 將數據讀入記憶體或者記憶體輸出的過程。 常見的IO流操作,一般說的是[記憶體]與[磁碟]之間的輸入輸出。 作用 持久化數據,保證數據不再 ...
  • C#.NET與JAVA互通之MD5哈希V2024 配套視頻: 要點: 1.計算MD5時,SDK自帶的計算哈希(ComputeHash)方法,輸入輸出參數都是byte數組。就涉及到字元串轉byte數組轉換時,編碼選擇的問題。 2.輸入參數,字元串轉byte數組時,編碼雙方要統一,一般為:UTF-8。 ...
  • CodeWF.EventBus,一款靈活的事件匯流排庫,實現模塊間解耦通信。支持多種.NET項目類型,如WPF、WinForms、ASP.NET Core等。採用簡潔設計,輕鬆實現事件的發佈與訂閱。通過有序的消息處理,確保事件得到妥善處理。簡化您的代碼,提升系統可維護性。 ...
  • 一、基本的.NET框架概念 .NET框架是一個由微軟開發的軟體開發平臺,它提供了一個運行時環境(CLR - Common Language Runtime)和一套豐富的類庫(FCL - Framework Class Library)。CLR負責管理代碼的執行,而FCL則提供了大量預先編寫好的代碼, ...
  • 本章將和大家分享在ASP.NET Core中如何使用高級客戶端NEST來操作我們的Elasticsearch。 NEST是一個高級別的Elasticsearch .NET客戶端,它仍然非常接近原始Elasticsearch API的映射。所有的請求和響應都是通過類型來暴露的,這使得它非常適合快速上手 ...
  • 參考delphi的代碼更改為C# Delphi 檢測密碼強度 規則(仿 google) 仿 google 評分規則 一、密碼長度: 5 分: 小於等於 4 個字元 10 分: 5 到 7 字元 25 分: 大於等於 8 個字元 二、字母: 0 分: 沒有字母 10 分: 全都是小(大)寫字母 20 ...