<?php 

/**
 * HFramework 数据库操作类
 * 本类基于PHP PDO开发，阅读本类，您需要有PHP PDO 方面的知识
 */
class HDb{

	/**
	 * 构造函数
	 * @param menu $dbType 待操作的数据库类型，
	 * 可选值为：master、slave，分别表示主数据库、从数据库
	 */
	function __construct($type = 'master')
	
	/**
	 * 删除扩展字段
	 * @param string $tableName 仅限适用的数据表的表名
	 */
	public function removeExtFields($tableName)
	
	/**
	 * 设置回调函数
	 * 相同的场景多次调用此方法，只会以最后一次调用为准
	 * @param string $scene 触发的场景，可选值有:INSERT/DELETE/UPDATE/SELECT，分别表示插入、更新、删除时触发
	 * @param string $tableName 适用的数据表的表名，只有此表被插入时才会触发对应的回调函数
	 * @param mixed $callback 可回调的函数，参数可接收的类型有：
	 * 此参数可以是一个string 型函数名，函数必须是全局可访问的
	 * 此参数可以是一个array型一维数组索引，数组第一项可以是类名或者类的实例，第二项是类的方法名；如果第一项是类名，则第二项必须是静态方法
	 * 注：$callback对应的函数需要有2个参数，第一个参数用于接收当前执行的SQL语句，第2个参数用于接收当前绑定的参数
	 */
	public static function setCallback($scene, $tableName, $callback)
	
	/**
	 * 删除回调
	 * @param string $scene 触发的场景，可选值有:INSERT/DELETE/UPDATE/SELECT，分别表示插入/删除/更新/查找 时触发
	 * @param string $tableName 仅限适用的数据表的表名
	 * @return void 无返回值
	 */
	public static function removeCallback($scene, $tableName)
	
	/**
	 * 从SQL语句中提炼表名和操作
	 * @param string $sql SQL语句
	 * @return array 一位索引数组，array[0] 表示表名， array[1]表示操作
	 */
	public static function getTableScene($sql)

	/**
	 * 执行SQL语句
	 * @param string $sql SQL语句
	 * @param array $params 绑定参数,格式为 array(':column1'=>'myData1', ':column2'=>'myData'...)
	 * @return boolen true=成功；失败返回false，异常会抛出错误
	 * 注：执行成功未必更新了数据（如执行后前后为变化）
	 */
	public function execute($sql, $params=array())
	
	/**
	 * 获取上一个 SQL语句操作后影响的行数
	 * @return int 行数
	 * 注：如果$sql中包含多个英文分号分隔的SQL语句，则获取更新行数时，返回第一个SQL语句的影响行数
	 */
	public function rowCount()
	
	/**
	 * 获取当前数据库连接的最后一次插入的记录ID(或者序列)
	 * 经实际测试，此方法不会对所有的数据库有效，例如对postgresSQL是无效的。
	 * @return string ID或者序列
	 */
	public function lastInsertId()
	
	/**
	 * 查询一条记录
	 * @param string $sql SQL语句，如果sql参数中没有“limit”关键词，则此方法会在SQL结尾自动添加"LIMIT 0 OFFSET 1" （此limit写法，兼容性更好)
	 * @param array $params 绑定参数，一维数组
	 * @return $mixed 成功返回 array（一维关联数组），失败返回 boolen false
	 * 判断是否查到数据，可以使用  !==false 或者 is_array() 判断，
	 * 不可以用 count(),因为count(false)的返回值是 1，
	 * 也不建议直接使用  if(返回值) 判断结果，因为 if(array())的返回值是false
	 */
	public function getRow($sql, $params = array())
	
	/**
	 * 查询多条记录
	 * @param string $sql  SQL语句，因为默认是查询所有符合条件的记录，数据量可能会很大，建议在SQL中使用limit语句
	 * @param array $params 绑定参数，一维数组
	 * @return array 二维关联数组，没有查到数据返回空数组
	 */
	public function getRows($sql, $params = array())

	/**
	 * 获取execute方法执行后返回的结果集
	 * 每次执行获取一行记录，多次执行则逐行依次返回
	 * @return mixed 成功返回 array一维关联数组，没有取到数据返回 boolen false
	 */
	public function fetch()
	
	/**
	 * 获取execute方法执行后返回的全部记录
	 * @return array 成功返回  array，没有取到数据返回空数组
	 */
	public function fetchAll()
	
	/**
	 * 启动事务
	 * @param object $creater 调用事务的对象
	 * 此参数用于实现事务的嵌套（标记事务的第最外层创建者，只有最外层创建者才能提交和回滚事务）
	 * @return boolen 成功返回 true， 或者在失败时返回 false
	 */
	public function transBegin($creater=null)
	
	/**
	 * 提交事务
	 * 内层嵌套的事务不会真正提交
	 * 如果内层事务已回滚外层事务提交会抛出错误
	 * @param object $creater 调用事务的对象
	 * @return boolen 成功返回 true， $this->_pdo->commit();在失败时返回 false
	 */
	public function transCommit($creater=null)
	
	/**
	 * 回滚事务
	 * 内层嵌套的事务不会真正回滚
 	 * 如果内层回滚，外层事务将不能提交（强制提交会抛出错误）
	 * @param object $creater 调用事务的对象，可以赋值为任何类的实例，用于判断事物嵌套关系
	 * @param string $errorMsg 回滚原因，用于其他对象捕获错误信息
	 * @return boolen 成功返回 true， 或者在失败时返回 false在
	 * 注：子事务中回滚，会一直返回false
	 */
	public function transRollback($creater=null, $errorMsg='')
	
	/**
	 * 单利模式实例化SQL条件对象
	 * 仅用于模型类创建查询条件
	 * @return object HDbCondition对象
	 */
	public function condition()
	
	/**
	 * 打印所有执行过的SQL语句和绑定的参数
	 * 仅在调试模式下有效
	 * @return void
	 */
	public function debug()
	
	/**
	 * 创建PDO对象,具体参数请参阅PHP的官方文档
	 * @param string $dsn  PDO配置参数
	 * @param string $username  数据库用户名
	 * @param stirng $password 数据库密码
	 * @param $driver_options  array PDO驱动相关的配置
	 */
	private function createPdo($dsn, $username, $password, $driver_options)

	/**
	 * 转换SQL语句
	 * 将表前缀转换与表名合并
	 * @param string $sql SQL语句
	 * @return string 合并后的SQL语句
	 */
	private function convertSql($sql)
}
?>