Интернет-журнал "Домашняя лаборатория", 2007 №6
Шрифт:
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);
}
// IUnknown
STDMETHODIMP_(ULONG) CoBook::AddRef
{
return ++m_refCount;
}
STDMETHODIMP_(ULONG) CoBook::Release
{
if (--m_refCount == 0)
{
delete this;
return 0;
}
else
return m_refCount;
}
STDMETHODIMP CoBook::Querylnterface(REFIID riid, void** pIFace)
{
if (riid == IID_IUnknown)
{
*pIFace = (IUnknown*)this;
}
else if (riid == IID_IPub)
}
*pIFace = (IPub*)this;
}
else if (riid == IID_IBook)
{
*pIFace = (IBook*)this;
}
else
{
*pIFace = NULL; return E_NOINTERFACE;
}
((IUnknown*)(*pIFace))->AddRef;
return S OK;
}
//IPub&IBook
STDMETHODIMP CoBook::SetTitle (BSTR bstrTitle)
{
SysReAllocString(&m_bstrTitle, bstrTitle);
return S_OK;
}
STDMETHODIMP CoBook::SetYear(int nYear)
{
m_nYear = nYear;
return S_OK;
}
STDMETHODIMP CoBook::SetAuthor(BSTR bstrAuthor)
{
SysReAllocString(&m_bstrAuthor, bstrAuthor);
return S_OK;
}
STDMETHODIMP CoBook::Getlnfo(BSTR *pbstrInfo)
{
char* pszTitle = NULL;