[Новости] [Вопросы] [Примеры] [Презентации] Мнения [О себе] [Ссылки] [Пермь] [Статистика] [Поиск]

Описание утилиты WebTools

Содержание:

• Назначение
• Настройка параметров
• Работа
• Последние изменения
• Заключительные замечания
• Скачать

Назначение:

Утилита WebTools написана мной для выполнения изменений на моём внешнем сайте и реализует функции FTP-клиента через http-proxy:8080, при этом используется wsDmur.ocx. Нужно отметить, что из-за ограничений, налагаемых http-proxy, не весь набор операций над данными на FTP-сервере поддержан. По существу возможны только: чтение, изменение и добавление файлов в существующие каталоги, в то время как операции создания новых каталогов, а также удаления файлов/каталогов недопустимы. Последние мне приходится выполнять используя инструментальные средства администрирования на моём Web-сервере. Основное назначение, к которому я стремился, это распознавание последних изменений в файлах, выполненных на локальном компьютере, и засылка только их (изменённых файлов) на внешний FTP-сервер, при этом размер файлов не должен превышать 1MB.

Если Вас интересует только закачка данных с внешних FTP-серверов через http-proxy:8080, то как надеюсь, утилита WebTools поможет Вам в этом, никаких ограничений на объём файлов в этом случае не налагается, а при обрыве соединений сервером, после успешной попытки повторного соединения, производится попытка докачки.

Приложение написано средствами MS VC++ 6.0 (MFC) и представляет собой MDI-приложение

Рис. 1 Приложение WebTools.

в котором может быть открыто произвольное количество документов, каждый из которых "связан" с адресом конкретного внешнего FTP-сервера.

Настройка параметров:
В начало

Для открытия нового документа и установки ему адреса внешнего FTP-сервера необходимо, при отсутствии каких-нибудь открытых файлов, вызвать диалог свойств "Application properties" (пункт меню Tools/Properties...)

Рис. 2  Диалог "Application properties" (General, Proxy).

и изменив http-команду (свойство Command) к Вашему http-proxy-серверу на требуемую, создать новый документ (пункт меню File/New). Обратите внимание, что если Ваш IP-адрес зарегистрирован на proxy-сервере, то никакие поля на закладке Proxy заполнять не требуется, в противном случае, следует определить UID и PWD для так называемой basic-авторизации на proxy-сервере. Назначение других свойств приведено в Таблице 1:

  Таб. 1 Назначение "Общих свойств приложения".

Относительно свойства Http-header нужно отметить, что строки, помещённые в качестве его значения, заносятся в http-заголовок сразу после команды (указанной в свойстве Command). В частности, этим свойством можно воспользоваться для авторизации на proxy-сервере, если по каким-либо причинам basic-авторизация Вас не устраивает. Более подробно см. в файле Readme wsDmur.ocx. Наконец, если Ваш FTP-сервер, также требует авторизованного доступа, то формат команды должен быть таким:
"GET ftp://UID:PWD@ftp_host.com/", где UID и PWD соответственно имя и пароль пользователя на Вашем FTP-сервере.

После создания файла все перечисленные свойства приложения становятся свойствами конкретного файла, и могут быть изменены, за исключением свойства Command. Если вызвать диалог свойств документа (пункт меню Tools/Properties...) при любом активном документе, то мы получим диалог изменения свойств именно этого документа.

В случае, если Вы предполагаете вносить изменения в файлы на Вашем FTP-сервере, то на закладке Location Вы должны установить соответствие между папками Вашего FTP-сервера и папками на локальных дисках Вашего компьютера, причём сделать это для каждой папки сервера:

Рис. 3  Диалог "Document properties" (Location).

При включенном флажке 'Reset All Subfolders' процесс определения месторасположения папок на локальном диске (Local Path) будет продолжен рекурсивно для всех подкаталогов, принадлежащих данному. По этому, в случае, когда структуры каталогов на FTP-сервере и на Вашем локальном диске совпадают, достаточно выполнить установку только для корневого каталога. Далее, предполагается, что в таким образом указанных папках на локальных дисках Вашего компьютера расположены именно те файлы (в соответствии с файлами на FTP-сервере) изменение которых Вы и предполагаете засылать на Ваш FTP-сервер. Проследите за тем, чтобы в отмеченных Вами каталогах была точная копия файлов Вашего внешнего FTP-сервера. С другой стороны, нужно отметить, что если Вы не предполагаете засылать изменения на FTP-сервер, то не следует определять значение свойств Local Path на закладке Location диалога "Document properties". Отсутствие значения свойства Local Path делает недоступными операции по изменению файлов как на локальных дисках, так и на FTP-сервере (см. Edit, Upload ниже).  

Информация о содержимом каталогов сервера/локального компьютера храниться в файлах с расширением wde, просмотр которых возможен из приложения WebTools без непосредственного обращения к серверу. Для регистрации в системном реестре расширения wde имеется небольшой файл: DocExtention.reg

