CakePHP 2.x CookBook 中文版 第七章 模型

模型

模型是应用程序中业务层的类。

这意味着它们负责管理工作域中几乎所有的与数据有关的东西:数据校验、交互和信息流演化。

通常模型类代理数据,用于 CakePHP 应用程序的数据访问,多数时候它们代理数据库表,但并不限于此,它也可以访问操纵数据的任何事物,如文件、外部 web service、iCal 事件或者一个 CSV 文件的行。

一个模型可以与其它模型相关联。例如,一个 Recipe 能够与食谱的 Author 及 食谱的 Ingredient 相关联。

这一节将说明模型的哪些特性可以是自动化的,如何覆盖这些特性,以及模型都有哪些方法和属性。还说明了关联数据的不同方法。描述了如果查找、保存和删除数据。最后,讲解了数据源。

理解模型

模型描述了你的数据模型。在面向对象编程中,一个数据模型是描述一件事的对象,比如一辆汽车、一个人、一幢房子。举例来说,一个博客可能有很多博客文章,每篇文章可能有很多评论。博客、文章和评论是全部示例模型,每一个都与其它的相关联。

下面是在 CakePHP 中定义的模型的简单示例:

1 class Ingredient extends AppModel {

2     public $name = 'Ingredient';

3 }

只需这样一个简单的声明,Ingredient 模型就被赋予了建立保存和删除数据的查询所需的全部功能。这些魔术方法继承自 CakePHP 的 Model 类。Ingredient 模型继承了应用程序模型 AppModel(一个扩展自内部 Model 类的模型类)。它是向 Ingredient 模型赋予功能的核心模型类。

介于内部 Model 类和最终的模型类之间的 AppModel 类,在你创建专属于自己的 AppModel 类之前是空的,它位于 CakePHP 内核文件夹。覆写 AppModel 类允许你定义对应用程序中所有的模型类都可用的功能。要做到这一点,只需要在 Model 文件夹中建立你自己的 AppModel.php ,和应用程序中的其它模型类放在一起。使用 Bake 建立项目时,会自动为你生成这个文件。

关于如何向多个模型添加相同的逻辑的更多信息,请参见 Behaviors 。

回到我们的 Ingredient 模型,为了在其上工作,需要在 /app/Model 文件夹创建 PHP 文件。按照约定它的名字应该与类相同,对于本例,就是 Ingredient.php 。

注解

如果 CakePHP 没有在 /app/Model 文件夹中找到符合条件的文件,它将动态创建一个模型对象。这意味关如果你的模型文件命名错误(例如 ingredient.php 或者 Ingredients.php),CakePHP 将使用出乎你意料的 AppModel 的实例(按照 CakePHP 自己的思维方式)。如果你尝试使用你已经定义在你的模型听方法,或者附加到你的模型上的行为,你会收到一个以你调用的方法名标识的 SQL 错误信息 - 它是 CakePHP 找不到你的模型的明确提示,你需要检查文件名、应用程序缓存,或者两者都检查一下。

注解

一些类名不能用于模型名。举例来说,’‘File’’ 不能使用,因为 ‘’File’’ 是 CakePHP 内核中已经存在的类。

定义过的模型就可以在 控制器 中访问了。CakePHP 会自动使与当前控制器名字相同的模型可用。例如,如果一个控制器的名字是 IngredientsController,将自动初始化 Ingredient 模型并将其赋予此控制器的 $this->Ingredient 变量:

1 class IngredientsController extends AppController {

2     public function index() {

3         //抓取所有的 ingredients 并将其传递给视图:

4         $ingredients = $this->Ingredient->find('all');

5         $this->set('ingredients', $ingredients);

6     }

7 }

关联模型通过主模型访问。在上面的例子中,Recipe 与 Ingredient 模型关联:

1 class Recipe extends AppModel {

2 

3     public function steakRecipes() {

4         $ingredient = $this->Ingredient->findByName('Steak');

5         return $this->findAllByMainIngredient($ingredient['Ingredient']['id']);

6     }

7 }

