PHP Classes

File: README.txt

Recommend this page to a friend!
  Classes of Michal Szpakowski   Event   README.txt   Download  
File: README.txt
Role: Documentation
Content type: text/plain
Description: README and Licence
Class: Event
Register handlers and trigger event actions
Author: By
Last change: Minor changes.
Date: 16 years ago
Size: 2,639 bytes
 

Contents

Class file image Download
This class is an Event simulation that resembles some other languages' functionalities, such as .NET events. The idea is that user creates an Event put in the static array in the class, accessible only via the static methods. The Event object itself is never accessible. However, there is an EventWrapper, which wraps functionality in way shown in the example.php file. To create an Event first you need to provide i.Event_Name.Event interface which has the on.Event_Name.Call and on.Event_name.Destroy functions (see documentation of Event.php). You can also provide other interface name, but the interface has to define these methods. Events are either Private, Protected or Public. Private events can be called only by the instance of EventCaller (or one of it's descendants) provided during Event creation. Making this caller private member of class makes event callable only by that class. Protected Events are callable only via the instance of a class, which name is provided during the creation. Since there is no possibility to create internal classes, object can be created to call the event. Hovewer, informational purposes require making it this way. When getting the CallerClass classname one can easily determine which module/library is the "owner" of the Event. Public events can be raised by any object which is EventCaller or one of it's descendants. Events provide datasets. Dataset is an information set which is an argument for Listeners. Listener is an object which "listens" whether the Event was raised. On raising the event, the on.Event_Name.Call is called. The callback function with one argument - dataset. Listeners have to implement the Event's interface provided at creation. Dataset can be of a null value, nevertheless handler methods must have at least one argument. Events are disposable or non-disposable. Disposable Events are unset after raising. Non-disposable stay in the memory (private events can be destroyed by unsetting the caller instance and calling the Event::callerDestroyed() function). First event is created either by the static Event::init() method or on first event creation. It's the EventCreated Event, non-disposable, with EventInfo dataset. EventCreated is raised when new event is created, as it's name says :). More documentation in the .php files. License: this package is available for non-commercial usage, after notyfying the author (szpakowski@gmail.com), on GPL License. Using this package in commercial projects has to be agreed by the author (usually free). Author does not provide any guarantees for the class. Have fun.