Visual Studio でチャートコントロールと RabbitMQ をデータバインド

データバインドによって、UI コントロールからデータに接続できます。 CData ADO.NET Provider for API を使って、Visual Studio 上でWindows Forms およびWeb Forms とRabbitMQ をデータバインドできます。この記事で、RabbitMQ を、ウィザードから変更をリアルタイムで反映するチャートにデータバインドする方法を説明します。 Code Walk-through セクションではチャートはほんの10行のコードで作成します。

チャートへのデータバインド

データバインドは３つのステップから構成されます。コントロールのインスタンス作成、データソースの設定、最後にデータバインドです。

接続を設定してデータベースオブジェクトを選択

下の手続きにより、データソース構成ウィザードを使ってチャートコントロールとRabbitMQ との接続を作成します。ウィザード上でデータバインドをするRabbitMQ エンティティを使います。

1. Windows Forms プロジェクトでは、チャートコントロールをツールボックスからフォーム上にドラグ＆ドロップします。チャートプロパティのデータセクションで DataSource を選択し、メニューからプロジェクトデータソースの追加を選択します。
2. 出てくるデータソース構成ウィザードでデータベース -> データセットを選択します。
3. データ接続ステップで、「新しい接続」をクリックします。

4. データ接続の選択ダイアログで、「変更」をクリックして、CData RabbitMQ のデータソースを選択して、接続プロパティを入力します。下は代表的な接続文字列ですです。:

   Below is a typical connection string:

   Profile=C:\profiles\\RabbitMQ.apip;AuthScheme=Basic;URL=http://localhost:15672;User=guest;Password=guest;

   RabbitMQ Management HTTP API について

   RabbitMQ は、複数のメッセージングプロトコルをサポートするオープンソースのメッセージブローカーです。RabbitMQ Management HTTP API は、RabbitMQ サーバーの管理データと監視データに HTTP 経由でアクセスする手段を提供します。この API では、仮想ホスト、エクスチェンジ、キュー、バインディング、コネクション、チャネル、コンシューマー、ユーザー、権限、ポリシー、クラスター全体の統計情報を取得できます。

   HTTP API を利用するには、RabbitMQ サーバーで Management プラグインを有効化する必要があります。デフォルトでは、管理インターフェースはポート 15672 でリッスンします。

   Basic 認証の設定

   RabbitMQ Management HTTP API は HTTP Basic 認証を使用します。RabbitMQ 管理ユーザーのユーザー名とパスワードを指定する必要があります。

   管理 API へのアクセスを有効にするには、以下のステップで進めます：

   1. サーバーで RabbitMQ Management プラグインが有効になっていることを確認します（rabbitmq-plugins enable rabbitmq_management）。
   2. 既存の管理ユーザーを使用するか、適切な管理タグ（management、policymaker、monitoring、または administrator）を持つユーザーを作成します。
   3. RabbitMQ Management HTTP API の完全なベース URL を控えておきます（例：http://localhost:15672）。

   RabbitMQ サーバーを設定したら、以下の接続プロパティを設定して接続します：

   • AuthScheme：Basic に設定します。
   • URL：RabbitMQ Management HTTP API のベース URL に設定します（例：http://localhost:15672）。
   • User：RabbitMQ の管理ユーザー名に設定します（例：guest）。
   • Password：RabbitMQ の管理パスワードに設定します。

   接続文字列の例：

   Profile=C:\profiles\RabbitMQ.apip;AuthScheme=Basic;URL=http://localhost:15672;User=guest;Password=guest;
   

   利用可能なテーブル

   RabbitMQ プロファイルでは、以下のテーブルにアクセスできます：

   • Overview - クラスター全体の統計情報と RabbitMQ ノードに関する情報
   • Nodes - RabbitMQ クラスター内の個々のノードに関する情報
   • NodeMemory - 特定のクラスターノードの詳細なメモリ使用状況の内訳
   • Connections - ブローカーへのすべてのオープンな AMQP コネクションの一覧
   • Channels - すべてのコネクションにわたるオープンな AMQP チャネルの一覧
   • Consumers - すべてのキューに登録されたコンシューマーの一覧
   • Exchanges - すべての仮想ホストで宣言されたエクスチェンジの一覧
   • Queues - すべての仮想ホストで宣言されたキューの一覧
   • Bindings - エクスチェンジとキュー間のすべてのバインディングの一覧
   • VirtualHosts - ブローカーに設定された仮想ホストの一覧
   • VhostPermissions - 特定の仮想ホスト内のユーザー権限
   • Users - すべての RabbitMQ ユーザーの一覧
   • Permissions - すべての仮想ホストにわたる全ユーザーの権限レコード
   • TopicPermissions - 全ユーザーのトピックレベルの権限レコード
   • Policies - 仮想ホスト内のキューおよびエクスチェンジに適用されたポリシーの一覧
   • OperatorPolicies - 仮想ホスト内のキューに適用されたオペレーターポリシーの一覧
   • Parameters - 仮想ホストごとのコンポーネントパラメータ（例：federation、shovel）の一覧
   • GlobalParameters - すべての仮想ホストに適用されるグローバルパラメータの一覧
   • VhostLimits - 特定の仮想ホストに設定されたリソース制限
   • UserLimits - 特定のユーザーに設定されたリソース制限
   • FeatureFlags - フィーチャーフラグの一覧と、ノード上での有効／無効の状態
   • DeprecatedFeatures - 非推奨機能の一覧と、その使用状態
   • AuthAttempts - ノードの認証試行統計
   • ClusterName - RabbitMQ クラスターの名前
   • WhoAmI - 現在認証されている管理ユーザーに関する情報
   • ExchangeBindingsSource - 特定のエクスチェンジがソースとなっているバインディング
   • ExchangeBindingsDestination - 特定のエクスチェンジが宛先となっているバインディング
   • QueueBindings - 仮想ホスト内の特定のキューのバインディング

5. 使用するデータソースオブジェクトを選択します。例は AuthAttempts テーブルです。

DataBind

データソースの追加とデータベースオブジェクトを選択したら、チャートにオブジェクトをバインドします。この例では、X軸に をY軸に を設定します。

1. チャートプロパティで、Series プロパティをクリックし、Series コレクション エディター を開きます。
2. Series プロパティでX軸、Y軸に設定するカラムを選択します：XValueMember および YValueMember プロパティにメニューからカラムを選びます。

チャートはこれでRabbitMQ にデータバインドされました。チャートを実行して最新のデータを表示させましょう。

コード Walk-through

RabbitMQ へのデータバインドはほんの数行のコードのみが必要で、３つの簡単なステップで完了できます。

1. RabbitMQ に接続します。
2. APIDataAdapter を作成して、クエリを作成し、結果を入れるデータセットを作成します。
3. 結果セットとチャートをデータバインドします。

下に完全なコードを示します:

APIConnection conn = new APIConnection("Profile=C:\profiles\\RabbitMQ.apip;AuthScheme=Basic;URL=http://localhost:15672;User=guest;Password=guest;");
APICommand comm = new APICommand("SELECT ,  FROM AuthAttempts WHERE NodeName = 'rabbit@hostname'", conn);
APIDataAdapter da = new APIDataAdapter(comm);
DataSet dataset = new DataSet();
da.Fill(dataset);

chart1.DataSource = dataset;
chart1.Series[0].XValueMember = "";
chart1.Series[0].YValueMembers = "";
// Insert code for additional chart formatting here.
chart1.DataBind();