上面的代码显示了如何使用已经连接的模型。想了解如何定义关联请移步至 Associations section

关于模型的更多...

  • 关联:将模型连接在一起
    • 关系类型
    • hasOne
    • belongsTo
    • hasMany
    • counterCache - 缓存你的 count()
    • hasAndBelongsToMany (HABTM)
    • hasMany 贯穿 (连接模型)
    • 在运行期间创建和销毁关联
    • 同一模型上的多个关系
    • 连接表
  • 检索数据
    • find
    • find(‘first’)
    • find(‘count’)
    • find(‘all’)
    • find(‘list’)
    • find(‘threaded’)
    • find(‘neighbors’)
    • 创建自定义 find 类型
    • 魔术查找类型
      • findAllBy
      • findBy
    • Model::query()
    • Model::field()
    • Model::read()
    • 复杂的查找条件
      • 子查询
      • 预处理语句
  • 保存数据
    • Model::set($one, $two = null)
    • Model::save(array $data = null, boolean $validate = true, array $fieldList = array())
    • Model::create(array $data = array())
    • Model::saveField(string $fieldName, string $fieldValue, $validate = false)
    • Model::updateAll(array $fields, array $conditions)
    • Model::saveMany(array $data = null, array $options = array())
    • Model::saveAssociated(array $data = null, array $options = array())
    • Model::saveAll(array $data = null, array $options = array())
    • 保存相关模型的数据(hasOne, hasMany, belongsTo)
    • 通过数据保存 hasMany
      • 保存相关模型数据 (HABTM)
        • 当 HABTM 变得复杂时怎么办?
    • 数据表
      • 使用 created 和 modified 列
  • 删除数据
    • delete
    • deleteAll
  • 数据校验
    • Simple Rules
    • One Rule Per Field
      • rule
      • required
      • allowEmpty
      • on
      • message
    • Multiple Rules per Field
      • last
    • Custom Validation Rules
      • Custom Regular Expression Validation
      • Adding your own Validation Methods
    • Dynamically change validation rules
      • Adding new validation rules
      • Modifying current validation rules
      • Removing rules from the set
    • Core Validation Rules
    • Localized Validation
      • Validating Data from the Controller
  • 回调方法
    • beforeFind
    • afterFind
    • beforeValidate
    • beforeSave
    • afterSave
    • beforeDelete
    • afterDelete
    • onError
  • 行为
    • Using Behaviors
    • Creating Behaviors
    • Creating behavior methods
      • Mapped methods
    • Behavior callbacks
      • Creating a behavior callback
  • 数据源
    • Basic API For DataSources
    • An Example
    • Plugin DataSources
  • 模型属性
    • useDbConfig
    • useTable
    • tablePrefix
    • 主键
    • displayField
    • recursive
    • order
    • data
    • _schema
    • validate
    • virtualFields
    • name
    • cacheQueries
  • 附加的方法和附属
    • Model::associations()
    • Model::buildQuery(string $type = 'first', array $query = array())
    • Model::deconstruct(string $field, mixed $data)
    • Model::escapeField(string $field = null, string $alias = null)
    • Model::exists($id)
    • Model::getAffectedRows()
    • Model::getAssociated(string $type = null)
    • Model::getColumnType(string $column)
    • Model::getColumnTypes()
    • Model::getID(integer $list = 0)
    • Model::getInsertID()
    • Model::getLastInsertID()
  • 虚拟列
    • Creating virtual fields
    • Using virtual fields
      • Model::hasField()
      • Model::isVirtualField()
      • Model::getVirtualField()
      • Model::find() and virtual fields
      • Pagination and virtual fields
    • Virtual fields and model aliases
    • Virtual fields in SQL queries
    • Limitations of virtualFields
  • 事务
    • Nested Transactions

你可能感兴趣的:(cakephp)