![BaseClass
• Validation Properties (getter/setter)
/**
* Sets the value of [created_at] column to a normalized version of the date/time value specified.
*
* @param mixed $v string, integer (timestamp), or DateTime value.
* Empty strings are treated as null.
* @return Category The current object (for fluent API support)
*/
public function setCreatedAt($v)
{
$dt = PropelDateTime::newInstance($v, null, 'DateTime');
if ($this->created_at !== null || $dt !== null) {
$currentDateAsString = ($this->created_at !== null && $tmpDt = new DateTime($this->created_at)) ? $tmpDt->format('Y-m-d H:i:s') :
null;
$newDateAsString = $dt ? $dt->format('Y-m-d H:i:s') : null;
if ($currentDateAsString !== $newDateAsString) {
$this->created_at = $newDateAsString;
$this->modifiedColumns[] = CategoryPeer::CREATED_AT;
}
} // if either are not null
return $this;
} // setCreatedAt()](https://image.slidesharecdn.com/propelsfugmd-130307043329-phpapp02/85/Propel-sfugmd-15-320.jpg)
Propel sfugmd
- 1. Klaus Großmann Dshini UG
- 2. Was Propel Ist PDO PDO MySQL MySQL • ORM für PHP 5 PostgreSQL PostgreSQL SQLite SQLite MSSQL MSSQL Oracle Oracle • 2005 gestartet • basiert auf Konzepten Apache Torque • Aufteilung in Generator und Runtime • Schema • MIT-Lizenz
- 3. Generator <?xml version="1.0" encoding="UTF-8"?> <database name="bookstore" defaultIdMethod="native"> <table name="book" phpName="Book"> <column name="id" type="integer" required="true" primaryKey="true" autoIncrement="true"/> <column name="title" type="varchar" size="255" required="true" /> <column name="isbn" type="varchar" size="24" required="true" phpName="ISBN"/> <column name="publisher_id" type="integer" required="true"/> <column name="author_id" type="integer" required="true"/> <foreign-key foreignTable="publisher" phpName="Publisher" refPhpName="Book"> <reference local="publisher_id" foreign="id"/> </foreign-key> <foreign-key foreignTable="author"> <reference local="author_id" foreign="id"/> </foreign-key> </table> <table name="author" phpName="Author"> <column name="id" type="integer" required="true" primaryKey="true" autoIncrement="true"/> <column name="first_name" type="varchar" size="128" required="true"/> <column name="last_name" type="varchar" size="128" required="true"/> </table> <table name="publisher" phpName="Publisher"> <column name="id" type="integer" required="true" primaryKey="true" autoIncrement="true" /> <column name="name" type="varchar" size="128" required="true" /> </table> </database>
- 4. Generator • Code-Generation aus XML-Schema • schnell • IDE freundlich • leicht zu lernen und verstehen
- 5. Killerfeatures • Inheritance • Single Table Inheritance • Class Table Inheritance • Concrete Table Inheritance
- 6. Single Table Inheritance • semantische Unterscheidung von Objekten <table name="book" abstract="true"> <column name="id" type="INTEGER" primaryKey="true" autoIncrement="true"/> <column name="title" type="VARCHAR" size="100"/> <column name="class_key" type="INTEGER" inheritance="single"> <inheritance key="1" class="Book"/> <inheritance key="2" class="Essay" extends="Book"/> <inheritance key="3" class="Comic" extends="Book"/> </column> </table> <?php $book = new Book(); $book->setTitle('War And Peace'); $book->save(); $essay = new Essay(); $essay->setTitle('On the Duty of Civil Disobedience'); $essay->save(); $comic = new Comic(); $comic->setTitle('Little Nemo In Slumberland'); $comic->save();
- 7. Class Table Inheritance <table name="player"> <column name="id" type="INTEGER" primaryKey="true" autoIncrement="true" /> <column name="first_name" type="VARCHAR" size="100" /> <column name="last_name" type="VARCHAR" size="100" /> </table> <table name="footballer"> <column name="id" required="true" primaryKey="true" autoIncrement="true" type="INTEGER" /> <column name="goals_scored" type="INTEGER" /> <column name="fouls_committed" type="INTEGER" /> <column name="player_id" type="INTEGER" /> <foreign-key foreignTable="player"> <reference local="player_id" foreign="id" /> </foreign-key> <behavior name="delegate"> <parameter name="to" value="player" /> </behavior> </table> <table name="basketballer"> <column name="id" required="true" primaryKey="true" autoIncrement="true" type="INTEGER" /> <column name="points" type="INTEGER" /> <column name="field_goals" type="INTEGER" /> <column name="three_points_field_goals" type="INTEGER" /> <column name="player_id" type="INTEGER" /> <foreign-key foreignTable="player"> <reference local="player_id" foreign="id" /> </foreign-key> <behavior name="delegate"> <parameter name="to" value="player" /> </behavior> </table>
- 8. Class Table Inheritance • Struktur analog zu Vererbung in Klassen • Realisierung via Delegation • ermöglicht „Mehrfachvererbung“ <?php $basketballer = new Basketballer(); $basketballer->setPoints(101); $basketballer->setFieldGoals(47); $basketballer->setThreePointsFieldGoals(7); // set player identity via delegation $basketballer->setFirstName('Michael'); $basketballer->setLastName('Giordano'); // same as $player = new Player(); $player->setFirstName('Michael'); $player->setLastName('Giordano'); $basketballer->setPlayer($player); // save basketballer and player $basketballer->save(); // retrieve delegated data directly from the main object echo $basketballer->getFirstName(); // Michael
- 9. Concrete Table Inheritance <table name="content"> <column name="id" type="INTEGER" primaryKey="true" autoIncrement="true" /> <column name="title" type="VARCHAR" size="100" /> <column name="category_id" required="false" type="INTEGER" /> <foreign-key foreignTable="category" onDelete="cascade"> <reference local="category_id" foreign="id" /> </foreign-key> </table> <table name="category"> <column name="id" required="true" primaryKey="true" autoIncrement="true" type="INTEGER" /> <column name="name" type="VARCHAR" size="100" primaryString="true" /> </table> <table name="article"> <behavior name="concrete_inheritance"> <parameter name="extends" value="content" /> </behavior> <column name="body" type="VARCHAR" size="100" /> </table> <table name="video"> <behavior name="concrete_inheritance"> <parameter name="extends" value="content" /> </behavior> <column name="resource_link" type="VARCHAR" size="100" /> </table>
- 10. Concrete Table Inheritance • hält gemeinsame Informationen doppelt vor • übernimmt Fremdschlüssel, Indexes und Validatoren • stellt via Transaktion Integrität zwischen Super- und Subclass sicher <?php // create a new Category $cat = new Category(); $cat->setName('Movie'); $cat->save(); // create a new Article $art = new Article(); $art->setTitle('Avatar Makes Best Opening Weekend in the History'); $art->setCategory($cat); $art->setContent('With $232.2 million worldwide total, Avatar had one of the best-opening weekends in the history of cinema.'); $art->save(); // create a new Video $vid = new Video(); $vid->setTitle('Avatar Trailer'); $vid->setCategory($cat); $vid->setResourceLink('http://www.avatarmovie.com/index.html') $vid->save();
- 11. Concrete Table Inheritance • OO Arbeiten mit den Modellen • Denormalisierung für optimale Performance • Propel kümmert sich um das Mapping • PHP arbeitet… • …mit der Vererbungshirachie • …auf den Objekten, nicht auf Datensätzen • …auf Collections, nicht auf Arrays • …auf Beziehungen, nicht auf Fremdschlüsseln
- 12. Runtime • nutzt generierte Klassen zur… • …Repräsentation (BaseObject) • …Datenabfrage (ModelCriteria) • minimaler Gluecode
- 13. BaseObject • Vererbungsbaum der ObjectModels • BaseObject > BaseClass > Class • BaseObject implementiert Standardverhalten eines OM
- 14. BaseClass • BaseClass implementiert transparent… • …DB-Abstraktion (save, delete, …) • …Validation Properties (getter/setter) • …Fremdschlüssel-Accessoren • …Behaviors
- 15. BaseClass • Validation Properties (getter/setter) /** * Sets the value of [created_at] column to a normalized version of the date/time value specified. * * @param mixed $v string, integer (timestamp), or DateTime value. * Empty strings are treated as null. * @return Category The current object (for fluent API support) */ public function setCreatedAt($v) { $dt = PropelDateTime::newInstance($v, null, 'DateTime'); if ($this->created_at !== null || $dt !== null) { $currentDateAsString = ($this->created_at !== null && $tmpDt = new DateTime($this->created_at)) ? $tmpDt->format('Y-m-d H:i:s') : null; $newDateAsString = $dt ? $dt->format('Y-m-d H:i:s') : null; if ($currentDateAsString !== $newDateAsString) { $this->created_at = $newDateAsString; $this->modifiedColumns[] = CategoryPeer::CREATED_AT; } } // if either are not null return $this; } // setCreatedAt()
- 16. Class • Klasse wird tatsächlich verwendet • überschreibt standardmäßig leer die Basis • custom Getter/Setter • Raum für DB-ferne, zusätzliche Funktionen
- 17. Class $category = new Category(); $con = Propel::getConnection(); $category->setName('Propel'); $con->beginTransaction(); $article = new Article(); $article try { ->setTitle('Propel is Awesome') $category = new Category(); ->setBody('You know why') $category->setName('Propel'); ->setCategory($category) ->save(); $article = new Article(); $article ->setTitle('Propel is Awesome') ->setBody('You know why') ->setCategory($category) ->save($con); $another_article = new Article(); $another_article ->setTitle('Doctrine not so much') ->setBody('You know why') ->setCategory($category) ->save($con); $con->commit(); } catch (Exception $e) { $con->rollBack(); }
- 18. ModelCriteria • Vererbungsbaum der Query-Klassen • ModelCriteria > BaseClassQuery > ClassQuery • ModelCriteria implementiert eine abstrakte, formale Definition einer SQL-Datenbankabfrage • kann überführt werden in konkrete Abfragen für MySQL, MSSQL, etc
- 19. BaseClassQuery • BaseClassQuery implementiert… • …fluent API für ModelCriteria • einfaches Filtern – filterByXXX() • einfaches Abfragen – findByXXX() • paginate, delete, update, … • …Class spezifische Methoden (für joins, etc) • …@method-Definitionen für IDEs für MagicMethods
- 20. ClassQuery • Klasse wird tatsächlich verwendet • überschreibt standardmäßig leer die Basis • Ort für eigene filterBy Methoden
- 21. ClassQuery // Kurzform ArticleQuery::create()->findOneByTitle('%Awesome', ArticleQuery::LIKE); // Langform ArticleQuery::create() ->filterByTitle('%Awesome', ArticleQuery::LIKE) ->findOne();