Get into the FLOW with Extbase

Get into the FLOW with Extbase http://www.sxc.hu/photo/768249

Who is this?

Dipl.-Ing. Mechanical Engineering

infected with TYPO3 in 2OO1

Tübingen

6O% selfemployed 6O% father

8O% ---- selfemployed 6O% 6O% father

5 years: Fraunhofer- Gesellschaft German Aerospace Center

5 years: high school teacher

What is Extbase all about?

v4 2OO9

v4 2OO6

Extbase v5 v4

Extbase FLOW 3

Extbase

OOP A ggregate DDD Extbase V iew Entity H elp er M VC VfB R epository

Extbase Value

Value enables and encourages the developer to write maintainable code separates di erent responsibilities modular architecture of the extension relieves the developer in safety-critical and recurring tasks validation of arguments invoking the template mechanism persistence read out the settings from TypoScript and FlexForms enables and encourages the developer to focus on solving the problem of the client saves primary and adapting development time (direct and indirect costs)

tp://commons.wikimedia.org/wiki/File:Z%C3%BCrich_-_Seefeld_-_Heureka_IMG_1757.JPG

tx_ttnews 3397 tx_pbsurvey_pi1 253O tx_ttproducts_pi1 1O9O tx_mmforum_pi1 6126 tx_veguestbook_pi1 1156 tp://commons.wikimedia.org/wiki/File:Z%C3%BCrich_-_Seefeld_-_Heureka_IMG_1757.JPG

