ПРИЛОЖЕНИЕ 1

Описание некоторых компонентов клиент-серверной версии Delphi

• Вкладка FaslNel
• Получение точного времени — компонент NMDayTime
• Обмен сообщениями между компонентами сетевых программ
• Компонент NMMsg
• Компонент NMMsgServ
• Работа с FTP-сервером — компонент NMFTP
• Работа с HTTP-сервером — компонент NMHTTP
• Работа с сервером новостей — компонент NMNNTP
• Работа с серверами электронной почты
• Получение почтовых сообщений — компонент NMPOP3
• Компонент NMSMTP
• Кодирование и декодирование данных, посылаемых в запросах — компонент NMURL
• Кодирование и декодирование файлов, передаваемых посредством Интернета — компонент NMUUProcessor
• Работа с обобщенным сокетом — компонент PowerSock
• Вкладка Internet
• Компонент WebBrowser

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

Вкладка Fast Net

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

Замечание

Эта вкладка была создана не самой корпорацией Inprise, а сторонним производителем — фирмой NetMasters L.L.C.

Получение точного времени — компонент NMDayTime

Значок компонента NMDayTime изображен на рис. П1.1.

Назначение

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

Рис. П1.1.КомпонентNMDayTime

Поскольку очень часто разные процессы, которые запускаются на разных машинах, представляют собой последовательную обработку одних и тех же данных, то отсутствие синхронизации часов может привести к неверной работе системы в целом. В Интернете присутствуют серверы, которые "раздают" точное время. Они, в свою очередь, синхронизированы с государственными и международными эталонами, что исключает возможность отставания или, наоборот, опережения часов по отношению к стандартам. Многие из таких серверов можно найти в Интернете с помощью поисковых систем. Кроме того, в демонстрационном примере компонента NMTime, прилагающегося к Delphi и описанного ниже, есть большой список серверов, которые в числе прочих служб обеспечивают доступ к точному времени.

Свойства

Свойства данного компонента, как и многих других, представляют собой богатый набор, которым редко приходится пользоваться в полном объеме. Наиболее важные из них рассмотрим в табл. П1.1.

Таблица П1.1.Некоторые свойства объекта NMDayTime

Методы

Методы объектов данного класса целиком унаследованы от класса TPowerSock, предназначенного для работы с сокетами. Описание этого компонента представлено ниже.

Рекомендации по использованию

Для использования данного компонента необходимо как минимум установить параметры сервера — имя или IP-адрес и порт, на котором работает служба предоставления времени. После этого можно затребовать время путем обращения к свойству DayTimestr. Следует отметить, что формат представления данных времени может зависеть от конкретного сервера, и поэтому свойство DayTimestr представлено строковым типом данных. При практическом использовании компонента необходимо сначала проверить, в каком именно формате работает применяемый сервер.

Кроме того, следует заметить, что Интернет не является системой, работающей в режиме реального времени. Это значит, что существует временная задержка между временем отправки запроса и получения ответа. Причем эта разница сильно зависит от загруженности канала связи и самого сервера, обрабатывающего запрос. Для того, чтобы добиваться очень точной установки времени, необходимо синхронизировать время в часы, когда канал вашего провайдера максимально разгружен (обычно это 4—5 часов утра). Кроме того, можно устанавливать некоторую разностную временную величину получения отклика, по истечении которой ответ будет считаться не точным. При получении ответа за время, меньшее этой величины, можно еще увеличить точность, путем нахождения срока обработки запроса. Если считать, что время доставки запроса и ответа одинаково (в большинстве случаев — это так, за исключением варианта спутникового соединения, в котором, как правило, отклик сервера доставляется намного быстрее), то получить практически точное показание часов можно при вычетании половины времени получения ответа и введении поправки на нее.

Пример

Для примера выберем сервер Национального института стандартов и технологий (National Institute of Standards and Technology), который является государственным учреждением США. Прежде чем начинать разработку приложения, необходимо уточнить параметры этого сервера. Описание службы DateTime находится по адресу www.boulder.nist.gov/timefreq/service/its.htm.На этой странице можно прочитать и о формате предоставления времени, и о параметрах сервера.

Приведем здесь описание формата предоставления времени с целью последующего его анализа в примере.

Описание используемого сервера времени

Строка, передаваемая клиенту и содержащая время и дату, имеет вид:

JJJJJ YR-MO-DA HH:MM:SS TT L H msADV UTC(NIST) OTM

где:

