Developer examples
This reference information provides examples and shows code snippets, command syntax, and configuration values that are relevant to performing application design, development, assembly, and deployment tasks.
You can also search for developer examples by title or by using keywords.
サブトピック
呼び出しスタブ・ジェネレーターの CSG.xml ファイル
CSG.xml ファイルには、<csg> カスタム・タスクを使用して Ant から、あるいは Ant ビルドとして Rational® Application Developer 内で、COBOL 呼び出しスタブ・ジェネレーターを開始する方法の完全な例が示されています。.呼び出しスタブ・ジェネレーターの CSGBatch.xml ファイル
Ant ビルド・ファイル CSGBatch.xml には、一連の COBOL ファイル (ディレクトリー内のすべての *.cbl ファイルなど) に対して <csg> を実行する例があります。呼び出しスタブ・ジェネレーターと CSGBatch.xml ファイルは、IBM® Rational Application Developer for WebSphere® Software 製品で使用可能です。COBOL 呼び出しスタブの Java クラスの使用例
COBOL 呼び出しスタブの Java™ クラスの使用例では、バッチ・アプリケーションが COBOL コンテナーを使用して COBOL プロシージャーを呼び出す方法を示しています。バッチ・トラブルシューティング用の COBOL コンテナー
バッチ・トラブルシューティング用の COBOL コンテナーを使用して問題が発生した場合は、さまざまなオプションを選択できます。COBOL RETURNING、RETURN-CODE、getReturnValue、および getReturnCode のパラメーター
COBOL モジュールで RETURNING パラメーターを指定した場合、stub.getReturnValue() メソッドを使用してスタブから値を取得することができます。このメソッドは RETURNINGパラメーターの Java オブジェクト表現を返します。これは、COBOL 呼び出しスタブ・ジェネレーター・ツールで生成されたデータ・バインディング・クラスです。例: com.ibm.wsspi.security.token.AuthenticationToken 実装
次の例は、認証トークンの実装を説明しています。 以下のサンプル・コードは抽象クラスを拡張しませんが 、com.ibm.wsspi.security.token.AuthenticationToken インターフェースを直接実装します。この インターフェースは直接実装することが可能ですが、重複するコードが書き込まれる可能性があります。 ただし、各種のトークン実装によって処理方法が大きく異なる 場合は、インターフェースを直接実装するとよいでしょう。例: com.ibm.wsspi.security.token.SingleSignonToken 実装
このファイルを使用して、シングル・サインオン実装の例を示します。 以下のサンプル・コードは抽象クラスを拡張しませんが、 com.ibm.wsspi.security.token.SingleSignonToken インターフェースを直接実装します。 この インターフェースは直接実装することが可能ですが、重複するコードが書き込まれる可能性があります。 ただし、各種のトークン実装によって処理方法が大きく異なる 場合は、インターフェースを直接実装するとよいでしょう。例: Java のメソッドを呼び出す ActiveX クライアント・アプリケーション
ActiveX to EJB (Enterprise Java Beans) ブリッジでは、 メソッドはネイティブ言語のメソッド起動構文を使用して呼び出されます。例: データ型変換のためのヘルパー・メソッドを使用する ActiveX クライアント・アプリケーション
通常、ActiveX (Visual Basic および VBScript) と Java メソッドの間のデータ型変換は、 『ActiveX to EJB ブリッジによるデータ型の変換』で説明しているように自動的に行われます。 ただし、自動変換が不可能な場合に備えて byte helper 関数および currency helper 関数が提供されています。例: カスタム認証トークン・ログイン・モジュール
この例は、ログインが初期ログインであるか、 伝搬ログインであるかを判別する方法を示します。例: カスタムのシングル・サインオン・トークン・ログイン・モジュール
このファイルは、ログインが初期ログインであるか、伝搬ログインであるかを判別する方法を示します。例: HTTP Cookie 検索
次の例は、HTTP 要求から Cookie を取得し、 その Cookie をデコードする方法を示しています。これにより、 Cookie は元のバイトに変換され、そのバイトから カスタム SingleSignonToken オブジェクトを作成することができます。 この例では、 これらのステップをログイン・モジュールから実行する方法を示します。また、これらのステップは サーブレットを使用して実行することもできます。例: アプレット・クライアント・コードの要件
アプレットがエンタープライズ Bean と対話するために使用するコードは java.naming.applet と呼ばれる追加のプロパティーを除いて、 スタンドアロンの Java プログラムまたはサーブレットが使用するコードと同じです。 このプロパティーは、 このクライアントがスタンドアロンの Java アプリケーションあるいはサーブレットではなく、 アプレットであることを InitialContext およびオブジェクト・リクエスト・ブローカー (ORB) に 通知します。例: アプレット・クライアント・タグの要件
標準のアプレットは、ブラウザーでアプレットを識別するための HTML <APPLET> タグが必要です。 <APPLET> タグはブラウザーの Java 仮想マシン (JVM) を呼び 出します。 <OBJECT> および <EMBED> タグで置き換えること もできます。例: コマンド・オブジェクトのキャッシュ
キャッシュ可能なコマンドは、サーブレットおよび JavaServer Pages (JSP) ファイルの同様のメカニズムで再使用するために、キャッシュに保管されます。例: Web サービスのキャッシュ
Web サービス・アプリケーション用のキャッシュ・ポリシーの集合と SOAP メッセージを作成できます。例: com.ibm.wsspi.security.token.AuthorizationToken 実装
このファイルを使用して、AuthorizationToken 実装の例を示します。 以下のサンプル・コードは抽象クラスを拡張しませんが 、com.ibm.wsspi.security.token.AuthorizationToken インターフェースを直接実装します。この インターフェースは直接実装することが可能ですが、重複するコードが書き込まれる可能性があります。 ただし、各種のトークン実装によって処理方法が大きく異なる場合は、 インターフェースを直接実装するとよいでしょう。例: com.ibm.wsspi.security.token.PropagationToken 実装
このファイルを使用して、伝搬トークン実装の例を 示します。 以下のサンプル・コードは、 抽象クラスの拡張は行いませんが、com.ibm.wsspi.security.token.PropagationToken インターフェースを 直接実装します。 この インターフェースは直接実装することが可能ですが、重複するコードが書き込まれる可能性があります。 ただし、各種のトークン実装によって処理方法が大きく異なる 場合は、インターフェースを直接実装するとよいでしょう。例: Web サービス・デプロイメント記述子のハンドラー・クラスの構成
このシナリオでは、クライアントおよびサーバーのハンドラー・クラスを WebServicesSamples.ear という名前のサンプル・アプリケーションに追加する方法について説明します。ハンドラー・クラスは、処理すべき要求または応答が指定されると、メッセージを表示します。例: 動的キャッシュ・サービスの構成
この例は、cachespec.xml ファイルを使用して動的キャッシュ・サービスを構成するためのすべてのステップをまとめたもので、 キャッシュ ID 生成規則、依存関係 ID、および無効化規則の使用について示します。例: PortletServingServlet を使用不可にする拡張ポートレット・デプロイメント記述子の構成
ポートレット URL サービスは、該当する URL を作成することによって、ポートレットのすべての機能および状態への直接アクセスをサポートします。 実動セットアップでは、ポートレットはその独自のアクセス制御を適用するエンタープライズ・ポータル・アプリケーションを介してサービスの提供を受けており、これが、セキュリティー・リスクと考えられます。 管理者は portletServingEnabled プロパティーを false に設定することによって、直接の URL サービスが機密性の高いポートレットに確実にアクセスしないようにできます。例: JAX-WS Web サービス・アドレッシング API を使用して汎用 Web サービス・リソース・インスタンスにアクセスする Web サービスの作成
Web サービスを使用して管理する必要があるネットワーク・プリンターを所有する IT 組織について検討します。この組織では、各プリンターを、 エンドポイント参照によって指定するリソースとしています。 この例では、WebSphere Application Server が提供する JAX-WS Web サービス・アドレッシング (WS-Addressing) アプリケーション・ プログラミング・インターフェース (API) を使用して、このようなサービスをコーディングする方法を示します。例: カスタム AuthorizationToken ログイン・モジュール
このファイルは、ログインが初期ログインであるか、伝搬ログインであるかを判別する方法を示します。例: カスタム伝搬トークン・ログイン・モジュール
初期ログインと伝搬ログインとを判別する方法を、この例で紹介します。例: ActiveX クライアント・アプリケーションに対するロギングとトレースの使用可能化
ActiveX to EJB ブリッジでは、 ロギングとトレースの 2 つのフォーマット (Windows アプリケーションのイベント・ログ および Java トレース・ログ) が提供されます。例: アプリケーション・クライアントのロギングおよびトレースの使用可能化
ActiveX to EJB ブリッジでは、 ロギングとトレースの 2 つのフォーマット (Windows アプリケーションのイベント・ログ および Java トレース・ログ) が提供されます。例: エンタープライズ Bean アプリケーションのコード
次の Enterprise JavaBeans (EJB) コンポーネントの例は、 EJB モジュール内の isCallerInRole および getCallerPrincipal メソッドの使用法を示しています。例: プロバイダー URL プロパティーの設定による初期コンテキストの取得
通常、Java Naming and Directory Interface (JNDI) クライアントは、正しい環境が既に構成されているため、明示的にプロパティー値を設定して、これらを InitialContext コンストラクターに渡す必要はないことを前提としています。 しかし、JNDI クライアントは、 その環境で識別された名前空間以外の名前空間にアクセスしなければならない場合があります。 このような場合は、InitialContext コンストラクターが使用する java.naming.provider.url (プロバイダー URL) プロパティーを明示的に設定する必要があります。 プロバイダー URL には、 初期コンテキストを取得するために、 初期コンテキスト・ファクトリーが使用できるブートストラップ・サーバー情報が入っています。 InitialContext コンストラクターに直接渡されたプロパティー値はいずれも、 その環境内の他のところで検出された同じプロパティーの設定より優先されます。例: CosNaming を使用した初期コンテキストの取得
WebSphere Application Server では、 初期コンテキストは、ブートストラップ・サーバーから取得されます。ブートストラップ・サーバーのアドレスは、ホストおよびポートで 構成されています。初期コンテキストを取得するには、 ブートストラップ・サーバーとして使用されるサーバーのホストおよびポートがわかっている必要があります。例: デフォルトの初期コンテキストの取得
プログラムによるデフォルトの初期コンテキストの取得には、さまざまな方法があります。例: JNDI を使用した EJB ホームまたはビジネス・インターフェースの検索
Java Naming and Directory Interface (JNDI) を使用するアプリケーションの大部分は、コンテナーで実行されます。 一部にはそうでないものもあります。 オブジェクトの検索に使用される名前は、アプリケーションがコンテナーで実行されるかどうかによって異なります。アプリケーションでは、検索名として corbaname URL を使用する方が便利な場合があります。コンテナー・ベースの JNDI クライアントおよび Java シン・クライアントは、corbaname URL を使用することができます。例: CosNaming を使用した EJB ホームの検索
CORBA CosNaming インターフェースを使用して、WebSphere Application Server ネーム・サーバーから EJB ホームまたは他の CORBA オブジェクトの検索を行うことができます。例: WSIF を使用した添付ファイル付き SOAP メッセージの引き渡し
Web Services Invocation Framework (WSIF) SOAP プロバイダーを使用して、標準 SOAP メッセージ用の SOAP 処理規則を変更せずに MIME multipart/related メッセージ内の添付ファイルを渡すための情報およびサンプル・コードです。これには、SOAP 添付ファイル用の Web サービス記述言語 (WSDL) 拡張の書き込み方法、および型と型マッピングの処理方法が含まれます。例: 読み取り/読み取り整合性検査
読み取り/読み取り整合性検査は、データが他のトランザクションから読み取られる LifeTimeInCache Bean にのみ適用されます。例: バージョン 5.x アプリケーションの Web Services Security のサンプル構成
バージョン 5.x アプリケーションを Web Services Security で セキュアするには、IBM 拡張デプロイメント記述子および IBM 拡張バインディングに、セキュリティー制約を定義する必要があります。 サンプル構成では、サンプルの鍵ストア・ファイル、およびデフォルトのバインディング情報が提供されています。 これにより、IBM デプロイメント記述子拡張およびバインディングの機能を示します。例: setClientInformation(Properties) API によるクライアント情報の設定
この API を用いて、接続に関する WebSphere Application Server クライアント情報を設定し、その情報をデータベースに受け渡すことができます。例: プロバイダー URL プロパティーの設定による、初期コンテキストとしての異なるルート・コンテキストの選択
サーバーごとに独自のサーバー・ルート・コンテキストがあり、 サーバーへのブートストラッピング時に、 サーバー・ルートはデフォルトの初期 JNDI コンテキストになります。EJB ホームなどのシステム成果物が ここでバインドされるため、 ほとんどの場合、このデフォルトが、必要とされる初期コンテキストです。 ただし、 その他にもルート・コンテキストが存在し、 ここに当該バインディングが含まれている場合もあります。 プロバイダー URL を指定して、他のルート・コンテキストを選択することができます。例: SIP サーブレットの Proxy サーブレット・クラス
例: SIP サーブレットの SendOnServlet クラス
SendOnServlet クラスは、単純な SIP サーブレットです。 各 INVITE で呼び出され、そこから要求を送信するという、 基本的な機能を実行します。例: SIP サーブレットの単純なプロキシー
単純なプロキシーのサーブレットの例を紹介します。例: ActiveX クライアント・アプリケーションを使用した Java クラスまたはオブジェクトへのアクセス
ActiveX と Enterprise JavaBeans (EJB) 間のブリッジで Java プロキシー・オブジェクトを使用できます。例: 読み取り専用のエンティティー Bean の使用
読み取り専用のエンティティー Bean を使用する Enterprise JavaBeans (EJB) アプリケーション作成の使用法のシナリオと例。例: 並行性と接続の使用
Runnable または Callable は、それが作成するコンポーネントが java:comp リソース参照を使用して取得した接続を使用できます。例: JAX-WS プロパティーを使用して JAX-WS ハンドラーの SOAP ヘッダーを操作する
WebSphere Application Server は、Java API for XML-Based Web Services (JAX-WS) に対する拡張を提供し、jaxws.binding.soap.headers.outbound プロパティーおよび jaxws.binding.soap.headers.inbound プロパティーを含む、Web Services for Java Platform, Enterprise Edition (Java EE) クライアント・プログラミング・モデルを提供します。 この例では、これらの 2 つのプロパティーを使用して JAX-WS ハンドラーの SOAP ヘッダーを操作する方法を示します。例: 動的照会のためのローカル・インターフェースの使用
ローカル・インターフェースを使用して動的 Enterprise JavaBeans (EJB) 照会を実行する場合は、 QueryLocal インターフェースで executeQuery メソッドを呼び出します。 このインターフェースはメソッドのトランザクションを開始しません。 このため、照会を実行するにはトランザクション・コンテキストを明示的に確立する必要があります。例: ポートレット集約タグ・ライブラリーの使用
集約タグ・ライブラリーを使用して、1 つのページ上に複数の異なるコンテンツが置かれるように複数のポートレットを集約できます。 このライブラリーは、サーブレットによって組み込まれるすべての JavaServer Pages (JSP) ファイルで使用することができます。例: 動的照会のためのリモート・インターフェースの使用
リモート・インターフェースを使用して動的 Enterprise JavaBeans (EJB) 照会を実行する場合は、 Query インターフェースで executeQuery メソッドを呼び出します。 executeQuery メソッドにはこのインターフェース用の必須トランザクション属性があります。 このため、照会を実行するためにトランザクション・コンテキストを明示的に確立する必要がありません。例: 作業域区画マネージャーの使用
例: tsx:repeat JavaServer Pages タグの使用による結果セットでの繰り返し (非推奨)
<tsx:repeat> タグは結果セットで繰り返されます。 結果セットは Bean の中に含まれています。 Bean は静的 Bean (例えば、IBM WebSphere Studio データベース・ウィザードを使用して作成された Bean) でも、動的に生成された Bean (例えば、<tsx:dbquery> 構文によって生成された Bean) でも構いません。例: System.out メッセージの表示
ActiveX to Enterprise JavaBeans (EJB) ブリッジには、 Java System.out メッセージを表示できるコンソールがありません。スタンドアロン・クライアント・プログラム (Visual Basic など) の実行中 にこれらのメッセージを見るには、出力をファイルに転送してください。Web サービス・コード実例
この Web サービス記述言語 (WSDL) の例およびコード・スニペットは、メディエーションをプログラミングするために Web サービス・メッセージ内のフィールドにアクセスする方法を示しています。


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=welc_ref_dev_xmp
ファイル名:welc_ref_dev_xmp.html