Yii Framework 开发教程(26) 数据库-Active Record示例

た入场券 2023-10-16 19:17 52阅读 0赞

使用Java或是.Net 写数据库应用，很多人都用过Hibernate（或NHibernate）可以大大简化数据库编程，而以对象的方式来读写数据库（ORM），Yii提供的Active Record (AR) 也是一个流行的 对象-关系映射 (ORM) 技术。每个 AR 类代表一个数据表（或视图），数据表（或视图）的列在 AR 类中体现为类的属性，一个 AR 实例则表示表中的一行。 常见的 CRUD 操作作为 AR 的方法实现。因此，我们可以以一种更加面向对象的方式访问数据。

这里修改[Yii Framework 开发教程(24) 数据库-DAO 示例][Yii Framework _24_ _-DAO] ，看看使用Active Record如何读取Employee表。

要访问一个数据表，我们首先需要通过集成 [CActiveRecord][] 定义一个 AR 类。 每个 AR 类代表一个单独的数据表，一个 AR 实例则代表那个表中的一行。

由于 AR 类经常在多处被引用，我们可以导入包含 AR 类的整个目录，而不是一个个导入。 例如，如果我们所有的 AR 类文件都在 `protected/models` 目录中，我们可以配置应用如下：

**\[php\]** [ view plain][view plain] [copy][view plain] [print][view plain] [?][view plain]

1.  'import'=>array(
2.  'application.models.\*',
3.  ),

'import'=>array(
    	'application.models.*',
    	),

本例定义Employee类如下：

**\[php\]** [ view plain][view plain] [copy][view plain] [print][view plain] [?][view plain]

1.  class Employee extends CActiveRecord
2.  \{
3.  public static function model($className=\_\_CLASS\_\_)
4.  \{
5.  return parent::model($className);
6.  \}
7.  
8.  public function tableName()
9.  \{
10. return 'Employee';
11. \}
12. \}

class Employee extends CActiveRecord
    {
    	public static function model($className=__CLASS__)
    	{
    		return parent::model($className);
    	}
    
    	public function tableName()
    	{
    		return 'Employee';
    	}
    }

数据表行中列的值可以作为相应 AR 实例的属性访问。比如 $employee->EmployeeId 可以访问Employee的EmployeeId字段。

本例只是读取Employee表，修改SiteController的indexAction方法：

**\[php\]** [ view plain][view plain] [copy][view plain] [print][view plain] [?][view plain]

1.  public function actionIndex()
2.  \{
3.  
4.  $model = Employee::model()->findAll();
5.  
6.  $this\->render('index', array(
7.  'model' => $model,
8.  
9.  ));
10. \}

public function actionIndex()
    {
    
    	$model = Employee::model()->findAll();
    
    	$this->render('index', array(
    		'model' => $model,
    
    		));
    }

可以看到只要一行代码 Employee::model()->findAll()就实现读取数据库表并赋值功能，来看看对应的显示记录的代码：

**\[php\]** [ view plain][view plain] [copy][view plain] [print][view plain] [?][view plain]

1. <?php foreach($model as $employee)
2. \{
3. 
4. echo 'EmployeeId:' . $employee\->EmployeeId . ' ';
5. echo 'First Name:' . $employee\->FirstName . ' ';
6. echo 'Last Name:' . $employee\->LastName . ' ';
7. echo 'Title:' . $employee\->Title . ' ';
8. echo 'Address:' . $employee\->Address . ' ';
9. echo 'Email:' . $employee\->Email . ' ';
10. echo '---------------------- ';
11. \}
12. 
13. ?>

<?php foreach($model as $employee)
 {
 
 	echo 'EmployeeId:' . $employee->EmployeeId . ' ';
 	echo 'First Name:' . $employee->FirstName . ' ';
 	echo 'Last Name:' . $employee->LastName . ' ';
 	echo 'Title:' . $employee->Title . ' ';
 	echo 'Address:' . $employee->Address . ' ';
 	echo 'Email:' . $employee->Email . ' ';
 	echo '---------------------- ';
 }
 
 ?>

可以看到使用AR可以通过数据库表的字段名（区分大小写）直接访问某个字段值，而无需在类Employee定义，从而大大简化代码。  
在前面介绍Model时说过CModel有两个子类，一个是FormModel，另外一个就是CActiveRecord，CActiveRecord定义了数据库访问的CRUD方法，比如

### 创建记录 ###

要向数据表中插入新行，我们要创建一个相应 AR 类的实例，设置其与表的列相关的属性，然后调用 [save()][save] 方法完成插入

