TargetRegistry on sillysky.net

CRecordDeregisterTarget

Tue, 09 Dec 2025 00:00:00 +0000

With this message a target can be deregistered.

Notice

If you have direct access to the target, it is easier to call the ITargetRegistry.deregisterTarget() method.

<record id="33f72955-04bb-44e1-8da7-ec660de91244" name="DEREGISTER_TARGET" isService="true">

    <description>
        Deregister a target asynchronously.
    </description>

    <namespaces>SYSTEM</namespaces>

    <slot key="nid" name="NAMESPACE_ID" answer="false" mandatory="true" type="ID">
        <description>The namespace ID.</description>
    </slot>

    <slot key="tid" name="TARGET_ID" answer="false" mandatory="true" type="ID">
        <description>The ID of the target to deregister.</description>
    </slot>

</record>

Example of use of the class CRecordDeregisterTarget (after

generating)

This method is an example of deregistering a target in its own node.

private void deregisterTarget(@NotNull final IId aNamespaceId,
                              @NotNull final IId aTargetId) throws CException
{
    final CEnvelope env = CEnvelope.forLocalNanoService(CWellKnownNID.SYSTEM);

    final CRecord record = CRecordDeregisterTarget.create();
    CRecordDeregisterTarget.setNamespaceId(record,
                                           aNamespaceId);
    CRecordDeregisterTarget.setTargetId(record,
                                        aTargetId);
    sendRequest(env,
                record);
}

This method is an example of deregistering a target in a remote node. The ID of the node is also required for this.

CRecordNotifyTargetDeregistered

Tue, 09 Dec 2025 00:00:00 +0000

This nano service is triggered by the TargetRegistry when a Target has been deregistered.

<record id="42686f64-56d9-40d8-9efc-e4f42e9902fd" name="NOTIFY_TARGET_DEREGISTERED"
        isNanoService="true" type="REQUEST">

    <description>
        SYSTEM nanoservice that will be triggered if a target in a namespace (any namespace) has been deregistered.
    </description>

    <namespaces>SYSTEM</namespaces>

    <slot key="1" name="ADDRESS" direction="REQUEST" presenceConstraint="MANDATORY" type="TARGET_ADDRESS">
        <description>Address of the deregistered target.</description>
    </slot>

    <slot key="2" name="NAME" direction="REQUEST" presenceConstraint="MANDATORY" type="STRING">
        <description>Name of the target, if available via name database.</description>
    </slot>

</record>

Example of use of the class CRecordNotifyTargetDeregistered (after

generating)

This record is a notification nanoservice in the SYSTEM namespace. To get the message when targets are deregistered, we need to stick an observer to the nanoservice. We do this best in the handler of CRecordStartTarget, which is called when our target is registered:

CRecordNotifyTargetRegistered

Tue, 09 Dec 2025 00:00:00 +0000

This nano service is triggered by the TargetRegistry when a new Target is registered.

<record id="42686f64-56d9-40d8-9efc-e4f42e9902fd" name="NOTIFY_TARGET_DEREGISTERED"
        isNanoService="true" type="REQUEST">

    <description>
        SYSTEM nano service that will be triggered if a target in a namespace (any namespace) has been deregistered.
    </description>

    <namespaces>SYSTEM</namespaces>

    <slot key="1" name="ADDRESS" direction="REQUEST" presenceConstraint="MANDATORY" type="TARGET_ADDRESS">
        <description>Address of the deregistered target.</description>
    </slot>

    <slot key="2" name="NAME" direction="REQUEST" presenceConstraint="MANDATORY" type="STRING">
        <description>Name of the target, if available via name database.</description>
    </slot>

</record>

Example of use of the class CRecordNotifyTargetRegistered (after

generating)

This record is a notification nanoservice in the SYSTEM namespace. To get the message when targets are registered, we need to stick an observer to the nanoservice. We do this best in the handler of CRecordStartTarget, which is called when our target is registered:

CRecordRegisterTarget

Tue, 09 Dec 2025 00:00:00 +0000

With this message a target can be registered.

Notice

If you have direct access to the target registry, it is easier to call the ITargetRegistry.registerTarget() method.

