Поддерживаемые исходящие операции

WebSphere Adapter for FTP поддерживает операции обработки исходящих запросов, описанные в следующей таблице.

Операция Результат
Create В заданном каталоге сервера FTP создается файл с указанным именем. Содержимое файла может передаваться как часть запроса от клиента, либо оно может извлекаться из локальной файловой системы, в которой работает адаптер. Извлечение содержимого можно настроить. Если создаваемый файл не существует, он создается и приложению J2EE возвращается значение null. Файл создается в промежуточном каталоге (если он существует), из которого перемещается в указанный каталог. Если промежуточный каталог не существует, файл создается в указанном каталоге.

Если файл, который требуется создать, уже существует, выдается исключительная ситуация FTPFileCreateException, файл не создается, а существующий файл не заменяется.

Append К файлу с указанным именем в заданном каталоге сервера FTP добавляется содержимое, переданное в запросе. Если файл существует, в него добавляется содержимое и приложению J2EE возвращается значение null. Файл, в который требуется добавить содержимое, копируется из указанного каталога в промежуточный (если он существует), и содержимое добавляется к файлу в промежуточном каталоге. Затем файл перемещается обратно в исходный указанный каталог. Если промежуточного каталога не существует, содержимое добавляется к файлу непосредственно в указанном каталоге. Если файл, в который необходимо добавить содержимое, не существует, вызывающему компоненту возвращается исключительная ситуация FTPFileAppendException.
Delete Файл удаляется из указанного каталога сервера FTP. После удаления файла приложению J2EE возвращается значение null. Если файл не существует, вызывающему компоненту возвращается исключительная ситуация FTPFileDeleteException.
Retrieve Возвращает содержимое одного или нескольких файлов, указанных в запросе. Если файлы, указанные в запросе существуют, их содержимое отправляется в качестве ответа. Содержимое файла может возвращаться приложению J2EE в качестве бизнес-объекта или сохраняться в локальной файловой системе адаптера. Это настраиваемый параметр. Имена файлов указываются в атрибуте fileName через запятую. Если файл не существует, вызывающему компоненту отправляется исключительная ситуация FTPFileRetrieveException.
Overwrite Заменяет файл в каталоге содержимым, указанным в запросе. Если целевой файл существует, его содержимое заменяется и приложению J2EE возвращается значение null. Файл, который необходимо заменить, копируется из указанного каталога в промежуточный (если он существует), и содержимое заменяется в промежуточном каталоге. Затем файл перемещается обратно в исходный указанный каталог. Если промежуточного каталога не существует, содержимое файла заменяется непосредственно в указанном каталоге. Если файл, который необходимо заменить, не существует, вызывающему компоненту возвращается исключительная ситуация FTPFileOverwriteException.
Exists Если файл, имя которого указано в запросе, существует в заданном каталоге, адаптер возвращает бизнес-объект ExistsResponse, в атрибуте DoesFileExists которого указано значение true. Если файл или каталог не существует, адаптер возвращает бизнес-объект ExistsResponse, в атрибуте DoesFileExists которого указано значение false.
List Возвращает список имен всех файлов и подкаталогов из каталога, указанного в запросе. Имена файлов и подкаталогов возвращаются в бизнес-объекте ListResponse. Если целевой каталог не существует, вызывающему компоненту возвращается исключительная ситуация FTPFileListException.
ServerToServer
FileTransfer
Передает указанный файл из одного каталога сервера FTP в другой каталог сервера FTP. Если запрос содержит неполную информацию о серверах, адаптер возвращает исключительную ситуацию FTPFileServerToServer
FileTransferException.
ExecuteFTPScript Выполняет команды из файла сценария FTP на сервере WebSphere Process Server. Выполняются только команды поддерживаемые сервером FTP; остальные команды игнорируются. В случае сбоя операции возвращается исключительная ситуация FTPFileExecuteFTPScriptException. Файл сценария не должен содержать команды, относящиеся к соединениям (например, open и connect), поскольку для выполнения команд применяется уже открытое соединение. Если команды из файла сценария необходимо выполнить в конкретном каталоге сервера FTP, то в качестве первой команды следует указать команду перехода в нужный каталог.

Опции исходящей конфигурации

WebSphere Adapter for FTP поддерживает следующие опции конфигурации обработки исходящих запросов:
  • Операции обработки исходящих запросов поддерживают как активные, так и пассивные информационные соединения. По умолчанию применяется активный режим.
  • Файлы можно передавать в двоичном режиме или режиме ASCII. По умолчанию применяется двоичный режим.
  • При необходимости для команд, выполняемых в ходе операции обработки исходящих запросов, можно включить функцию контроля. Полученная информация записывается в файл трассировки, если указан уровень трассировки FINEST.
  • Если запросы передаются через Proxy FTP, расположенный между адаптером и сервером FTP, для настройки доступны параметры Proxy Socks. Параметры Proxy настраиваются на уровне приложения и применяются для всех фабрик управляемых соединений и спецификаций активации, принимающих участие в настройке адаптера.
  • Если в ходе исходящей операции create приложение J2EE передает содержимое файла, то перед выполнением операции файл можно сохранить в рабочей станции.
  • Если исходящие операции извлекают несколько файлов, их имена должны быть перечислены через запятую в атрибуте fileName.
  • До и после операций обработки исходящих запросов можно вызывать ExecuteFTPScript. Файл сценария не должен содержать команды, относящиеся к соединениям (например, open), поскольку для выполнения команд применяется уже открытое соединение.
  • Номер порта сервера FTP можно настроить в URL FTP. Например, ftp://localhost:номер-порта
  • С помощью пассивных информационных соединений адаптер можно подключить к серверу FTP через брандмауэр.
  • Пароли по умолчанию хранятся в незашифрованном виде в файлах импорта и экспорта. Если настроен псевдоним идентификации, то фактический пароль для входящих и исходящих конфигураций извлекается из псевдонима идентификации сервера WebSphere Process Server.
  • В случае применения сервера FTP, если вывод команды ls -l отличается от стандартных списков, поддерживаемых Apache commons net 1.4.1 для других операционных систем, вы можете реализовать собственный анализатор для обработки вывода ls -l.
  • Адаптер поддерживает защиту FTP с помощью протокола SSL. Для защищенных операций применяются пассивные соединения.
  • В случае тайм-аута соединения FTP адаптер восстанавливает потерянное соединение. Если установить соединение невозможно, выполняется указанное число повторных попыток. Прерванные операции передачи файлов не продолжаются и требуют перезапуска.
  • В ходе исходящих операций create файлы создаются в промежуточном каталоге (если он существует). Затем они перемещаются в целевой каталог. Такой подход позволяет третьему приложению считать данные из файла до его окончательной записи. Кроме того, промежуточный каталог применяется операциями Append и Overwrite; указанный файл сначала копируется в промежуточный каталог (если он существует), затем обрабатывается и возвращается в целевой каталог. Если промежуточный каталог не существует, операция выполняется в целевом каталоге.

Условия использования |


(c) Copyright IBM Corporation 2005, 2006.
Справочная система Information Center создана с использованием технологии Eclipse (http://www.eclipse.org)