REGEDIT
HKEY_CLASSES_ROOT\.wde = WebTools.Document
HKEY_CLASSES_ROOT\WebTools.Document = WebTools Doc
HKEY_CLASSES_ROOT\WebTools.Document\DefaultIcon = D:\Program Files\FtpClient\WebTools.exe,1
HKEY_CLASSES_ROOT\WebTools.Document\shell\open\command = D:\Program Files\FtpClient\WebTools.exe "%1"
HKEY_CLASSES_ROOT\WebTools.Document\shell\open\ddeexec = [open("%1")]

подправив пути в котором и зарегистрировав его в системном реестре, Вы сможете вызывать приложение WebTools двойным щелчком на файлах с расширением wde из Windows Explorer.

Работа:
В начало

Вся незамысловатая работа с приложением WebTools может быть рассказана путём объяснения ряда "не стандартных" пунктов  меню Tools (на Рис. 4 слева) и всплывающего меню, вызываемого по правой клавише мыши на правом окне документа (на Рис. 4 справа). 

Рис. 4 Пункты меню

Прежде всего, если в документе не устанавливалось соответствие между папками на FTP-сервере и каталогами на дисках локального компьютера, т.е. на закладке Location в окне свойств "Document properties" (см. выше), то ряд пунктов не будет доступными, к ним относятся:

  Таб. 2 Команды, обеспечивающие изменение данных на сервере.

Остальные пункты доступны почти всегда и означают:

  Таб. 3 Команды, обеспечивающие получение данных с сервера.

С каждым документом связан только один экземпляр wsDmur.ocx, обслуживающий его работу с сервером, поэтому будьте терпеливы в ожидании полного завершения любой команды обращения к серверу (Refresh Item, Open, Download; Upload all changed, Upload) прежде чем пытаться начать выполнять другую, однако, вполне допустима одновременная работа с разными документами.

При загрузки данных с сервера (Open, Download), анализируя содержимое очередного блока данных, полученных с сервера, в случае наличия в нём информации о длине данных в блоке, в нижней части окна документа появляется ProgressBar, и соответственно не появляется, в случае отсутствия подобной информации.

Рис. 5 Информация о процессе загрузки данных с сервера.

Здесь формат числовых данных, представленных в правой части, таков:
загружено / всего : процент_загруженного (количество_обрывов_соединения)

При засылке данных на FTP-сервер (Upload all changed, Upload) подобная информация никогда не предоставляется сервером. Все данные объединяются в один блок размером до 1MB, а в качестве результат мы получаем лишь уведомление о успешном (или неудачном) завершении попытки изменения данных на сервере.

Логика определения последних изменений не контролирует дату изменения файлов на сервере и опирается исключительно на дату последних изменений файлов на локальных дисках Вашего компьютера. Поэтому не требуется какого-либо согласования времени/даты сервера и Вашего компьютера, однако это делает невозможным внесение изменений с нескольких различных компьютеров на FTP-сервер на основании даты последних изменений.

Последние изменения:
В начало

Заключительные замечания:
В начало

• Все ограничения компоненты wsDmur.ocx (см. файл ReadMe.txt) также присущи и приложению WebTools. См. также назначение в данном описании... и среди важных это то, что не следует пытаться использовать данную утилиту, если Вы имеете прямой (не через http-proxy:8080) выход в Internet, поскольку работа с портом 21 (FTP) никак не поддержана.
• Из-за того, что я воспользовался MFC классом CMapWordToOb, общее количество элементов каталога одного документа (директорий + файлов) ограничено USHRT_MAX (0xffff), хочется надеяться, что это не является очень жёстким ограничением для большинства случаев.
• Есть опасения, что у некоторых proxy-серверов могут быть особенности в части http-формата каталога, возвращаемого ими. Во время написания мной использовался Squid 2.3.STABLE4, однако нет никакой уверенности в том, что это стандарт. Поэтому если у Вас другой proxy-сервер и никакого оглавления каталогов не выдаётся, пожалуйста, отправьте на мой e-mail рабочий файл, указанный у Вас в качестве значения свойства File Name.
• Думаю, что WebTools может успешно использоваться Вами и в случае, если Вам не требуется изменять данные на FTP-серверах непосредственно, однако часто приходится скачиваить данные с определённого множества FTP-серверов.
• Буду благодарен за уведомления меня об обнаруженных ошибках, которые, как надеюсь, будут мной устраняться по мере их обнаружения.
• Думы относительно расширения функциональных возможностей, конечно приветствуются также, однако не думаю, что могут быть быстро реализованы.

Скачать:

• Загрузить wsDmur.zip (44,3KB) (ver 2.0.0.6) см. также назначение wsDmur.ocx и примеры его использования
• Загрузить wbTools.zip (66,5KB) (ver. 2.0.6.3) Для использования, требуется загрузить и зарегистрировать wsDmur.ocx (пункт выше), конечно.
• Загрузить wbToolsm.zip (66,5KB) (ver. 2.0.6.4) Для использования, требуется загрузить и зарегистрировать wsDmur.ocx (см. выше), конечно.
• см. также замечание в начале стр. Примеры, относительно медленной скорости загрузки :-()

В начало

По вопросам, связанным с этим веб-узлом, обращайтесь по адресу: © Michael Drozdov, 2000-2005. Все права защищены. Последнее изменение страницы: Вт, 23 августа 2005