「Worklight: リソース・ハンドラー」パターンを生成した後に完了するタスク

パターンを生成した後に完了する必要があるタスクです。

このパターンは、操作 (作成、読み取り、更新、および削除) ごとにサブフローを作成します。サブフローの実装は、バックエンド・アプリケーションの呼び出しで完了します。このパターンは、サブフロー内の CRUD 操作ごとに参照実装を生成します。参照実装は、例として提供されます。これを使用すると、生成されるアプリケーションを作業用のソリューションとして Message Broker にデプロイすることができるので、パターンの働きを理解するのに役立ちます。

このパターンによって生成される Worklight アダプターは、データに変換を適用せず、モバイル・アプリケーションから Message Broker にそのまま渡します。この設計は、モバイル・アプリケーションと Message Broker 内のサブフローとの間で渡される JSON データのフォーマットについて、合意が必要であることを意味します。モバイル・アプリケーションと Message Broker との間で渡されるアプリケーション・データは、単一の JSON オブジェクトです。モバイル・アプリケーションは、WL.Client.InvokeProcedure を起動してバックエンド・アプリケーションを呼び出す際にこの JSON オブジェクトを提供します。

Worklight やモバイル・アプリケーションとは別個に Message Broker アプリケーションをテストできます。例えば、FireFox Poster プラグインは HTTP/JSON 要求を Message Broker との間で送受信できます。Worklight Studio を用いて Message Broker アプリケーションをテストすることもできます。Worklight Studio は、モバイル・アプリケーションからの HTTP/JSON 要求をシミュレートして、このパターンによって生成されたアダプターを呼び出すことができます。

セキュリティーを有効にした場合は、モバイル・アプリケーションは認証と許可のためにユーザー資格情報も提供しなければなりません。

セキュリティー

セキュリティーを有効にした場合、このパターンは追加の構成可能サービス・ファイルを生成します。このファイルは、Message Broker 内でのセキュリティー処理を構成します。1 つ目のファイル (AuthenticationSecurityProfile.configurableservice) は、HTTPInput ノードによって実行される認証を構成します。2 つ目のファイル (AuthorisationSecurityProfileReaders.configurableservice) は、リーダーの許可を構成します。3 つ目のファイル (AuthorisationSecurityProfileWriters.configurableservice) は、1 つ以上の書き込み操作 (作成、更新、または削除) を選択した場合にのみ生成されます。このファイルは、ライターの許可を構成します。

Message Broker Toolkit または Message Broker Explorer でこの構成可能サービス・ファイルを Message Broker にデプロイしてください。詳しくは、Message Broker のヘルプ内にある「構成可能サービス」のトピックを参照してください。

デプロイメント時に、mqsisetdbparms を使用して LDAP ユーザー ID とパスワードを設定することをお勧めします。Message Broker は、これらの資格情報を使用して LDAP サーバーにログインし、認証を実行します。ユーザー ID とパスワードが構成されていない場合、Message Broker は、匿名で LDAP サーバーにバインドします。詳しくは、Message Broker のヘルプ内にある「LDAP を使用した認証の構成」のトピックを参照してください。

グローバル・キャッシュ

キャッシュを使用可能にした場合は、Message Broker でグローバル・キャッシュを構成しなければなりません。Message Broker Explorer でデフォルトのグローバル・キャッシュを簡単に構成できます。詳しくは、Message Broker のヘルプ内にある「グローバル・キャッシュの管理」のトピックを参照してください。

グローバル・キャッシュには、データの自動満了 (強制削除) はありません。したがって、このパターンによって生成されるアプリケーションはデータを無期限にキャッシュに入れます。この状況は、他のチャネルによってバックエンド・アプリケーションに変更が加えられる場合 (Message Broker を介さず直接バックエンド・アプリケーションに変更が加えられる場合など) には適切でない可能性があります。

