javaextensions/iapinfo/inc.s60/javacommdb.h
branchRCL_3
changeset 14 04becd199f91
child 25 ae942d28ec0e
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/javaextensions/iapinfo/inc.s60/javacommdb.h	Tue Apr 27 16:30:29 2010 +0300
@@ -0,0 +1,139 @@
+/*
+* Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:  JavaCommDB definition
+ *
+*/
+
+
+#ifndef JAVACOMMDB_H
+#define JAVACOMMDB_H
+
+#include <commsdattypesv1_1.h>
+#include <commsdat.h>
+#include <metadatabase.h>
+#include "com_nokia_mid_iapinfo_CommsTable.h"
+
+using namespace CommsDat;
+
+/**
+ *  Class implements the native part of Java CommDB API.
+ *
+ *  @lib j9_23_commdb.lib
+ *  @since S60 v3.0
+ */
+class JavaCommDB
+//:
+//    public CJavaPeer<JavaCommDB>
+
+{
+
+public:
+
+    ~ JavaCommDB();
+
+    /**
+     * Opens the given table.
+     * @since S60 v3.0
+     * @param aTablename name of the CommDB table to be opened
+     * @return error code
+     */
+    void OpenL(const TDesC&);
+
+    /**
+     * Close the table and delete allocated member objects.
+     * @since S60 v3.0
+     * @return error code
+     */
+    TInt Close();
+
+    /**
+     * Get number of records in the current table.
+     * @since S60 v3.0
+     * @return record count
+     */
+    TInt GetRecordCount();
+
+    /**
+     * Retrieves the value of the given field from the actual record.
+     * The field contains integer type value.
+     * @since S60 v3.0
+     * @param aFieldName name of the field.
+     * @return integer value of the field
+     */
+    TInt GetIntFieldValueL(const TDesC& aFieldName);
+
+    /**
+     * Retrieves the value of the given field from the actual record.
+     * The field contains string type value.
+     * @since S60 v3.0
+     * @param aFieldName name of the field.
+     * @return String value of the field
+     */
+    HBufC* GetStringFieldValueL(const TDesC& aFieldName);
+
+    /**
+     * Moves the actual record pointer to the next record.
+     * @since S60 v3.0
+     * @return number of the actual record
+     */
+    TInt Next();
+
+    /**
+     * Moves the actual record pointer to the previous record.
+     * @since S60 v3.0
+     * @return number of the actual record
+     */
+    TInt Previous();
+
+    /**
+     * Finds a record in the current table by its name.
+     * The search is case sensitive.
+     * If the record exists the current record will be changed to this record.
+     * @since S60 v3.0
+     * @param aFieldName name of the record
+     * @return with the RecordId of the found record, KErrNotFound if no record found with the given name.
+     */
+    TInt FindByNameL(const TDesC& aFieldName);
+
+    /**
+     * Finds a record in the current table by its RecordId. If the record exists
+     * the current record will be changed to this record.
+     * @since S60 v3.0
+     * @param aId RecordId of the record
+     * @return with the RecordId of the found record, KErrNotFound if no record found with the given RecordId.
+     */
+    TInt FindById(TInt aId);
+
+private:
+
+    /**
+     * Stores the number of the current record.
+     */
+    TInt iCurrentRecord;
+
+    /**
+     * Pointer to the actual DB Session object.
+     * Initialized in the Open() function.
+     */
+    CMDBSession* iDb;
+
+    /**
+     * Pointer to the current RecordSet object.
+     * Initialized in the Open() function.
+     */
+    CMDBRecordSet<CCDRecordBase>* iTable;
+};
+
+#endif // JAVACOMMDB_H
+