サービスおよび標準 API のプログラムでの呼び出し

サービスと標準 API をプログラムで呼び出すためのサンプル・コードと、プロトコルを確認することができます。

アプリケーションは、アプリケーションの標準 API およびサービスをプログラムで呼び出す方法を例示するサンプル・コードが用意されています。 <runtime_sandbox>/xapidocs/code_examples/ ディレクトリーにあるサンプル・ファイルを参照してください。

注: サービス定義フレームワーク内で定義されたサービスを実行するには、YIFApiインターフェースの executeFlow(を使用します。

アプリケーションからのアウトバウンドである API およびサービス・トランザクションは、サービス・ビルダーを使用して構成できます。詳しくは、 組織および参加者モデリングの概念を参照してください。

アプリケーションに到着する API およびサービス・トランザクションは、以下のプロトコルを使用して呼び出すことができます。
  • EJB
  • HTTP と HTTPS
  • LOCAL
  • Web サービス
  • COM+

EJB

コードのサーバー ・サイドでの実行に EJB を使用します。 Java™ 呼び出し。 アプリケーションのすべてのメソッドは、YFS 環境および文書を取り、文書を返します。 EJB は、リモートに呼び出されるように設計されているため、これらの文書はそれぞれ一方の端でシリアル番号付けされ、他方の端でシリアル番号が解除されます。 ただし、アプリケーションは EJB を使用し、そこで各 API は 2 つのストリング・パラメーターを取り、ストリングを返します。 こうすることによって、標準の適切に定義されたインターフェースを使用して、任意の文書実装を強制的にシリアライズおよびシリアライズ解除します。

例えば、新しい EJB は、以下のようなメソッド・シグニチャーを使用して作成されます。
String createOrder(String env, String inputXML) throws YFSException, RemoteException;

ここで、env は、createEnvironment 変数への有効な入力である必要がある XML です。 戻り値は出力 XML です。

YIFClientFactory.getInstance().getApi(“EJB”) を使用して API を呼び出すとき、この呼び出しは、このストリング・ベースの EJB を使用して行われます。 このタイプの呼び出しでは、YFS 環境および文書を渡すことができ、文書が返されます。 アプリケーションのコードは、変換を透過的に実行します。

注: DOM ベースの EJB は非推奨です。 したがって、サーバー・サイドの実行にはストリング・ベースの EJB を使用する必要があります。

HTTP

コードのサーバー ・サイドでの実行に HTTP を使用します。 Java 呼び出し。

LOCAL

コードのクライアント・サイドでの実行にローカルを使用します。 COM または Java 呼び出し。

Web サービス

コードのクライアント・サイドでの実行に Web サービスを使用します。 COM または Java 呼び出し。

COM+

VB または C++ コードのクライアント・サイドでの実行に COM を使用します。 COM または Java 呼び出し。

COM の使用には、サーバーおよびランタイム・クライアントの設定が必要です。

注: EJB、COM、または HTTP トランスポート・プロトコルを介して同期 API 呼び出しを行っているときに検出された例外は、再処理のためにキューに入れられません。