<record id="1685ebe1-b0e4-4560-a3ec-98e8b3968f3f" name="REGISTER_TARGET" isNanoService="true" type="REQUEST">

    <description>
        Register a target asynchronously.
    </description>

    <namespaces>SYSTEM</namespaces>

    <slot key="nid" name="NAMESPACE_ID" direction="REQUEST" presenceConstraint="MANDATORY" type="ID">
        <description>The namespace ID.</description>
    </slot>

    <slot key="tgt" name="TARGET" direction="REQUEST" presenceConstraint="MANDATORY" type="OBJECT">
        <description>The target to register.</description>
    </slot>

    <slot key="tid" name="TID_WANTED" direction="REQUEST" presenceConstraint="OPTIONAL" type="ID">
        <description>Optional: The wanted target ID.</description>
    </slot>

    <slot key="name" name="NAME" direction="REQUEST" presenceConstraint="OPTIONAL" type="STRING">
        <description>Optional: A name for the target, which will be registered in the name database.</description>
    </slot>

    <slot key="adr" name="ADDRESS" direction="RESPONSE" presenceConstraint="OPTIONAL" type="TARGET_ADDRESS">
        <description>The target address on success.</description>
    </slot>

</record>

Example of use of the class CRecordRegisterTarget (after

generating)

CRecordStartTarget

Tue, 09 Dec 2025 00:00:00 +0000

The first message sent to a Target after registering with the TargetRegistry.

Description

<record id="42e31e06-40f6-4c84-870f-1e54bec696bd" name="START_TARGET" isService="false">

    <description>
        The first message a target will get (asynchronously).
    </description>

    <slot key="1" name="TARGET_ADDRESS" answer="false" mandatory="true" type="TARGET_ADDRESS">
        <description>The new target address.</description>
    </slot>

    <slot key="2" name="QID" answer="false" mandatory="true" type="ID">
        <description>The message queue ID.</description>
    </slot>

    <slot key="3" name="TARGET_REGISTRY" answer="false" mandatory="true" type="OBJECT">
        <description>The target registry the target was registered in.</description>
    </slot>

    <slot key="4" name="MESSAGE_SENDER" answer="false" mandatory="true" type="OBJECT">
        <description>The message sender needed to send messages.</description>
    </slot>

</record>

Example of use of the class CRecordStartTarget (after

generating)

To catch this message, we need a message handler. We add it in the constructor of the message handler registry.

CRecordTargetMonitorNotifyTargetDeregistered

Tue, 09 Dec 2025 00:00:00 +0000

A message sent from a TargetMonitor to an Observer after a Target is deregistered.

<record id="02a157fe-13c5-4b45-8182-b16ff6172fd0" name="TARGET_MONITOR_NOTIFY_TARGET_DEREGISTERED">

    <description>
        Target Monitor: Monitored target de-registered.
    </description>

    <slot key="1" name="ADDRESS" answer="false" mandatory="true" type="TARGET_ADDRESS">
        <description>Address of the deregistered target.</description>
    </slot>

    <slot key="2" name="NAME" answer="false" mandatory="true" type="STRING">
        <description>Name in the name database of the deregistered target.</description>
    </slot>

</record>

CRecordTargetMonitorNotifyTargetRegistered

Tue, 09 Dec 2025 00:00:00 +0000

A message sent from a TargetMonitor to an Observer after a Target has been registered.

<record id="45950e8f-b034-4ac0-91ff-793eb4a4e193" name="TARGET_MONITOR_NOTIFY_TARGET_REGISTERED">

    <description>
        Target Monitor: Monitored target registered.
    </description>

    <slot key="1" name="ADDRESS" answer="false" mandatory="true" type="TARGET_ADDRESS">
        <description>Address of the registered target.</description>
    </slot>

    <slot key="2" name="NAME" answer="false" mandatory="true" type="STRING">
        <description>Target name as given in the target class.</description>
    </slot>

    <slot key="3" name="CLASS_NAME" answer="false" mandatory="true" type="STRING">
        <description>Class name of the registered target.</description>
    </slot>

    <slot key="4" name="SIMPLE_CLASS_NAME" answer="false" mandatory="true" type="STRING">
        <description>Simple class name of the registered target.</description>
    </slot>

    <slot key="5" name="QUEUE_ID" answer="false" mandatory="true" type="ID">
        <description>Queue ID of the registered target.</description>
    </slot>

</record>