namespace DeviceService.Driver
|
{
|
/// <summary>
|
/// 由 DriverManager 创建并统一管理的驱动实例代理。
|
///
|
/// 驱动对象本身活在驱动包的 AppDomain 中（WPF/普通类均不可跨域封送），
|
/// 因此宿主拿到的是本类的透明代理：宿主调用 <see cref="Invoke"/>、
|
/// <see cref="GetMethods"/>、<see cref="Release"/> 时，实际执行都发生在驱动自己的域内。
|
/// </summary>
|
public sealed class DriverInstance : MarshalByRefObject
|
{
|
private readonly DriverLoader _owner;
|
|
/// <summary>实例句柄（宿主与加载器之间定位实例的唯一标识）</summary>
|
public string Handle { get; }
|
|
/// <summary>驱动类型的 CLR 全名</summary>
|
public string TypeFullName { get; }
|
|
/// <summary>注解中的"类型"（如 CAN）</summary>
|
public string DriverType { get; }
|
|
/// <summary>注解中的"品牌"（如 BA）</summary>
|
public string Brand { get; }
|
|
/// <summary>所属驱动包名（由 DriverManager 回填，仅用于展示）</summary>
|
public string PackageFolder { get; set; }
|
|
// 实例由 DriverManager 长期持有，无限生存期，避免远程租约到期被回收
|
public override object InitializeLifetimeService() => null;
|
|
internal DriverInstance(DriverLoader owner, string handle, string typeFullName,
|
string driverType, string brand)
|
{
|
_owner = owner;
|
Handle = handle;
|
TypeFullName = typeFullName;
|
DriverType = driverType;
|
Brand = brand;
|
}
|
|
/// <summary>列出该驱动类型可调用的公共方法（用于确定 methodIndex）</summary>
|
public DriverMethodInfo[] GetMethods()
|
{
|
return _owner.GetMethods(TypeFullName);
|
}
|
|
/// <summary>
|
/// 在该驱动实例上反射调用方法。参数为字符串形式，按目标类型自动转换，
|
/// out/ref 参数的回填值会包含在结果中。
|
/// </summary>
|
public InvokeResult Invoke(int methodIndex, string[] rawArgs)
|
{
|
return _owner.InvokeOnInstance(Handle, methodIndex, rawArgs);
|
}
|
|
/// <summary>
|
/// 直接调用（原始对象参数/返回值），供动态代理使用。
|
/// 注意：参数与返回值必须可跨域封送（基元类型、string、[Serializable] DTO）。
|
/// </summary>
|
public InvokeDirectResult InvokeDirect(int methodIndex, object[] args)
|
{
|
return _owner.InvokeOnInstanceDirect(Handle, methodIndex, args);
|
}
|
|
/// <summary>
|
/// 释放该实例（若驱动实现了 IDisposable 则调用 Dispose）。
|
/// </summary>
|
public void Release()
|
{
|
_owner.ReleaseInstance(Handle);
|
}
|
}
|
}
|