このパターンで提供されるキャッシュを改良する方法は複数あります。1 つ目のオプションは、バックエンド・アプリケーションで変更を listen し、これらのイベントをトリガーとして使用して、キャッシュから項目を削除することです。この方法の好例としては、DatabaseInput ノードがあります。DatabaseInput ノードは、1 つ以上のデータベース表をモニターし、アプリケーション・データに対する変更を探すことができます。変更が検出されると、削除する必要がある項目をメッセージ・フローがキャッシュから削除できます。モバイル・アプリケーションから行われる次の読み取り要求は、キャッシュ内でこのデータを検出しないので、バックエンド・アプリケーションを照会して変更を収集します。

2 つ目のオプションは、キャッシュ全体に対して定期的に消去作業を行うことです。この方法には、mqsicacheadmin コマンドを使用して簡単に実装できるという利点があります。このコマンドに -c clearGrid オプションを指定して定期的に実行するシェル・スクリプトは、キャッシュからすべての項目を削除します。この方法により、キャッシュが無制限に大きくならずに済み、データがキャッシュに残る最大時間も確定します。詳しくは、Message Broker のヘルプ内にある「mqsicacheadmin」のトピックを参照してください。

Message Broker のデプロイメント

  1. サービスを WebSphere Message Broker にデプロイします。アプリケーションをブローカー・アーカイブ・ファイルに追加する必要があります。
    1. 「ファイル」>「新規」>「BAR ファイル」をクリックします。
    2. アプリケーションの名前を入力するか、あるいは表示されているリストから 1 つを選択します。リストは、アクティブ作業セットのプロジェクトのみを表示するようにフィルタリングされています。
    3. 作成する BAR ファイルの名前を入力します。
    4. 「終了」をクリックします。 拡張子が .bar のファイルが作成され、「ナビゲーター」ビューで「ブローカー・アーカイブ」フォルダーの下に表示されます。BAR ファイルの「内容」エディターが開きます。
    5. 「準備」タブで、生成されたアプリケーションを選択し、BAR ファイルに追加します。
    6. 「ビルドして保存」をクリックして、BAR ファイルを作成します。
  2. ブローカー・アーカイブ・ファイルを構成します。「Worklight: リソース・ハンドラー」パターン・インスタンス用のメッセージ・フローをデプロイする前は、ブローカー・アーカイブ・ファイル内のアプリケーションをこれ以上構成する必要はありませんが、いくつかのデフォルト・オプションを検討して、環境に応じて構成を変更することもできます。「ブローカー・アーカイブ」エディターの「管理」ページで、次のようにします。
    1. オプション: ユーザー定義プロパティー LoggingOn を使用して、Web サービス・メッセージ・フローのロギングをオンにするかオフにするかを選択します。
    2. オプション: ユーザー定義プロパティー ErrorLoggingOn を使用して、エラー・メッセージを生成するかどうかを選択します。
    3. オプション: ブローカー・アーカイブの中の構成可能な任意のプロパティーを変更できます (例えばセキュリティーや追加のインスタンス作成に関するプロパティー)。

      値の変更によってパターン・インスタンスの動作が影響を受けないことを確認する必要があります。

  3. キューを作成します。エラー・メッセージやログ・メッセージに関する WebSphere MQ キューがまだ存在しない場合は作成しなければなりません。
    1. WebSphere MQ リソースを作成します。WebSphere MQ リソースは、runmqsc などのプログラムおよびユーティリティーを使用してコマンド行で作成したり、あるいは WebSphere MQ Explorer グラフィカル・インターフェースを使用して作成したりできます。 WebSphere MQ リソースの作成に関する詳細は、WebSphere MQ ライブラリーの Web ページで「WebSphere MQ Intercommunication」を参照してください。
  4. BAR ファイルを実行グループにデプロイします。

Worklight のデプロイメント

  1. 生成された Worklight アダプターを Worklight Server にデプロイします。
    1. Worklight プロジェクトをワークスペースからファイル・システムにエクスポートします。
    2. Worklight Studio を開始し、Worklight プロジェクトをインポートします。
    3. インポートしたプロジェクト内のアダプター上で、「実行」>「Worklight アダプターのデプロイ」をクリックします。

「Worklight: リソース・ハンドラー」パターンの仕様に戻る