Galosys.Foundation.Orleans 26.5.20.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 标识符