Создание DLL с Web-ресурсами

Появление в палитре компонентов Borland C++ Builder компонента TCppWebBrowser и компонента TWebBrowser в палитре компонентов Borland Delphi открыло для программистов этих двух сред возможности использования функциональности Internet Explorer'а в прикладных программах. В совокупности со средствами HTML-редакторов, TCppWebBrowser (TWebBrowser) позволяет с легкостью создавать автономные продукты, базируемые на технологии Web-дизайна, отличающиеся не только быстротой и качественностью написания, но и современным интерфейсом. Однако, самым неприятным фактом в использовании данного компонента при написании локального программного продукта, каковым могут быть, например, мультимедийная энциклопедия либо интерактивный учебник, является необходимость наличия отображаемых HTML-страниц, являющихся частью самой программы. Явное их присутствие в открытом виде на дистрибутивах или в уже установленном состоянии на жестких дисках вызывает непреодолимое желание любознательного пользователя заняться их самостоятельным редактированием и некоторое чувство незаконченности процесса создания продукта у самого программиста. Самыми простым и легким способом решения подобной проблемы является помещение служебной информации программы (Web-страниц) в ресурсы DLL.

Широко известен тот факт, что интерфейс Windows насквозь пропитан окнами отображения, аналогичными по функциональности окну, находящемуся в клиентской области Internet Explorer. Тем не менее, в открытом виде это явление практически незаметно глазу обычного пользователя. И уж совсем немногие знают, что некоторые элементы панели управления Windows напрямую выполнены в виде Web-страниц. В частности, элемент панели управления под названием "Установка и удаление программ" исполняется именно в таком виде, начиная с версий Windows ME и Windows 2000. Возникает вполне закономерный вопрос: где же Windows хранит содержимое этих страниц?

Скрупулезное исследование системного каталога даёт ответ на данный вопрос. Web-страницы, используемые интерфейсом Windows, хранятся в виде обычных ресурсов библиотек DLL. К примеру, попытка установления связи в Internet Explorer с недоступным адресом приводит к отображению в окне IE страницы, содержащей соответствующую информацию. Данная страница представлена ресурсом DNSERROR.HTM файла shdoclc.dll, убедиться в чем можно при помощи любого редактора ресурсов (Resource Workshop, Resource Scrutator и т.п.). Таким образом, становится очевидным, что Internet Explorer (а, следовательно, TCppWebBrowser и TWebBrowser аналогично) имеет возможность использования ресурсов, содержащихся в библиотеках DLL.

В прилагаемых к статье архивах содержится весь описанный в ней инструментарий и пример готовой DataBank.dll.

Архив Initial.zip содержит промежуточный объектный файл DataBank.obj будущей библиотеки, файл сценария ресурсов DataBank.rc и компилируемый из него двоичный файл ресурсов DataBank.res. Кроме того, в данный архив включены файлы, непосредственно помещаемые в качестве ресурсов в библиотеку: Header.gif, Return.gif, Back.jpg, Index.htm, Mainpage.htm, Page.htm и Top.htm.

Архив Tools.zip содержит весь инструментарий, необходимый для компиляции и линковки библиотеки DLL. В него входят компилятор ресурсов BRCC32.EXE, линкер ILINK32.EXE, необходимые для их корректной работы файлы UUID.LIB, LNKDFM60.DLL, RLINK32.DLL, RW32CORE.DLL, а также пакетный файл BuildAll.bat, содержащий командные строки для работы с компилятором ресурсов и линкером. Данный инструментарий в обязательно должен входить в поставки Borland C++ Builder и Borland Delphi любых версий, но, возможно, с именами, отличными от имен прилагаемых в архивах файлов.

Архив Results.zip содержит конечный результат работы - библиотеку ресурсов DataBank.dll. Кроме этого, в данный архив включен файл URL.txt с примером адреса головной страницы ресурса данной библиотеки для Internet Explorer , с учетом того, что DataBank.dll предположительно расположен в директории C:\IEnDLL.

Архив DllSymChanger.zip содержит созданную мной программу DllSymChanger.exe, облегчающую процесс замены символов, необходимый для функционирования библиотеки DLL.

