Zjednodušení přístupu k datům s atributy databáze
Toto téma ukazuje použití atributů databáze ke zjednodušení databázových operací.
Základní způsob pro přístup k informacím z databáze, je vytvoření třídy příkazu (nebo třídy tabulky) a třídy uživatelského záznamu pro určitou tabulku v databázi. Atributy databáze zjednodušují některé deklarace šablon, které jste dříve museli provést.
Použití atributů databáze demonstrují dvě následující části, které ukazují dvě odpovídající tabulky a deklarace třídy uživatelského záznamu: první používá atributy a druhý používá šablony technologie OLE DB. Taková deklarace kódu je obvykle umístěna v hlavičkovém souboru pojmenovaném podle tabulky nebo objektu příkazu, například Authors.h.
Porovnáním dvou souborů můžete vidět, o kolik je jednodušší použít atributy. Mezi rozdíly patří:
Pomocí atributů stačí pouze deklarovat jednu třídu: CAuthors, zatímco se šablonami musíte deklarovat dvě: CAuthorsNoAttrAccessor a CAuthorsNoAttr.
Volání db_source ve verzi s atributy odpovídá volání OpenDataSource() ve verzi s deklarací šablon.
Volání db_table ve verzi s atributy je ekvivalentní následující deklaraci šablony:
class CAuthorsNoAttr : public CTable<CAccessor<CAuthorsNoAttrAccessor> >Volání db_column ve verzi s atributy jsou ekvivalentní mapě sloupce (viz BEGIN_COLUMN_MAP ... END_COLUMN_MAP) v deklaraci šablony.
Atributy vloží deklaraci třídy uživatelského záznamu za vás. Třída uživatelského záznamu je ekvivalentní CAuthorsNoAttrAccessor v deklaraci šablony. Pokud je vaše třída tabulky CAuthors, vložená třída uživatelského záznamu se nazývá CAuthorsAccessor a jeho deklaraci je možné pouze zobrazit ve vloženém kódu. Další informace naleznete v sekci "Vložené atributy třídy uživatelského záznamu" v tématu Uživatelské záznamy.
Všimněte si, že musíte nastavit vlastnosti sady řádků v kódu s atributy i v kódu se šamblonami pomocí CDBPropSet::AddProperty.
Informace o atributech uvedené v tomto tématu, viz Atributy příjemce technologie OLE DB.
Deklarace tabulky a přistupujícího objektu pomocí atributů
Následující kód volá db_source a db_table v třídě tabulky. db_source určuje zdroj dat a připojení, které má být použito. db_table vloží příslušný kód šablony k deklaraci třídy tabulky. db_column určí mapu sloupce a vloží deklaraci přistupujícího objektu. Atributy příjemce technologie OLE DB můžete použít v jakémkoli projektu, který podporuje knihovnu ATL.
Zde je deklarace tabulky a deklarace přistupujícího objektu pomocí atributů:
//////////////////////////////////////////////////////////////////////
// Table and accessor declaration using attributes
// authors.h
//////////////////////////////////////////////////////////////////////
// Table class declaration
// (Note that you must provide your own connection string for db_source.)
[
db_source(L"your connection string"),
db_table("Authors")
]
class CAuthors
{
public:
DWORD m_dwAuIDStatus;
DWORD m_dwAuthorStatus;
DWORD m_dwYearBornStatus;
DWORD m_dwAuIDLength;
DWORD m_dwAuthorLength;
DWORD m_dwYearBornLength;
[ db_column(1, status=m_dwAuIDStatus, length=m_dwAuIDLength) ] LONG m_AuID;
[ db_column(2, status=m_dwAuthorStatus, length=m_dwAuthorLength) ] TCHAR m_Author[51];
[ db_column(3, status=m_dwYearBornStatus, length=m_dwYearBornLength) ] SHORT m_YearBorn;
void GetRowsetProperties(CDBPropSet* pPropSet)
{
pPropSet->AddProperty(DBPROP_CANFETCHBACKWARDS, true);
pPropSet->AddProperty(DBPROP_CANSCROLLBACKWARDS, true);
pPropSet->AddProperty(DBPROP_IRowsetChange, true);
}
};
Deklarace tabulky a přistupujícího objektu pomocí šablon
Zde je deklarace tabulky a deklarace přistupujícího objektu pomocí šablon:
//////////////////////////////////////////////////////////////////////
// Table and user record class declaration using templates
// authors.h
//////////////////////////////////////////////////////////////////////
// User record class declaration
class CAuthorsNoAttrAccessor
{
public:
DWORD m_dwAuIDStatus;
DWORD m_dwAuthorStatus;
DWORD m_dwYearBornStatus;
DWORD m_dwAuIDLength;
DWORD m_dwAuthorLength;
DWORD m_dwYearBornLength;
LONG m_AuID;
TCHAR m_Author[51];
SHORT m_YearBorn;
void GetRowsetProperties(CDBPropSet* pPropSet)
{
pPropSet->AddProperty(DBPROP_CANFETCHBACKWARDS, true);
pPropSet->AddProperty(DBPROP_CANSCROLLBACKWARDS, true);
pPropSet->AddProperty(DBPROP_IRowsetChange, true);
}
HRESULT OpenDataSource()
{
CDataSource _db;
HRESULT hr;
hr = _db.OpenFromInitializationString(L"your connection string");
if (FAILED(hr))
{
#ifdef _DEBUG
AtlTraceErrorRecords(hr);
#endif
return hr;
}
return m_session.Open(_db);
}
void CloseDataSource()
{
m_session.Close();
}
operator const CSession&()
{
return m_session;
}
CSession m_session;
BEGIN_COLUMN_MAP(CAuthorsNoAttrAccessor)
COLUMN_ENTRY_LENGTH_STATUS(1, m_AuID, m_dwAuIDLength, m_dwAuIDStatus)
COLUMN_ENTRY_LENGTH_STATUS(2, m_Author, m_dwAuthorLength, m_dwAuthorStatus)
COLUMN_ENTRY_LENGTH_STATUS(3, m_YearBorn, m_dwYearBornLength, m_dwYearBornStatus)
END_COLUMN_MAP()
};
class CAuthorsNoAttr : public CTable<CAccessor<CAuthorsNoAttrAccessor> >
{
public:
HRESULT OpenAll()
{
HRESULT hr;
hr = OpenDataSource();
if (FAILED(hr))
return hr;
__if_exists(GetRowsetProperties)
{
CDBPropSet propset(DBPROPSET_ROWSET);
__if_exists(HasBookmark)
{
propset.AddProperty(DBPROP_IRowsetLocate, true);
}
GetRowsetProperties(&propset);
return OpenRowset(&propset);
}
__if_not_exists(GetRowsetProperties)
{
__if_exists(HasBookmark)
{
CDBPropSet propset(DBPROPSET_ROWSET);
propset.AddProperty(DBPROP_IRowsetLocate, true);
return OpenRowset(&propset);
}
}
return OpenRowset();
}
HRESULT OpenRowset(DBPROPSET *pPropSet = NULL)
{
HRESULT hr = Open(m_session, "Authors", pPropSet);
#ifdef _DEBUG
if(FAILED(hr))
AtlTraceErrorRecords(hr);
#endif
return hr;
}
void CloseAll()
{
Close();
CloseDataSource();
}
};