Интернет-журнал "Домашняя лаборатория", 2007 №6 - Усманов

CoJournal. Для задания соответствующего ProgID следует для данного раздела создать подраздел с именем ProgID и в качестве значения для параметра по умолчанию взять PubInProcServer.CoJournal.

Для задания пути к серверу (один сервер для двух коклассов), надо под ключом

НКЕY_CLASSЕS_ROOT CLSID {49F00760-7238-11d5-98С7-000001223694} создать раздел InProcServer32 и в качестве параметра по умолчанию задать полный путь к dll серверу.

Это же повторяется для CLSID кокласса CoJournal.

• ProgID и соответствующий CLSID

Под ключом НКЕY_CLASSЕS_ROOT надо создать разделы PubInProcServer.CoBook и PubInProcServer.CoJournal. Для каждого из построенных разделов создать подразделы CLSID, где в качестве значения параметра по умолчанию задаются CLSID соответствующих коклассов.

Клиент

Теперь можно реализовать клиента для сервера PubInProcServer. Для этого можно в Visual C++ создать проект консольного приложения PubClient, куда перенести файлы iid.h, iid.cpp и все файлы с описаниями интерфейсов. Тем самым, клиент должен знать все GUID используемых коклассов и их интерфейсов (не обязательно всех в данном классе, но всех, используемых данным клиентом).

Сам клиент реализован в файле PubClient.cpp

// PubClient.cpp — клиент для сервера PubinProcServer

#include "IBook.h"

#include "IJournal.h"

#include "iid.h"

#include <iostream.h>

define MAX_ID 100 // максимальное число публикаций

int main()

{

              CoInitialize(NULL); // инициализация COM

              IClassFactory* pBF = NULL;

              IClassFactory* pJF = NULL;

              IBook* pIBook = NULL;

              IJournal* pIJournal = NULL;

              BSTR bstr;

              char* pszText;

              HRESULT hr;

              int nNewID = 0;

              IPub* alPub[MAX_ID]; // массив указателей на публикации

              bstr = SysAllocString(L"");

             // Активация фабрики класса CoBookFactory и получение указателя на интерфейс IClassFactory этой фабрики (pBF)

            hr = CoGetClassObject(CLSID_CoBook, CLSCTX_INPROC_SERVER, NULL, IID_IClassFactory, (void**)&pBF);

               if(FAILED(hr)) // в случае неудачи — выход

               return 0;

             // Активация фабрики класса CoJournaiFactory и получение указателя на интерфейс IClassFactory этой фабрики (pJF)

           hr = CoGetClassObject(CLSID_CoJournal, CLSCTX_INPROC_SERVER,

           NULL, IID_IClassFactory, (void**)&pJF);

           if(FAILED(hr)) // в случае неудачи — выход

                  return 0;

           // Активация нового экземпляра кокласса CoBook

           hr = pBF —> CreateInstance(NULL, IID_IBook, (void**)SpIBook);

           // В случае успеха — ввод данных

          if (SUCCEEDED(hr))

          {

           SysReAllocString(&bstr, L" A.W.Troelsen");

           pIBook — > SetAuthor(bstr);

           SysReAllocString(&bstr, L" COM and ATL 3.0");

           pIBook -> SetTitle(bstr);

           pIBook —> SetYear(2000);

           alPub [nNewID+ +] = pIBook;

           }

           // Активация нового экземпляра кокласса CoJournal

           hr = pJF —> CreateInstance(NULL, IID_IJournal, (void**)SpIJournal);

           // В случае успеха — ввод данных

           if (SUCCEEDED(hr))

           {

                     SysReAllocString(&bstr, L" The Journal of the Graph Theory");

                          pIJournal —> SetTitle(bstr);

                          pIJournal —> SetYear(2001);

                          pIJournal —> SetNumber(1);

                          aIPub[nNewID++] = pIJournal;

            }

           // Активация нового экземпляра кокласса CoJournal

                       hr = pJF->CreateInstance(NULL, IID_IJournal, (void**)SpIJournal);

           // В случае успеха — ввод данных

           if (SUCCEEDED(hr))

           {

                      SysReAllocString(&bstr, L" SIGIR");

                      pIJournal —> SetTitle(bstr);

                      pIJournal —> SetYear (1999);

                      pIJournal —> SetNumber(12);

                      aIPub[nNewID++] = pIJournal;

            }

            // Удаление фабрик классов

             pBF —> Release ();

             pJF->Release ();

// Вывод информации о всех публикациях

            if(nNewID)

            for(int id = 0; id < nNewID; id++)

            {

            SysFreeString (bstr);

            aIPub[id] — > GetInfo(&bstr);

            pszText = (char*)malloc(2*SysStringLen(bstr));

            wcstombs(pszText, bstr, 2*SysStringLen(bstr));

            MessageBox (NULL, pszText, "Publication",

            MB OK|MB SETFOREGROUND);

           free(pszText);

           }

          // Удаление всех публикаций

               if(nNewID)

                for(int id = 0; id < nNewID; id++)

           {

                 aIPub[id] — > Release ();

            }

            SysFreeString(bstr);

            CoUninitialize (); // Завершение работы с COM

            return 0;

}

Несколько замечаний к приведенной программе.

СОМ функция CoGetClassObject имеет следующие параметры:

• Ссылка на идентификатор создаваемого кокласса

• Тип запрашиваемого сервера CLSCTX_INPROC_SERVER означает, что запрашивается сервер в процессе клиента. Дня локального сервера надо задать СLSСТX_LОСAL_SЕRVER, и для удаленного — CLSCTX_REMOTE_SERVER. Можно комбинировать эти флаги для автоматического выбора наиболее близкого сервера.

• В третьем параметре задается информация об удаленной машине при использовании удаленного сервера.

• Идентификатор запрашиваемого интерфейса

• Возвращаемый указатель на запрашиваемый интерфейс

Функция MessageBox() используется для вывода информации о публикации в окне сообщений. Эту информация клиент получает с сервера вызывав метод GetInfо(). Память под возвращаемую BSTR-строку сервер выделяет сам, а клиент отвечает за ее освобождение. Перед передачей информации в окно сообщений выполняется преобразование BSTR-строки в ANSI-строку.

Язык описания интерфейсов и библиотека типов

Теперь обратимся к вопросам о языковой независимости и прозрачности местоположения. Как уже ранее упоминалось, это принципиальные для СОМ требования.

Первое означает, что как компоненты, так и использующие их клиенты могут реализовываться на любом поддерживающем СОМ языке программирования (в частности, C++ и Visual Basic). Однако описанные ранее интерфейсы (файлы IPub.h, IBook.h и IJoumal.h) представлены на C++. Это означает, что любой разработчик, желающий реализовать эти интерфейсы в своем коклассе, должен использовать именно C++. Более неприятно, что и любой клиент, желающий использовать построенные таким образом компоненты, также должен быть написан на C++.

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

Что нужно для обеспечения