Galosys.Foundation.Orleans 26.10.29.1

Galosys.Foundation.Orleans

成熟度: 🟡 可用 — 功能完整，测试或文档可能不完善

Galosys.Foundation Orleans 分布式 Actor 框架集成模块，提供 Orleans 集群配置、存储提供器、仪表板监控及扩展方法。

功能概览

1. Orleans 配置管理

// 配置选项绑定到 appsettings.json
services.Configure<OrleansOptions>(configuration.GetSection("Orleans"));

2. 集群配置

// OrleansOptions 支持的集群配置
public ClusterOptions? Cluster { get; set; } = new ClusterOptions();

// 配置示例
{
  "Orleans": {
    "Cluster": {
      "ServiceId": "MyService",
      "ClusterId": "production"
    }
  }
}

3. ADO.NET 存储配置

// 配置 ADO.NET 存储
public OrleansAdoNetOptions? AdoNet { get; set; } = new OrleansAdoNetOptions
{
    Invariant = "System.Data.SqlClient"
};

// 配置示例
{
  "Orleans": {
    "AdoNet": {
      "ConnectionString": "Server=localhost;Database=Orleans;Trusted_Connection=true;",
      "Invariant": "System.Data.SqlClient"
    }
  }
}

4. 仪表板监控

// 启用仪表板
public bool DashboardEnabled { get; set; } = false;

// 仪表板配置
public OrleansDashboardOptions Dashboard { get; set; } = new OrleansDashboardOptions
{
    Port = 8081,
    Host = "*",
    HostSelf = true,
    BasePath = "/orleans",
    UserName = "orleans",
    Password = "orleans"
};

// 配置示例
{
  "Orleans": {
    "DashboardEnabled": true,
    "Dashboard": {
      "Port": 8081,
      "Host": "*",
      "BasePath": "/orleans",
      "UserName": "admin",
      "Password": "securePassword"
    }
  }
}

5. 字符串扩展方法

// 检查字符串是否为空或默认值
var isEmpty = "".IsEmptyOrDefault(); // true
var isDefault = "default".IsEmptyOrDefault(); // true
var isCustom = "custom".IsEmptyOrDefault(); // false

// 自定义默认值
var isEmpty = "".IsEmptyOrDefault("N/A"); // true
var isDefault = "N/A".IsEmptyOrDefault("N/A"); // true

安装

<PackageReference Include="Galosys.Foundation.Orleans" Version="x.x.x" />

使用

配置 Orleans 服务

// 在 Program.cs 或 Startup.cs 中
builder.Services.AddOrleans(builder =>
{
    builder.UseAzureClustering(options =>
    {
        options.ConnectionString = "your-connection-string";
    });
    // 或使用 ADO.NET 集群
    builder.UseAdoNetClustering(options =>
    {
        options.Invariant = "System.Data.SqlClient";
        options.ConnectionString = "your-connection-string";
    });
});

配置 Orleans 仪表板

// 启用仪表板
builder.Services.AddOrleans(builder =>
{
    builder.UseDashboard(options =>
    {
        options.Port = 8081;
        options.Host = "*";
        options.BasePath = "/orleans";
    });
});

完整配置示例

{
  "Orleans": {
    "Cluster": {
      "ServiceId": "MyService",
      "ClusterId": "production"
    },
    "AdoNet": {
      "ConnectionString": "Server=localhost;Database=Orleans;Trusted_Connection=true;",
      "Invariant": "System.Data.SqlClient"
    },
    "DashboardEnabled": true,
    "Dashboard": {
      "Port": 8081,
      "Host": "*",
      "HostSelf": true,
      "BasePath": "/orleans",
      "UserName": "admin",
      "Password": "securePassword"
    }
  }
}

核心类

目录结构

Galosys.Foundation.Orleans/
├── Microsoft/
│   └── Extensions/
│       └── Options/
│           └── OrleansOptions.cs    # 配置选项类
└── System/
    └── StringExtensions.cs          # 字符串扩展方法

依赖

• Microsoft.Orleans.Sdk
• Microsoft.Orleans.Transactions
• Galosys.Foundation.Core

注意事项

1. 集群配置：生产环境建议使用 Azure Clustering 或 ADO.NET Clustering
2. 存储配置：确保数据库连接字符串正确配置
3. 仪表板安全：生产环境应更改默认用户名和密码
4. 扩展方法：IsEmptyOrDefault 扩展方法适用于验证 Orleans 标识符