•  JJJJJ — число, с помощью которого находится текущий день с начала отсчета Юлианского календаря, по которому мы отсчитываем в настоящее время дату. Делается это путем прибавления к текущему числу 2.4 миллиона;
•  YR-MO-DA — три числа, разделенные знаком, которые являются соответственно двумя последними цифрами в номере года, номером текущего месяца и датой;
•  HH:MM:SS — час, минута и секунда, разделенные двоеточием;
•  TT— число, в котором закодирован текущий стандарт времени, по которому живут Соединенные Штаты Америки. Кроме того, здесь указывается число дней до перевода времени на зимний/летний стандарты;
•  L — число, которое идентифицирует состояние хода времени, когда одна секунда будет добавлена в текущем месяце (значение 1), отнята от последней минуты месяца (значение 2), либо сохранится (значение 0). Производится эта процедура периодически для того, чтобы однажды не получилось, что время полдня придется на нынешнюю полночь и, наоборот, из-за небольшого несоответствия нашего отсчета времени скорости вращения Земли;
•  H— код технического состояния сервера. В случае, когда все в порядке, он содержит 0. При возможном расхождении со стандартом времени на 5 секунд код содержит 1. При наличии серьезных проблем здесь присутствует значение 2;
•  msADV — число миллисекунд, которое создатели сервера советуют прибавить к времени, полученному от сервера, с целью компенсации сетевой задержки, описанной выше. Это число статично и равно 50 миллисекундам, поэтому не следует его воспринимать, как истину в последней инстанции. Рекомендуем вам определять погрешность времени по методике, описанной выше;
•  UTC(NIST) — метка, идентифицирующая "поставщика" времени;
•   OTM— метка *, подтверждающая точность полученного времени.

 Институт, который обеспечивает доступ к точному времени, поддерживает несколько серверов, список которых доступен по адресу www.boulder.nist.gov /timefreq/service/time-servers.html. Мы воспользуемся сервером time-a.nist.gov, которому соответствует IP-адрес 129.6.15.28. Служба времени установлена здесь на сетевом порту с номером 13.

Таким образом, все, что осталось сделать, — это получить строку, содержащую время, и раскодировать ее.

Постановка задачи и ее реализация

В данном примере реализуем следующие задачи:

• Получение данных о текущем времени от сервера.
•  Раскодирование этой информации.
•  Установка текущего времени в соответствии с полученными сведениями.

Для реализации поставленных задач создадим новый проект, поместим в форму компонент NMDateTime и кнопку Button. Из свойств первого изменим Host на time-a.nist.gov. Остальные параметры могут оставаться установленными по умолчанию. Сделайте на кнопке надпись "Установить время". Два раза щелкнув по ней в режиме проектирования, откройте заготовку для обработчика события Buttoniciick. В него следует вписать код, приведенный в листинге П1.1.

Листинг П1.1. Реализация процесса получения и установки времени 

procedure TForml.ButtonlClick(Sender: TObject);

var

newdatetime, localdatetime: tsystemtime;

currentzoneinfо: TTimeZonelnformation;

tmpstring: string;

timebefore, timeafter, delta: tdatetime;

begin

timebefore:=now;

tmpstring:=NMDayTimel.DayTimeStr;

delta:=(timeafter-timebefore)/2;

if Copy(tmpstring,29,1)='0' then

begin

newdatetime.wYear:=strtoint('20'+copy(tmpstring,8,2));

newdatetime.wMonth:=strtoint(copy(tmpstring,11,2));

newdatetime.wDay:=strtoint(copy(tmpstring,14,2));

newdatetime.wHour:=strtoint(copy(tmpstring,17,2});

newdatetime.wMinute:=strtoint(copy(tmpstring,20,2)) ;

newdatetime.wSecond:=(strtoint(copy(timetostr(delta) ,7,2))+

strtoint(copy(tmpstring,23,2))); GetTimeZonelnformation(currentzoneinfo); SystemTimeToTzSpecificLocalTime(@currentzoneinfo,

newdatetime,localdatetime); SetLocalTime(localdatetime);

end; 

end;

Рассмотрим несколько пояснений к приведенному коду.

Прежде чем получать данные от сервера, нужно выяснить текущее время, чтобы затем найти время выполнения запроса. После обращения к свойству NMDayTimel. DayTimeStr в переменную tmpstring помешается информация, полученная от сервера. Вслед за выполнением запроса, опять находится текущее время, а также вычисляется разность между ним и начальным. Половина этой разности и будет составлять поправку на осуществление запроса.

После того как искомая информация получена, необходимо ее декодировать и поместить в запись newdatetime. Поскольку сервер предоставляет время по международным стандартам, то также нужно сделать поправку на часовой пояс. Это осуществляет функция SystemTimeToTzSpecificLocalTime, вызываемая  через Windows API.

Последним этапом является вызов также API-функции setLocaiTime, выполняющей установку текущего времени.

