widgets/data_list/PEARSQLDataListSource.inc

<?php

/**
 * This file contains the SQLDataListSource child class
 * that uses the PEAR DB object to talk to the DB.
 *
 * @author Walter A. Boring IV <waboring@buildabetterweb.com>
 * @package phpHtmlLib
 */

/**
 * This requires the SQLDataListSource
 * parent class
 *
 */
include_once($phphtmllib."/widgets/data_list/SQLDataListSource.inc");

/**
 * Have to have PEAR and DB included
 * the pear dir must be in the 
 * include path.
 */
require_once("PEAR.php");
require_once("DB.php");

/**
 * This SQLDataListSource child class interacts with
 * with the specific DB via the php PEAR DB abstraction
 * objects.
 *
 * How to use?
 * in the DataList child's get_data_source() method
 * you pass in the already connected PEAR DB object
 * in to the constructor.  PEARSQLDataListSource 
 * takes care of the rest.
 *
 * @author Walter A. Boring IV <waboring@buildabetterweb.com>
 * @package phpHtmlLib
 */
class PEARSQLDataListSource extends SQLDataListSource {

        /**
         * This var holds the Database object
         * that is used to do the sql queries
         * It is assumed that the db is already
         * connected to, and the object provides
         * 2 methods:
         * query() - execute a sql query
         */
        var $_db = NULL;

        /**
         * this holds the query result from the
         * PEAR::DB->query() call
         *
         */
        var $_result = NULL;


        /**
         * The constructor is used to pass in the
         * PEAR DB object that has already been
         * created and connected to the db.
         *
         * @param PEAR::DB object - MUST BE CONNECTED
         */
        function PEARSQLDataListSource( &$db ) {
                $this->set_db_object( $db );
        }
        
        /**
     * Set the DB object we will use
     * to talk to the DB.
     *
     * @param  object - $db the babw_db object.
     */
    function set_db_object( &$db ) {
        $this->_db = &$db;
    }

    /**
         * This is the function that does the data fetching,
         * and sorting if needed.  
         * If the source is a sql database, this is where the
         * query gets called.  This function doesn't actually read the
         * data from the DB yet.  That is what get_next_data_row()
         * does.
     *  
         * @return boolean - the query passed/failed. 
         */
        function do_query() {
                $this->_result = $this->_db->query($this->_query);
                if (DB::isError($this->_result)) {
                        $msg = $this->_result->getMessage();
                        user_error("PEARSQLDataListSource::do_query() - query failed : ".$msg);
            return false;
                } else {
            return true;
        }
        }

        
        /**
         * This function gets the next data row
         * from the query()
         *
         * @return array()
         */
        function get_next_data_row() {
                return $this->_result->fetchRow(DB_FETCHMODE_ASSOC);
        }

        /**
     * This function builds the limit
     * clause portion of a DB query.
     *
     * @return string - the limit portion of 
     *                  the query.
     */
    function build_limit_clause($offset, $limit) {
        if ($this->get_limit() != -1 ) {
                        if ($offset == '' || $offset == "none") {
                                $offset = 0;
                        }
                        switch(get_class($this->_db)) {
                        case "db_mysql":
                                $clause = " LIMIT $offset, $limit ";
                                break;
                        case "db_pgsql":
                                $clause = " LIMIT $limit, $offset ";
                                break;
                        default:
                                $clause = " LIMIT $offset, $limit ";
                                break;
                        }
            return $clause;
        } else {
            return NULL;
        }
    }
    
    /**
     * find the number of rows to be returned 
     * from a query from a table and where clause
     *
     * @param string $table - the table to count from
     * @param string $where_clause - a where clause
     *
     * @return int the # of rows
     */
    function count($tables, $where_clause='', $count_clause='*') {
                $query = "select count(".$count_clause.") as COUNT from ".$tables." ".$where_clause;
        $result = $this->_db->query($query);
                if (DB::isError($result)) {
                        $msg = $result->getMessage();
                        user_error("PEARSQLDataListSource::count() - query failed : ".$msg);
            return 0;
                } else {
            $value = $result->fetchRow(DB_FETCHMODE_ASSOC);
            return ($value ? (int)$value["COUNT"] : NULL);
        }               
    }
    
}

