https://limb.nohau.ru/ 2026-11-10T16:45:34+00:00 https://limb.nohau.ru/ https://limb.nohau.ru/lib/exe/fetch.php?media=wiki:dokuwiki.svg text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:controller&rev=1289372570&do=diff The key conceptions of Limb3 Controller Controller handles application logic. Here is the list of the key conceptions of Limb3 Controller: * Request - contains request information. lmbHttpRequest contains POST, GET and FILES. * Response - contains response information from application once Request is processed. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:criteria&rev=1289372570&do=diff Criteria Criteria is a group of classes that allows you to build complex conditions for SQL queries using nice OO interface. The initial conception was adopted from Propel and later was a bit simplified. UML Static Structure } Criteria classes All criteria classes are children of lmbSQLBaseCriteria class that implements basic functionality to allow a composition of criteria. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:daos&rev=1289372570&do=diff DAO - Data Access lmbObject Description DAO classes are used to unify the process of getting raw data from the persistence layer(it's on the TODO list to rename current DAO implementation into RecordSet). DAO classes can have two methods: * fetch() text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:data_container&rev=1289372570&do=diff Data containers All data containers used in Limb implement two interfaces: DataSource and Iterator. UML charts Non-list data containter implementing DataSource } List data containter implementing DataSourceIterator } Examples Iteration Let's define a small array of data, create an ArrayDataSet using this array and iterate over it using Iterator interface. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:db_schema&rev=1289372570&do=diff New Limb3 DB Schema DB Schema example This example shows typical DB structure of Limb3 based project. To simplify the example we removed all tables that related to statistics, access policy, all domain objects except articles. Required tables * text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:dbal&rev=1289372570&do=diff Limb DBAL structure Limb DBAL structure } Description PackageDescriptionWACT DBALWACT Data Base Abstraction Layer. Limb DBAL is build around WACT DBAL.QueryA group of classes that allows partially encapsulate SQL queries. lmbSelectQuery is most commonly used class from this package. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:filters&rev=1289372570&do=diff Intercepting Filters Chain Description Intercepting filters are used to pre-process requests and post-process responses. They wrap and modify or transform inputs and outputs to/from core application logic. Intercepting Filter pattern can be applied at any level of an application. Limb uses intercepting filters as a part of FrontController. You can read more about this pattern at text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:limb_mvc&rev=1289372570&do=diff MVC pattern Limb is built around MVC pattern also known as Model2. On the diagram below you can see the core Limb class packages. Limb3 structure } * RequestDispatching, Filters, Commands - are the components of Controller. * DBAL, DAO, ORM, DomainObjects - are the components of Model. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:lmb_command_processing_filter&rev=1289372570&do=diff lmbCommandProcessingFilter lmbCommandProcessingFilter executes a lmbCommand according to the requested lmbService and Action. class lmbCommandProcessingFilter implements lmbInterceptingFilter { public function run($filter_chain) { $dispatched = lmbToolkit :: instance()->getDispatchedRequest(); if(!is_object($dispatched)) throw new lmbException('Request is not dispatched yet! lmbDispatchedRequest not found in lmbToolkit!'); $command = $dispatched->getActionCommand(); … text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:lmb_command&rev=1289372570&do=diff Limb3 Commands Short description Limb Commands implement a very simple interface which consists of the only perform() method. Commands are the main containers of an application specific logic. UML Static Structure } Frequently used generic commands text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:lmb_dispatched_request&rev=1289372570&do=diff lmbDispatchedRequest lmbDispatchedRequest contains requested lmbService and Action. lmbDispatchedRequest is created in lmbRequestDispatcher and passed to lmbToolkit in lmbRequestDispatchingFilter so that other classes can use lmbDispatchedRequest for their needs. Some filters where lmbDispatchedRequest is used: * lmbCommandProcessingFilter - executes a command that matches the requested lmbService and Action. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:lmb_file_schema&rev=1289372570&do=diff lmbFileSchema Description lmbFileSchema is a mechanism used in Limb to find full file paths by short aliases. lmbFileSchema is used by different class factories, template engine, etc. UML Static structure } Comments Here is the sample code that uses lmbToolkit to get access to lmbFileSchema in order to locate full file path of a command: text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:lmb_observable_command&rev=1289372570&do=diff lmbObservableCommand lmbObservableCommand allows to register multiple commands onvoked on perform event. lmbObservableCommand :: registerOnPerformListener($listener) accepts and registers a listener - an object of WACT Delegate class. Here is an example of lmbObservableCommand usage: text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:lmb_property_optional_command&rev=1289372570&do=diff lmbPropertyOptionalCommand lmbPropertyOptionalCommand is a child class of lmbObservableCommand and allows you to insert «if» conditional logic into the command chain. lmbPropertyOptionalCommand accepts dataspace object and property name in constructor. lmbPropertyOptionalCommand triggers onPerform event only if the dataspace has not null specified property. lmbPropertyOptionalCommand is mostly used with text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:lmb_request_dispatcher&rev=1289372570&do=diff lmbRequestDispatcher lmbRequestDispatcher is a class that performs the main part of RequestDispatching. lmbRequestDispatcher uses lmbRequestExtractors to determine current lmbService and Action. lmbRequestDispatcher :: dispatch($request) method returns lmbDispatchedRequest. lmbRequestDispatchingFilter is a common place where lmbRequestDispatcher is used. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:lmb_request_dispatching_filter&rev=1289372570&do=diff lmbRequestDispatchingFilter lmbRequestDispatchingFilter implements lmbInterceptingFilter interface and performs RequestDispatching using some concrete lmbRequestDispatcher. lmbRequestDispatchingFilter has a factory method to create lmbRequestDispatcher object, as well as factory methods to create ServiceRequestExtractor and lmbActionRequestExtractor. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:lmb_select_query&rev=1289372570&do=diff lmbSelectQuery lmbSelectQuery allows to partially encapsulate SQL SELECT query. lmbSelectQuery accepts a text template of Select SQL that can be extended. This template SQL must contain several special placeholders where extensions can be inserted into, e.g.: %fields% or %where%. That's why it's more corrent to call lmbSelectQuery as TemplateSelectQuery(on the TODO list). text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:lmb_service&rev=1289372570&do=diff Limb3 Services Short description lmbService - is a group of Actions, related to some domain or functional area. For example, for user authentication we can create and use Login lmbService, to work with site structure - SiteStructure lmbService, etc. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:lmb_toolkit&rev=1289372570&do=diff lmbToolkit Any web-application has several objects which should be shared among many components and have global meaning. For example, Request, Response, data base connection, different class factories, etc. Some developers make these classes global, some implement them as Singletons, some pass them across the entire application. We prefer not not use Singletons or any of these methods since they cause difficulties for unit testing. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:lmbsql_field_criteria&rev=1289372570&do=diff lmbSQLFieldCriteria lmbSQLFieldCriteria creates a simple condition for a db table field. lmbSQLFieldCriteria accepts field name, value and condition type in constructor: $criteria = new lmbSQLFieldCriteria('contract.start_date', $date_str, lmbSQLFieldCriteria:: LESS); $criteria = new lmbSQLFieldCriteria('contract.end_date', $date_str, '>'); text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:model&rev=1289372570&do=diff Model Model classes holds data, stores them in persistence layer, deals with business rules and domain logic. Limb Model consists of the following components: * DataContainers - classes that holds data. There are two groups of data containers: iterators and datasources. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:packages&rev=1289372570&do=diff Limb3 packages Basic conceptions The conception of package in Limb3 is very primitive. Packaging is achieved through work of special FileResolvers that try to find files in different folders. See FileResolvers documentation page for more info. Limb3 package conception is very raw. There is no means to automate package dependency check so be carefull. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_3:en:architecture:request_dispatching&rev=1289372570&do=diff Request Dispatching Request Dispatching is a process of determination of the requested lmbService and requested Action. There is the list of classes that play important roles in Request Dispatching process: * lmbRequestDispatcher that accepts ServiceRequestExtractor and lmbActionRequestExtractor in constructor (see