! /** ! * Main news function: calls the init_news() function and decides by the given CODEs which of the ! * functions to display news should by called. ! * ! * @param! string! ! $content : function output is added to this ! * @param! array! ! $conf : configuration array ! * @return!string! ! $content: complete content generated by the tt_news plugin ! */ ! function main_news($content, $conf) { ! ! $this->local_cObj = t3lib_div::makeInstance('tslib_cObj'); // Local cObj. ! ! $this->init($conf); ! ! if ($this->conf['displayCurrentRecord']) { ! ! ! $this->config['code'] = $this->conf['defaultCode']?trim($this->conf['defaultCode']):'SINGLE'; ! ! ! $this->tt_news_uid = $this->cObj->data['uid']; ! ! } ! ! // get codes and decide which function is used to process the content ! ! $codes = t3lib_div::trimExplode(',', $this->config['code']?$this->config['code']:$this->conf['defaultCode'], 1); ! ! if (!count($codes)) { // no code at all ! ! ! $codes = array(); ! ! ! $noCode = true; ! ! } ! ! while (list(, $theCode) = each($codes)) { ! ! ! $theCode = (string)strtoupper(trim($theCode)); ! ! ! $this->theCode = $theCode; ! ! ! switch ($theCode) { ! ! ! ! case 'SINGLE': ! ! ! ! $content .= $this->displaySingle(); ! ! ! ! break; ! ! ! ! case 'VERSION_PREVIEW': ! ! ! ! $content .= $this->displayVersionPreview(); ! ! ! ! break; ! ! ! ! case 'LATEST': ! ! ! ! case 'LIST': ! ! ! ! case 'SEARCH': ! ! ! ! case 'XML': ! ! ! ! $content .= $this->displayList(); ! ! ! ! break; ! ! ! ! case 'AMENU': ! ! ! ! $content .= $this->newsArchiveMenu(); ! ! ! ! break; ! ! ! ! case 'CATMENU': ! ! ! ! $content .= $this->displayCatMenu(); ! ! ! ! break; ! ! ! ! default:

! /** ! * Displays the "single view" of a news article. Is also used when displaying single news records with the "insert records" content element. ! * ! * @return!string! ! html-code for the "single view" ! */ ! function displaySingle() { ! ! $singleWhere = 'tt_news.uid=' . intval($this->tt_news_uid); ! ! $singleWhere .= ' AND type NOT IN(1,2)' . $this->enableFields; // only real news -> type=0 ! ! $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery( ! ! ! '*', ! ! ! 'tt_news', ! ! ! $singleWhere); ! ! $row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res); ! ! // get the translated record if the content language is not the default language ! ! if ($GLOBALS['TSFE']->sys_language_content) { ! ! ! $OLmode = ($this->sys_language_mode == 'strict'?'hideNonTranslated':''); ! ! ! $row = $GLOBALS['TSFE']->sys_page->getRecordOverlay('tt_news', $row, $GLOBALS['TSFE']->sys_language_content, $OLmode); ! ! } ! ! if ($this->versioningEnabled) { ! ! ! // get workspaces Overlay ! ! ! $GLOBALS['TSFE']->sys_page->versionOL('tt_news',$row); ! ! ! // fix pid for record from workspace ! ! ! $GLOBALS['TSFE']->sys_page->fixVersioningPid('tt_news',$row); ! ! } ! ! $GLOBALS['TSFE']->displayedNews[]=$row['uid']; ! ! if (is_array($row) && ($row['pid'] > 0 || $this->vPrev)) { // never display versions of a news record (having pid=-1) for normal website users ! ! ! ! // Get the subpart code ! ! ! if ($this->conf['displayCurrentRecord']) { ! ! ! ! $item = trim($this->getNewsSubpart($this->templateCode, $this->spMarker('###TEMPLATE_SINGLE_RECORDINSERT###'), $row)); ! ! ! } ! ! ! if (!$item) { ! ! ! ! $item = $this->getNewsSubpart($this->templateCode, $this->spMarker('###TEMPLATE_SINGLE###'), $row); ! ! ! } ! ! ! ! // reset marker array ! ! ! $wrappedSubpartArray = array(); ! ! ! ! // build the backToList link ! ! ! if ($this->conf['useHRDates']) { ! ! ! ! $pointerName = 'pointer'; ! ! ! ! $wrappedSubpartArray['###LINK_ITEM###'] = explode('|', $this->pi_linkTP_keepPIvars('|', array( ! ! ! ! ! 'tt_news' => null, ! ! ! ! ! 'backPid' => null, ! ! ! ! ! $this->config['singleViewPointerName'] => null, ! ! ! ! ! 'pS' => null, ! ! ! ! ! 'pL' => null), $this->allowCaching, ($this->conf['dontUseBackPid']?1:0), $this->config['backPid']));

'pointer'; ! ! ! ! $wrappedSubpartArray['# ##LINK_ITEM###'] = explode('|', $this- >pi_linkTP_keepPIvars(' |', array( ! ! ! ! ! 'tt_news' => null, ! ! ! ! ! 'backPid' => null, ! ! ! ! ! $this- >config['singleViewPoin terName'] => null, ! ! ! ! ! 'pS' => null, ! ! ! ! ! 'pL' => null), $this- >allowCaching, ($this- >conf['dontUseBackPid'] ?1:0), $this- >config['backPid'])); ! ! ! } else { ! ! ! ! $wrappedSubpartArray['# ##LINK_ITEM###'] = explode('|', $this- >pi_linkTP_keepPIvars(' |', array( ! ! ! ! ! 'tt_news' => null, ! ! ! ! ! 'backPid' => null, ! ! ! ! ! $this- >config['singleViewPoin terName'] => null), $this->allowCaching, ($this- >conf['dontUseBackPid'] ?1:0), $this- >config['backPid'])); ! ! ! } ! ! ! ! // set the title of the single view page to the title of the news record ! ! ! if ($this- >conf['substitutePageti tle']) { ! ! ! ! $GLOBALS['TSFE']- >page['title'] = $row['title']; ! ! ! ! // set pagetitle for indexed search to news title ! ! ! ! $GLOBALS['TSFE']- >indexedDocTitle = $row['title']; ! ! ! } ! ! ! if ($this- >conf['displaySingle.'] ['catOrderBy']) { ! ! ! ! $this- >config['catOrderBy'] = $this- >conf['displaySingle.'] ['catOrderBy']; ! ! ! } ! ! ! $markerArray = $this- >getItemMarkerArray($ro w, 'displaySingle'); ! ! ! // Substitute ! ! ! $content = $this->cObj- >substituteMarkerArrayC ached($item, $markerArray, array(), $wrappedSubpartArray); ! ! } elseif ($this- >sys_language_mode == 'strict' && $this- >tt_news_uid && $GLOBALS['TSFE']- >sys_language_content) { // not existing translation ! ! ! $noTranslMsg = $this- >local_cObj- >stdWrap($this- >pi_getLL('noTranslMsg' ), $this- >conf['noNewsIdMsg_stdW rap.']); ! ! ! $content = $noTranslMsg; ! ! } elseif ($row['pid'] < 0) { // a non-public version of a record was requested ! ! ! $nonPlublicVersion = $this->local_cObj- >stdWrap($this- >pi_getLL('nonPlublicVe rsionMsg'), $this- >conf['nonPlublicVersio nMsg_stdWrap.']); ! ! ! $content = $nonPlublicVersion; ! ! } else { // if singleview is shown with no tt_news uid given from GETvars (&tx_ttnews[tt_news]=) an error message is displayed. ! ! ! $noNewsIdMsg = $this- >local_cObj- >stdWrap($this- >pi_getLL('noNewsIdMsg' ), $this-

control flow business logic CRUD data render output other , eg. config

control flow business logic aggregate CRUD data render output other , eg. config

control flow business logic generalize CRUD data render output other , eg. config

partition

Extbase use & Fluid

control flow business logic CRUD data render output other , eg. config

Controller Domain Model Domain Repository View other , eg. config

Blog features administrate blogs, blog posts and blog comments list all available blogs list all blog posts of a blog list all comments of a blog post allow users to post new comments

Blog features administrate blogs, blog posts and blog comments Blog list all available blogs list all blog posts of a blog list all comments of a blog post allow users to post new comments

Blog features administrate blogs, blog posts and blog comments Blog list all available blogs list all blog posts of a blog list all comments of a blog post allow users to post new comments Post Comment Tag

tslib_piBase tx_blog 1 userFunc TYPO3 tx_blog_pi

tslib_piBase tx_blog 1 userFunc 2 exec_SELECTgetRows TYPO3 tx_blog_pi Database

tslib_piBase tx_blog 1 userFunc 2 exec_SELECTgetRows TYPO3 tx_blog_pi rows as Database array 3

tslib_piBase tx_blog 1 userFunc 2 exec_SELECTgetRows TYPO3 tx_blog_pi HTML rows as Database 4 array 3

Control ow public function main($content, $conf) { ! $this->conf = $conf; ! $this->pi_setPiVarDefaults(); ! $this->pi_loadLL(); ! if ($this->piVars['postUid']) { ! ! if ($this->piVars['newComment']) { ! ! ! $this->storeNewComment(); ! ! } ! ! $content = $this->renderPost(); ! } elseif ($this->piVars['blogUid']) { ! ! $content = $this->renderBlog(); ! } else { ! ! $content = $this->renderListOfBlogs(); ! } ! return $this->pi_wrapInBaseClass($content); }

Task 1: Output a listing of blogs protected function renderListOfBlogs() { ! $blogs = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows( ! ! '*', ! ! 'tx_blogexample_blog', ! ! 'sys_language_uid=' . $GLOBALS['TSFE']->sys_language_uid . $this->cObj->enableFields('tx_blogexample_blog'), ! ! '', ! ! 'date' ! ! ); ! $template = $this->cObj->fileResource($this->conf['template']); ! $blogElementSubpart = $this->cObj->getSubpart($template, '###SUBPART_BLOGELEMENT###');

Task 1: Output a listing of blogs ! foreach ($blogs as $blog) { ! ! $linkParameters = array('blogUid' => $blog['uid']); ! ! $markers = array( ! ! ! '###BLOG_NAME###' => $blog['name'], ! ! ! '###BLOG_LOGO###' => $this->cImage('uploads/tx_blog/' . $blog['logo']), ! ! ! '###BLOG_DESCRIPTION###' => $this->pi_RTEcssText($blog['description']), ! ! ! '###BLOG_MORELINK###' => $this->pi_linkTP('show blog', $linkParameters, true), ! ! ); ! ! $blogElements.= $this->cObj->substituteMarkerArray($blogElementSubpart, $markers); ! } ! return $content; }

Task 1: Output a listing of blogs  <div class="blog element"> ! ###BLOG_NAME### ! ###BLOG_LOGO### ! ###BLOG_DESCRIPTION### ! ###BLOG_MORELINK### </div>

Task 2: Display a single post with its comments protected function renderPost() { ! $post = $this->pi_getRecord('tx_blogexample_post', $this->piVars['postUid']); ! $comments = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows( ! ! '*', ! ! 'tx_blogexample_comment', ! ! 'deleted=0 AND hidden=0 AND sys_language_uid=' . $GLOBALS['TSFE']->sys_language_uid ! ! ! . ' AND post_uid=' . $this->piVars['postUid'] . ' AND post_table="tx_blogexample_post"' . $this->cObj->enableFields('tx_blogexample_comment'), ! ! '', ! ! 'date DESC' ! ); // fill marker arrays and substitute in template // return content }

Task 3: Add a new comment to a blog post the whole plugin is cached („USER“) dynamic user input won‘t outputted instantly de ne uncached behavior in TypoScript [globalVar = _POST:tx_blogexample_pi1|newComment = 1] ! plugin.tx_blogexample_pi1 = USER_INT [globals]

Task 3: Add a new comment to a blog post protected function storeNewComment() { ! $fields = array( ! ! 'post_uid' => $this->piVars['postUid'], ! ! 'post_table' => 'tx_blogexample_post', ! ! 'date' => time(), ! ! 'author' => $this->piVars['author'], ! ! 'email' => $this->piVars['email'], ! ! 'content' => $this->piVars['content'], ! ); ! $GLOBALS['TYPO3_DB']->exec_INSERTquery( ! ! 'tx_blogexample_comment', $fields ! ); }

Security: SQL injections protected function renderPost() { ! $post = $this->pi_getRecord('tx_blogexample_post', $this->piVars['postUid']); ! $comments = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows( ! ! '*', ! ! 'tx_blogexample_comment', ! ! 'deleted=0 AND hidden=0 AND sys_language_uid=' . $GLOBALS['TSFE']->sys_language_uid ! ! ! . ' AND post_uid=' . $this->piVars['postUid'] . ' AND post_table="tx_blogexample_post"' . $this->cObj->enableFields('tx_blogexample_comment'), ! ! '', ! ! 'date DESC' ! ); [...]

Security: SQL injections protected function renderPost() { ! $post = $this->pi_getRecord('tx_blogexample_post', $this->piVars['postUid']); ! $comments = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows( ! ! '*', ! ! 'tx_blogexample_comment', ! ! 'deleted=0 AND hidden=0 AND sys_language_uid=' . $GLOBALS['TSFE']->sys_language_uid ! ! ! . ' AND post_uid=' . $this->piVars['postUid'] . ' AND post_table="tx_blogexample_post"' . $this->cObj->enableFields('tx_blogexample_comment'), ! ! '', ! ! 'date DESC' ! ); [...] http://www.example.com/index.php&id=99&postUid=1

Security: SQL injections protected function renderPost() { ! $post = $this->pi_getRecord('tx_blogexample_post', $this->piVars['postUid']); ! $comments = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows( ! ! '*', ! ! 'tx_blogexample_comment', ! ! 'deleted=0 AND hidden=0 AND sys_language_uid=' . $GLOBALS['TSFE']->sys_language_uid ! ! ! . ' AND post_uid=' . $this->piVars['postUid'] . ' AND post_table="tx_blogexample_post"' . $this->cObj->enableFields('tx_blogexample_comment'), ! ! '', ! ! 'date DESC' ! ); [...] http://www.example.com/index.php&id=99&postUid=1 SELECT * FROM tx_blog_comment WHERE post_uid=1;

Security: SQL injections protected function renderPost() { ! $post = $this->pi_getRecord('tx_blogexample_post', $this->piVars['postUid']); ! $comments = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows( ! ! '*', ! ! 'tx_blogexample_comment', ! ! 'deleted=0 AND hidden=0 AND sys_language_uid=' . $GLOBALS['TSFE']->sys_language_uid ! ! ! . ' AND post_uid=' . $this->piVars['postUid'] . ' AND post_table="tx_blogexample_post"' . $this->cObj->enableFields('tx_blogexample_comment'), ! ! '', ! ! 'date DESC' ! ); [...] http://www.example.com/index.php&id=99&postUid=1; INSERT INTO be_users SET ...; SELECT * FROM tx_blog_comment WHERE 1=1 SELECT * FROM tx_blog_comment WHERE post_uid=1; INSERT INTO be_users SET ...; SELECT * FROM tx_blog_comment WHERE 1=1 AND post_table="tx_blogexample_post"

Security: SQL injections protected function renderPost() { ! $post = $this->pi_getRecord('tx_blogexample_post', $this->piVars['postUid']); ! $comments = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows( ! ! '*', ! ! 'tx_blogexample_comment', ! ! 'deleted=0 AND hidden=0 AND sys_language_uid= . $GLOBALS['TSFE']->sys_language_uid ! ! ! . ' AND post_uid=' . intval($this->piVars['postUid']) . ' AND post_table="tx_blogexample_post"' . $this->cObj->enableFields('tx_blogexample_comment'), ! ! '', ! ! 'date DESC' ! ); [...] http://www.example.com/index.php&id=99&postUid=1; INSERT INTO be_users SET ...; SELECT * FROM tx_blog_comment WHERE 1=1 SELECT * FROM tx_blog_comment WHERE post_uid=1; INSERT INTO be_users SET ...; SELECT * FROM tx_blog_comment WHERE 1=1 AND post_table="tx_blogexample_post"

http://www.sxc.hu/photo/516864/ Extension building with Extbase

1 userFunc Extbase TYPO3 Dispatcher

1 2 userFunc Request BlogExample Extbase TYPO3 Dispatcher Controller

1 2 userFunc Request BlogExample Extbase TYPO3 Dispatcher Controller 3 findByTitle('MyBlog') Repository Domain Model Blog Post Comment Tag

1 2 userFunc Request BlogExample Extbase TYPO3 Dispatcher Controller 3 findByTitle('MyBlog') Blog 4 Repository Domain Model Blog Post Comment Tag

1 2 userFunc Request BlogExample Extbase TYPO3 Dispatcher Controller 3 assign(Blog) findByTitle('MyBlog') render() 5 Blog 4 View Repository Domain Model Blog Post Comment Tag

1 2 userFunc Request BlogExample Extbase TYPO3 Dispatcher HTML Response Controller 6 3 assign(Blog) findByTitle('MyBlog') render() 5 Blog Response 4 View Repository Domain Model Blog Post Comment Tag

Blog Post Comment Tag

/** * A blog * * @version $Id:$ * @copyright Copyright belongs to the respective authors * @license http://opensource.org/licenses/gpl-license.php GNU Public License, version 2 * @scope prototype * @entity */ class Tx_BlogExample_Domain_Model_Blog extends Tx_Extbase_DomainObject_AbstractEntity { ! /** ! * The blog's title. ! * ! * @var string ! * @validate Text, StringLength(minimum = 1, maximum = 80) ! * @identity ! */ ! protected $title = ''; ! /** ! * A short description of the blog ! * ! * @var string ! * @validate Text, StringLength(maximum = 150) ! */ ! protected $description = '';

! } ! /** ! * Sets this blog's title ! * ! * @param string $title The blog's title ! * @return void ! */ ! public function setTitle($title) { ! ! $this->title = $title; ! } ! /** ! * Returns the blog's title ! * ! * @return string The blog's title ! */ ! public function getTitle() { ! ! return $this->title; ! } ! /** ! * Sets the description for the blog ! * ! * @param string $description ! * @return void ! */ ! public function setDescription($description) { ! ! $this->description = $description;

! * @return Tx_Extbase_Persistence_ObjectStorage ! */ ! public function getPosts() { ! ! return $this->posts; ! } ! /** ! * Sets the administrator value ! * ! * @param Tx_BlogExample_Domain_Model_Administrator $administrator The Administrator of this Blog ! * @return void ! */ ! public function setAdministrator(Tx_BlogExample_Domain_Model_Administrator $administrator) { ! ! $this->administrator = $administrator; ! } ! /** ! * Returns the administrator value ! * ! * @return Tx_BlogExample_Domain_Model_Administrator ! */ ! public function getAdministrator() { ! ! return $this->administrator; ! } }

/** * A blog post comment * * @package Blog * @subpackage Domain * @version $Id:$ * @copyright Copyright belongs to the respective authors * @license http://opensource.org/licenses/gpl-license.php GNU Public License, version 2 * @scope prototype * @entity */ class Tx_BlogExample_Domain_Model_Comment extends Tx_Extbase_DomainObject_AbstractEntity { ! /** ! * @var DateTime ! */ ! protected $date; ! /** ! * @var string ! * @validate Text, StringLength(minimum = 3, maximum = 80) ! */ ! protected $author; ! /** ! * @var string ! * @validate EmailAddress

! * @param string $content ! * @return void ! */ ! public function setContent($content) { ! ! $this->content = $content; ! } ! /** ! * Getter for content ! * ! * @return string ! */ ! public function getContent() { ! ! return $this->content; ! } ! /** ! * Returns this comment as a formatted string ! * ! * @return string ! */ ! public function __toString() { ! ! return $this->author . ' (' . $this->email . ') said on ' . $this->date->format('Y-m-d') . ':' . chr(10) ! ! ! $this->content . chr(10); ! } }

http://www.sxc.hu/photo/444174/ and... action

/** * The blog controller for the Blog package * * @version $Id:$ * @license http://opensource.org/licenses/gpl-license.php GNU Public License, version 2 */ class Tx_BlogExample_Controller_BlogController extends Tx_Extbase_MVC_Controller_ActionController { ! /** ! * @var Tx_BlogExample_Domain_Model_BlogRepository ! */ ! protected $blogRepository; ! /** ! * Initializes the current action ! * ! * @return void ! */ ! public function initializeAction() { ! ! $this->blogRepository = t3lib_div::makeInstance('Tx_BlogExample_Domain_Repository_BlogRepository'); ! ! $this->postRepository = t3lib_div::makeInstance('Tx_BlogExample_Domain_Repository_PostRepository'); ! ! $this->administratorRepository = t3lib_div::makeInstance('Tx_BlogExample_Domain_Repository_AdministratorRepository'); ! } ! /** ! * Index action for this controller. Displays a list of blogs. ! * ! * @return string The rendered view ! */ ! public function indexAction() { ! ! $this->view->assign('blogs', $this->blogRepository->findAll()); ! }

! } ! /** ! * Index action for this controller. Displays a list of blogs. ! * ! * @return string The rendered view ! */ ! public function indexAction() { ! ! $this->view->assign('blogs', $this->blogRepository->findAll()); ! } ! /** ! * Displays a form for creating a new blog ! * ! * @param Tx_BlogExample_Domain_Model_Blog $newBlog A fresh blog object taken as a basis for the rendering ! * @return string An HTML form for creating a new blog ! * @dontvalidate $newBlog ! */ ! public function newAction(Tx_BlogExample_Domain_Model_Blog $newBlog = NULL) { ! ! $this->view->assign('newBlog', $newBlog); ! ! $this->view->assign('administrators', $this->administratorRepository->findAll()); ! } ! /** ! * Creates a new blog ! * ! * @param Tx_BlogExample_Domain_Model_Blog $newBlog A fresh Blog object which has not yet been added to the repository ! * @return void ! */ ! public function createAction(Tx_BlogExample_Domain_Model_Blog $newBlog) { ! ! $this->blogRepository->add($newBlog); ! ! $this->pushFlashMessage('Your new blog was created.'); ! ! $this->redirect('index'); ! }

How could you fetch a blog?

How could you fetch a book?

Model Blog Post Comment Tag

Model BlogRepository Blog Post Comment Tag

/** * A repository for Blogs */ class Tx_BlogExample_Domain_Repository_BlogRepository extends Tx_Extbase_Persistence_Repository { ! ! /** ! * Remove the blog's posts before removing the blog itself. ! * ! * @return array An array filled with blogs ! */ ! public function findAll() { ! ! $blogs = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows( ! ! ! '*', ! ! ! 'tx_blogexample_domain_model_blog', ! ! ! 'sys_language_uid=' . $GLOBALS['TSFE']->sys_language_uid . $this->cObj->enableFields('tx_blogexample_domain_model_blog'), ! ! ! '', ! ! ! 'date' ! ! ! ); ! ! ! ! ! return $blogs; ! } }

/** * A repository for Blogs */ class Tx_BlogExample_Domain_Repository_BlogRepository extends Tx_Extbase_Persistence_Repository { ! }

/** * A repository for Posts */ class Tx_BlogExample_Domain_Repository_PostRepository extends Tx_Extbase_Persistence_Repository { ! ! /** ! * Finds posts by the specified blog ! * ! * @param Tx_BlogExample_Domain_Model_Blog $blog The blog the post must refer to ! * @param integer $limit The number of posts to return at max ! * @return array The posts ! */ ! public function findByBlog(Tx_BlogExample_Domain_Model_Blog $blog, $limit = 20) { ! ! $query = $this->createQuery(); ! ! return $query->matching($query->equals('blog', $blog)) ! ! ! ->setOrderings(array('date' => Tx_Extbase_Persistence_QueryInterface::ORDER_DESCENDING)) ! ! ! ->setLimit($limit) ! ! ! ->execute(); ! } ! /** ! * Finds the previous of the given post ! * ! * @param Tx_BlogExample_Domain_Model_Post $post The reference post ! * @return Tx_BlogExample_Domain_Model_Post ! */ ! public function findPrevious(Tx_BlogExample_Domain_Model_Post $post) {

! * @param Tx_BlogExample_Domain_Model_Post $post The reference post ! * @return Tx_BlogExample_Domain_Model_Post ! */ ! public function findNext(Tx_BlogExample_Domain_Model_Post $post) { ! ! $query = $this->createQuery(); ! ! $posts = $query->matching($query->greaterThan('date', $post->getDate())) ! ! ! ->setOrderings(array('date' => Tx_Extbase_Persistence_QueryInterface::ORDER_DESCENDING)) ! ! ! ->setLimit(1) ! ! ! ->execute(); ! ! return (count($posts) == 0) ? NULL : current($posts); ! } ! /** ! * Finds most recent posts by the specified blog ! * ! * @param Tx_BlogExample_Domain_Model_Blog $blog The blog the post must refer to ! * @param integer $limit The number of posts to return at max ! * @return array The posts ! */ ! public function findRecentByBlog(Tx_BlogExample_Domain_Model_Blog $blog, $limit = 5) { ! ! $query = $this->createQuery(); ! ! return $query->matching($query->equals('blog', $blog)) ! ! ! ->setOrderings(array('date' => Tx_Extbase_Persistence_QueryInterface::ORDER_DESCENDING)) ! ! ! ->setLimit($limit) ! ! ! ->execute(); ! } }

Repositories Encapsulate all data access SQL is allowed only in the Repository ... but not necessary anymore: use the Query object instead Magic methods: ndBy*, ndOneBy*

Blog Post Comment Tag

Aggregate Blog Post Comment Tag

Blog Entity Post Comment Tag

Blog Entity Post Value Object Comment Tag

Aggregate Root Blog Entity Post Value Object Comment Tag

Aggregate getLatestComment() Root Blog Post Comment Tag

<h1 class="csc-firstHeader">Welcome to {blog.title}</h1> <p class="bodytext">{blog.description}</p> <div class="tx-blogexample-list-container"> ! <f:if condition="{blog.posts}"> ! ! <f:then> ! ! <p class="bodytext"><f:translate key="label_recent_posts">Below are the most recent posts:</f:translate></p> ! ! ! <ul> ! ! ! ! <f:for each="{blog.posts}" as="post"> ! ! ! ! ! <li> ! ! ! ! ! ! <h3> ! ! ! ! ! ! ! <f:format.date>{post.date}</f:format.date> ! ! ! ! ! ! ! <f:link.action action="show" controller="Post" arguments="{post: post, blog: post.blog}">{post.title}</f:link.action> ! ! ! ! ! ! </h3> ! ! ! ! ! ! <p class="bodytext"><f:format.crop maxCharacters="100">{post.content}</f:format.crop></p> ! ! ! ! ! ! <p> ! ! ! ! ! ! ! By: {post.author.fullName}<br /> ! ! ! ! ! ! ! Tags: <f:for each="{post.tags}" as="tag">[{tag.name}] </f:for><br /> ! ! ! ! ! ! ! <f:link.action controller="Post" action="show" arguments="{post : post}"> <f:translate key="read_more">read more >></f:translate> </f:link.action><br /> ! ! ! ! ! ! ! <f:link.action controller="Post" action="edit" arguments="{post : post, blog : blog}"> Edit </f:link.action> <f:link.action controller="Post" action="delete" arguments="{post : post, blog : blog}"> Delete </f:link.action> ! ! ! ! ! ! </p> ! ! ! ! ! </li> ! ! ! ! </f:for> ! ! ! </ul> ! ! </f:then> ! ! <f:else> ! ! ! <p>This blog currently doesn't contain any posts.</p> ! ! </f:else> ! </f:if> ! <p><f:link.action action="new" controller="Post" arguments="{blog : blog}">Create a new Post</f:link.action></p> </div>

Security All arguments must be registered. Registration of expected arguments happens through de ning them as method parameters. PHPDoc is mandatory as it is used for data type validation

*/ class Tx_BlogExample_Domain_Model_Comment extends Tx_Extbase_DomainObject_AbstractEntity { ! /** ! * @var DateTime ! */ ! protected $date; ! /** ! * @var string ! * @validate Text, StringLength(minimum = 3, maximum = 80) ! */ ! protected $author; ! /** ! * @var string ! * @validate EmailAddress ! */ ! protected $email; ! /** ! * @var string ! * @validate Text, NotEmpty ! */ ! protected $content; ! ! ! /** ! * Constructs this post

Controlle r odel Do main / M View Con fig ura tio n

Principles of Domain Driven Design focus on the domain = activity or business of user we start with the business logic (PHP classes) we don't care about the database backend / persistence layer objects represent things in the real world, with their attributes and behavior ubiquitous language building blocks Entity Value Objects Repositories

What's next?

What's next New Kickstarter currently ongoing project by the core development team will be released shortly after 4.3 Domain-Driven Design - Don't think in databases, think in Domain Models! Support for BE-Modules experimental by now AJAX-Dispatcher Dependency Injection PDO Storage Backend

- Modern architecture

Modular reusable Greatly reusable components components

Easy and clean API

Easy testable

Get more implemented in less time

You will get addicted

Bastian Waidelich Sebastian Kurfürst Than k You Steffen Kamper and the TYPO3 V5 Team for all the inspiration and the beautiful code Ingmar Schlecht Christopher Hlubek Xavier Perseguers

Resources and links Project web site: http://forge.typo3.org/projects/show/typo3v4-mvc SVN: https://svn.typo3.org/TYPO3v4/CoreProjects/MVC/ Newslist typo3.projects.typo3v4mvc@lists.net elders.de First stable release with TYPO3 4.3 alpha3: http://typo3.org/download/packages/

http://flow3.typo3.org	1983
http://www.slideshare.net	91
http://paper.li	19
http://www.bertrandkeller.info	7
http://csit.uniud.it	3
http://translate.googleusercontent.com	3
http://a0.twimg.com	2
http://www.e-presentations.us	1

Get into the FLOW with Extbase

by jocrau on Sep 16, 2009

Accessibility

Categories

Tags

Upload Details

Usage Rights

8 Embeds 2,109

Statistics

Get into the FLOW with Extbase — Presentation Transcript