**\[php\]** [ view plain][view plain] [copy][view plain] [print][view plain] [?][view plain]

1.  $employee=new Employee;
2.  $employee\->FirstName='James';
3.  $employee\->LastName='Shen';
4.  ...
5.  $employee\->save();

$employee=new Employee;
    $employee->FirstName='James';
    $employee->LastName='Shen';
    ...
    $employee->save();

如果表的主键是自增的，在插入完成后，AR 实例将包含一个更新的主键。如果一个列在表结构中使用了静态默认值（例如一个字符串，一个数字）定义。

### 读取记录 ###

要读取数据表中的数据，我们可以通过如下方式调用 `find` 系列方法中的一种

**\[php\]** [ view plain][view plain] [copy][view plain] [print][view plain] [?][view plain]

1.  // 查找满足指定条件的结果中的第一行
2.  $post=Post::model()->find($condition,$params);
3.  // 查找具有指定主键值的那一行
4.  $post=Post::model()->findByPk($postID,$condition,$params);
5.  // 查找具有指定属性值的行
6.  $post=Post::model()->findByAttributes($attributes,$condition,$params);
7.  // 通过指定的 SQL 语句查找结果中的第一行
8.  $post=Post::model()->findBySql($sql,$params);

// 查找满足指定条件的结果中的第一行
    $post=Post::model()->find($condition,$params);
    // 查找具有指定主键值的那一行
    $post=Post::model()->findByPk($postID,$condition,$params);
    // 查找具有指定属性值的行
    $post=Post::model()->findByAttributes($attributes,$condition,$params);
    // 通过指定的 SQL 语句查找结果中的第一行
    $post=Post::model()->findBySql($sql,$params);

如上所示，我们通过 `Post::model()` 调用 `find` 方法。 请记住，静态方法 `model()` 是每个 AR 类所必须的。 此方法返回在对象上下文中的一个用于访问类级别方法（类似于静态类方法的东西）的 AR 实例。

如果 `find` 方法找到了一个满足查询条件的行，它将返回一个 `Post` 实例，实例的属性含有数据表行中相应列的值。 然后我们就可以像读取普通对象的属性那样读取载入的值，例如 `echo $post->title;`。

如果使用给定的查询条件在数据库中没有找到任何东西， `find` 方法将返回 null 。

调用 `find` 时，我们使用 `$condition` 和 `$params` 指定查询条件。此处 `$condition` 可以是 SQL 语句中的`WHERE` 字符串，`$params` 则是一个参数数组，其中的值应绑定到 `$condation` 中的占位符。

### 更新记录 ###

在 AR 实例填充了列的值之后，我们可以改变它们并把它们存回数据表。

**\[php\]** [ view plain][view plain] [copy][view plain] [print][view plain] [?][view plain]

1.  $post=Post::model()->findByPk(10);
2.  $post\->title='new post title';
3.  $post\->save(); // 将更改保存到数据库

$post=Post::model()->findByPk(10);
    $post->title='new post title';
    $post->save(); // 将更改保存到数据库

### 删除记录 ###

如果一个 AR 实例被一行数据填充,我们也可以删除此行数据

**\[php\]** [ view plain][view plain] [copy][view plain] [print][view plain] [?][view plain]

1.  $post=Post::model()->findByPk(10); // 假设有一个帖子，其 ID 为 10
2.  $post\->delete(); // 从数据表中删除此行

$post=Post::model()->findByPk(10); // 假设有一个帖子，其 ID 为 10
    $post->delete(); // 从数据表中删除此行

注意，删除之后， AR 实例仍然不变，但数据表中相应的行已经没了

其它可以参见[Yii中文文档][Yii]，这里不再详细复述了。  
本例显示结果：  
[![201212127004][]][201212127004 1]本例[下载][Link 1]

[Yii Framework _24_ _-DAO]: http://www.imobilebbs.com/wordpress/archives/4036
[CActiveRecord]: http://www.yiiframework.com/doc/api/1.1/CActiveRecord
[view plain]: http://blog.csdn.net/mapdigit/article/details/8449259#
[save]: http://www.yiiframework.com/doc/api/1.1/CActiveRecord#save
[Yii]: http://www.yiiframework.com/doc/guide/1.1/zh_cn/database.ar
[201212127004]: http://www.imobilebbs.com/wordpress/wp-content/uploads/2012/12/201212127004.png
[201212127004 1]: http://www.imobilebbs.com/wordpress/archives/4047/attachment/201212127004
[Link 1]: http://www.imobilebbs.com/download/yii/ActiveRecordDemo.zip