?>
1	<?php
2
3	/**
4	* This file contains the SQLDataListSource child class
5	* that uses the PEAR DB object to talk to the DB.
6	*
7	* @author Walter A. Boring IV <waboring@buildabetterweb.com>
8	* @package phpHtmlLib
9	*/
10
11	/**
12	* This requires the SQLDataListSource
13	* parent class
14	*
15	*/
16	include_once($phphtmllib."/widgets/data_list/SQLDataListSource.inc");
17
18	/**
19	* Have to have PEAR and DB included
20	* the pear dir must be in the
21	* include path.
22	*/
23	require_once("PEAR.php");
24	require_once("DB.php");
25
26	/**
27	* This SQLDataListSource child class interacts with
28	* with the specific DB via the php PEAR DB abstraction
29	* objects.
30	*
31	* How to use?
32	* in the DataList child's get_data_source() method
33	* you pass in the already connected PEAR DB object
34	* in to the constructor. PEARSQLDataListSource
35	* takes care of the rest.
36	*
37	* @author Walter A. Boring IV <waboring@buildabetterweb.com>
38	* @package phpHtmlLib
39	*/
40	class PEARSQLDataListSource extends SQLDataListSource {
41
42	/**
43	* This var holds the Database object
44	* that is used to do the sql queries
45	* It is assumed that the db is already
46	* connected to, and the object provides
47	* 2 methods:
48	* query() - execute a sql query
49	*/
50	var $_db = NULL;
51
52	/**
53	* this holds the query result from the
54	* PEAR::DB->query() call
55	*
56	*/
57	var $_result = NULL;
58
59
60	/**
61	* The constructor is used to pass in the
62	* PEAR DB object that has already been
63	* created and connected to the db.
64	*
65	* @param PEAR::DB object - MUST BE CONNECTED
66	*/
67	function PEARSQLDataListSource( &$db ) {
68	$this->set_db_object( $db );
69	}
70
71	/**
72	* Set the DB object we will use
73	* to talk to the DB.
74	*
75	* @param object - $db the babw_db object.
76	*/
77	function set_db_object( &$db ) {
78	$this->_db = &$db;
79	}
80
81	/**
82	* This is the function that does the data fetching,
83	* and sorting if needed.
84	* If the source is a sql database, this is where the
85	* query gets called. This function doesn't actually read the
86	* data from the DB yet. That is what get_next_data_row()
87	* does.
88	*
89	* @return boolean - the query passed/failed.
90	*/
91	function do_query() {
92	$this->_result = $this->_db->query($this->_query);
93	if (DB::isError($this->_result)) {
94	$msg = $this->_result->getMessage();
95	user_error("PEARSQLDataListSource::do_query() - query failed : ".$msg);
96	return false;
97	} else {
98	return true;
99	}
100	}
101
102
103
104	/**
105	* This function gets the next data row
106	* from the query()
107	*
108	* @return array()
109	*/
110	function get_next_data_row() {
111	return $this->_result->fetchRow(DB_FETCHMODE_ASSOC);
112	}
113
114	/**
115	* This function builds the limit
116	* clause portion of a DB query.
117	*
118	* @return string - the limit portion of
119	* the query.
120	*/
121	function build_limit_clause($offset, $limit) {
122	if ($this->get_limit() != -1 ) {
123	if ($offset == '' \|\| $offset == "none") {
124	$offset = 0;
125	}
126	switch(get_class($this->_db)) {
127	case "db_mysql":
128	$clause = " LIMIT $offset, $limit ";
129	break;
130	case "db_pgsql":
131	$clause = " LIMIT $limit, $offset ";
132	break;
133	default:
134	$clause = " LIMIT $offset, $limit ";
135	break;
136	}
137	return $clause;
138	} else {
139	return NULL;
140	}
141	}
142
143	/**
144	* find the number of rows to be returned
145	* from a query from a table and where clause
146	*
147	* @param string $table - the table to count from
148	* @param string $where_clause - a where clause
149	*
150	* @return int the # of rows
151	*/
152	function count($tables, $where_clause='', $count_clause='*') {
153	$query = "select count(".$count_clause.") as COUNT from ".$tables." ".$where_clause;
154	$result = $this->_db->query($query);
155	if (DB::isError($result)) {
156	$msg = $result->getMessage();
157	user_error("PEARSQLDataListSource::count() - query failed : ".$msg);
158	return 0;
159	} else {
160	$value = $result->fetchRow(DB_FETCHMODE_ASSOC);
161	return ($value ? (int)$value["COUNT"] : NULL);
162	}
163	}
164
165	}
166
167	?>
MailToCvsAdmin">MailToCvsAdmin	ViewVC Help
Powered by ViewVC 1.1.26