Шрифт:
Интервал:
Закладка:
unsigned short Data2;
unsigned short Data3;
unsigned char Data4[8];
} GUID
Эту структуру удобно задавать с помощью следующего макроса
#define DEFINE_GUID(name,
1, w1, w2, b1, Ь2, Ь3, Ь4, Ь5, Ь6, b7, b8)
EXTERN_C const GUID name
= { 1, w1, w2, { b1, Ь2, Ь3, Ь4, Ь5, Ь6, b7 b8 } }
Ниже представлен файл iid.h в котором определены GUID всех трех ранее определенных интерфейсов (позже в этот файл будут добавлены и GUID классов, реализующих указанные интерфейсы). Для получения GUID можно использовать утилиту guidgen.ехе из Visual Studio. Эта утилита позволяет получить определение нового GUID в виде макроса DEFINE GUID, который можно скопировать и вставить в файл определений GUID. В закоментированных строках этого файла содержатся значения GUID в виде, удобном для просмотра человеком. Имя идентификатора интерфейса стандартно формируется следующим образом — префикс IID_, за которым следует имя интерфейса. Например, IID_IPub.
// iid.h — GUID для интерфейсов
// {9A5DE 9А0-7225-11d5-9 8С7-000001223694}
DEFINE_GUID(IID_IPub,
0x9a5de9a0, 0x7225, 0x11d5,
0x98, 0xc7, 0x0, 0x0, 0x1, 0x22, 0x36, 0x94);
// {9A5DE9A1-7225-11d5-98C7-000001223694 }
DEFINE_GUID(IID_IBook,
0x9a5de9a1, 0x7225, 0x11d5,
0x98, 0xc7, 0x0, 0x0, 0x1, 0x22, 0x36, 0x94);
// {9A5DE 9A2-7225-11d5-98C7-000001223694}
DEFINE_GUID(IID_IJournal,
0x9a5de9a2, 0x7225, 0xlld5,
0x98, 0xc7, 0x0, 0x0, 0x1, 0x22, 0x36, 0x94);
Реализация интерфейсов — коклассы
Теперь пора перейти к реализации наших интерфейсов. В соответствии с базовой архитектурой СОМ, интерфейсы реализуются в классах, каждый из которых может реализовать несколько интерфейсов. Далее определяются и реализуются два класса — CoBоoк и CоJournal, реализующие соответственно интерфейсы IBook и IJournal. Все названия классов в СОМ удобно начинать с префикса со, подчеркивая их принадлежность данной модели. Часто классы, определенные в СОМ, называют коклассами.
Рассмотрим вначале файл CoBоок. h
//////////////////////////////////////////////////
// СоВоок. h: заголовочный файл для класс СоВоок //
//////////////////////////////////////////////////
#ifndef _СоВоок_
#define _СоВоок_
#include "IBook.h" // определение интерфейса IBook
#include "iid.h" // GUID интерфейса IBook
class CoBook:
public IBook
{
public:
CoBook(); // конструктор
virtual ~CoBook(); // деструктор
// IUnknown
STDMETHODIMP Querylnterface(REFIID riid, void** pIFace);
STDMETHODIMP_(ULONG) AddRef();
STDMETHODIMP (ULONG) Release();
// IPub
STDMETHODIMP SetTitle(BSTR bstrTitle);
STDMETHODIMP SetYear(int nYear);
STDMETHODIMP Getlnfo(BSTR* pbstrlnfo);
// IBook
STDMETHODIMP SetAuthor(BSTR bstrAuthor);
private:
ULONG m_refCount; // Счетчик ссылок
BSTR m_bstrTitle; // Название публикации
BSTR m_bstrAuthor; // Автор публикации
int m_nYear; // Год публикации
};
#endif
Здесь определяется класс CоBоок, порожденный от интерфейса IBook. Так как интерфейс IBook был сам порожден от интерфейса IPub, а последний — от стандартного интерфейса IUnknown, то класс CоBоок должен реализовать чисто виртуальные методы всех этих интерфейсов.
Здесь при определении методов используются следующие макросы
#define STDMETHODIMP HRESULT stdcall
#define STDMETHODIMP (type) type stdcall
теперь надо поговорить об основном стандартном интерфейсе модели COM — IUknown.
Как уже не раз говорилось, любой интерфейс СОМ должен порождаться от IUnknown или от другого интерфейса. Следовательно, все интерфейсы СОМ имеют общего предка — интерфейс IUnknown. Этот интерфейс определяется в <unknwn.h> и его GUID равен
00000000-0000-0000-С000-000000000046.
Интерфейс IUnknown определяет 3 метода, и все эти методы должны быть реализованы в каждом коклассе
• Querylnterfасе()
Данный метод обеспечивает клиента информацией о том, реализован ли интересующий его интерфейс в данном коклассе. В случае реализованное™ запрашиваемого интерфейса клиент получает ссылку на интерфейс. Этот подход обеспечивает необходимую гибкость, позволяя работать с одним компонентам различным клиентам, имеющим различный уровень знаний о доступных интерфейсах.
Семантика этого метода следующая. Имея указатель некоторого интерфейса pIFacel некоторого объекта и передавая в Queryinterfасе ссылку на идентификатор нового интерфейса IID_IFace2 можно получить указатель на новый интерфейс piFace2, если он реализован в данном объекте. В случае успеха возвращаемое значение S_OK, а в случае неудачи — E_NOINTERFACE
hr = pIFacel->QueryInterfасе(IID_IFace2, (void**)&pIFace2);
При реализации этого метода нужно обеспечить выполнение следующего принципа — клиент, имеющий ссылку на некоторый интерфейс объекта, должен иметь возможность перехода к любому другому интерфейсу этого объекта.
Эта реализация может обеспечиваться за счет использования таблиц виртуальных функций, которыми и являются все методы всех интерфейсов (при реализации кокласса на C++). Заметим, что если кокласс порожден от независимых друг от друга интерфейсов (т. е. один интерфейс не является потомком другого), то компилятор C++ создает виртуальных таблиц — по одной на каждый интерфейс. В каждой таблице хранятся указатели на все методы всех интерфейсов, от которых порожден данный интерфейс. Следовательно, начинается каждая таблица виртуальных функций с указателей на методы интерфейса iunknown. Обратите внимание, что реализовать каждый метод нужно только один раз, не зависимо от числа его появлений в таблицах виртуальных функций данного класса.
• AddRef()
В СОМ управление временем жизни объекта выполняется при использовании функций AddRef() и Reiease(). Taк как объект может использоваться многими клиентами одновременно, ни один из клиентов не имеет права удалить объект из памяти. В СОМ каждый активизированный объект ведет подсчет сделанных на него ссылок. При обнулении этого счетчика кокласс удаляет себя из памяти. Метод AddRef() вызывается при появлении новой ссылки на объект и увеличивает значение счетчика (в нашем случае это m refcount) на 1. Возвращает данный метод текущее число ссылок.
• Release ()
Этот метод вызывается при освобождении ссылки на объект и уменьшает значение счетчика на 1. Он же удаляет кокласс из памяти при обнулении счетчика ссылок. Метод возвращает текущее число ссылок.
Теперь реализация класса CoBоок
//////////////////////////////////////////////////
// СоВоок. срр: реализация класса СоВоок.
//
//////////////////////////////////////////////////
#include <stdio.h>
#include "СоВоок. h"
extern ULONG g_objCount; // Счетчик числа объектов
//////////////////////////////////////////////////
// Конструктор и деструктор
//////////////////////////////////////////////////
СоВоок::СоВоок()
{
m_refCount = 0;
++g_obj Count;
m_bstrTitle = SysAllocString(L"");
m_bstrAuthor = SysAllocString(L"");
}
CoBook::~CoBook()
{
-- g_objCount;
if(m_bstrTitle)
SysFreeString(m_bstrTitle);
if(m_bstrAuthor)
SysFreeString(m_bstrAuthor);
}
//