Signal
シグナルは、マルチプロセスアプリケーションにおいてプロセス間でのやり取りを管理し衝突を避けるために 4Dランゲージが提供する ツールです。 シグナルは、1つ以上のプロセスが実行を一時停止し、特定のタスクが完了するまで待つようにする仕組みです。 どのプロセスもシグナルを待機またはリリースすることができます。
プロセス間のやり取りを管理するには、セマフォーも使用できます。 セマフォーは、2つ以上のプロセスが同じリソース (ファイル、レコードなど) を同時に変更しないようにするための仕組みです。 セマフォーを解除できるのは、それを設定したプロセスのみです。
Signal オブジェクト
シグナルは、ワーカーやプロセスを呼び出す/作成するコマンドに対して引数として渡す必要のある共有オブジェクトです。
4D.Signal
オブジェクトは次のビルトインされたメソッドおよびプロパティを持ちます:
シグナルの .wait()
メソッドを呼び出したワーカーやプロセスは、.signaled
プロパティが true になるまで実行を停止します。 シグナルを待っている間、呼び出したプロセスは CPU を消費しません。 これはマルチプロセスアプリケーションのパフォーマンスを鑑みると有意義な仕組みです。 .signaled
プロパティは、いずれかのワーカーまたはプロセスがシグナルの .trigger()
メソッドを呼び出した時点で true になります。
また、コードのブロックを避けるため、.wait()
呼び出しの際に定義したタイムアウト時間に達することでも待機状態を脱することができます。
Signal オブジェクトは、New signal コマンドによって作成されます。
シグナルの使い方
4D では、New signal
コマンドを呼び出すことで新規 Signal オブジェクトを作成します。 作成したシグナルは、New process
あるいは CALL WORKER
コマンドに引数として渡す必要があります。それにより、プロセスやワーカーはタスクを完了した際にシグナルを書き換えることができます。
signal.wait()
は、他のワーカー/プロセスのタスクが完了するまで待機するワーカー/プロセスから呼び出す必要があります。signal.trigger()
は、他のワーカー/プロセスを待機状態から解放するために、タスク実行を終えたワーカー/プロセスが呼び出す必要があります。
signal.trigger()
の呼び出しによって解放されたシグナルは 、再利用することができません。 別のシグナルを設定す るには、New signal
コマンドをあらためて呼び出す必要があります。
Signal オブジェクトは 共有オブジェクト であるため、呼び出されたワーカー/プロセスから結果を返すために使用することもできます。 この場合、Use...End use
構文内で値を書き込む必要があります。
例題
var $signal : 4D.Signal
// シグナルを作成します
$signal:=New signal
// メインプロセスを呼び出し、OpenForm メソッドを実行します
CALL WORKER(1;"OpenForm";$signal)
// 他の計算をします
...
// プロセスの終了を待機します
$signaled:=$signal.wait()
// 結果を処理します
$calc:=$signal.result+...
OpenForm メソッド:
#DECLARE ($signal : 4D.Signal)
var $form : Object
$form:=New object("value";0)
// フォームを開きます
$win:=Open form window("Information";Movable form dialog box)
DIALOG("Information";$form)
CLOSE WINDOW($win)
// $signal 共有オブジェクトに新しい属性を追加することで、他のプロセスに返り値を受け渡します:
Use($signal)
$signal.result:=$form.value
End use
// 待機プロセスに向けてシグナルをトリガーします
$signal.trigger()
概要
.description : TextSignal オブジェクトのカスタムな詳細 |
.signaled : BooleanSignal オブジェクトの現在の状態 |
.trigger( ) シグナルオブジェクトの signaled プロパティを true に設定します |
.wait( { timeout : Real } ) : Boolean シグナルオブジェクトの .signaled プロパティが true になるか、任意の timeout に指定したタイムアウト時間が経過するまで、カレントプロセスを待機させます |
New signal
履歴
リリース | 内容 |
---|---|
17 R4 | 追加 |
New signal { ( description : Text ) } : 4D.Signal
引数 | 型 | 説明 | |
---|---|---|---|
description | Text | -> | シグナルの詳細 |
戻り値 | 4D.Signal | <- | シグナルを格納するネイティブオブジェクト |
説明
New signal
コマンドは、4D.Signal
オブジェクトを作成します。
シグナルは、ワーカー/プロセスから他のワーカー/プロセスへと引数のように渡せる共有オブジェクトです。 そのため、以下のようなことが可能になります:
- 呼び出されたワーカー/プロセスは特定の処理が完了した後に Signal オブジェクトを更新することができます。
- 呼び出し元のワーカー/プロセスは CPUリソースを消費することなく、実行を停止してシグナルが更新されるまで待つことができます。
任意で description 引数に、シグナルの詳細を説明するカスタムテキストを渡すことができます。 テキストは、シグナルの作成後に定義することも可能です。
Signal オブジェクトは共有オブジェクトのため、Use...End use
構文を使用することで、.description
プロパティのほか、ユーザー独自のプロパティを管理するのに使用することもできます。
戻り値
新規の 4D.Signal
オブジェクト。
例題
以下は、シグナルを設定するワーカーの典型的な例です:
var $signal : 4D.Signal
$signal:=New signal("This is my first signal")
CALL WORKER("myworker";"doSomething";$signal)
$signaled:=$signal.wait(1) // 最大で 1秒待機します
If($signaled)
ALERT("myworker はタスクを終了しました。 結果: "+$signal.myresult)
Else
ALERT("myworker は 1秒以内にタスクを終了できませんでした。")
End if
以下は、doSomething メソッドの一例です:
#DECLARE ($signal : 4D.Signal)
// 何らかの処理
//...
Use($signal)
$signal.myresult:=$processingResult // 結果を返します
End use
$signal.trigger() // 処理が完了しました
.description
履歴
リリース | 内容 |
---|---|
17 R4 | 追加 |
.description : Text
説明
.description
プロパティは、Signal
オブジェクトのカスタムな詳細を格納します。
.description
は、Signal オブジェクトの作成時、あるいはその他のタイミングでも設定することができます。 ただし、Signal
オブジェクトは共有オブジェクトであるため、.description
プロパティに書き込む際には必ず Use...End use
構文を使わなくてはならない点に留意が必要です。
読み書き可能 プロパティです。
.signaled
履歴
リリース | 内容 |
---|---|
17 R4 | 追加 |
.signaled : Boolean
説明
.signaled
プロパティは、Signal
オブジェクトの現在の状態を格納します。 Signal オブジェクトが作成された時点では、.signaled
は false です。 Signal オブジェクトに対して .trigger()
が呼び出された時に true となります。
このプロパティは 読み取り専用 です。
.trigger()
履歴
リリース | 内容 |
---|---|
17 R4 | 追加 |
.trigger( )
引数 | 型 | 説明 | |
---|---|---|---|
引数を必要としません |
説明
.trigger()
関数は、シグナルオブジェクトの signaled
プロパティを true に設定します 。すると、このシグナルを待機していたワーカーやプロセスが開始されます。
Signal がすでにシグナルされている (つまり signaled
プロパティが true になっている) 状態であった場合、この関数は何もしません。
.wait()
履歴
リリース | 内容 |
---|---|
17 R4 | 追加 |
.wait( { timeout : Real } ) : Boolean
引数 | 型 | 説明 | |
---|---|---|---|
timeout | Real | -> | シグナルの最大待機時間 (秒単位) |
戻り値 | Boolean | <- | .signaled プロパティの状態 |