1: <?php
2:
3: /**
4: * This file is part of the Nette Framework (https://nette.org)
5: * Copyright (c) 2004 David Grudl (https://davidgrudl.com)
6: */
7:
8: namespace Nette;
9:
10: use Nette;
11:
12:
13: /**
14: * Nette\Object is the ultimate ancestor of all instantiable classes.
15: *
16: * It defines some handful methods and enhances object core of PHP:
17: * - access to undeclared members throws exceptions
18: * - support for conventional properties with getters and setters
19: * - support for event raising functionality
20: * - ability to add new methods to class (extension methods)
21: *
22: * Properties is a syntactic sugar which allows access public getter and setter
23: * methods as normal object variables. A property is defined by a getter method
24: * or setter method (no setter method means read-only property).
25: * <code>
26: * $val = $obj->label; // equivalent to $val = $obj->getLabel();
27: * $obj->label = 'Nette'; // equivalent to $obj->setLabel('Nette');
28: * </code>
29: * Property names are case-sensitive, and they are written in the camelCaps
30: * or PascalCaps.
31: *
32: * Event functionality is provided by declaration of property named 'on{Something}'
33: * Multiple handlers are allowed.
34: * <code>
35: * public $onClick; // declaration in class
36: * $this->onClick[] = 'callback'; // attaching event handler
37: * if (!empty($this->onClick)) ... // are there any handlers?
38: * $this->onClick($sender, $arg); // raises the event with arguments
39: * </code>
40: *
41: * Adding method to class (i.e. to all instances) works similar to JavaScript
42: * prototype property. The syntax for adding a new method is:
43: * <code>
44: * MyClass::extensionMethod('newMethod', function (MyClass $obj, $arg, ...) { ... });
45: * $obj = new MyClass;
46: * $obj->newMethod($x);
47: * </code>
48: *
49: * @author David Grudl
50: *
51: * @property-read Nette\Reflection\ClassType $reflection
52: */
53: abstract class Object
54: {
55:
56: /**
57: * Access to reflection.
58: * @return Nette\Reflection\ClassType
59: */
60: public static function getReflection()
61: {
62: return new Reflection\ClassType(get_called_class());
63: }
64:
65:
66: /**
67: * Call to undefined method.
68: * @param string method name
69: * @param array arguments
70: * @return mixed
71: * @throws MemberAccessException
72: */
73: public function __call($name, $args)
74: {
75: return ObjectMixin::call($this, $name, $args);
76: }
77:
78:
79: /**
80: * Call to undefined static method.
81: * @param string method name (in lower case!)
82: * @param array arguments
83: * @return mixed
84: * @throws MemberAccessException
85: */
86: public static function __callStatic($name, $args)
87: {
88: return ObjectMixin::callStatic(get_called_class(), $name, $args);
89: }
90:
91:
92: /**
93: * Adding method to class.
94: * @param string method name
95: * @param callable
96: * @return mixed
97: */
98: public static function extensionMethod($name, $callback = NULL)
99: {
100: if (strpos($name, '::') === FALSE) {
101: $class = get_called_class();
102: } else {
103: list($class, $name) = explode('::', $name);
104: $rc = new \ReflectionClass($class);
105: $class = $rc->getName();
106: }
107: if ($callback === NULL) {
108: return ObjectMixin::getExtensionMethod($class, $name);
109: } else {
110: ObjectMixin::setExtensionMethod($class, $name, $callback);
111: }
112: }
113:
114:
115: /**
116: * Returns property value. Do not call directly.
117: * @param string property name
118: * @return mixed property value
119: * @throws MemberAccessException if the property is not defined.
120: */
121: public function &__get($name)
122: {
123: return ObjectMixin::get($this, $name);
124: }
125:
126:
127: /**
128: * Sets value of a property. Do not call directly.
129: * @param string property name
130: * @param mixed property value
131: * @return void
132: * @throws MemberAccessException if the property is not defined or is read-only
133: */
134: public function __set($name, $value)
135: {
136: ObjectMixin::set($this, $name, $value);
137: }
138:
139:
140: /**
141: * Is property defined?
142: * @param string property name
143: * @return bool
144: */
145: public function __isset($name)
146: {
147: return ObjectMixin::has($this, $name);
148: }
149:
150:
151: /**
152: * Access to undeclared property.
153: * @param string property name
154: * @return void
155: * @throws MemberAccessException
156: */
157: public function __unset($name)
158: {
159: ObjectMixin::remove($this, $name);
160: }
161:
162: }
163: