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

Компонент NMFTP представляет собой клиентскую сущность, но может использоваться серверными модулями для загрузки файлов и получения информации о содержимом других FTP-серверов.

Для того чтобы использовать компонент NMFTP, необходимо поместить его в форму, в случае визуального приложения, либо в Data Module,в случае не-визульного. После этого задаются параметры FTP-сервера. Как обычно, это либо имя в DNS, либо IP-адрес и порт, на котором работает данный компонент. Если вы создаете программу общего назначения, безотносительно к самому FTP-серверу и пользователю, который будет с ней работать, то необходимо предусмотреть возможность указания имени пользователя и пароля.

Перед передачей на выполнение FTP-серверу каких-либо команд, следует вызвать метод Connect.

Если нужно получать информацию о содержимом папок, то вызывается метод Niist. После того можно считывать названия файлов и папок путем обращения к свойству FTPDirectoryList.name[n], где п — номер позиции файла или каталога в полученном списке. Для перехода к нужному каталогу вызывается метод changeDir, в параметре которого должно содержаться название этого каталога. Вслед за изменением текущего каталога, необходимо вызвать метод Niist.

Использование команды Niist, по сравнению с List, существенно сокращает время загрузки информации о содержимом каталога, но если нужно работать с полным описанием файлов, то придется обращаться к методу List.

Желательно все операции взаимодействия с FTP-сервером помещать в защищенные блоки try... except... finally. Это обезопасит программу от "зависания" в том случае, когда, например, пользователь пытается прочитать содержимое папки, которую системный администратор открыл только для ограниченного круга лиц, куда не входит пользователь программы. В особенности это касается процессов записи файлов на сервер, когда, даже при наличии прав чтения, пользователю может быть запрещено загружать файлы.

Для загрузки файлов с сервера пользуются методом Download. Этот метод полностью берет на себя задачу по закачиванию информации с сервера на компьютер клиента. Если во время загрузки произошла ошибка, например, вследствие отключения клиента от сети Интернет, или превышения времени ожидания сервера, из-за его чрезмерной загруженности, то принятая информация не теряется. Она сохраняется в целевом файле. Возникновение такой ситуации следует отслеживать с использованием события OnFaiiure.

Данный компонент предусматривает возможность восстановления процесса загрузки файла не сначала, а с того места, где произошел обрыв. Для этого вызывается метод DownioadRestore. Главное при вызове этого метода, чтобы на диске уже был сохранен фрагмент целевого файла. На использовании такого механизма и основано действие многочисленных программ загрузки файлов. Если необходимо информировать клиента о ходе и скорости загрузки файлов, времени, которое осталось ждать, то можно пользоваться свойством BytesRecvd. Разумеется, при отслеживании размера принятого фрагмента файла необходимо из текущего значения этого поля вычесть начальное, т. е. существовавшее в момент запроса на выполнение загрузки.

Аналогичным образом организован обратный процесс — загрузка файлов с компьютера пользователя на сервер. Тем не менее, следует учитывать отличие в вызове функции восстановления этого процесса — uploadRestore. Необходимо отслеживать, сколько байтов уже было отправлено с тем, чтобы сервер мог определять текущую позицию записи и указывать ее в качестве третьего параметра вызова этой процедуры.

Следует отметить, что компонент NMFTP, как и следующий, удобно использовать в программах, которые планируется применять в локальных сетях, подключенных к сети Интернет через прокси-сервер. Для этого, следует просто заполнить соответствующие поля данного компонента.

Работа с HTTP-сервером — компонент NMHTTP

Пиктограмма компонента NMHTTP приведена на рис. П1.4.

Рис П1.4. Значок компонента NMHTTP

Дата добавления: 2014-12-29