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

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

Содержание:

• Назначение
• Формат Script-файлов
• Настройка параметров
• Протокол выполненных изменений
• Заключительные замечания
• Скачать исходники

Назначение:

Проблема: Некоторые редакторы, например Microsoft® FrontPage Editor 3.0, умудряется форматировать исходный код скриптов, причем порой в результате, код перестаёт корректно выполняться (например, код известного счётчика http://SpyLOG.com) :-(... однако, другие его возможности (я имею ввиду FrontPage Editor) мне лично нравятся, и у меня нет желания отказаться от него только по этой причине.
Решение: Я не стал сильно разбираться: как именно нужно исправить Java-script код, чтобы устранить отмеченную выше особенность, а просто написал предлагаемую Вашему вниманию утилиту, которая выполняет замещение всех вставок Script-кода в html-файлах указанного каталога (и во всех подкаталогах) на код из указанных Script-файлов. Кроме этого, мне показалось, что подобная утилита может быть полезна, не только для преодоления отмеченной проблемы...

Формат Script-файлов:
В начало

Для того, чтобы Script-код был однозначно распознаваемый в html-файлах он должен быть заключён в уникальные для него маркеры начала/конца кода. Соответственно эти же маркеры, должны быть помещены и в код соответствующих script-файлов. Чтобы не городить огород, легче всего просто поместить в такие маркеры названия Script-файлов, содержащих исходный код. Например:

Файл: MainPageCounter.js

<!-- MainPageCounter.js begin -->
  <!-- SpyLOG v.... -->
  .... здесь собственно script-код
  <!-- SpyLOG -->
<!-- MainPageCounter.js end -->

здесь жирным шрифтом выделены маркеры соответственно начала и конца script-кода, также обратите внимание, что:

• маркеры начала и конца отличаются друг от друга (т.е. каждый уникальный)
• маркеры начинаются с первой позиции, в то время как заключённый в них код, по крайней мере не с первой. (это упростило процедуру распознавания маркеров в файлах скриптов..., и если это Вам не нравится, Вы можете усложнить это настолько, насколько позволит Вам Ваша фантазия, перепрограммировав приводимый мной исходный код на MS VC++ 6.0 :-)
• наконец, script не может быть вложенным :-( я имею ввиду, что он не должен содержать script-код, определённым в каком-нибудь другом script-файле).   

Другими словами, первая строка script-файла, содержащая символ '<' в первой позиции интерпретируется как строка, содержащая маркер начала, и аналогично последняя строка с символом '<' в первой позиции - маркер конца. Надеюсь, для скриптов это не столь уж сильные ограничения :-)

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

Изначально, я не собирался создавать какой-либо интерфейс для редактирования настроечных параметров этой утилиты, однако подумал, что в нашем изменяющемся мире это не помешает :-) поэтому используя средства MFC VC++ 6.0 я всё-таки это сделал. При этом, я использовал контролы, поставляемые с VS 6.0+SP4, и если у Вас это не так, то опять же, Вы можете воспользоваться исходным кодом на MS VC++ 6.0, чтобы настроить его на то, что Вы имеете...

Итак, вся настройка уместилась в одно окно свойств на двух его закладках: Source и Scriprs. На закладке Source, определяется месторасположение (Folder) и расширения файлов (Extensions), в которых требуется выполнять замещение script-кода, а также можно установить/отменить режим поиска таких файлов во всех подкаталогах (Include subfolders). 

Pic 1. Replacer properties: Source

На закладке Scriprs, Вы можете редактировать список Ваших script-файлов, код которых и будет вставлен, заменяя "испорченный код" в исходных файлах, указанных на закладке Source. 

Pic 2. Replacer properties: Scripts

т.е. здесь Вы можете:

• Добавить новый script-файл в список (пункт меню: Add...), из стандартного диалога Open File, указав любой файл с расширением js или vbs (ожидаемый формат таких файлов описан выше в разделе Формат  Script-файлов ), при этом автоматически будут определены все его свойства: File, Begin, End, Path: Название файла, Маркер Начала скрипта, Маркер Конца скрипта, Каталог месторасположения.
• Изменить выделенный script-файл (пункт меню: Replace...), указанный Вами файл заменит выделенный в списке script-файл.
• Удалить выделенный script-файл из списка (пункт меню: Delete).
• Обновить все script-файлы (пункт меню: UpdateAll). Анализируя каждый файл в списке, будут изменены Маркеры Начала/Конца кода скрипта, если будет обнаружено их несоответствия, а также будут удалены из списка те script-файлы, который не будут найдены на диске.    

И это вся настройка..., следует также сказать, что вся текущая информация храниться в системном реестре, ключ к которой надеюсь виден на следующем рисунке:

Pic 3. System Regestry Key

... и опять, если Вас это не устраивает измените соответствующий VC++ код... :-)

Протокол выполненных изменений:
В начало

Наконец, выполнив пункт меню Options\Update (и если ничего не произойдёт непредвиденного), Вы получите протокол выполненных изменений:

Здесь отображается информация следующим образом:

• без отступа - текущий каталог
• один шаг отступу - файлы (Source), в которых выполнялся поиск script-кода
• два шага отступа - script-файлы, кодом которых были заменены вхождения script-кода в исходных файлах (Source)   

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

• Эту утилиту я написал для себя и выставил её исключительно только в надежде, что она кому-нибудь ещё поможет...
• Я использовал MS VC++ 6.0 и Controls  из поставки SP4 для VS 6.0, если этого у Вас нет,  см. Visual Studio® 6.0 Service Pack 4 (SP4) на http://msdn.microsoft.com/vstudio/sp/vs6sp4/default.asp - SP4 - включает собрание всех предыдущих пакетов (SP3, SP2 и SP1) и рекомендуется для всех инструментальных средств, входящих в Visual Studio 6.0. ... и если, по каким-либо причинам Вам это не достать, что ж, придётся залезть в код :-( ... и если Вы будите вынуждены сделать, не удивляётесь помеси: MFC+STL (просто местами MFC меня достал :-)
• В идеальных условиях у меня это работает (я имею ввиду: нет захваченных на запись обрабатываемых файлов и т.д.), и обработка ошибок в том виде как есть, много оставляет желать лучшего... :-) Поэтому не стремитесь испытать на прочность мной написанный код, скорее всего это ничего не даст кроме огорчения :-)
• Наконец, буду рад любым пожеланиям на улучшения, если конечно они не потребуют неразумных временных затрат на реализацию :-)

Прежде чем скачивать исходники, внимательно прочтите Заключительные замечания Скачать исходники [119KB]

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