Содержимое архивов автономно от наличия или отсутствия на компьютере пользователя установленных версий BCB и Delphi, его работа проверена на машине с абсолютно "свежей" Windows 98 SE.

Вспомнив классическое (не-RAD) программирование с присущим ему "ручным" созданием файла сценария ресурсов, приходим к выводу, что это - как раз то, что нам нужно. Иными словами, нас интересует возможность создания некоторой DLL, в составе которой находились бы ресурсы с требуемыми нам, в конечном счете, HTM-страницами.

В процессе создания исполняемого файла для среды Windows, файлы с исходными текстами приложения компилируются в объектные модули OBJ. Затем редактор связей собирает из объектных модулей промежуточный вариант загрузочного модуля, не содержащий ресурсов. При этом используется файл определения модуля DEF. Текстовый файл сценария ресурсов RC и файлы, непосредственно содержащие требуемые ресурсы, компилируются в двоичный файл RES. На последней стадии формирования загрузочного модуля, его промежуточный вариант собирается с файлом ресурсов для получения окончательного исполняемого файла. Следовательно, для создания DLL ресурсов нам потребуется пройти все эти стадии. Но, чтобы облегчить задачу и всегда пропускать (по нескольким причинам) в будущем первый этап, я самостоятельно создал требуемый объектный файл будущей библиотеки. Сделано это было следующим образом: в BCB6 создаем новый проект DLL, отключаем в мастере создания возможность использования VCL, отключаем в опциях проекта использование пакеджей времени выполнения и использование RTL, и собираем (строим) проект. Из всего, что было создано BCB в каталоге проекта, нас интересует единственный файл. В прилагаемом архиве Initial.zip этот файл носит название DataBank.obj, который, собственно, и являлся бы результатом выполнения первых двух этапов действий, необходимых для создания требуемой DLL. (В случае, если у читателя возникнет желание самостоятельно проверить целесообразность предложенного мной подхода, он может самостоятельно написать текст программы, текст заголовочного файла программы, текст DEF-файла, скопировать в каталог примера H- и LIB-файлы, необходимые для компиляции, и, непосредственно, компилятор кода BCC32.EXE). Название OBJ-файла не имеет никакого значения, так как в дальнейшем из этого файла будет образован конечный файл библиотеки ресурсов с тем именем, которое пользователь может назначить либо при сборке, либо просто переименовать созданный им файл DLL (тем более, что в теле этой библиотеки ее имя нигде не присутствует).

На следующем этапе нам необходимо получить компилированный файл ресурсов, которые будут включены в нашу DLL. Для этого необходимы непосредственно сами ресурсы (HTM-страницы) и файл сценария ресурсов (в нашем случае он носит имя DataBank.rc).

В прилагаемом архиве Initial.zip в виде примера рассмотрено создание DLL с размещенными внутри связанными Web-страницами. Файлы, представляющие эти страницы, носят следующие имена: Index.htm, Mainpage.htm, Page.htm, Top.htm, Header.gif, Return.gif, Back.jpg. Далее следуют три необходимых требования, предъявляемых для правильного функционирования IE внутри создаваемой DLL:

Все файлы, участвующие в работе Web-страниц должны находиться в одной директории; Все ссылки в Web-страницах должны быть относительными; Имя ни одного из файлов, используемых в Web-страницах, не должно содержать символов подчеркивания. Имена файлов должны состоять из набора символов A…Z и 0…9. Имена файлов не должны начинаться с цифр. При несоблюдении первого требования, пользователь просто не сможет разместить файлы внутри DLL в соответствии с их начальным положением. Следовательно, в ссылках HTM-документов изначально будут указаны несуществующие объекты.

При несоблюдении второго требования (при использовании абсолютных ссылок), IE будет пытаться отыскать указанные объекты с использованием абсолютного адреса (в данном случае - пути расположения файла), что в корне неверно. Впрочем, использование относительных ссылок само по себе является нормальной практикой Web-программирования.

Несоблюдение третьего требования в области использования символа подчеркивания не является критичным и будет рассмотрено ниже. Остальные же части третьего требования должны соблюдаться. Связано это с тем, что имена ресурсов при компиляции RES-файла должны подчиняться правилам задания идентификаторов языка C, нарушение которых приводит к ошибкам в процессе компиляции файла сценария ресурсов в двоичный файл ресурсов.

