Xamarin.Forms の MessagingCenter
サンプルのダウンロード発行/サブスクライブ パターンは、パブリッシャーがサブスクライバーと呼ばれる受信者を知らずに、メッセージを送信するメッセージング パターンです。 同様に、サブスクライバーは、パブリッシャーを知らずに特定のメッセージをリッスンします。
.NET のイベントでは、発行/サブスクライブ パターンが実装されます。こうしたイベントは、コントロールやそれを含むページなど、疎結合が不要な場合に、コンポーネント間の通信レイヤーに対して最もシンプルで簡単な方法です。 ただし、パブリッシャーとサブスクライバーの有効期間はオブジェクト参照によって相互に結合され、サブスクライバーの種類にはパブリッシャーの種類への参照が含まれている必要があります。 これにより、特に、静的なオブジェクトまたは有効期間の長いオブジェクトのイベントをサブスクライブする、有効期間が短いオブジェクトがある場合に、メモリ管理の問題が発生する可能性があります。 イベント ハンドラーが削除されていない場合、サブスクライバーは、パブリッシャー内のサブスクライバーへの参照によって保持されます。これにより、サブスクライバーのガベージ コレクションが妨げられるか、または遅延します。
クラスは Xamarin.FormsMessagingCenter パブリッシュ/サブスクライブ パターンを実装し、オブジェクトと型の参照によるリンクに不便なコンポーネント間のメッセージ ベースの通信を可能にします。 このメカニズムにより、パブリッシャーとサブスクライバーは相互に参照することなく通信できるため、相互の依存関係を減らすことができます。
MessagingCenter クラスでは、マルチキャストの発行/サブスクライブ機能を提供します。 つまり、1 つのメッセージをパブリッシュする複数のパブリッシャーが存在し、同じメッセージをリッスンしている複数のサブスクライバーが存在する可能性があるということです。
パブリッシャーは MessagingCenter.Send メソッドを使用してメッセージを送信しますが、サブスクライバーは MessagingCenter.Subscribe メソッドを使用してメッセージをリッスンします。 さらに、サブスクライバーは、必要に応じて MessagingCenter.Unsubscribe メソッドを使用して、メッセージ サブスクリプションを解除することもできます。
重要
内部的には、MessagingCenter クラスでは弱参照が使用されます。 つまり、オブジェクトはアクティブに保持されず、ガベージ コレクションの実行が可能になります。 そのため、クラスでメッセージを受信する必要がなくなった場合にのみ、メッセージのサブスクリプションを解除する必要があります。
メッセージの発行
MessagingCenter メッセージは文字列です。 パブリッシャーは、MessagingCenter.Send オーバーロードの 1 つを使用してメッセージをサブスクライバーに通知します。 次のコード例では、Hi メッセージを発行します。
MessagingCenter.Send<MainPage>(this, "Hi");
この例では、Send メソッドによって、送信者を表すジェネリック引数を指定します。 また、メッセージを受信するには、サブスクライバーが同じジェネリック引数を指定する必要もあります。これは、その送信者からのメッセージをリッスンしていることを示します。 さらに、この例では 2 つのメソッド引数を指定しています。
- 最初の引数では、送信者インスタンスを指定します。
- 2 番目の引数では、メッセージを指定します。
また、ペイロード データは、メッセージと共に送信することもできます。
MessagingCenter.Send<MainPage, string>(this, "Hi", "John");
この例では、Send メソッドで 2 つのジェネリック引数を指定します。 1 つ目はメッセージを送信している型で、2 つ目は送信されているペイロード データの型です。 メッセージを受信するには、サブスクライバーでも同じジェネリック引数を指定する必要があります。 これにより、メッセージ ID を共有するものの、異なるペイロード データ型を送信する複数のメッセージを、異なるサブスクライバーが受信することができます。 さらに、この例では、サブスクライバーに送信されるペイロード データを表す 3 番目のメソッド引数を指定しています。 この場合、ペイロード データは string です。
Send メソッドでは、ファイア アンド フォーゲット アプローチを使用して、メッセージと任意のペイロード データが発行されます。 そのため、メッセージを受信するために登録されたサブスクライバーがない場合でも、メッセージが送信されます。 この状態では、送信されたメッセージは無視されます。
メッセージのサブスクライブ
サブスクライバーは、MessagingCenter.Subscribe オーバーロードのいずれかを使用して、メッセージを受信するように登録できます。 次のコード例は、この例を示しています。
MessagingCenter.Subscribe<MainPage> (this, "Hi", (sender) =>
{
// Do something whenever the "Hi" message is received
});
この例では、Subscribe メソッドは、MainPage 型によって送信された Hi メッセージに対して this オブジェクトをサブスクライブし、メッセージの受信に応答してコールバック デリゲートを実行します。 ラムダ式として指定されたコールバック デリゲートは、UI を更新したり、データを保存したり、他の操作をトリガーしたりするコードになる可能性があります。
注意
サブスクライバーは、パブリッシュされたメッセージのすべてのインスタンスを処理する必要はなく、これは Subscribe メソッドで指定されたジェネリック型引数によって制御できます。
次の例は、ペイロード データを含むメッセージをサブスクライブする方法を示しています。
MessagingCenter.Subscribe<MainPage, string>(this, "Hi", async (sender, arg) =>
{
await DisplayAlert("Message received", "arg=" + arg, "OK");
});
この例では、Subscribe メソッドでペイロード データが string である MainPage 型によって送信された Hi メッセージをサブスクライブします。 コールバック デリゲートは、このようなメッセージの受信に応答して実行されます。これにより、アラートのペイロード データが表示されます。
重要
Subscribe メソッドによって実行されるデリゲートは、Send メソッドを使用してメッセージを発行するのと同じスレッド上で実行されます。
メッセージのサブスクリプションの解除
サブスクライバーは、受信する必要がなくなったメッセージのサブスクライブを解除することができます。 これは、いずれかの MessagingCenter.Unsubscribe オーバーロードで実現されます。
MessagingCenter.Unsubscribe<MainPage>(this, "Hi");
この例では、Unsubscribe メソッドで、MainPage 型によって送信された Hi メッセージから this オブジェクトのサブスクリプションを解除します。
ペイロード データを含むメッセージは、次の 2 つのジェネリック引数を指定する Unsubscribe オーバーロードを使用して、サブスクリプションを解除する必要があります。
MessagingCenter.Unsubscribe<MainPage, string>(this, "Hi");
この例では、Unsubscribe メソッドで、ペイロード データが string である MainPage 型によって送信された Hi メッセージから this オブジェクトのサブスクリプションを解除します。