<?php 
/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.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.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

require_once ("database.php");

/** 
 * This class gives implementation of MySQL database
 */
class MySQLDatabase extends Database
{
	/**
	 * handle to the database
	 */
	protected $dbhandle;

	/**
	 * Connection informations
	 */
	public $connectionInfo;

	/**
	 * Constructor
	 * @param connectioninfo
	 */
	public function MySQLDatabase($connInfo)
	{
		$this->connectionInfo = $connInfo;	
	}

	/**
	 * This method establishes a connection to the database. 
	 * @return boolean, upon successfull execution true is returned. 
	 * Otherwise false will be returned. 
	 */
	public function ConnectToDatabase()
	{
		if ($this->connectionInfo != NULL)
		{
			$this->dbhandle = mysql_connect($this->connectionInfo->server, $this->connectionInfo->user, $this->connectionInfo->password)
				or die ("Couldn't connect to the server!!!");
			$selected = mysql_select_db($this->connectionInfo->database, $this->dbhandle) 
				or die ("Couldn't open the database!!!");
		}
		return true;
	}

	/**
	 * This method close the connection that is established to the
	 * database.
	 */
	public function CloseDatabase()
	{
		mysql_close($this->dbhandle);
	}

	/**
	 * This method executes a query that it receives.
	 * @param query the query to execute
	 * @return non-NULL upon success and NULL otherwise.
	 */
	public function ExecuteQuery($query)
	{
		return mysql_query($query, $this->dbhandle);
	}

	/**
	 * This method returns the a value from a sql result set (a tuple
	 * returned after execution of ExecuteQuery method.
	 * @param result, the result obtained from ExecuteQuery method.
	 * @return the value at (raw, column) of the tuple.
	 */
	public function GetSQLValue($result)
	{
		return mysql_fetch_array($result, MYSQL_BOTH);
	}

	/**
	 * Gets the ID of the last inserted record. returns -1 if error. 
	 */
	public function GetInsertID()
	{
		$insertID = mysql_insert_id($this->dbhandle);
		if($insertID == NULL)
		{
			return -1;
		}
		else
		{
			return $insertID;
		}
	}

	/**
	 * Begin a transaction. return status will be not null if success
	 */
	public function BeginTransaction()
	{
		return $this->ExecuteQuery("START TRANSACTION");
	}

	/**
	 * Commit a transaction.  return status will be not null if success
	 */
	public function CommitTransaction()
	{
		return $this->ExecuteQuery("COMMIT");
	}

	/**
	 * Rollback a transaction. return status will be not null if success
	 */
	public function RollbackTransaction()
	{
		return $this->ExecuteQuery("ROLLBACK");
	}
}
?>