Итак, после размещения Web-объектов в директории компиляции, мы должны создать файл сценария ресурсов, носящий расширение RC. В примере этот файл имеет название DataBank.rc. Он создается в любом текстовом редакторе и сохраняется в виде обычного текста. Каждая из строк данного файла состоит из имени ресурса, типа ресурса и файла, представляющего данный ресурс. Поскольку в ссылках используемых нами Web-страниц мы указываем имена файлов, содержащих Web-объекты, необходимо каждому ресурсу присвоить имя, соответствующее имени Web-объекта. Вот здесь и возникает основная сложность. Дело в том, что если именам ресурсов мы присвоим имена файлов ресурсов (то есть в имени ресурса поставим в соответствующем месте точку), то при компиляции RES-файла будет получено сообщение об ошибке:

Expecting resource name or resource type name

Для решения данной проблемы, вместо точки, разделяющей "имя" ресурса и его "расширение", мы используем символ подчеркивания - единственный символ, не являющийся цифрой или латинской буквой и разрешенный при создании имени ресурса. Как нетрудно догадаться, конечный файл DLL будет содержать ресурсы с именами, разделенными символом подчеркивания, который, для работоспособности DLL придется заменять точкой. Но об этом - позже.

Вторым элементом строки описания ресурса является имя типа ресурса. Если мы будем применять для назначения нашим ресурсам предопределенный произвольный тип RCDATA, компиляция и сборка DLL пройдут, ресурсы будет корректно вызываться из библиотеки любыми прикладными программами как ресурсы, но IE откажется обрабатывать их таким образом, как нам необходимо. Точно то же самое произойдет, если мы присвоим ресурсам страниц любой другой произвольный тип. То есть, у меня существовала определенная надежда, что IE будет рассматривать типы сгруппированных ресурсов как своеобразные поддиректории, что было бы совсем неплохо для систематизации иерархии взаимосвязей между логическими группами страниц, но разработчики IE, видимо, придерживаются иного мнения на этот счет. Таким образом, если мы присвоим типу ресурса имя, например, PAGEAREA или какое-либо другое, включая и RCDATA, после завершающей обработки библиотеки IE все равно откажется воспринимать Web-страницы в виде Web-страниц. Решение в этой тупиковой ситуации подсказывает изучение структуры системой библиотеки shdoclc.dll. Все страницы, расположенные в его ресурсах, принадлежат двум типам, имена которых являются не строковыми, а целочисленными идентификаторами. Для задания целочисленных типов ресурсов, в строке файла сценария ресурсов необходимо целочисленные значения идентификаторов заключить в круглые скобки. В противном случае, компилятор ресурсов воспримет их как строковые идентификаторы.

Третьим элементом строки описания ресурса является имя файла страницы. Оно может быть указано просто в виде подстроки, либо заключено в двойные кавычки. Излишне говорить, что все используемые в создании DLL файлы при таком способе работы должны находиться в одной директории диска. Это касается как всех служебных файлов проекта, так и всех файлов, помещаемых в ресурсы.

В конечном виде строка, описывающая присоединение страницы index.htm к ресурсам будущей библиотеки, выглядит так:

index_htm (23) index.htm

После того, как создан файл сценария ресурсов, необходимо провести его компиляцию. Для этого воспользуемся компилятором ресурсов командной строки BRCC32.EXE, входящим в состав BCB6. Взглянув на название файла компилятора, видим, что результатом его работы станет 32-разрядный двоичный файл ресурсов (по крайней мере, если не использовать дополнительных опций командной строки). Теоретически, можно воспользоваться различными 16-разрядными компиляторами (RC.EXE, BRCC.EXE и т.п.) и мы достигнем намеченного результата, но, так как далее нами будет использоваться 32-разрядный линкер, рекомендую пользоваться именно 32-разрядным компилятором ресурсов. Запуск компилятора ресурсов производится из командной строки, которая включает в себя непосредственно имя файла компилятора ресурсов и имя файла сценария ресурсов:

brcc32 DataBank.rc

