1 | <?php |
||
51 | class ObjectProxy implements ObjectInterface |
||
52 | { |
||
53 | /** |
||
54 | * Apparat object URL |
||
55 | * |
||
56 | * @var ApparatUrl |
||
57 | */ |
||
58 | protected $url = null; |
||
59 | /** |
||
60 | * Object |
||
61 | * |
||
62 | * @var ObjectInterface |
||
63 | */ |
||
64 | protected $object = null; |
||
65 | |||
66 | /******************************************************************************* |
||
67 | * PUBLIC METHODS |
||
68 | *******************************************************************************/ |
||
69 | |||
70 | /** |
||
71 | * Object proxy constructor |
||
72 | * |
||
73 | * @param ApparatUrl $url Apparat object URL |
||
74 | */ |
||
75 | 3 | public function __construct(ApparatUrl $url) |
|
79 | |||
80 | /** |
||
81 | * Return the object repository path |
||
82 | * |
||
83 | * @return PathInterface Object repository path |
||
84 | */ |
||
85 | public function getRepositoryPath() |
||
96 | |||
97 | /** |
||
98 | * Return the object property data |
||
99 | * |
||
100 | * @return array Object property data |
||
101 | */ |
||
102 | public function getPropertyData() |
||
106 | |||
107 | /** |
||
108 | * Return the object payload |
||
109 | * |
||
110 | * @return string Object payload |
||
111 | */ |
||
112 | public function getPayload() |
||
116 | |||
117 | /** |
||
118 | * Return the object ID |
||
119 | * |
||
120 | * @return Id Object ID |
||
121 | */ |
||
122 | public function getId() |
||
126 | |||
127 | /** |
||
128 | * Return the enclosed remote object |
||
129 | * |
||
130 | * @return ObjectInterface Remote object |
||
131 | */ |
||
132 | protected function object() |
||
133 | { |
||
134 | // Lazy-load the remote object if necessary |
||
135 | if (!$this->object instanceof ObjectInterface) { |
||
136 | // Instantiate the local object repository, load and return the object |
||
137 | $this->object = Kernel::create(Service::class)->get($this->url)->loadObject($this->url->getLocalPath()); |
||
138 | } |
||
139 | |||
140 | return $this->object; |
||
141 | } |
||
142 | |||
143 | /** |
||
144 | * Return the object type |
||
145 | * |
||
146 | * @return Type Object type |
||
147 | */ |
||
148 | public function getType() |
||
152 | |||
153 | /** |
||
154 | * Return the object revision |
||
155 | * |
||
156 | * @return Revision Object revision |
||
157 | */ |
||
158 | public function getRevision() |
||
162 | |||
163 | /** |
||
164 | * Return the creation date & time |
||
165 | * |
||
166 | * @return \DateTimeImmutable Creation date & time |
||
167 | */ |
||
168 | public function getCreated() |
||
172 | |||
173 | /** |
||
174 | * Return the publication date & time |
||
175 | * |
||
176 | * @return \DateTimeImmutable Publication date & time |
||
177 | */ |
||
178 | public function getPublished() |
||
182 | |||
183 | /** |
||
184 | * Return the object hash |
||
185 | * |
||
186 | * @return string Object hash |
||
187 | */ |
||
188 | public function getHash() |
||
192 | |||
193 | /** |
||
194 | * Return the object description |
||
195 | * |
||
196 | * @return string Object description |
||
197 | */ |
||
198 | public function getDescription() |
||
202 | |||
203 | /** |
||
204 | * Return the object abstract |
||
205 | * |
||
206 | * @return string Object abstract |
||
207 | */ |
||
208 | public function getAbstract() |
||
212 | |||
213 | /** |
||
214 | * Return all object keywords |
||
215 | * |
||
216 | * @return array Object keywords |
||
217 | */ |
||
218 | public function getKeywords() |
||
222 | |||
223 | /** |
||
224 | * Return all object categories |
||
225 | * |
||
226 | * @return array Object categories |
||
227 | */ |
||
228 | public function getCategories() |
||
232 | |||
233 | /** |
||
234 | * Return all object authors |
||
235 | * |
||
236 | * @return AuthorInterface[] Authors |
||
237 | */ |
||
238 | public function getAuthors() |
||
242 | |||
243 | /** |
||
244 | * Add an object author |
||
245 | * |
||
246 | * @param AuthorInterface $author Author |
||
247 | * @return ObjectInterface Self reference |
||
248 | */ |
||
249 | public function addAuthor(AuthorInterface $author) |
||
253 | |||
254 | /** |
||
255 | * Get a particular property value |
||
256 | * |
||
257 | * Multi-level properties might be traversed by property name paths separated with colons (":"). |
||
258 | * |
||
259 | * @param string $property Property name |
||
260 | * @return mixed Property value |
||
261 | */ |
||
262 | public function getDomainProperty($property) |
||
266 | |||
267 | /******************************************************************************* |
||
268 | * MAGIG METHODS |
||
269 | *******************************************************************************/ |
||
270 | |||
271 | /** |
||
272 | * Return the absolute object URL |
||
273 | * |
||
274 | * @return string |
||
275 | */ |
||
276 | 4 | public function getAbsoluteUrl() |
|
280 | |||
281 | /******************************************************************************* |
||
282 | * PRIVATE METHODS |
||
283 | *******************************************************************************/ |
||
284 | |||
285 | /** |
||
286 | * Generic caller |
||
287 | * |
||
288 | * @param string $name Method name |
||
289 | * @param array $arguments Method arguments |
||
290 | */ |
||
291 | public function __call($name, $arguments) |
||
303 | } |
||
304 |
If you return a value from a function or method, it should be a sub-type of the type that is given by the parent type f.e. an interface, or abstract method. This is more formally defined by the Lizkov substitution principle, and guarantees that classes that depend on the parent type can use any instance of a child type interchangably. This principle also belongs to the SOLID principles for object oriented design.
Let’s take a look at an example:
Our function
my_function
expects aPost
object, and outputs the author of the post. The base classPost
returns a simple string and outputting a simple string will work just fine. However, the child classBlogPost
which is a sub-type ofPost
instead decided to return anobject
, and is therefore violating the SOLID principles. If aBlogPost
were passed tomy_function
, PHP would not complain, but ultimately fail when executing thestrtoupper
call in its body.