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所在的列.