Example on how to create database and table

examples/interfaces/create.cpp

@@ -0,0 +1,147 @@
+/*
+ *	PROGRAM:	Object oriented API samples.
+ *	MODULE:		create.cpp
+ *	DESCRIPTION:	A sample of creating new database and new table in it.
+ *					Run something like this to build: c++ create.cpp -lfbclient
+ *
+ *  The contents of this file are subject to the Initial
+ *  Developer's Public License Version 1.0 (the "License");
+ *  you may not use this file except in compliance with the
+ *  License. You may obtain a copy of the License at
+ *  http://www.ibphoenix.com/main.nfs?a=ibphoenix&page=ibp_idpl.
+ *
+ *  Software distributed under the License is distributed AS IS,
+ *  WITHOUT WARRANTY OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing rights
+ *  and limitations under the License.
+ *
+ *  The Original Code was created by Alexander Peshkoff
+ *  for the Firebird Open Source RDBMS project.
+ *
+ *  Copyright (c) 2013 Alexander Peshkoff <peshkoff@mail.ru>
+ *  and all contributors signed below.
+ *
+ *  All Rights Reserved.
+ *  Contributor(s): ______________________________________.
+ */
+
+#include <stdlib.h>
+#include <stdio.h>
+#include <string.h>
+
+#include <ibase.h>
+#include <firebird/Provider.h>
+
+using namespace Firebird;
+
+// Here we get access to master interface. This is main interface of firebird,
+// and the only one for getting which there is special function in our API.
+static IMaster* master = fb_get_master_interface();
+
+// Probably not best way of error processing, but it's OK for a sample
+static void check(IStatus* s, const char* text)
+{
+	if (!s->isSuccess())
+		throw text;
+}
+
+int main()
+{
+	int rc = 0;
+
+	// set default password if none specified in environment
+	setenv("ISC_USER", "sysdba", 0);
+	setenv("ISC_PASSWORD", "masterkey", 0);
+
+	// Declare pointers to required interfaces
+	// IStatus is used to return wide error description to user
+	IStatus* st = NULL;
+	// IProvider is needed to start to work with database (or service)
+	IProvider* prov = NULL;
+	// IAttachment and ITransaction contain methods to work with database attachment
+	// and transactions
+	IAttachment* att = NULL;
+	ITransaction* tra = NULL;
+
+	try
+	{
+		// status vector and main dispatcher are returned by calls to IMaster functions
+		// no error return may happen - this functions always succeed
+		st = master->getStatus();
+		prov = master->getDispatcher();
+
+		// create DPB (to be replaced with IPBWriter)
+		unsigned char dpbBuf[32];
+		unsigned char *dpb = dpbBuf;
+		*dpb++ = isc_dpb_version1;
+		*dpb++ = isc_dpb_page_size;
+		*dpb++ = 2;
+		*dpb++ = (8 * 1024) & 0xFF;
+		*dpb++ = (8 * 1024) >> 8;
+
+		// create empty database
+		att = prov->createDatabase(st, "fbtests.fdb", dpb - dpbBuf, dpbBuf);
+		check(st, "createDatabase");
+		printf("Database fbtests.fdb created\n");
+
+		// detach from database
+		att->detach(st);
+		check(st, "detach");
+		att = NULL;
+
+		// attach employee db
+		att = prov->attachDatabase(st, "fbtests.fdb", 0, NULL);
+		check(st, "attachDatabase");
+		printf("Re-attached database fbtests.fdb\n");
+
+		// start transaction
+		tra = att->startTransaction(st, 0, NULL);
+		check(st, "startTransaction");
+
+		// create table
+		att->execute(st, tra, 0, "create table dates_table (d1 date)", 3,
+			NULL, NULL, NULL, NULL);	// Input parameters and output data not used
+		check(st, "execute");
+
+		// commit transaction retaining
+		tra->commitRetaining(st);
+		check(st, "commitRetaining");
+		printf("Table dates_table created\n");
+
+		// insert a record into dates_table
+		att->execute(st, tra, 0, "insert into dates_table values (CURRENT_DATE)", 3,
+			NULL, NULL, NULL, NULL);	// Input parameters and output data not used
+		check(st, "execute");
+
+		// commit transaction retaining
+		tra->commit(st);
+		check(st, "commit");
+		tra = NULL;
+		printf("Record inserted into dates_table\n");
+
+		// close interfaces
+		att->detach(st);
+		check(st, "detach");
+		att = NULL;
+	}
+	catch(const char* text)
+	{
+		// handle error
+		rc = 1;
+		fprintf(stderr, "%s:\n", text);
+		if (st)
+			isc_print_status(st->get());
+	}
+
+	// release interfaces after error caught
+	if (tra)
+		tra->release();
+	if (att)
+		att->release();
+	if (prov)
+		prov->release();
+	if (st)
+		st->dispose();
+
+	return rc;
+}