Page History

On this page

Creating a signal instance

You can create Signal Instances by using the following

APIs. You can create the signal by specifying its name, its Qualified name, or you can pass the Signal object.

signal)

The following example demonstrates how to create a Signal Instance:

ALH.createSignal("start");
ALH.

Sending a signal instance to a specific target object

You can send

Signal Instances by using the following APIs. You must specify the Signal (either by specifying the Signal Name or the Signal Instance) and the Target (either by specifying the Target Name or the Target Object). Optionally, you can specify the Port Name from which the signal is sent. In this case, the target is the owner of the port. 

 "portName")

The conditions that apply when creating an Instance are as follows:

• If a signal name contains "::", it will find the signal from a qualified name. The signal will be found if its qualified name

• ends with signalName.
• If

• a target is an instance of an fUML Object

• ,

• the signal is sent to

• it directly.
• If

• a target is an instance of a String, there are two possible cases as follows:
  
  • It will find the target object(s) from all waiting objects whose part/property names match the

• • "targetName".
  • It will find the target object(s) through

• • connectors,

• • if the "targetName" is the name of the

• • port.

The following example shows how to send a specific signal to a specific target object in ALH API

ALH.sendSignal("play", o);

        // "Player" is an object, and "out2" is a port name owned by that object.

All parameters must not be null. Otherwise, the ScriptEngine errors will be thrown.

Getting the last signal instance from a runtime object

You can use the following API to retrieve the last signal instance from a runtime object. It is equivalent to $signal$.

)

The following code fragment shows how to get the last signal instance in the event pool of a specified object using ALH API

ALH.getLastSignal(