Completed
Push — master ( 1bc840...f440aa )
by Joschi
03:31
created

AbstractObject::undelete()   A

Complexity

Conditions 3
Paths 2

Size

Total Lines 10
Code Lines 5

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 5
CRAP Score 3

Importance

Changes 6
Bugs 0 Features 1
Metric Value
c 6
b 0
f 1
dl 0
loc 10
cc 3
eloc 5
nc 2
nop 0
ccs 5
cts 5
cp 1
crap 3
rs 9.4285
1
<?php
2
3
/**
4
 * apparat-object
5
 *
6
 * @category    Apparat
7
 * @package     Apparat\Object
8
 * @subpackage  Apparat\Object\Domain
9
 * @author      Joschi Kuphal <[email protected]> / @jkphl
10
 * @copyright   Copyright © 2016 Joschi Kuphal <[email protected]> / @jkphl
11
 * @license     http://opensource.org/licenses/MIT The MIT License (MIT)
12
 */
13
14
/***********************************************************************************
15
 *  The MIT License (MIT)
16
 *
17
 *  Copyright © 2016 Joschi Kuphal <[email protected]> / @jkphl
18
 *
19
 *  Permission is hereby granted, free of charge, to any person obtaining a copy of
20
 *  this software and associated documentation files (the "Software"), to deal in
21
 *  the Software without restriction, including without limitation the rights to
22
 *  use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
23
 *  the Software, and to permit persons to whom the Software is furnished to do so,
24
 *  subject to the following conditions:
25
 *
26
 *  The above copyright notice and this permission notice shall be included in all
27
 *  copies or substantial portions of the Software.
28
 *
29
 *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
30
 *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
31
 *  FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
32
 *  COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
33
 *  IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
34
 *  CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
35
 ***********************************************************************************/
36
37
namespace Apparat\Object\Domain\Model\Object;
38
39
use Apparat\Kernel\Ports\Kernel;
40
use Apparat\Object\Domain\Model\Object\Traits\DomainPropertiesTrait;
41
use Apparat\Object\Domain\Model\Object\Traits\IterableTrait;
42
use Apparat\Object\Domain\Model\Object\Traits\MetaPropertiesTrait;
43
use Apparat\Object\Domain\Model\Object\Traits\PayloadTrait;
44
use Apparat\Object\Domain\Model\Object\Traits\ProcessingInstructionsTrait;
45
use Apparat\Object\Domain\Model\Object\Traits\RelationsTrait;
46
use Apparat\Object\Domain\Model\Object\Traits\StatesTrait;
47
use Apparat\Object\Domain\Model\Object\Traits\SystemPropertiesTrait;
48
use Apparat\Object\Domain\Model\Path\RepositoryPath;
49
use Apparat\Object\Domain\Model\Path\RepositoryPathInterface;
50
use Apparat\Object\Domain\Model\Properties\AbstractDomainProperties;
51
use Apparat\Object\Domain\Model\Properties\InvalidArgumentException as PropertyInvalidArgumentException;
52
use Apparat\Object\Domain\Model\Properties\MetaProperties;
53
use Apparat\Object\Domain\Model\Properties\ProcessingInstructions;
54
use Apparat\Object\Domain\Model\Properties\Relations;
55
use Apparat\Object\Domain\Model\Properties\SystemProperties;
56
use Apparat\Object\Domain\Repository\SelectorInterface;
57
use Apparat\Object\Domain\Repository\Service;
58
59
/**
60
 * Abstract object
61
 *
62
 * @package Apparat\Object
63
 * @subpackage Apparat\Object\Domain
64
 */