Если данная программа выполняется на компьютере, с неустойчивым подсоединением к сети Интернет, то в ней следует обработать возникновение исключительных ситуаций.

Обмен сообщениями между компонентами сетевых программ

На вкладке FastNetимеется два компонента, специально предназначенных для обмена сообщения и файлами в масштабах локальных и глобальных сетей: NMMsg и NMMsgServ, пиктограммы которых представлены на рис. П1.2.

Рис. П1.2.Компоненты NMMsg и NMMsgServ

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

Компонент NMMsg

Назначение

Объекты класса NMMsg предназначены для выполнения следующих основных операций:

•  Установление связи с компьютером, выполняющим роль сервера в данном обмене информацией, на котором работает программа с активизированным и соответствующим образом настроенным компонентом NMMsgServ.
•  Отправка следующих данных: простой текст, содержимое потока, файлы.
•   Получение данных в текстовые переменные, в поток, запись их в файл.

Обратите внимание, что в отличие от обмена данными с помощью компонентов Delphi clientsocket и serverSocket, в данной паре компонентов для работы с файлами не нужно создавать потоки, ассоциированные с ними. Достаточно указать имя файла, и путь к нему, если файл размещен в каталоге, отличном от текущего.

Свойства

Следует отметить, что как и в компоненте NMDateTime, практически все свойства объектов класса ыммзд унаследованы от класса TPowerSock. Основные из них приведены в табл. П1.2.

Таблица П1.2.Важнейшие свойства объекта тмзд

Методы

Компонент NMMsg содержит набор методов, наиболее важные из которых представлены в табл. П1.З.

Таблица П1.3.Ключевые методы объекта NMMsg

События

Для объекта NMMsg возникновение события демонстрирует состояние сокетного соединения, а его обработка используется для выполнения тех или иных операций, требующих соответствующего состояния. Например, читать данные, которые прислал сервер, имеет смысл тогда, и только тогда, когда сервер прислал некие данные. Наиболее важные события этого компонента представлены в табл. П1.4.

Таблица П1.4.События объекта NMMsg

Рекомендации по использованию

Данный компонент работает в паре с объектом NmsgServ. Серверный компонент, разумеется, может сочетаться с клиентским в одном приложении, все зависит от рода выполняемых задач.

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

Чтобы создать клиента, необходимо компонент NMMsgServ поместить или в форму (в случае визуального приложения) или в Data Module,выполняющий роль контейнера невизуальных объектов. После этого нужно, как минимум, сделать следующее:

•  Определить все параметры сервера: IP-адрес или его имя, сетевой порт, на котором работает серверный компонент.
•  Вызвать наиболее удобный метод отправки сообщения. Как видим, существуют различные методы, к которым можно прибегнуть для отправки данных. Программисту предоставлена свобода выбора самого подходящего.

Вызов метода отправки или приема сообщения должен происходить только в случае, когда объект NMMsg готов его обработать. Это значит, что операторы, выполняющие те или иные действия, необходимо помещать в процедуры обработки событий. Таким образом, например, в ответ на появление события onConnect, можно вызвать метод Postit, или после возникновения события OnPacketRecvd прочитать в переменную полученные данные.

Компонент NMMsgServ Назначение

Представляет собой серверную часть системы обмена данными, предоставляемой компонентами ыммзд и NMMsgServ.

Компонент NMMsgServ имеет следующие основные функции.

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

Свойства

Свойства данного объекта, будучи по большей части унаследованы от объекта PowerSock, аналогичны ему и объекту ыммзд, но поскольку речь идет о серверной реализации, то важнейшие из них имеют свою специфику. Прежде всего, нужно настраивать локальные параметры, важнейшим из которых является номер сетевого порта. Свойства компонента NMMsgServ представлены в табл. П1.5.

Таблица П1.5.Важнейшие из свойств объекта NMMsgServ

Методы

Поскольку действия, реализуемые компонентами ыммзд и NMMsgServ в вопросах отправки и приема сообщений одинаковы, то и методы тоже одинаковы. Исключение составляет метод Listen, который вызывается достаточно редко. Дело в том, что объект NMMsgServ сразу при запуске программы начинает опрашивать порты, и поэтому искусственно вызвать его, как правило, не имеет смысла.

Для получения информации о методах данного объекта, касающихся приема/отправки информации, загляните в предыдущий раздел.

События

События, которые возникают у объектов класса NMMsgServ, представлены в табл. П1.6.

Таблица П1.6.События объекта NWsgServ

Рекомендации по использованию

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

