Joseph Doherty
2a6ac07111
- Client.Shared-003: DefaultSessionAdapter.WriteValueAsync / CallMethodAsync guard against null/empty Results and throw ServiceResultException with the response's ServiceResult code instead of indexing into a missing list. - Client.Shared-004: DefaultSessionAdapter.CloseAsync / HistoryReadRawAsync / HistoryReadAggregateAsync use the Session.*Async overloads and honour the caller's CancellationToken. - Client.Shared-009: AcknowledgeAlarmAsync returns the underlying ServiceResultException.StatusCode on failure instead of always Good; IOpcUaClientService doc updated to describe the new contract. - Client.Shared-010: ConnectionSettings.CertificateStorePath defaults to empty; DefaultApplicationConfigurationFactory resolves the canonical PKI path lazily, so per-failover ConnectionSettings copies don't hit the filesystem. - Client.Shared-011: added the alarm-fallback regression test, extracted EndpointSelector as a pure static, and added EndpointSelectorTests covering security-mode match, Basic256Sha256 preference, fallback, diagnostics, hostname rewrite, and null/empty guards. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
68 lines
2.5 KiB
C#
68 lines
2.5 KiB
C#
namespace ZB.MOM.WW.OtOpcUa.Client.Shared.Models;
|
|
|
|
/// <summary>
|
|
/// Settings for establishing an OPC UA client connection.
|
|
/// </summary>
|
|
public sealed class ConnectionSettings
|
|
{
|
|
/// <summary>
|
|
/// The primary OPC UA endpoint URL.
|
|
/// </summary>
|
|
public string EndpointUrl { get; set; } = string.Empty;
|
|
|
|
/// <summary>
|
|
/// Optional failover endpoint URLs for redundancy.
|
|
/// </summary>
|
|
public string[]? FailoverUrls { get; set; }
|
|
|
|
/// <summary>
|
|
/// Optional username for authentication.
|
|
/// </summary>
|
|
public string? Username { get; set; }
|
|
|
|
/// <summary>
|
|
/// Optional password for authentication.
|
|
/// </summary>
|
|
public string? Password { get; set; }
|
|
|
|
/// <summary>
|
|
/// Transport security mode. Defaults to <see cref="Models.SecurityMode.None" />.
|
|
/// </summary>
|
|
public SecurityMode SecurityMode { get; set; } = SecurityMode.None;
|
|
|
|
/// <summary>
|
|
/// Session timeout in seconds. Defaults to 60.
|
|
/// </summary>
|
|
public int SessionTimeoutSeconds { get; set; } = 60;
|
|
|
|
/// <summary>
|
|
/// Whether to automatically accept untrusted server certificates. Defaults to true.
|
|
/// </summary>
|
|
public bool AutoAcceptCertificates { get; set; } = true;
|
|
|
|
/// <summary>
|
|
/// Path to the certificate store. Defaults to <see cref="string.Empty"/>; the
|
|
/// consuming application configuration factory resolves the canonical path via
|
|
/// <see cref="ClientStoragePaths.GetPkiPath"/> lazily on first connect, so
|
|
/// constructing settings — including the throwaway copies built per failover
|
|
/// attempt — does not touch disk or run the legacy-folder migration probe.
|
|
/// </summary>
|
|
public string CertificateStorePath { get; set; } = string.Empty;
|
|
|
|
/// <summary>
|
|
/// Validates the settings and throws if any required values are missing or invalid.
|
|
/// </summary>
|
|
/// <exception cref="ArgumentException">Thrown when settings are invalid.</exception>
|
|
public void Validate()
|
|
{
|
|
if (string.IsNullOrWhiteSpace(EndpointUrl))
|
|
throw new ArgumentException("EndpointUrl must not be null or empty.", nameof(EndpointUrl));
|
|
|
|
if (SessionTimeoutSeconds <= 0)
|
|
throw new ArgumentException("SessionTimeoutSeconds must be greater than zero.",
|
|
nameof(SessionTimeoutSeconds));
|
|
|
|
if (SessionTimeoutSeconds > 3600)
|
|
throw new ArgumentException("SessionTimeoutSeconds must not exceed 3600.", nameof(SessionTimeoutSeconds));
|
|
}
|
|
} |