zerodds-cs 1.0.0-rc.1

C# P/Invoke, NativeAOT-compatible, IDL4-C# runtime
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

// SPDX-License-Identifier: Apache-2.0
// Copyright 2026 ZeroDDS Contributors
//
// Domain.cs — DDS-PSM-Cxx 1.0 §7.5.11.

using System;
using ZeroDDS.Core;

namespace ZeroDDS.Domain;

/// <summary>DomainParticipantFactory (Spec §7.5.11.4). Singleton.</summary>
public static class DomainParticipantFactory
{
    /// <summary>Gibt die Singleton-Factory zurueck.</summary>
    public static IntPtr GetInstance() => Native.DpfGetInstance();

    /// <summary>Erzeugt einen Participant mit Default-QoS.</summary>
    public static DomainParticipant CreateParticipant(uint domainId)
    {
        var f = Native.DpfGetInstance();
        var h = Native.DpfCreateParticipant(f, domainId, IntPtr.Zero);
        if (h == IntPtr.Zero) throw new DdsError("DomainParticipantFactory::CreateParticipant");
        return new DomainParticipant(h, f);
    }

    /// <summary>Erzeugt einen Participant mit expliziter QoS (Spec §2.2.2.2.2.2).</summary>
    public static DomainParticipant CreateParticipant(uint domainId,
        ZeroDDS.Qos.DomainParticipantQos qos)
    {
        var f = Native.DpfGetInstance();
        using var scope = new ZeroDDS.QosBridge.NativeQosScope();
        var native = ZeroDDS.QosBridge.QosBridge.ToNative(qos, scope);
        IntPtr h;
        unsafe { h = Native.DpfCreateParticipant(f, domainId, (IntPtr)(&native)); }
        if (h == IntPtr.Zero) throw new DdsError("DomainParticipantFactory::CreateParticipant with QoS");
        return new DomainParticipant(h, f);
    }
}

/// <summary>DomainParticipant (Spec §7.5.11.5).</summary>
public sealed class DomainParticipant : IDisposable
{
    private IntPtr _handle;
    private readonly IntPtr _factory;
    private bool _disposed;

    internal DomainParticipant(IntPtr handle, IntPtr factory)
    {
        _handle = handle;
        _factory = factory;
    }

    /// <summary>Native handle (intern fuer Topic/Pub/Sub-Konstruktion).</summary>
    public IntPtr Handle => _handle;

    /// <summary>Domain-Id (Spec §7.5.11.5).</summary>
    public uint DomainId
    {
        get
        {
            EnsureAlive();
            return Native.DpGetDomainId(_handle);
        }
    }

    /// <summary>assert_liveliness.</summary>
    public void AssertLiveliness()
    {
        EnsureAlive();
        StatusCheck.Check(Native.DpAssertLiveliness(_handle), "DomainParticipant::AssertLiveliness");
    }

    /// <summary>contains_entity.</summary>
    public bool ContainsEntity(InstanceHandle h)
    {
        EnsureAlive();
        return Native.DpContainsEntity(_handle, h.Value) != 0;
    }

    /// <summary>ignore_participant.</summary>
    public void IgnoreParticipant(InstanceHandle h)
    {
        EnsureAlive();
        StatusCheck.Check(Native.DpIgnoreParticipant(_handle, h.Value),
            "DomainParticipant::IgnoreParticipant");
    }

    /// <summary>delete_contained_entities.</summary>
    public void DeleteContainedEntities()
    {
        EnsureAlive();
        StatusCheck.Check(Native.DpDeleteContainedEntities(_handle),
            "DomainParticipant::DeleteContainedEntities");
    }

    /// <summary>Disposable-Pfad: aufraeumen.</summary>
    public void Dispose()
    {
        if (_disposed) return;
        _disposed = true;
        if (_handle != IntPtr.Zero)
        {
            Native.DpDeleteContainedEntities(_handle);
            Native.DpfDeleteParticipant(_factory, _handle);
            _handle = IntPtr.Zero;
        }
        GC.SuppressFinalize(this);
    }

    ~DomainParticipant() { Dispose(); }

    internal void EnsureAlive()
    {
        if (_disposed || _handle == IntPtr.Zero)
            throw new AlreadyClosedException("DomainParticipant disposed");
    }
}