65
abstract class AbstractObject implements ObjectInterface
66
{
67
    /**
68
     * Use traits
69
     */
70
    use SystemPropertiesTrait, MetaPropertiesTrait, DomainPropertiesTrait, RelationsTrait,
71
        ProcessingInstructionsTrait, PayloadTrait, IterableTrait, StatesTrait;
72
73
    /**
74
     * Repository path
75
     *
76
     * @var RepositoryPathInterface
77
     */
78
    protected $path;
79
    /**
80
     * Latest revision
81
     *
82
     * @var Revision
83
     */
84
    protected $latestRevision;
85
86
    /**
87
     * Object constructor
88
     *
89
     * @param RepositoryPathInterface $path Object repository path
90
     * @param string $payload Object payload
91
     * @param array $propertyData Property data
92
     */
93 38
    public function __construct(RepositoryPathInterface $path, $payload = '', array $propertyData = [])
94
    {
95
        // If the domain property collection class is invalid
96 38
        if (!$this->domainPropertyCClass
97 38
            || !class_exists($this->domainPropertyCClass)
98 38
            || !(new \ReflectionClass($this->domainPropertyCClass))->isSubclassOf(AbstractDomainProperties::class)
99
        ) {
100 1
            throw new PropertyInvalidArgumentException(
101
                sprintf(
102 1
                    'Invalid domain property collection class "%s"',
103 1
                    $this->domainPropertyCClass
104
                ),
105 1
                PropertyInvalidArgumentException::INVALID_DOMAIN_PROPERTY_COLLECTION_CLASS
106
            );
107
        }
108
109
        // Save the original object path
110 37
        $this->path = $path;
111
112
        // Load the current revision data
113 37
        $this->loadRevisionData($payload, $propertyData);
114
115
        // Determine the latest revision number (considering a possible draft)
116 36
        $this->latestRevision = $this->hasDraft()
117
            ? Kernel::create(Revision::class, [$this->getRevision()->getRevision() + 1, true])
118 36
            : $this->getRevision();
119
120
        // Update the object path
121 36
        $this->updatePath();
122 36
    }
123
124
    /**
125
     * Load object revision data
126
     *
127
     * @param string $payload Object payload
128
     * @param array $propertyData Property data
129
     */
130 37
    protected function loadRevisionData($payload = '', array $propertyData = [])
131
    {
132 37
        $this->payload = $payload;
133
134
        // Instantiate the system properties
135 37
        $systemPropertyData = (empty($propertyData[SystemProperties::COLLECTION]) ||
136 37
            !is_array(
137 37
                $propertyData[SystemProperties::COLLECTION]
138 37
            )) ? [] : $propertyData[SystemProperties::COLLECTION];
139 37
        $this->systemProperties = Kernel::create(SystemProperties::class, [$systemPropertyData, $this]);
140
141
        // Instantiate the meta properties
142 36
        $metaPropertyData = (empty($propertyData[MetaProperties::COLLECTION]) ||
143 36
            !is_array(
144 36
                $propertyData[MetaProperties::COLLECTION]
145 36
            )) ? [] : $propertyData[MetaProperties::COLLECTION];
146
        /** @var MetaProperties $metaProperties */
147 36
        $metaProperties = Kernel::create(MetaProperties::class, [$metaPropertyData, $this]);
148 36
        $this->setMetaProperties($metaProperties, true);
149
150
        // Instantiate the domain properties
151 36
        $domainPropertyData = (empty($propertyData[AbstractDomainProperties::COLLECTION]) ||
152 29
            !is_array(
153 36
                $propertyData[AbstractDomainProperties::COLLECTION]
154 36
            )) ? [] : $propertyData[AbstractDomainProperties::COLLECTION];
155
        /** @var AbstractDomainProperties $domainProperties */
156 36
        $domainProperties = Kernel::create($this->domainPropertyCClass, [$domainPropertyData, $this]);
157 36
        $this->setDomainProperties($domainProperties, true);
158
159
        // Instantiate the processing instructions
160 36
        $procInstData = (empty($propertyData[ProcessingInstructions::COLLECTION]) ||
161 24
            !is_array(
162 36
                $propertyData[ProcessingInstructions::COLLECTION]
163 36
            )) ? [] : $propertyData[ProcessingInstructions::COLLECTION];
164
        /** @var ProcessingInstructions $procInstCollection */
165 36
        $procInstCollection = Kernel::create(ProcessingInstructions::class, [$procInstData, $this]);
166 36
        $this->setProcessingInstructions($procInstCollection, true);
167
168
        // Instantiate the object relations
169 36
        $relationData = (empty($propertyData[Relations::COLLECTION]) ||
170 30
            !is_array(
171 36
                $propertyData[Relations::COLLECTION]
172 36
            )) ? [] : $propertyData[Relations::COLLECTION];
173
        /** @var Relations $relationCollection */
174 36
        $relationCollection = Kernel::create(Relations::class, [$relationData, $this]);
175 36
        $this->setRelations($relationCollection, true);
176
177
        // Reset the object state
178 36
        $this->resetState();
179 36
    }
180
181
    /**
182
     * Return whether this object already has a draft revision
183
     *
184
     * @return bool Whether this object has a draft revision
185
     */
186 36
    protected function hasDraft()
187
    {
188
        // Create the object draft resource path
189 36
        $draftPath = $this->path->setRevision(Revision::current(true));
190
191
        // Use the object manager to look for a draft resource
192
        /** @var ManagerInterface $objectManager */
193 36
        $objectManager = Kernel::create(Service::class)->getObjectManager();
194 36
        return $objectManager->objectResourceExists($draftPath);
195
    }
196
197
    /**
198
     * Update the object path
199
     */
200 36
    protected function updatePath()
201
    {
202 36
        $revision = $this->getRevision();
203 36
        $this->path = $this->path->setRevision(
204 36
            !$revision->isDraft() && ($this->getCurrentRevision()->getRevision() == $revision->getRevision())
205 27
                ? Revision::current($revision->isDraft())
206 36
                : $revision
207 36
        )->setHidden($this->isDeleted());
208 36
    }
209
210
    /**
211
     * Return this object's current revision
212
     *
213
     * @return Revision Current revision
214
     */
215 33
    protected function getCurrentRevision()
216
    {
217 33
        if ($this->latestRevision->isDraft() && ($this->latestRevision->getRevision() > 1)) {
218 1
            return Kernel::create(Revision::class, [$this->latestRevision->getRevision() - 1, false]);
219
        }
220 33
        return $this->latestRevision;
221
    }
222
223
    /**
224
     * Use a specific object revision
225
     *
226
     * @param Revision $revision Revision to be used
227
     * @return ObjectInterface Object
228
     * @throws OutOfBoundsException If a revision beyond the latest one is requested
229
     */
230 32
    public function useRevision(Revision $revision)
231
    {
232
        // If a revision beyond the latest one is requested
233 32
        if (!$revision->isCurrent() && ($revision->getRevision() > $this->latestRevision->getRevision())) {
234 1
            throw new OutOfBoundsException(
235 1
                sprintf('Invalid object revision "%s"', $revision->getRevision()),
236 1
                OutOfBoundsException::INVALID_OBJECT_REVISION
237
            );
238
        }
239
240
        // Determine whether the current revision was requested
241 32
        $currentRevision = $this->getCurrentRevision();
242 32
        $isCurrentRevision = $revision->isCurrent() || $currentRevision->equals($revision);
243 32
        if ($isCurrentRevision) {
244 32
            $revision = $currentRevision;
245
        }
246
247
        // If the requested revision is not already used
248 32
        if (!$this->getRevision()->equals($revision)) {
249
250
            /** @var ManagerInterface $objectManager */
251 1
            $objectManager = Kernel::create(Service::class)->getObjectManager();
252
            /** @var Revision $newRevision */
253 1
            $newRevision = $isCurrentRevision ? Revision::current() : $revision;
254
            /** @var RepositoryPath $newRevisionPath */
255 1
            $newRevisionPath = $this->path->setRevision($newRevision);
256
257
            // Instantiate the requested revision resource
258 1
            $revisionResource = $objectManager->loadObjectResource($newRevisionPath, SelectorInterface::ALL);
259
260
            // Load the revision resource data
261 1
            $this->loadRevisionData($revisionResource->getPayload(), $revisionResource->getPropertyData());
262
263
            // Update the object path
264 1
            $this->updatePath();
265
        }
266
267 32
        return $this;
268
    }
269
270
    /**
271
     * Return the object repository path
272
     *
273
     * @return RepositoryPathInterface Object repository path
274
     */
275 38
    public function getRepositoryPath()
276
    {
277 38
        return $this->path;
278
    }
279
280
    /**
281
     * Return the object property data
282
     *
283
     * @param bool $serialize Serialize property objects
284
     * @return array Object property data
285
     */
286 9
    public function getPropertyData($serialize = true)
287
    {
288 9
        $propertyData = array_filter([
289 9
            SystemProperties::COLLECTION => $this->systemProperties->toArray($serialize),
290 9
            MetaProperties::COLLECTION => $this->metaProperties->toArray($serialize),
291 9
            AbstractDomainProperties::COLLECTION => $this->domainProperties->toArray($serialize),
292 9
            ProcessingInstructions::COLLECTION => $this->processingInstructions->toArray($serialize),
293 9
            Relations::COLLECTION => $this->relations->toArray($serialize),
294 9
        ], function (array $collection) {
295 9
            return (boolean)count($collection);
296 9
        });
297
298 9
        return $propertyData;
299
    }
300
301
    /**
302
     * Return the absolute object URL
303
     *
304
     * @return string
305
     */
306 4
    public function getAbsoluteUrl()
307
    {
308 4
        return getenv('APPARAT_BASE_URL').ltrim($this->path->getRepository()->getUrl(), '/').strval($this->path);
309
    }
310
311
    /**
312
     * Persist the current object revision
313
     *
314
     * @return ObjectInterface Object
315
     */
316 5
    public function persist()
317
    {
318
        // If this is not the latest revision
319 5
        if ($this->getRevision()->getRevision() !== $this->latestRevision->getRevision()) {
320 1
            throw new RuntimeException(
321
                sprintf(
322 1
                    'Cannot persist revision %s/%s',
323 1
                    $this->getRevision()->getRevision(),
324 1
                    $this->latestRevision->getRevision()
325
                ),
326 1
                RuntimeException::CANNOT_PERSIST_EARLIER_REVISION
327
            );
328
        }
329
330
        // Update the object repository
331 5
        $this->path->getRepository()->updateObject($this);
332
333
        // Reset to a clean state
334 3
        $this->resetState();
335 3
        $this->latestRevision = $this->getRevision();
336 3
        $this->updatePath();
337
338
        // Post persistence hook
339 3
        $this->postPersist();
340
341 2
        return $this;
342
    }
343
344
    /**
345
     * Post persistence hook
346
     *
347
     * @return void
348
     */
349 3
    protected function postPersist()
350
    {
351 3
    }
352
353
    /**
354
     * Publish the current object revision
355
     *
356
     * @return ObjectInterface Object
357
     */
358 2
    public function publish()
359
    {
360
        // If this is an unpublished draft
361 2
        if ($this->isDraft() & !$this->hasBeenPublished()) {
362 2
            $this->setPublishedState();
363 2
            $this->latestRevision = $this->latestRevision->setDraft(false);
364 2
            $this->updatePath();
365
        }
366
367 2
        return $this;
368
    }
369
370
    /**
371
     * Delete the object and all its revisions
372
     *
373
     * @return ObjectInterface Object
374
     */
375 3
    public function delete()
376
    {
377
        // If this object is not already deleted
378 3
        if (!$this->isDeleted() && !$this->hasBeenDeleted()) {
379 3
            $this->setDeletedState();
380 3
            $this->updatePath();
381
        }
382
383 3
        return $this;
384
    }
385
386
    /**
387
     * Undelete the object and all its revisions
388
     *
389
     * @return ObjectInterface Object
390
     */
391 2
    public function undelete()
392
    {
393
        // If this object is already deleted
394 2
        if ($this->isDeleted() && !$this->hasBeenUndeleted()) {
395 2
            $this->setUndeletedState();
396 2
            $this->updatePath();
397
        }
398
399 2
        return $this;
400
    }
401
402
    /**
403
     * Convert this object revision into a draft
404
     */
405 5
    protected function convertToDraft()
406
    {
407
        // Assume the latest revision as draft revision
408 5
        $draftRevision = $this->latestRevision;
409
410
        // If it equals the current revision: Spawn a draft
411 5
        if ($draftRevision->equals($this->getCurrentRevision())) {
412 5
            $draftRevision = $this->latestRevision = $draftRevision->increment()->setDraft(true);
413
        }
414
415
        // Set the system properties to draft mode
416 5
        $this->setSystemProperties($this->systemProperties->createDraft($draftRevision), true);
417
418
        // Update the object path
419 5
        $this->updatePath();
420 5
    }
421
}
422