借助网络配置,控制Modbus工具的日志显示,避免卡死界面
智能大石头 authored at 2021-12-11 22:09:19
6.50 KiB
XCoder
using System;
using System.Collections.Concurrent;
using System.Collections.Generic;
using System.ComponentModel;
using System.Globalization;
using Avalonia.Data;
using Avalonia.Data.Converters;
using Avalonia.Markup.Xaml;
using Avalonia.Threading;

namespace NewLife.XCoder.Services;

/// <summary>可绑定的译文条目:语言切换时通知界面刷新</summary>
public sealed class LocalizationItem : INotifyPropertyChanged
{
    internal LocalizationItem(String key) => Key = key;

    /// <summary>词表键(英文原文)</summary>
    public String Key { get; }

    /// <summary>当前语言译文</summary>
    public String Value => LocalizationService.T(Key);

    /// <summary>属性变化通知</summary>
    public event PropertyChangedEventHandler? PropertyChanged;

    internal void RaiseChanged() => PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Value)));
}

/// <summary>译文条目缓存:XAML 标记扩展与语言切换通知之间的桥</summary>
public static class LocalizationSource
{
    private static readonly ConcurrentDictionary<String, LocalizationItem> _items = new(StringComparer.Ordinal);

    /// <summary>取指定键的译文条目</summary>
    /// <param name="key">词表键(英文原文)</param>
    /// <returns>可绑定的译文条目</returns>
    public static LocalizationItem Get(String key) => _items.GetOrAdd(key, k => new LocalizationItem(k));


    private static void RaiseChanged()
    {
        // 控件可能创建在无头/测试会话的专用 UI 线程上,优先使用 Application 的调度器
        var dispatcher = Avalonia.Application.Current?.Dispatcher;
        if (dispatcher != null)
        {
            if (!dispatcher.CheckAccess())
            {
                dispatcher.Post(RaiseChanged);
                return;
            }
        }
        else if (!Dispatcher.UIThread.CheckAccess())
        {
            Dispatcher.UIThread.Post(RaiseChanged);
            return;
        }

        foreach (var item in _items.Values)
        {
            item.RaiseChanged();
        }
    }

    private static Boolean _subscribed;

    /// <summary>确保订阅语言切换通知</summary>
    public static void EnsureSubscribed()
    {
        if (_subscribed) return;

        _subscribed = true;
        LocalizationService.Changed += _ => RaiseChanged();
    }
}

/// <summary>本地化文本转换器:把状态/日志等动态中文文本转换为当前语言</summary>
/// <remarks>只做显示层转换,不修改 ViewModel 中的原始数据;未命中词表时保持原文。</remarks>
public sealed class LocalizedTextConverter : IValueConverter
{
    /// <summary>共享实例,供 XAML 通过 <c>{x:Static}</c> 引用</summary>
    public static readonly LocalizedTextConverter Instance = new();

    /// <summary>转换文本</summary>
    /// <param name="value">原始文本</param>
    /// <param name="targetType">目标类型</param>
    /// <param name="parameter">转换参数</param>
    /// <param name="culture">格式化文化</param>
    /// <returns>当前语言文本</returns>
    public Object? Convert(Object? value, Type targetType, Object? parameter, CultureInfo culture)
        => value is String text ? LocalizationService.Translate(text) : value;

    /// <summary>反向转换保持原值,兼容可编辑控件的双向绑定</summary>
    /// <param name="value">目标值</param>
    /// <param name="targetType">目标类型</param>
    /// <param name="parameter">转换参数</param>
    /// <param name="culture">格式化文化</param>
    /// <returns>原值</returns>
    public Object? ConvertBack(Object? value, Type targetType, Object? parameter, CultureInfo culture) => value;
}

/// <summary>本地化格式转换器:把计数套入当前语言格式串</summary>
/// <remarks>格式键通过 <c>ConverterParameter</c> 传入,每次计数变化时按当前语言重新格式化。</remarks>
public sealed class LocalizedFormatConverter : IValueConverter
{
    /// <summary>共享实例,供 XAML 通过 <c>{x:Static}</c> 引用</summary>
    public static readonly LocalizedFormatConverter Instance = new();

    /// <summary>组合计数与格式串</summary>
    /// <param name="value">计数值</param>
    /// <param name="targetType">目标类型</param>
    /// <param name="parameter">格式键,如 <c>{0} services</c></param>
    /// <param name="culture">格式化文化</param>
    /// <returns>格式化后的文本;缺少格式串时返回计数字符串</returns>
    public Object? Convert(Object? value, Type targetType, Object? parameter, CultureInfo culture)
    {
        var format = parameter as String;
        if (format.IsNullOrEmpty()) return value?.ToString() ?? "";

        try
        {
            return String.Format(culture, LocalizationService.T(format), value);
        }
        catch (FormatException)
        {
            return format;
        }
    }

    /// <summary>反向转换保持原值</summary>
    /// <param name="value">目标值</param>
    /// <param name="targetType">目标类型</param>
    /// <param name="parameter">转换参数</param>
    /// <param name="culture">格式化文化</param>
    /// <returns>原值</returns>
    public Object? ConvertBack(Object? value, Type targetType, Object? parameter, CultureInfo culture) => value;
}

/// <summary>XAML 译文标记扩展:<c>Text="{loc:Tr Workbench}"</c></summary>
/// <remarks>
/// 返回绑定到 <see cref="LocalizationItem.Value"/> 的反射绑定,
/// 语言切换时由 <see cref="LocalizationSource"/> 统一发出通知,已打开的界面即时刷新。
/// 键含逗号或空格时使用引号:<c>{loc:Tr 'Search tools, features or keywords…'}</c>。
/// </remarks>
public sealed class TrExtension : MarkupExtension
{
    /// <summary>词表键(英文原文)</summary>
    public String Key { get; set; } = "";

    /// <summary>实例化</summary>
    public TrExtension() { }

    /// <summary>按词表键实例化</summary>
    /// <param name="key">词表键(英文原文)</param>
    public TrExtension(String key) => Key = key;

    /// <summary>提供绑定值</summary>
    /// <param name="serviceProvider">XAML 服务提供者</param>
    /// <returns>指向译文条目的绑定</returns>
    // 运行时绑定依赖反射;桌面版 JIT 发布可用,开启 NativeAOT 时会出现 IL3050 提示
    public override Object ProvideValue(IServiceProvider serviceProvider) => new ReflectionBinding(nameof(LocalizationItem.Value))
    {
        Source = LocalizationSource.Get(Key),
        Mode = BindingMode.OneWay,
    };
}