PHP 클래스 AbstractObject, atk4

공개 프로퍼티들

프로퍼티	타입	설명
$_info		Records debug information.
$_initialized	boolean	To make sure you have called parent::init() properly.
$api
$app	App_CLI	Always points to current Application
$auto_track_element	boolean	When this object is added, owner->elements[$this->short_name] will be == $this;.
$controller	Controller	Reference to the current controller. Read only. Use setController()
$debug	boolean	Setting this to true will output additional debug info about object
$default_controller	string	Default controller to initialize when calling setModel()
$default_exception	string	$default_exception='PathFinder' by default would return 'Exception_PathFinder' from exception(). $default_exceptoin='PathFinder' in combination with ->exception('Blah','_NotFound') will return 'Exception_PathFinder_NotFound' $default_exception='BaseException' in combination with ->exception('Blah', 'PathFinder') will create 'Exception_PathFinder' exception. and finally $default_exception='PathFinder' in combination with ->exception('Blah','NotFound') will return 'Exception_NotFound';
$elements	array	short_name => object hash of children objects
$hooks		{{{ Hooks: http://agiletoolkit.org/doc/hooks
$model	Model	Reference to the current model. Read only. Use setModel()
$name	string	Unique object name
$owner	AbstractObject	Link to object into which we added this object
$short_name	string	Name of the object in owner's element array

공개 메소드들

메소드	설명
__call ( string $method, array $arguments ) : mixed	Call method is used to display exception for non-existant methods and provides ability to extend objects with addMethod().
__clone ( ) : AbstractObject	Clones associated controller and model. If cloning views, add them to the owner.
__construct ( array $options = [] )	This is default constructor of ATK4. Please do not re-define it and avoid calling it directly. Always use add() and init() methods.
__destruct ( )	Always call parent if you redefine this/.
__sleep ( ) : mixed	Do not serialize objects.
__toString ( ) : string	Converts into string "Object View(myapp_page_view)".
_removeElement ( string $short_name )	Actually removes the element.
_shorten ( string $desired ) : string	Method used internally for shortening object names.
_ticker ( )
_unique ( &$array, string $desired = null ) : string	This funcion given the associative $array and desired new key will return the best matching key which is not yet in the array.
_unique_element ( $desired = null )
add ( array \| string \| object $class, array \| string $options = null, string $template_spot = null, array \| string $template_branch = null ) : AbstractObject	Creates new object and adds it as a child of current object.
addHook ( string $hook_spot, AbstractObject \| callable $callable, array $arguments = [], integer $priority = 5 )	If priority is negative, then hooks will be executed in reverse order.
addMethod ( string \| array $name, callable $callable )	Add new method for this object.
breakHook ( mixed $return )	When called from inside a hook callable, will stop execution of other callables on same hook. The passed argument will be returned by the hook method.
debug ( boolean \| string $msg = true, string $file = null, string $line = null )	Turns on debug mode for this object.
destroy ( $recursive = true )	Removes object from parent and prevents it from rendering \code $view = $this->add('View'); $view -> destroy(); \endcode.
each ( string \| callable $callable )	A handy shortcut for foreach(){ .
exception ( string $message = 'Undefined Exception', string $type = null, string $code = null ) : BaseException	Returns relevant exception class. Use this method with "throw".
fatal ( string $error, integer $shift )	Reports fatal error. Use ->exception instead.
forget ( string $key = null )	Forget session data for arg $key. If $key is omitted will forget all associated session data.
getElement ( string $short_name ) : AbstractObject	Find child element by its short name. Use in chaining.
getModel ( ) : AbstractModel	Return current model.
hasElement ( string $short_name ) : AbstractObject \| boolean	Find child element. Use in condition.
hasMethod ( string $name ) : boolean	Return if this object has specified method (either native or dynamic).
hook ( string $hook_spot, array $arg = [] ) : mixed	Execute all callables assigned to $hook_spot.
info ( $msg )
init ( )	Initialize object. Always call parent::init(). Do not call directly.
learn ( string $key, mixed $default = null ) : mixed	Similar to memorize, but if value for key exist, will return it.
logError ( string $error, string $msg = '' )	Output string into error file.
logInfo ( string $info, string $msg = '' )	Output string into info file.
logVar ( string $var, string $msg = '' )	Output string into log file.
memorize ( string $key, mixed $value ) : mixed	Remember data in object-relevant session data.
newInstance ( array $properties = null ) : self	Creates one more instance of $this object.
recall ( string $key, mixed $default = null ) : mixed	Returns session data for this object. If not previously set, then $default is returned.
removeElement ( string $short_name )	Remove child element if it exists.
removeHook ( string $hook_spot )	Delete all hooks for specified spot.
removeMethod ( string $name )	Remove dynamically registered method.
rename ( string $short_name )	Names object accordingly. May not work on some objects.
runTests ( Tester $tester = null )	This method will find private methods started with test_ in the current class and will execute each method in succession by passing $t argument to it. Before each test execution takes place, $t->prepareForTest($test) will be called. It must return non-false for test to be carried out.
setController ( string \| object $controller, string \| array $name = null ) : AbstractController	Associate controller with the object.
setModel ( string \| object $model ) : AbstractModel	Associate model with object.
tryCall ( string $method, array $arguments ) : mixed	Attempts to call dynamic method. Returns array containing result or false.
upCall ( string $type, array $args = [] )	Call specified method for this class and all parents up to app.
warning ( string $msg, integer $shift )	Records warning.

메소드 상세

__call() 공개 메소드

Call method is used to display exception for non-existant methods and provides ability to extend objects with addMethod().

public __call ( string $method, array $arguments ) : mixed
$method	string	Name of the method
$arguments	array	Arguments
리턴	mixed

__clone() 공개 메소드

Clones associated controller and model. If cloning views, add them to the owner.

public __clone ( ) : AbstractObject
리턴	AbstractObject	Copy of this object

__construct() 공개 메소드

This is default constructor of ATK4. Please do not re-define it and avoid calling it directly. Always use add() and init() methods.

public __construct ( array $options = [] )
$options	array	will initialize class properties

__destruct() 공개 메소드

Always call parent if you redefine this/.

public __destruct ( )

__sleep() 공개 메소드

Do not serialize objects.

public __sleep ( ) : mixed
리턴	mixed

__toString() 공개 메소드

Converts into string "Object View(myapp_page_view)".

public __toString ( ) : string
리턴	string

_removeElement() 공개 메소드

Actually removes the element.

public _removeElement ( string $short_name )
$short_name	string	short name

_shorten() 공개 메소드

Method used internally for shortening object names.

public _shorten ( string $desired ) : string
$desired	string	Desired name of new object.
리턴	string	Shortened name of new object.

_ticker() 공개 메소드

public _ticker ( )

_unique() 공개 메소드

For example, if you have array('foo'=>x,'bar'=>x) and $desired is 'foo' function will return 'foo_2'. If 'foo_2' key also exists in that array, then 'foo_3' is returned and so on.

public _unique ( &$array, string $desired = null ) : string
$desired	string	Desired key for new object
리턴	string	unique key for new object

_unique_element() 공개 메소드

public _unique_element ( $desired = null )

add() 공개 메소드

Returns new object.

링크 보기: http://agiletoolkit.org/learn/understand/base/adding

public add ( array \| string \| object $class, array \| string $options = null, string $template_spot = null, array \| string $template_branch = null ) : AbstractObject
$class	array \| string \| object	Name of the new class. Can also be array with 0=>name and rest of array will be considered as $options or object.
$options	array \| string	Short name or array of properties. 0=>name will be used as a short-name or your object.
$template_spot	string	Tag where output will appear
$template_branch	array \| string	Redefine template
리턴	AbstractObject

addHook() 공개 메소드

If priority is negative, then hooks will be executed in reverse order.

public addHook ( string $hook_spot, AbstractObject \| callable $callable, array $arguments = [], integer $priority = 5 )
$hook_spot	string	Hook identifier to bind on
$callable	AbstractObject \| callable	Will be called on hook()
$arguments	array	Arguments are passed to $callable
$priority	integer	Lower priority is called sooner

addMethod() 공개 메소드

Add new method for this object.

public addMethod ( string \| array $name, callable $callable )
$name	string \| array	Name of new method of $this object
$callable	callable	Callback

breakHook() 공개 메소드

When called from inside a hook callable, will stop execution of other callables on same hook. The passed argument will be returned by the hook method.

public breakHook ( mixed $return )
$return	mixed	What would hook() return?

debug() 공개 메소드

Using first argument as string is obsolete.

public debug ( boolean \| string $msg = true, string $file = null, string $line = null )
$msg	boolean \| string	"true" to start debugging
$file	string	obsolete
$line	string	obsolete

destroy() 공개 메소드

Removes object from parent and prevents it from rendering \code $view = $this->add('View'); $view -> destroy(); \endcode.

public destroy ( $recursive = true )

each() 공개 메소드

. } code. Make your callable return "false" if you would like to break the loop.

public each ( string \| callable $callable )
$callable	string \| callable	will be executed for each member

exception() 공개 메소드

Returns relevant exception class. Use this method with "throw".

public exception ( string $message = 'Undefined Exception', string $type = null, string $code = null ) : BaseException
$message	string	Static text of exception.
$type	string	Exception class or class postfix
$code	string	Optional error code
리턴	BaseException

fatal() 공개 메소드

Reports fatal error. Use ->exception instead.

public fatal ( string $error, integer $shift )
$error	string	error text
$shift	integer	relative offset in backtrace

forget() 공개 메소드

Forget session data for arg $key. If $key is omitted will forget all associated session data.

public forget ( string $key = null )
$key	string	Optional key of data to forget

getElement() 공개 메소드

Exception if not found.

public getElement ( string $short_name ) : AbstractObject
$short_name	string	Short name of the child element
리턴	AbstractObject

getModel() 공개 메소드

Return current model.

public getModel ( ) : AbstractModel
리턴	AbstractModel	Currently associated model object

hasElement() 공개 메소드

Find child element. Use in condition.

public hasElement ( string $short_name ) : AbstractObject \| boolean
$short_name	string	Short name of the child element
리턴	AbstractObject \| boolean

hasMethod() 공개 메소드

Return if this object has specified method (either native or dynamic).

public hasMethod ( string $name ) : boolean
$name	string	Name of the method
리턴	boolean

hook() 공개 메소드

Execute all callables assigned to $hook_spot.

public hook ( string $hook_spot, array $arg = [] ) : mixed
$hook_spot	string	Hook identifier
$arg	array	Additional arguments to callables
리턴	mixed	Array of responses or value specified to breakHook

info() 공개 메소드

public info ( $msg )

init() 공개 메소드

Initialize object. Always call parent::init(). Do not call directly.

public init ( )

learn() 공개 메소드

Similar to memorize, but if value for key exist, will return it.

public learn ( string $key, mixed $default = null ) : mixed
$key	string	Data Key
$default	mixed	Default value
리턴	mixed	Previously memorized data or $default

logError() 공개 메소드

Output string into error file.

public logError ( string $error, string $msg = '' )
$error	string	error
$msg	string	msg

logInfo() 공개 메소드

Output string into info file.

public logInfo ( string $info, string $msg = '' )
$info	string	info
$msg	string	msg

logVar() 공개 메소드

Output string into log file.

public logVar ( string $var, string $msg = '' )
$var	string	var
$msg	string	msg

memorize() 공개 메소드

Remember data in object-relevant session data.

public memorize ( string $key, mixed $value ) : mixed
$key	string	Key for the data
$value	mixed	Value
리턴	mixed	$value

newInstance() 공개 메소드

Creates one more instance of $this object.

public newInstance ( array $properties = null ) : self
$properties	array	Set initial properties for new object
리턴	self

recall() 공개 메소드

Returns session data for this object. If not previously set, then $default is returned.

public recall ( string $key, mixed $default = null ) : mixed
$key	string	Data Key
$default	mixed	Default value
리턴	mixed	Previously memorized data or $default

removeElement() 공개 메소드

Remove child element if it exists.

public removeElement ( string $short_name )
$short_name	string	short name of the element

removeHook() 공개 메소드

Delete all hooks for specified spot.

public removeHook ( string $hook_spot )
$hook_spot	string	Hook identifier to bind on

removeMethod() 공개 메소드

Remove dynamically registered method.

public removeMethod ( string $name )
$name	string	Name of the method

rename() 공개 메소드

Names object accordingly. May not work on some objects.

public rename ( string $short_name )
$short_name	string	Short name of the child element

runTests() 공개 메소드

$test will be an array containing keys for 'name', 'object' and 'class'

public runTests ( Tester $tester = null )
$tester	Tester

setController() 공개 메소드

Associate controller with the object.

public setController ( string \| object $controller, string \| array $name = null ) : AbstractController
$controller	string \| object	Class or instance of controller
$name	string \| array	Name or property for new controller
리턴	AbstractController	Newly added controller

setModel() 공개 메소드

Associate model with object.

public setModel ( string \| object $model ) : AbstractModel
$model	string \| object	Class or instance of model
리턴	AbstractModel	Newly added Model

tryCall() 공개 메소드

Attempts to call dynamic method. Returns array containing result or false.

public tryCall ( string $method, array $arguments ) : mixed
$method	string	Name of the method
$arguments	array	Arguments
리턴	mixed

upCall() 공개 메소드

Call specified method for this class and all parents up to app.

public upCall ( string $type, array $args = [] )
$type	string	information
$args	array	relative offset in backtrace

warning() 공개 메소드

Records warning.

public warning ( string $msg, integer $shift )
$msg	string	information
$shift	integer	relative offset in backtrace

프로퍼티 상세

$_info 공개적으로 프로퍼티

Records debug information.

public $_info

$_initialized 공개적으로 프로퍼티

To make sure you have called parent::init() properly.

public bool $_initialized
리턴	boolean

$api 공개적으로 프로퍼티

사용 중단: 4.3.0 Left for compatibility with ATK 4.2 and lower, use ->app instead

public $api

$app 공개적으로 프로퍼티

Always points to current Application

public App_CLI $app
리턴	App_CLI

$auto_track_element 공개적으로 프로퍼티

When this object is added, owner->elements[$this->short_name] will be == $this;.

public bool $auto_track_element
리턴	boolean

$controller 공개적으로 프로퍼티

Reference to the current controller. Read only. Use setController()

public Controller $controller
리턴	Controller

$debug 공개적으로 프로퍼티

Setting this to true will output additional debug info about object

public bool $debug
리턴	boolean

$default_controller 공개적으로 프로퍼티

Default controller to initialize when calling setModel()

public string $default_controller
리턴	string

$default_exception 공개적으로 프로퍼티

$default_exception='PathFinder' by default would return 'Exception_PathFinder' from exception(). $default_exceptoin='PathFinder' in combination with ->exception('Blah','_NotFound') will return 'Exception_PathFinder_NotFound' $default_exception='BaseException' in combination with ->exception('Blah', 'PathFinder') will create 'Exception_PathFinder' exception. and finally $default_exception='PathFinder' in combination with ->exception('Blah','NotFound') will return 'Exception_NotFound';

public string $default_exception
리턴	string

$elements 공개적으로 프로퍼티

short_name => object hash of children objects

public array $elements
리턴	array

$hooks 공개적으로 프로퍼티

{{{ Hooks: http://agiletoolkit.org/doc/hooks

public $hooks

$model 공개적으로 프로퍼티

Reference to the current model. Read only. Use setModel()

public Model $model
리턴	Model

$name 공개적으로 프로퍼티

Unique object name

public string $name
리턴	string

$owner 공개적으로 프로퍼티

Link to object into which we added this object

public AbstractObject $owner
리턴	AbstractObject

$short_name 공개적으로 프로퍼티

Name of the object in owner's element array

public string $short_name
리턴	string