После того как загружена программа, которая содержит компонент NMMsgServ, начинается мониторинг соответствующего сетевого порта. В связи с подсоединением клиента, получением от него данных, возникают различные события, которые нужно обрабатывать с целью обеспечения взаимодействия с ним.

Работа с FTP-сервером — компонент NMFTP

Пиктограмма компонента NMFTP представлена на рис. П1.З.

Рис. П1.3.Значок компонента NMFTP

Назначение

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

Свойства

Свойства компонента NMFTP собраны в табл. П1.7.

Таблица П1.7.Свойства компонента NMFTP

Следует отметить, что существует несколько вариантов аутентификации на FTP-сервере. Первый заключается в том, что администратор ресурса создает определенный список пользователей, которым доступен этот сервер. Данный вариант организации доступа подразумевает явное указание имени пользователя и пароля при входе на сервер. Второй вариант предусматривает возможность входа на сервер всех желающих, без указания каких бы то ни было учетных данных. Последний вариант является в некотором роде промежуточным. В нем пользователь в качестве параметра userio указывает слово anonymous, а в пароле — свой электронный адрес. Разумеется, права доступа к содержимому FTP-сервера определяются системным администратором ресурса.

Тип TFTPDirectoryList

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

Этот объект представляет собой несколько наборов строк, организованных по типу TStringList. Возможен доступ к следующим свойствам этого объекта:

•  Attribute. Набор строк, в котором содержатся атрибуты конкретных позиций содержимого каталога (файлов или папок).
•  ModifDate. В данном строковом массиве находятся даты модификации позиций каталога.
•  Name. Массив имен содержимого каталога.
•  size. Строковый массив, содержащий размеры позиций каталога.

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

Например, для получения доступа к имени первого элемента в списке элементов данного каталога нужно обратиться к свойству name[0].

Методы

Возвращаясь к описанию компонента NMFTP, приведем в табл. П1.8 его основные методы.

Таблица П1.8.Методы компонента NMFTP

События

При работе с объектом NMFTP могут возникать события, приведенные в табл. П1.9.

Таблица П1.9.Важнейшие события объекта 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

Назначение

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

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

Свойства

Основные свойства компонента NMHTTP описаны в табл. ШЛО.

Таблица П1.10.Свойства компонента NMHTTP

Методы

Основные методы объекта NMHTTP приведены в табл. П1.11.

Таблица П1.11.Методы объекта NMHTTP

События

Основные события компонента NMHTTP приведены в табл. П1.12.

Таблица П1.12.События компонента NMHTTP

Рекомендации по использованию

Компонент NMHTTP рекомендуется применять, когда необходимо создавать клиентскую программу, взаимодействующую с Web-сервером напрямую, минуя браузер. Это бывает нужно, когда получаемые данные используются не для формирования и отображения Web-страницы, а непосредственно в программе. Примером такого применения могут служить серверные модули, которые посылают клиенту XML-пакеты используя стандартные возможности CGI и обычный Web-сервер. На стороне клиента работает функциональный блок, принимающий от компонента NMHTTP XML-пакет и осуществляющий разбор полученных данных, а затем на их основании определяющий алгоритм работы программы, либо передающий полученные данные на обработку следующему элементу информационной системы.

Чтобы запросить у сервера данные, необходимо прежде всего заполнить параметры используемого сервера — IP-адрес или DNS имя и порт, а затем вызвать метод connect. Как правило, Web-службы работают на порту с номером 80. Если требуется сразу сохранить в файле полученные данные, минуя непосредственно этап их анализа и обработки, то следует установить поле inputFiieMode в значение true. Кроме того, до запроса документа в поле Body задается имя файла, в который этим компонентом будет помешаться полученная информация. В случае, когда сообщение будет использовано сразу, поле inputFiieMode устанавливается в значение false. Тогда после выполнения запроса в свойстве Body будет находиться полученный документ.

Для получения документа необходимо послать на сервер команду его отправки. Простейшим вариантом реализации этого, является обращение к методу Get. Его вызов требует указание единственного параметра — URL документа. Если запрашивается динамическое содержимое, генерируемое серверным модулем, то может потребоваться указание параметров, способ формирования которых описан в гл. 9. Разумеется, при этом серверный модуль должен использовать Get-метод получения клиентских данных. Подробную информацию о том, как писать такие серверные программы, читайте в гл. 9.

Другим возможным вариантом передачи данных на сервер является метод Post. В этом случае происходит передача сведений не в части URL, а в теле HTTP-запроса, что удобно для отправки больших блоков информации. Данный метод, как и предыдущий, приводит к получению нового документа с сервера и вызывается путем обращения к методу объекта NMHTTP с аналогичным названием — Post. Подробнее о параметрах вызова этого метода читайте в табл. П1.11 этого приложения.

Следует отметить, что компонент МНТТР поддерживает функции создания на сервере файлов, с последующей записью в них информации. Данная возможность обеспечивается использованием метода Put. В настоящее время многие Web-серверы не поддерживают этот метод, и поэтому лучше избегать использования такого варианта загрузки файлов на сервер и вместо него применить компонент NMFTP и его более широкие возможности по удаленной работе с файлами.

Работа с сервером новостей — компонент NMNNTP

Пиктограмма этого компонента представлена на рис. П1.5.

Назначение

Данный компонент предназначен для создания клиентской части системы работы со службами новостей.

Рис. П1.5.Значок компонента NMNNTP

В его основные функции входит:

•  Навигация по списку доступных статей.
• Получение с сервера новостных сообщений, а также прикрепленных к ним файлов.
•  Обеспечение доступа к полученной информации для других компонентов программы.
•  Публикация новых сообщений, а также приложенных к ним файлов.

Свойства

Основные свойства компонента NMNNTP сведены в табл. П1.13.

Таблица П1.13.Свойства компонента NMNNTP

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

Методы

Основные методы объекта NMNNTP описаны в табл. П1.14.

Таблица П1.14.Методы объекта NMNNTP

События

Данный компонент имеет возможность обработки множества ситуаций, которые могут возникнуть при работе с сервером новостей. Ключевым событием является onArticie, означающее успешное получение статьи, а также всех приложений, которые к ней относятся.

Рекомендации по использованию

Для применения данного компонента, прежде всего, нужно задать параметры сервера новостей. После этого следует определить режим кэширования информации. Если предполагается использовать режим online во все время работы приложения и скорость доступа к серверу высока, то можно использовать режим cmRemote. В случае, когда эти условия не выполняются, необходимо совмещать режимы cmMixed и cmLocal. Во время работы в первом из них, нужно синхронизировать кэш с изменениями, которые произошли за момент последней синхронизации. Достигается это путем последовательного перебора всех статей выбранной группы новостей. После проведения этой операции можно работать в режиме cmLocal, что позволяет работать с кэшем подобно серверу новостей.

После установки всех параметров соединения с сервером можно выполнять метод connect, а затем — процедуру GetGroupList, которая обновит значение свойства GroupList, содержащего названия доступных новостных групп.

Проведя процедуру выбора необходимой группы, нужно с помощью метода SetGroup сделать ее текущей. Вслед за установкой активной группы можно загружать банк сообщений. Это производится методом GetArtideList.

Для доступа к конкретному сообщению необходимо знать его номер, и указывая его в качестве параметра, вызвать метод GetArticie, который загружает данное сообщение и делает его текущим. Вслед за этим можно обращаться к телу сообщения и приложениям. Для удобства работы компонент NMNNTP может автоматически извлекать приложения и сохранять их в каталоге, указанном в свойстве AttachFilePath. Для активизации этой возможности следует значение свойства ParseAttachments установить в true.

В случае, когда клиент должен иметь возможность поместить собственное сообщение, необходимо заполнить поля свойства PostRecord, записать содержимое размещаемой статьи в свойство PostBody и, если это необходимо, указать пути к приложенным файлам в свойстве PostAttachments. Когда все готово к отправке, остается установить свойство Posting в true и выполнить процедуру PostArticle.

Работа с серверами электронной почты

Поскольку создание приложений для работы с электронной почтой, а в особенности серверных модулей, умеющих взаимодействовать с почтовыми серверами, представляется очень важным в современном мире, то на компонентах, обеспечивающих такую работу, остановимся подробнее.

Прежде всего, нужно заметить, что существует несколько протоколов для работы с электронной почтой. Для отправки сообщений, как правило, используются SMTP-серверы, а для приема — РОРЗ-серверы. Создание собственных почтовых серверов — непростая задача, которая уже с успехом реализована многими производителями программного обеспечения. Интернет-программистам остается лишь создать удобный Web-интерфейс для работы с электронной почтой.

На вкладке FastNet имеется два компонента, предназначенных для взаимодействия с почтовыми серверами: NMSMTP и NMPОРЗ, пиктограммы которых изображены на рис. П1.6.

Рис. П1.6.Компоненты, предназначенные для работы с сервером электронной почты

Эти компоненты разделяют обязанности по отправке и приему электронной почты. Первый компонент — NMPOPS получает почту и управляет содержимым ящика на сервере, a NMSMTP — служит для отправки сообщений через SMTP-сервер.

Получение почтовых сообщений — компонент NMPOP3

Назначение

Данный компонент предназначен для приема и менеджмента сообщений, хранящихся на почтовых серверах, которые взаимодействуют с клиентами по протоколу РОРЗ. Он имеет следующие основные функции:

•  Получение списка всех сообщений, которые хранятся на сервере.
•   Загрузка писем на локальный компьютер.
•   Удаление писем из ящика на сервере.

Свойства

Данный компонент обладает свойствами, приведенными в табл. П1.15.

Таблица П1.15.Свойства компонента NMPOPS

Два свойства компонента принадлежат к специальным типам: TMailMessage и TSummary. Они используются для собрания свойств сообщения в одном свойстве.

Тип TMailMessage

Данный тип представляет собой запись со следующими полями:

•  Attachments. Здесь содержатся имена прикрепленных к письму файлов.
•  Body. Содержит само письмо.
• From. Включает электронный адрес отправителя.
•  Head. Содержит расширенный заголовок сообщения.
•  Messageid. Является идентификатором письма на сервере.
•  Subject. Содержит тему письма.

Тип TSummary

Это тоже запись. В ней присутствуют несколько полей, в которых хранятся описательные характеристики письма:

•  Bytes. Содержит размер сообщения в байтах.
• From. Включает электронный адрес отправителя.
•  Header. Содержит расширенный заголовок сообщения.
•  Messageid. Является идентификатором письма на сервере.
•  Subject. Содержит тему письма.

Для доступа к перечисленным параметрам сообщений необходимо интересуемое письмо сделать активным.

Методы

Основные методы компонента NMРОРЗ сведены в табл. П1.16.

Таблица П1.16.Методы компонента NMРОРЗ

События

События, которые могут возникать при работе объектов класса NMРОРЗ, приведены в табл. П1.17.

Таблица П1.17.События компонента NMРОРЗ

Рекомендации по использованию

Существует несколько контекстных вариантов использования компонента NMРОРЗ. Как в случае создания клиентской программы, так и разработки серверного модуля, который, взаимодействуя с клиентом, создает промежуточный слой между его браузером и почтовым сервером, решается ряд общих задач. Различия заключаются в способе обработки получаемых данных. Почтовый клиент сохраняет их в собственную базу данных, а серверный модуль формирует Web-страницы на основании полученных клиентом писем. Для хранения писем на компьютере клиента, как правило, используется специальный файл, представляющий собой базу данных принятых писем. В качестве такой базы, в большинстве случаев, используется текстовый файл, в котором сообщения определенным образом отделяются друг от друга. Формат этого файла определяется программистом. Чтобы сделать работу с программой комфортной, обычно сохраняют отправленные сообщения, а также другие данные, например, черновики.

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

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

К основным задачам компонента NМРОРЗ следует отнести извлечение писем с почтового сервера, удаление их из ящика, передача полученных сообщений для обработки в клиентскую программу.

Для того чтобы получить письмо, нужно заполнить идентификаторы учетной записи пользователя на почтовом сервере, параметры самого сервера, и вызвать метод connect.

Обычно пользователя сначала сжатым образом информируют о письмах, хранящихся на сервере. То есть отображается список из кратких описаний сообщений, в котором каждому письму соответствует тема, размер, дата получения и отправитель. Чтобы получить информацию такого рода, вначале необходимо выяснить, сколько писем хранится в почтовом ящике (свойство Maiicount), затем, последовательно перебирая их в цикле, вызвать метод Getsuinmary, чтобы заполнить свойство summary и, таким образом, получить возможность использования описания каждого из писем.

После выбора пользователем конкретного письма для загрузки нужно обратиться к методу GetMaiiMessage, после чего, текст сообщения будет доступен в свойстве GetMaiiMessage.Body, а прикрепленные к письму файлы будут находиться В каталоге AttachFilePath. .

Компонент NMSMTP

 Назначение

Компонент предназначен для создания и отправки писем адресатам через SMTP-сервер.

Свойства

Свойства компонента NMSMTP собраны в табл. П1.18.

Таблица П1.18.Свойства компонента NMSMTP

Можно заметить, что параметры компонента NMSMTP не содержат пароля. Связано это с тем, что, как правило, SMTP-сервера не требуют полной аутентификации, в лучшем случае ограничиваясь только именем пользователя. Свойство SubType указывает на тип разметки отправляемого письма.

Тип данных TPostMessage

Данный тип представляет собой запись, устанавливая поля которой, можно последовательно формировать письмо, с тем, чтобы потом вызвать метод его отправки.

Вся информация, которую может содержать эта запись, разгруппирована по следующим полям:

