File Source for Database.class.php

<?php
/**
* @package databases
*/
/**
* @package databases
* @version 0.1.44
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @license http://www.gnu.org/copyleft/lesser.html
* GNU Lesser General Public License
* @copyright Copyright (C) 2003 Daniel PlÃ¼cken <daniel@debakel.net>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General
* Public License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place, Suite 330,
* Boston, MA 02111-1307 USA
*/
class Database
{
/**
* The name of this database.
*
* @var string $name
* @access public
*/
var $name;
/**
* Carries the databasetable's objects of this database.
*
* @var array $dbt
* @access private
*/
var $dbt;
/**
* Carryies the view's objects of this database.
*
* @var array $view
* @access private
*/
var $view;
/**
* Refers to the databasehost in which this database lies.
*
* @var object $parent
* @access public
*/
var $parent;
/**
* The last stored databasequery.
*
* @var string $last_query
* @access public
*/
var $last_query;
/**
* Carries the name of a function which has to be invoked on a connection
* error.
*
* @access public
* @var function $error_callback
*/
var $error_callback = null;
/**
* Constructor
*
* @version 1.1
* @since 0.1.0
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @param string $name
* @param object $parent
*/
function Database( $name, $parent = "" )
{
if ( !empty( $name ) )
{
$this->name = $name;
$this->parent = $parent;
}
else
die(
"<h3>You have to give a name to this database!</h3>"
."<b>Use following Syntax:<b><br><br>\r\n"
."<pre>\r\n"
." \x24db = new Database( \x24name );\r\n"
."</pre>\r\n"
);
}
/**
* Sets the name of the function that should be invoked on a connection error.
* The function to call back has to have two parameter. The first parameter is
* for the error code. The second one contains the errordescription.
*
* @version 1.0
* @since 0.1.43
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @param string $function_name_str
* @return void
*/
function setErrorCallback( $function_name_str )
{ $this->error_callback = $function_name_str; }
/**
* Adds a databasetable's reference to this object of a database.
*
* @version 1.1
* @since 0.1.0
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @param object $dbt_obj
*/
function addDBT( &$dbt_obj )
{
if(
!function_exists( "is_a" )
&& (
get_class( $dbt_obj ) == "abstdatabasetable"
|| get_parent_class( $dbt_obj ) == "abstdatabasetable"
)
)
{
$dbt_obj->setParent( $this );
$this->dbt[] = $dbt_obj;
}
else
if(
function_exists( "is_a" )
&& (
is_a( $dbt_obj, "ABSTDatabaseTable" )
|| is_subclass_of( $dbt_obj, "ABSTDatabaseTable" )
)
)
{
$dbt_obj->setParent( $this );
$this->dbt[] = $dbt_obj;
}
else
die(
"<h3>The parameter does not refer to "
."a valid object of a databasetable!</h3>"
);
}
/**
* Adds a view's reference to this object of a database.
*
* @version 1.1
* @since 0.1.2
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @param object $view_obj
*/
function addView( &$view_obj )
{
if(
!function_exists( "is_a" )
&& (
get_class( $view_obj ) == "view"
|| get_parent_class( $view_obj ) == "view"
)
)
$this->view[] = $view_obj;
else
if(
function_exists( "is_a" )
&& (
is_a( $view_obj, "View" )
|| is_subclass_of( $view_obj, "view" )
)
)
$this->view[] = $view_obj;
else
die(
"<h3>The parameter does not refer to "
."a valid object of a database view!</h3>"
);
}
/**
* Returns the array of references to the databasetables.
*
* @version 1.0
* @since 0.1.0
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @return string
*/
function &getDatabaseTables ()
{ return $this->dbt; }
/**
* Returns the array of references to the views.
*
* @version 1.0
* @since 0.1.2
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @return string
*/
function &getViews ()
{ return $this->view; }
/**
* Returns the databasename.
*
* @version 1.0
* @since 0.1.0
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @return string
*/
function getDatabase()
{ return $this->name; }
/**
* Returns the databasename. This method is an alias for the method
* getDatabase()
*
* @version 1.0
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @return string
*/
function getName()
{ return $this->name; }
/**
* Returns the last stored database query.
*
* @version 1.0
* @since 0.1.3
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @return array
*/
function getLastQuery()
{ return $this->last_query; }
/**
* Sets the parent of this object.
*
* @version 1.2
* @since 0.1.1
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @param object
* @return void
*/
function setParent( &$obj_ref )
{
if(
!function_exists( "is_a" )
&& (
get_class( $obj_ref ) == "abstdatabasehost"
|| get_parent_class( $obj_ref ) == "abstdatabasehost"
)
)
$this->parent = &$obj_ref;
else
if(
function_exists( "is_a" )
&& (
is_a( $obj_ref, "ABSTDatabaseHost" )
|| is_subclass_of( $obj_ref, "ABSTDatabaseHost" )
)
)
$this->parent = &$obj_ref;
else
die(
"<h3>The given parameter is not a reference "
."of an object of a databasehost!</h3>"
);
}
/**
* Returns the id of the connection resource to the database host.
*
* @access public
* @version 1.0
* @since 0.1.44
*
* @return object
*/
function &getResourceID()
{ return $this->parent->getResourceID(); }
} // End of class Database
?>

Source for file Database.class.php