Subversion Repositories PHPX

Rev

Rev 52 | Rev 54 | Go to most recent revision | Show entire file | Regard whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 52 Rev 53
Line 33... Line 33...
33
   * The names of the properties that should be used in database
33
   * The names of the properties that should be used in database
34
   * queries, and their mapping to the columns of
34
   * queries, and their mapping to the columns of
35
   * the <code>Table</code>, if specified (keys are property names,
35
   * the <code>Table</code>, if specified (keys are property names,
36
   * values are column names, or both if the key is numeric).
36
   * values are column names, or both if the key is numeric).
37
   *
37
   *
-
 
38
   * NOTE: It should not be necessary to include the
-
 
39
   * <code>persistentId</code> property value here.  If an object
-
 
40
   * is not in the database, it should be assigned an ID
-
 
41
   * automatically when saved; if it is in the database,
-
 
42
   * you already have its ID as you searched by it.
-
 
43
   *
38
   * @type array
44
   * @type array
39
   */
45
   */
40
  protected $_persistentProperties = array('id');
46
  protected $_persistentProperties = array();
41
47
42
        /**
48
        /**
43
   * Creates a new model object
49
   * Creates a new model object
44
   *
50
   *
45
   * @see AbstractModel::__construct()
51
   * @see AbstractModel::__construct()
Line 112... Line 118...
112
118
113
        return $a;
119
        return $a;
114
  }
120
  }
115
121
116
  /**
122
  /**
117
   * Finds the record for the model object in a database, fills
123
   * Finds the record for the model object in the table, fills
118
   * the object with missing data, and returns the result.
124
   * the object with missing data, and returns the result.
119
   *
125
   *
120
   * @see Table::find(Model)
126
   * @see Table::find(Model)
121
   * @return Model|null
127
   * @return Model|null
122
   *   This object filled with missing data, or <code>null</code>
128
   *   This object filled with missing data, or <code>null</code>
123
   *   if there is no data for this object
129
   *   if there is no data for this object
124
   */
130
   */
125
  public function find ()
131
  public function find ()
126
  {
132
  {
127
    $result = $this->persistentTable->find(
133
    $result = $this->persistentTable->find($this->{$this->_persistentId});
128
        $this->{$this->_persistentId});
-
 
129
    if ($result)
134
    if ($result)
130
    {
135
    {
131
        return $this->map($result);
136
        return $this->map($result);
132
    }
137
    }
133
138
134
    return null;
139
    return null;
135
  }
140
  }
136
141
137
  /**
142
  /**
138
   * Saves a model object in the <code>Table</code>
143
   * Saves the model object in the table
139
   *
144
   *
140
   * @param array $propertyNames = null
145
   * @param array $propertyNames = null
141
   *   Names of the properties whose values should be saved
146
   *   Names of the properties whose values should be saved
142
   *   in the database.  The default is to save the values
147
   *   in the database.  The default is to save the values
143
   *   of all persistent properties.
148
   *   of all persistent properties.
Line 145... Line 150...
145
   * @see Model::getPropertyArray()
150
   * @see Model::getPropertyArray()
146
   * @see Table::updateOrInsert()
151
   * @see Table::updateOrInsert()
147
   */
152
   */
148
  public function save (array $propertyNames = null)
153
  public function save (array $propertyNames = null)
149
  {
154
  {
-
 
155
        $table = $this->persistentTable;
-
 
156
        $idPropertyName = $this->_persistentId;
-
 
157
150
        return $this->persistentTable->updateOrInsert(
158
        $result = $table->updateOrInsert(
151
                $this->getPropertyArray($propertyNames), array(
159
                $this->getPropertyArray($propertyNames),
-
 
160
                array(
152
                                $this->persistentTable->id => $this->{$this->_persistentId}
161
                        $table->id => $this->$idPropertyName
153
                )
162
                )
154
        );
163
        );
-
 
164
-
 
165
        if ($result && ($lastInsertId = $table->lastInsertId))
-
 
166
        {
-
 
167
                $this->$idPropertyName = $lastInsertId;
-
 
168
        }
-
 
169
-
 
170
        return $result;
-
 
171
  }
-
 
172
-
 
173
  /**
-
 
174
   * Inserts the model object into the table
-
 
175
   *
-
 
176
   * @param array $propertyNames = null
-
 
177
   *   Names of the properties whose values should be insert
-
 
178
   *   in the database.  The default is to insert the values
-
 
179
   *   of all persistent properties.
-
 
180
   * @return boolean
-
 
181
   * @see Model::getPropertyArray()
-
 
182
   * @see Table::insert()
-
 
183
   */
-
 
184
  public function insert (array $propertyNames = null)
-
 
185
  {
-
 
186
        $table = $this->persistentTable;
-
 
187
        $idPropertyName = $this->_persistentId;
-
 
188
-
 
189
        $result = $table->insert($this->getPropertyArray($propertyNames));
-
 
190
-
 
191
        if ($result && ($lastInsertId = $table->lastInsertId))
-
 
192
        {
-
 
193
                $this->$idPropertyName = $lastInsertId;
-
 
194
        }
-
 
195
-
 
196
        return $result;
155
  }
197
  }
156
198
157
  /**
199
  /**
158
   * Deletes a model object from the <code>Table</code>
200
   * Deletes a model object from the <code>Table</code>
159
   *
201
   *