•  Attachments. Относится к типу TStringList и содержит строки с именами приложенных файлов и путями к ним.
•  Body. Содержит текст самого письма.
•  Date. Указывает дату отправки сообщения. Данное поле заполняется в случае, когда требуется указание даты, отличной от текущей, а в противном случае, дата сообщению присваивается автоматически.
•  FromAddress. Содержит электронный адрес отправителя.
•   FromName. Указывает имя отправителя.
•  LocaiProgram. Определяет программу, формирующую и отправляющую письмо.
•  ReplyTo. Содержит электронный адрес, на который отправителю письма можно послать ответ. Используется в случае, когда этот адрес отличен от адреса, указанного в свойстве FromAddress.
•  Subject. Включает тему письма.
•  ToAddress. Содержит электронный адрес получателя.
•  ToBlindCarbonCopy. Относится к типу TStringList, в строках которого могут содержаться электронные адреса, по которым производится отсылка скрытой копии сообщения.
•  ToCarbonCopy. Также относится к типу TStringList, в строках которого могут содержаться электронные адреса получателей копии сообщения.

Методы

Методы компонента NMSMTP описаны в табл. П1.19.

Таблица П1.19.Методы компонента NMSMTP

События

События компонента NMSMTP описаны в табл. П1.20.

Таблица П1.20.События компонента NMSMTP

Рекомендации по использованию

С самого начала использования компонента NMSMTP в программе необходимо задать имя сервера (или его IP-адрес) и порт, на котором работает SMTP-служба.

Для того чтобы сформировать сообщение, нужно заполнить поля свойства PostMessage. Полям, содержащим электронный адрес отправителя и получателя, необходимо обязательно присвоить соответствующие значения. Само письмо может быть простым текстом, набранным в кодировке ASCII, либо полноценной Web-страницей. В зависимости от типа форматирования, нужно указать его название в свойстве subType.

После того как формирование сообщения завершено, можно, используя метод connect, подключаться к серверу и методом SendMail отправлять письмо.

Кодирование и декодирование данных, посылаемых в запросах — компонент NMURL

Пиктограмма этого компонента показана на рис. П1.7.

Рис. П1.7.Значок компонента NMURL

Назначение

Компонент NMURL предназначен для простой, но в тоже время очень часто используемой, особенно серверными модулями, операции: приведение данных, полученных через переменные окружения, к стандартному виду, и наоборот — кодирование информации для передачи ее в среде WWW. Подробное описание представления данных, передаваемых в качестве параметров GET-запроса, читайте в гл. 9.

Свойства

Ключевым свойством данного объекта является inputstring, куда помешается строка для последующего кодирования/декодирования.

Результат кодирования помешается в свойство Encode. После такой обработки, данные можно передавать по сети Интернет, не опасаясь за прохождение специальных символов и кириллицы через множество различных систем.

Если необходимо наоборот декодировать полученные, например при Get-запросе, данные, то обращаются к свойству Decode, возвращающему исходную строку.

Методы

У данного объекта ключевые методы отсутствуют в связи с тем, что вся работа с ним проходит через его свойства.

События

Единственным событием является onError, которое может возникнуть в случае появления ошибки при кодировании/декодировании данных.

Рекомендации по использованию

Использовать компонент NMURL очень просто. Достаточно поместить его на форму или в модуль данных, присвоить некоторое значение свойству inputstring и извлечь требуемые данные из параметра Encode или Decode, в зависимости от того, что требовалось сделать с ними.

Кодирование и декодирование файлов, передаваемых посредством Интернета — компонент NMUUProcessor

Пиктограмма компонента NMUUProcessor изображена на рис. П1.8.

Рис. П1.8.Значок компонента NMUUProcessor

Назначение

Компонент NMUUProcessor предназначен для приведения данных, содержащихся в потоках, к виду, пригодному для их передачи через Интернет и локальные сети, а также восстановления закодированных исходных данных. Он поддерживает две основные системы кодирования: MIME (Multimedia Internet Mail Extension) и UUEncoding (Unix to Unix Encoding). Наибольшую пользу из компонента NMUUProcessor можно извлечь, используя его совместно с файловыми потоками.

Свойства

Свойства компонента NMUUProcessor описаны в табл. П1.21.

Таблица П1.21.Свойства компонента NMUUProcessor

Методы

Методы компонента muuprocessor сведены в табл. П1.22.

Таблица П1.22.Методы компонента muuprocessor

События

События компонента NMUUProcessor описаны в табл. П1.23.

Таблица П1.23. События компонента NMUUProcessor

Рекомендации по использованию

Как правило, при использовании обычных компонентов, предназначенных для работы с Интернетом, нет нужды вручную кодировать или декодировать данные. Компонент NMUUProcessor применяется при создании собственных серверов и программ, осуществляющих обмен файлами или другими типами данных через сеть. Чтобы закодировать данные, необходимо создать поток, поместить в него данные и указать его имя в свойстве inputstream. Если затем задать метод кодирования, а в свойстве OutputStream указать имя выходного потока, то можно вызывать метод Encode. Разработка процесса декодирования данных происходит аналогично.

