Symbian DBMS中的检索
DBMS方面的应用中检索是必不可少的操作,通常我们习惯使用SQL来进行检索,就像下面这样:
//SQL keywords definitions
_LIT(KSelect, "SELECT ");
_LIT(KDelete, "DELETE " );
_LIT(KFrom, " FROM ");
_LIT(KWhere, " WHERE ");
_LIT(KEqual, " = ");
_LIT(KNotEqual, " <> ");
_LIT(KOrderBy, " ORDER BY ");
_LIT(KDot, ", ");
_LIT(KAnd, " AND " );
_LIT(KLike, " LIKE ");
_LIT(KQuotation, "'");
_LIT( KAsterisk, "*" );
// Implementation specific constants
const int KCustomSqlMaxLength = 256;
/**
* Function: GetColumnDataByKeyL
*
* Description: Get a value from appointed table and column by key.
*
* Returns: KErrNone or one of the system wide error codes.
*/
TInt COurDb::GetColumnDataByKeyL( const TDesC &aTable, const TDesC &aCol, const TDesC &aSortCol,
const TDesC &aKeyCol, const TInt aKey, TDes &aVal )
{
TBuf<KCustomSqlMaxLength> sqlStr;
sqlStr.Append( KSelect );
sqlStr.Append( aCol );
sqlStr.Append( KFrom );
sqlStr.Append( aTable );
sqlStr.Append( KWhere );
sqlStr.Append( aKeyCol );
sqlStr.Append( KEqual );
sqlStr.AppendNum( aKey );
sqlStr.Append( KOrderBy );
sqlStr.Append( aSortCol );
// Create a view on the database
RDbView view;
TInt ret( 0 );
ret = view.Prepare( iDb, TDbQuery( sqlStr ), view.EReadOnly );
if( ret != KErrNone )
{
view.Close();
return ret;
}
User::LeaveIfError( view.EvaluateAll() );
CDbColSet* colSet = view.ColSetL();
CleanupStack::PushL(colSet);
if( view.FirstL() )
{
ret = KErrNone;
view.GetL();
aVal.Copy( view.ColDes( colSet->ColNo( aCol ) ) );
}
else
{
ret = KErrNotFound;
}
CleanupStack::PopAndDestroy(colSet);
view.Close();
return ret;
}
上面的方法对程序员来说是最得心应手的,但由于需要组织一长串的SQL语句所以略显冗长,其实Symbian DBMS API提供了检索的功能,可以通过RDbTable:: SeekL()进行单一和复合的查询功能,应用RDbTable:: SeekL()上面的代码就可以变成:
/**
* Function: GetColumnDataByKeyL
*
* Description: Get a value from appointed table and column by key.
*
* Returns: KErrNone or one of the system wide error codes.
*/
TInt COurDb::GetColumnDataByKeyL( const TDesC &aTable, const TDesC &aCol, const TDesC &aIndex,
const TInt aKey, TDes &aVal )
{
// Create an read-only database table object
RDbTable table;
TInt ret = table.Open( iDb, aTable, table.EReadOnly );
if( ret != KErrNone )
{
return ret;
}
CDbColSet* colSet = table.ColSetL();
CleanupStack::PushL(colSet);
table.SetIndex( aIndex ); //
if( table.SeekL( TDbSeekKey( aKey ) ) )
{
table.GetL();
aVal .Copy( table.ColDes( colSet->ColNo( aCol ) ) );
ret = KErrNone;
}
else
{
ret = KErrNotFound;
}
CleanupStack::PopAndDestroy( colSet );
table.Close();
return ret;
}
使用RDbTable:: SeekL()我们需要为数据表设置当前使用的索引,然后通过构造一个TDbSeekKey查询对象传给RDbTable:: SeekL()进行实际的检索,这么简单就完成了检索,去掉了繁杂字符串组合操作.下面接着介绍一下通过RDbTable:: SeekL()实现复合查询的方法,可能有人看过TDbSeekKey的定义后会被TDbSeekKey::Add()这个方法迷惑,认为通过它为查询对象TDbSeekKey添加键值就行了,可不幸的是我们会在运行时得到一个panic.正确的方法是使用Symbian DBMS提供的另一个查询类TDbSeekMultiKey<TInt S>,它是一个瘦模板类,构造时传入复合查询时key的个数,然后通过Add方法把每个key添加进行就可以了:
TDbSeekMultiKey<2> key;
key.Add( aKey1 );
key.Add( aKey2 );
table.SetIndex( aIndex ); //
if( table.SeekL( key ) )
{
table.GetL();
aVal .Copy( table.ColDes( colSet->ColNo( aCol ) ) );
ret = KErrNone;
}
else
{
ret = KErrNotFound;
}
有一点需要注意一下:就是在使用RDbTable:: SeekL()进行检索时,当前使用的索引必需包含每个key所在的列.