WebSphere® Adapter for FTP は、Outbound 処理で以下の表に説明されている操作をサポートします。
操作 | 結果 |
---|---|
Create | 指定された名前のファイルが、FTP サーバーの指定されたディレクトリーに作成される。ファイルの内容は、クライアントからの要求の一部として提供されます。あるいは、アダプターが稼働しているローカル・ファイル・システムから内容を取り出すこともできます。この内容の取り出し方法は構成可能です。作成するファイルが存在しない場合は、ファイルが作成され、J2EE アプリケーションに null が返されます。ファイルは、ステージング・ディレクトリー (存在する場合) に作成され、このディレクトリーから指定されたディレクトリーに移動されます。
ステージング・ディレクトリーが存在しない場合は、ファイルは指定されたディレクトリー内に作成されます。 作成するファイルが既に存在する場合は、FTPFileCreateException 例外が送信され、ファイルは作成されず、既存のファイルも上書きされません。 |
Append | FTP サーバーの指定されたディレクトリーにある指定された名前のファイルが、要求の中で送信された内容で付加される。ファイルが存在する場合は、内容が付加され、J2EE アプリケーションに null が返されます。付加するファイルは、指定されたディレクトリーからステージング・ディレクトリー (存在する場合) にコピーされ、ステージング・ディレクトリー内のファイルに内容が付加されます。この後このファイルは、元の指定されたディレクトリーに戻されます。ステージング・ディレクトリーが存在しない場合、指定されたディレクトリー内のファイルに内容が直接付加されます。付加するファイルが存在しない場合は、呼び出し側コンポーネントに FTPFileAppendException 例外が送信されます。 |
Delete | 指定されたディレクトリー内のファイルが、FTP サーバーで削除される。ファイルの削除後、J2EE アプリケーションに null が返されます。ファイルが存在しない場合は、呼び出し側コンポーネントに FTPFileDeleteException 例外が送信されます。 |
Retrieve | 要求で指定されたファイルの内容が返される。要求で指定されたファイルが存在する場合、そのファイルの内容が取得され、応答として送信されます。 ファイル内容は J2EE アプリケーションにビジネス・オブジェクトとして送信されるか、アダプターが稼働しているローカル・ファイル・システムに保管されます。 これは構成可能です。ファイル名は、fileName 属性にコンマで区切ったリストとして入力されます。ファイルが存在しない場合は、FTPFileRetrieveException 例外が呼び出し側コンポーネントに送信されます。 |
Overwrite | この操作は、ディレクトリーのファイルに要求で指定された内容を上書きする。上書きするファイルが存在する場合は、内容が上書きされ、J2EE アプリケーションに null が返されます。上書きするファイルは、指定されたディレクトリーからステージング・ディレクトリー (使用している場合) にコピーされ、ステージング・ディレクトリー内のそのファイルに内容が上書きされます。この後このファイルは、元の指定されたディレクトリーに戻されます。ステージング・ディレクトリーが存在しない場合、指定されたディレクトリー内のファイルに内容が上書きされます。更新するファイルが存在しない場合は、呼び出し側コンポーネントに FTPFileOverwriteException 例外が送信されます。 |
Exists | 要求内のファイル名が指定のディレクトリーに存在する場合、アダプターは DoesFileExists 属性が true に設定された ExistsResponse ビジネス・オブジェクトを返す。ファイル名が存在しない場合、またはディレクトリーが存在しない場合、アダプターは DoesFileExists 属性が false に設定された ExistsResponse ビジネス・オブジェクトを返します。 |
List | この操作は、要求で指定したディレクトリー内のすべてのファイル名およびサブディレクトリー名を返す。ディレクトリー内のファイル名およびサブディレクトリー名が取り出され、ListResponse ビジネス・オブジェクトで応答として送信されます。指定したディレクトリーが存在しない場合は、呼び出し側コンポーネントに FTPFileListException 例外が送信されます。 |
ServerToServer FileTransfer |
1 つの FTP サーバー・ディレクトリーから別の FTP サーバー・ディレクトリーへ指定されたファイルを転送する。要求に 2 つのサーバーについてのすべての情報が含まれていない場合、アダプターは FTPFileServerToServer FileTransferException 例外を送信します。 |
ExecuteFTPScript | この操作は、WebSphere Process Server の FTP スクリプト・ファイルに存在するコマンドを実行する。操作により、FTP サーバーがサポートするコマンドのみが実行され、他のコマンドは無視されます。 操作が失敗する場合、FTPFileExecuteFTPScriptException 例外が送信されます。 アダプターは、既に確立されている接続を使用してコマンドを実行するため、スクリプト・ファイルに open または connect などの接続に関連したコマンドを指定しないでください。スクリプト・ファイル内のコマンドを FTP サーバー上の特定のディレクトリーで実行する必要がある場合は、スクリプト・ファイルにそのディレクトリーに移動する最初のコマンドを指定する必要があります。 |
(c) Copyright IBM Corporation 2005, 2006.
(C) Copyright IBM Japan 2006
このインフォメーション・センターでは Eclipse テクノロジー (http://www.eclipse.org) が採用されています。