Red Hat Summit10.11. FTP プロバイダーの設定
| プロパティー | Description | 必須 |
|---|---|---|
| hostname | ポート 21 を使用する <host> だけの <host:port> の組み合わせを指定できます。 | はい |
| username | FTP 接続に使用されるユーザー名。 | はい |
| password | 上記のユーザーのパスワード | はい |
| directory | 新しいファイル用に監視される FTP ディレクトリー | はい |
| input-suffix | インストラクターが使用するファイルのフィルターに使用されるファイルの接尾辞（ドットの追加など、.esbIn など）。これは、空の文字列として指定することで、すべてのファイルを取得するように指定することもできます。 | はい |
| work-suffix | ファイルの処理中に使用されるファイル接尾辞。これにより、別のスレッドまたはプロセスも選択されなくなります。デフォルトは .esbInProcess です。 | いいえ |
| post-delete | true の場合、ファイルは処理された後に削除されます。この場合、ディレクトリー後および post-suffix は効果がないことに注意してください。デフォルトは true です。 | いいえ |
| post-directory | ファイルの処理後にファイルが移動される FTP ディレクトリー。デフォルトは上記のディレクトリーの値に設定されます。 | いいえ |
| post-suffix | 処理後にファイル名に追加されるファイルの接尾辞。デフォルトは .esbDone です。 | いいえ |
| error-delete | true の場合、処理中にエラーが発生した場合にファイルが削除されます。この場合、error-directory および error-suffix は効果がないことに注意してください。デフォルトは true です。 | いいえ |
| error-directory | 処理中にエラーが発生した場合にファイルを移動する FTP ディレクトリー。デフォルトは上記のディレクトリーの値に設定されます。 | いいえ |
| error-suffix | 処理中にエラーが発生するとファイル名に追加される接尾辞。デフォルトは .esbError です。 | いいえ |
| protocol | プロトコルは以下のいずれかになります。
| いいえ |
| passive | FTP 接続がパッシブモードであることを示します。これを true に設定すると、FTP クライアントは ftpserver への 2 つの接続を確立します。デフォルトは false で、クライアントは FTP サーバーに接続先となるポートを指示します。その後、FTP サーバーはクライアントへの接続を確立します。 | いいえ |
| read-only | true の場合、FTP サーバーはファイルの書き込み操作を許可しません。この場合、work-suffix、post-delete、post-directory、post-suffix、post-delete、error-directory、および error-suffix プロパティーは影響を受けないことに注意してください。デフォルトは false です。詳細は、読み取り専用 FTP リスナー を参照してください。 | いいえ |
| certificate-url | FTPS サーバー検証のパブリックサーバー証明書への URL、または SFTP クライアント検証のプライベート証明書への URL。SFTP 証明書は、デプロイメントアーティファクト内に埋め込まれたリソースとして配置できます。 | いいえ |
| certificate-name | FTPS サーバー検証の証明書の共通名 | いいえ |
| certificate-passphrase | SFTP クライアント検証用の秘密鍵のパスフレーズ。 | いいえ |
設定されたスケジュール(scheduleidref)に基づいてリモートファイルをポーリングする schedule リスナーを設定できます。
ftp-provider プロパティー read-only を true に設定すると、リモートファイルシステムが書き込み操作を許可しないことをシステムに指示します。これは、特定のファイルにパーミッションが付与されるイントラネットコンピューターで FTP サーバーが実行されている場合によくあります。
読み取り専用実装は JBoss TreeCache を使用して取得されたファイル名の一覧を保持し、以前に取得されていないファイル名のみを取得します。キャッシュを、キャッシュローダーを使用して安定したストレージに永続化するように設定する必要があります。
注記
キャッシュからファイル名を削除するストラテジーが存在する必要があります。企業には、定期的にファイルを別の場所に移動するアーカイブプロセスが存在する可能性があります。キャッシュからファイル名を削除するには、数日ごとにすべてのファイル名をキャッシュから削除するデータベースの手順を使用できます。別のストラテジーでは、キャッシュからファイル名をエビクトすると、cacheloader からファイル名も削除される TreeCacheListener を指定します。その後、エビクション期間は設定可能になります。これは、ftp-listener 設定でプロパティー(removeFilesystemStrategy-cacheListener)を設定することで設定できます。
| 名前 | Description |
|---|---|
| scheduleidref | FTP リスナーによって使用されるスケジュール。サービススケジューリング を参照してください。 |
| remoteFileSystemStrategy-class | リモートファイルシステムストラテジーを、実装するクラスで上書きします( org.jboss.soa.esb.listeners.gateway.remotestrategies.RemoteFileSystemStrategy )。デフォルトは org.jboss.soa.esb.listeners.gateway.remotestrategies.ReadOnlyRemoteFileSystemStrategyです。 |
| remoteFilesystemStrategy-configFile | ローカルファイルシステムまたはクラスパスに存在する JBoss TreeCache 設定ファイルを指定します。デフォルトでは、クラスパスのルートにある /ftpfile-cache-config.xml という名前のファイルを検索します。 |
| removeFilesystemStrategy-cacheListener | TreeCache で使用される JBoss TreeCacheListener 実装を指定します。デフォルトは TreeCacheListener ではありません。 |
| maxNodes | キャッシュに保存されるファイルの最大数。0 は制限なしを示します |
| timeToLiveSeconds | ノードがスイプされるまでのアイドル時間（秒単位）。0 は制限なしを示します |
| maxAgeSeconds | ノードがスイプアウトされるまでのアイドル時間に関係なく、オブジェクトは TreeCache （秒単位）に存在する必要がある時間。0 は制限なしを示します |
以下は、設定例です。
<ftp-listener name="FtpGateway"
busidref="helloFTPChannel"
maxThreads="1"
is-gateway="true"
schedule-frequency="5">
<property name="remoteFileSystemStrategy-configFile" value="./ftpfile-cache-config.xml"/>
<property name="remoteFileSystemStrategy-cacheListener" value=
"org.jboss.soa.esb.listeners.gateway.remotestrategies.cache.DeleteOnEvictTreeCacheListener"/>
</ftp-listener>
以下は、JBoss Cache コンポーネントの設定方法を示すサンプルコードです。
<region name="/ftp/cache">
<attribute name="maxNodes">5000</attribute>
<attribute name="timeToLiveSeconds">1000</attribute>
<attribute name="maxAgeSeconds">86400</attribute>
</region>
| プロパティー | Description | コメント |
|---|---|---|
| maxNodes | キャッシュに保存されるファイルの最大数。 | 0 は制限なしを示します |
| timeToLiveSeconds | ノードがスイプされるまでのアイドル時間（秒単位）。 | 0 は制限なしを示します |
| maxAgeSeconds | ノードがスイプアウトされるまでのアイドル時間に関係なく、オブジェクトは TreeCache （秒単位）に存在する必要がある時間 | 0 は制限なしを示します |
注記
helloworld_ftp_action クイックスタートは読み取り専用設定を示しています。クイックスタートの実行手順については、helloworld_ftp_action クイックスタートディレクトリーでant help を実行します。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}