Работа с обобщенным сокетом — компонент PowerSock

Пиктограмма компонента PowerSock изображена на рис. П1.9.

Рис. П1.9.Значок компонента PowerSock

Назначение

Данный компонент представляет собой обобщенный сокет, инкапсулирующий в себе средства как для работы на стороне клиента, так и на стороне сервера. Подробное описание работы с сокетами читайте в гл. 13. Здесь будут рассмотрены лишь вопросы, специфичные для данного компонента.

Итак, данный компонент осуществляет передачу, прием данных через сеть, а также управляет внешними подключениями со стороны других сокетов, производимых с целью того же клиент-серверного взаимодействия. В отличие от сокетов, которые расположены на вкладке Internetпалитры компонентов, данный объект представляет собой единую структуру, предназначенную для работы на любом участке системы — как на стороне сервера, так и на стороне клиента. Это достигается путем включения в один объект всех требуемых свойств и методов.

Свойства

При использовании компонента PowerSock доступны свойства, описанные в табл. П1.24.

Таблица П1.24. Свойства объекта PowerSock

Методы

Методы компонента Powersock описаны в табл. П1.25.

Таблица П1.25.Методы компонента PowerSocket

События

События, которые могут возникать при работе описываемого компонента, представлены в табл. П1.26.

Таблица П1.26.События компонента PowerSock

Рекомендации по использованию

Компонент PowerSock, как уже отмечалось, используется для организации клиент-серверного взаимодействия в рамках локальных сетей, а также сети Интернет. Если создается клиентская программа, то для соединения с сервером необходимо установить его адрес и порт, на котором работает служба, заполнив соответствующие свойства объекта. После этого, можно вызывать метод Connect для установки соединения. Если же работа идет на стороне сервера, то нужно вызвать метод Listen для разрешения подключения клиентов.

После того как соединение установлено, можно использовать многочисленные функции отправки и приема данных, которые описаны в разделе данного приложения, посвященном компоненту NMMsg.

Вкладка Internet

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

Большинство из компонентов, которые располагаются на этой вкладке, уже были описаны, и поэтому здесь рассматриваться не будут. Чтобы узнать о компонентах ClientSocket, ServerSocket, PageProducer, QueryTableProducer, Следует Обратиться К\к гл. 10 и 13. КомпонентыDataSetPageProducer и DataSetTableProducer представляют собой составную часть комплексной технологии DataSet, используемой в Delphi, рассмотрение которой выходит за рамки этой книги, и поэтому их описание будет опущено.

Следует отметить, что объект webDispatcher используется создаваемым Web-серверным приложением автоматически. По сути, Web-модуль, которым мы пользовались при создании серверных программ на основе невизуальных компонентов, — это модуль данных, в котором уже присутствует компонент webDispatcher. Описание действий, управление ими, а также организация и создание алгоритма работы модуля на основе рассмотренных действий приведено в гл. 10.

Компонент WebBrowser

Значок компонента WebBrowser представлен на рис. П1.10.

Рис. П1.10.Значок компонента WebBrowser

Назначение

Данный компонент представляет собой элемент управления ActiveX. Это значит, что на самом деле программа, используя данный компонент, обращается к программным ресурсам компьютера и использует Internet Explorer(IE), установленный в операционной системе Windows. Этот компонент может выполнить все те операции, которые заложены в IE, поэтому его использование позволяет сделать создаваемую программу очень функциональной. Для того чтобы созданная программа корректно работала на компьютере конечного пользователя, в его системе должен быть установлен IE версии не ниже 4.0. Разумеется, это требование автоматически выполняется, если используется операционная система Windows 98 или более новая.

Свойства

Свойства объекта WebBrowser сведены в табл. П1.27.

Таблица П1.27. Свойства объектаWebBrowser

Методы

Методы компонента WebBrowser сведены в табл. П1.28.

Таблица П1.28. Методы компонента WebBrowser

События

События экземпляров класса TWebBrowser сведены в табл. П1.29.

Таблица П1.29. События компонента WebBrowser

Замечание 

В данных событиях различают два очень сходных понятия — "загрузка документа" и "навигация". Первый процесс означает получение файлов из сети Интернет, а второй — переход к новой странице, ее загрузка и отображение.

Рекомендации по использованию

Для того чтобы использовать компонент WebBrowser, его необходимо поместить в форму приложения, установить размеры и положение, а затем в программе вызвать метод Navigate для загрузки нужного Интернет-ресурса.