При работе BRCC32.EXE вызывает библиотеку RW32CORE.DLL. В процессе компиляции на экране появится строка с названием компилятора и строка с указанием принадлежности авторских прав на него. Если компиляция пройдет удачно, никаких дополнительных сообщений не появится, и в директории проекта появится двоичный файл ресурсов DataBank.res. Если в процессе компиляции произойдет ошибка, появится соответствующее сообщение, и двоичный файл ресурсов создан не будет.

Следующим шагом в создании DLL является сборка библиотеки из объектного файла DataBank.obj и двоичного файла ресурсов DataBank.res. Для этой цели воспользуемся линкером ILINK32.EXE, вызывающий в свою очередь библиотеки RLINK32.DLL и LNKDFM60.DLL и использующий файл UUID.LIB. Командная строка вызова линкера с параметрами выглядит следующим образом:

ilink32 DataBank.obj, DataBank.dll, , , , DataBank.res

Будьте внимательны и не ошибитесь с количеством запятых при наборе командной строки. Мы видим, что в командной строке указано имя объектного файла, имя двоичного файла ресурсов и конечное имя библиотеки. Если в качестве создаваемого модуля указать не DataBank.dll, а, например, MMedia.dll, то именно MMedia.dll и будет создан. В процессе сборки выводится строка с названием линкера и строка с указанием принадлежности авторских прав на него. Кроме того, при компиляции именно с этим комплектом служебных файлов, будет выводиться следующее предупреждение:

Warning: Image linked as an executable, but with a .DLL or .BPL extension

Это связано с отсутствием DEF-файла, но, тем не менее, на корректность содержимого библиотеки не влияет. В процессе сборки линкером будут созданы файлы с именем результирующего модуля и расширениями TDS, MAP, ILC, ILD, ILF, ILS которые можно безболезненно удалить.

Библиотека с ресурсами Web-элементов создана.

Если бы мы воспользовались 16-разрядным линкером (например, LINK.EXE), то в результате мы получили бы корректную 16-разрядную DLL, но IE отказался бы работать с ней, выдав соответствующее сообщение.

Предположим, что DataBank.dll имеет следующий путь:

C:\IEnDLL\DataBank.dll

Если мы запустим IE и в строке URL введем

res://C:\IEnDLL\DataBank.dll/INDEX_HTM

Internet Explorer найдет ресурс INDEX_HTM расположенный в DataBank.dll, но не сможет правильно определить ожидаемых от него действий, поскольку имя идентификатора ресурса воспринимается IE как имя файла без расширения.

На этом этапе работа по созданию DLL принимает "шаманский" оборот. Мы сталкиваемся с ситуацией, когда Internet Explorer отказывается корректно воспринимать ресурс без "расширения", а компилятор ресурсов отказывается включать в идентификатор ресурса символ точки. Теперь необходимо вооружиться каким-либо Bin-редактором и "руками" аккуратно заменить символы подчеркивания в заголовке библиотеки точками, не изменяя размера файла. Для этого подходит любой Bin-редактор (UltraEdit, WinHex и т.п.), но я лично воспользовался FAR "по F4". Искать строку "INDEX_HTM" в файле бесполезно, так как еще на этапе компиляции двоичного файла ресурсов из-за его 32-разрядной природы между каждой парой символов идентификатора были помещены символы со значением 0x00. Заменив в заголовке библиотеки соответствующие символы подчеркивания точками и сохранив файл, получаем именно такую DLL, ради которой и были предприняты все вышеперечисленные действия. Для облегчения этого процесса в прилагаемый архив DllSymChanger.zip помещена написанная мной программа DllSymChanger.exe, открывающая файл RC и производящая замены символов подчеркивания точками в одноименном файле DLL, находящемся в той же директории.

Теперь осталось запустить IE и в строке URL ввести

res://C:\IEnDLL\DataBank.dll/INDEX.HTM

Основная задача выполнена полностью.

Стоит заметить, что при выполнении ссылок внутри библиотеки, IE действует как при выполнении ссылок в директории диска.

Таким образом, при создании DLL можно использовать любые Web-объекты, интерпретируемые IE (звук, видео, VRML и т.д.).

Данный предложенный мною способ, открывает большие возможности для программистов в использовании компонента TCppWebBrowser (TWebBrowser) вкупе с достаточной защищенностью служебных данных программного продукта.

Вот и всё, Удачи!