SAMConnection->receive()
(no version information, might be only in CVS)
SAMConnection->receive() --
メッセージをキューあるいは購読から取得する
説明
class
SAMConnection {
SAMMessage
receive ( string target [, array properties] )
}
パラメータ
target
メッセージを取得するキュー、トピックあるいは購読の識別子。
properties
オプションの連想配列で、受信操作を制御するパラメータを指定します。
返り値
このメソッドは SAMMessage オブジェクトを返します。
エラーが発生した場合は FALSE を返します。
例
例 1. キューからのメッセージの取得
<?php
$msg = $conn->receive('queue://receive/test');
if (!$msg) {
// 受信に失敗しました!
echo "Receive failed ($conn->errno) $conn->error";
}
?>
|
|
例 2. オプションを指定して、キューからのメッセージの取得
この例では SAM_CORRELID オプションを使用して、
受信するメッセージを表すための相関 ID を指定します。
また、タイムアウトを 10 秒に指定します。
<?php
$msg = $conn->receive('queue://receive/test', array(SAM_CORRELID => $token, SAM_WAIT => 10000));
?>
|
|
例 3. 購読からのメッセージの取得
この例では、購読 ID からメッセージを受信する方法を示します。
<?php
$msg = $conn->receive($subscriptionName);
if (!$msg) {
// 受信に失敗しました!
echo "Receive failed ($conn->errno) $conn->error";
}
?>
|
$subscriptionName は、事前のコールで取得した購読 ID
であることに注意しましょう。
|