hasOne()
Description
Sets up a hasOne association between this model and the specified one.
Function Syntax
hasOne(name [, class, foreignKey, joinType ])
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name |
string |
Yes | |
Gives the association a name that you refer to when working with the association (in the include argument to findAll() to name one example). |
class |
string |
No | |
Name of associated class (usually not needed if you follow the Wheels conventions since the model name will be deduced from the name argument). |
foreignKey |
string |
No | |
Foreign key property name (usually not needed if you follow the Wheels conventions since the foreign key name will be deduced from the name argument). |
joinType |
string |
No | outer |
Use to set the join type when joining associated tables, possible values are inner (for INNER JOIN) and outer (for LEFT OUTER JOIN). |
Examples
<!--- Specify that instances of this model has one profile (the table for the associated model, not the current, should have the foreign key set on it) --->
<cfset hasOne("profile")>
<!--- Same as above but setting the `joinType` to `inner` which basically means this model should always have a record in the `profiles` table --->
<cfset hasOne(name="profile", joinType="inner")>
