FileAdapterStrategy::__construct() - Code Metrics - Inspection of "Added object creation and ID allocation" - apparat/object - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 1ad7db...177e73 )

by Joschi

created 2016-04-23 11:26 UTC

FileAdapterStrategy::__construct() C

↳ Parent: FileAdapterStrategy

Complexity

Conditions	7
Paths	5

Size

Total Lines	37
Code Lines	19

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	22
CRAP Score	7

Importance

Changes	4
Bugs	0	Features	1

Metric	Value
c	4
b	0
f	1
dl	0
loc	37
ccs	22
cts	22
cp	1
rs	6.7272
cc	7
eloc	19
nc	5
nop	1
crap	7

<?php

/**
 * apparat-object
 *
 * @category    Apparat
 * @package     Apparat\Object
 * @subpackage  Apparat\Object\Infrastructure
 * @author      Joschi Kuphal <[email protected]> / @jkphl
 * @copyright   Copyright © 2016 Joschi Kuphal <[email protected]> / @jkphl
 * @license     http://opensource.org/licenses/MIT The MIT License (MIT)
 */

/***********************************************************************************
 *  The MIT License (MIT)
 *
 *  Copyright © 2016 Joschi Kuphal <[email protected]> / @jkphl
 *
 *  Permission is hereby granted, free of charge, to any person obtaining a copy of
 *  this software and associated documentation files (the "Software"), to deal in
 *  the Software without restriction, including without limitation the rights to
 *  use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
 *  the Software, and to permit persons to whom the Software is furnished to do so,
 *  subject to the following conditions:
 *
 *  The above copyright notice and this permission notice shall be included in all
 *  copies or substantial portions of the Software.
 *
 *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
 *  FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
 *  COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
 *  IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 *  CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ***********************************************************************************/

namespace Apparat\Object\Infrastructure\Repository;

use Apparat\Kernel\Ports\Kernel;
use Apparat\Object\Application\Repository\AbstractAdapterStrategy;
use Apparat\Object\Domain\Model\Object\Id;
use Apparat\Object\Domain\Model\Object\ObjectInterface;
use Apparat\Object\Domain\Model\Object\ResourceInterface;
use Apparat\Object\Domain\Model\Path\PathInterface;
use Apparat\Object\Domain\Model\Path\RepositoryPath;
use Apparat\Object\Domain\Repository\RepositoryInterface;
use Apparat\Object\Domain\Repository\RuntimeException;
use Apparat\Object\Domain\Repository\Selector;
use Apparat\Object\Domain\Repository\SelectorInterface;
use Apparat\Object\Infrastructure\Factory\ResourceFactory;
use Apparat\Resource\Infrastructure\Io\File\AbstractFileReaderWriter;

/**
 * File adapter strategy
 *
 * @package Apparat\Object
 * @subpackage Apparat\Object\Infrastructure
 */
class FileAdapterStrategy extends AbstractAdapterStrategy
{
    /**
     * Adapter strategy type
     *
     * @var string
     */
    const TYPE = 'file';
    /**
     * Configuration
     *
     * @var array
     */
    protected $config = null;
    /**
     * Root directory (without trailing directory separator)
     *
     * @var string
     */
    protected $root = null;
    /**
     * Configuration directory (including trailing directory separator)
     *
     * @var string
     */
    protected $configDir = null;

    /**
     * Adapter strategy constructor
     *
     * @param array $config Adapter strategy configuration
     * @throws InvalidArgumentException If the root directory configuration is empty
     * @throws InvalidArgumentException If the root directory configuration is invalid
     */
    public function __construct(array $config)
    {
        parent::__construct($config, ['root']);

        // If the root directory configuration is empty
        if (empty($this->config['root'])) {
            throw new InvalidArgumentException(
                'Empty file adapter strategy root',
                InvalidArgumentException::EMTPY_FILE_STRATEGY_ROOT
            );
        }

        // Get the real path of the root directory
        $this->root = realpath($this->config['root']);

        // If the repository should be initialized
        if (
            !empty($this->config['init'])
            && (boolean)$this->config['init']
            && $this->initializeRepository()
        ) {
            $this->root = realpath($this->config['root']);
        }

        // If the root directory configuration is still invalid
        if (empty($this->root) || !@is_dir($this->root)) {
            throw new InvalidArgumentException(
                sprintf(
                    'Invalid file adapter strategy root "%s"',
                    $this->config['root']
                ),
                InvalidArgumentException::INVALID_FILE_STRATEGY_ROOT
            );
        }

        $this->configDir = $this->root.DIRECTORY_SEPARATOR.'.repo'.DIRECTORY_SEPARATOR;
    }

    /**
     * Initialize the repository
     *
     * @return boolean Success
     * @throws RuntimeException If the repository cannot be initialized
     * @throws RuntimeException If the repository size descriptor can not be created
     */
    public function initializeRepository()
    {
        $configDir = $this->config['root'].DIRECTORY_SEPARATOR.'.repo'.DIRECTORY_SEPARATOR;

        // If the repository cannot be initialized
        if (!is_dir($configDir) && !mkdir($configDir, 0777, true)) {
            throw new RuntimeException('Could not initialize repository', RuntimeException::REPO_NOT_INITIALIZED);
        }

        // If the repository size descriptor can not be created
        if (!@is_file($configDir.'size.txt') && !file_put_contents($configDir.'size.txt', '0')) {
            throw new RuntimeException(
                'Could not create repository size descriptor',
                RuntimeException::REPO_SIZE_DESCRIPTOR_NOT_CREATED
            );
        }

        return true;
    }

    /**
     * Find objects by selector
     *
     * @param Selector|SelectorInterface $selector Object selector
     * @param RepositoryInterface $repository Object repository
     * @return PathInterface[] Object paths
     */
    public function findObjectPaths(SelectorInterface $selector, RepositoryInterface $repository)
    {
        chdir($this->root);

        // Build a glob string from the selector
        $glob = '';
        $globFlags = GLOB_ONLYDIR | GLOB_NOSORT;

        $year = $selector->getYear();
        if ($year !== null) {
            $glob .= '/'.$year;
        }

        $month = $selector->getMonth();
        if ($month !== null) {
            $glob .= '/'.$month;
        }

        $day = $selector->getDay();
        if ($day !== null) {
            $glob .= '/'.$day;
        }

        $hour = $selector->getHour();
        if ($hour !== null) {
            $glob .= '/'.$hour;
        }

        $minute = $selector->getMinute();
        if ($minute !== null) {
            $glob .= '/'.$minute;
        }

        $second = $selector->getSecond();
        if ($second !== null) {
            $glob .= '/'.$second;
        }

        $uid = $selector->getId();
        $type = $selector->getType();
        if (($uid !== null) || ($type !== null)) {
            $glob .= '/'.($uid ?: Selector::WILDCARD).'.'.($type ?: Selector::WILDCARD);

            $revision = $selector->getRevision();
            if ($revision !== null) {
                $glob .= '/'.($uid ?: Selector::WILDCARD).'-'.$revision;
                $globFlags &= ~GLOB_ONLYDIR;
            }
        }

        return array_map(
            function ($objectPath) use ($repository) {
                return Kernel::create(RepositoryPath::class, [$repository, '/'.$objectPath]);
            },
            glob(ltrim($glob, '/'), $globFlags)
        );
    }

    /**
     * Find and return an object resource
     *
     * @param string $resourcePath Repository relative resource path
     * @return ResourceInterface Object resource
     */
    public function getObjectResource($resourcePath)
    {
        return ResourceFactory::create(AbstractFileReaderWriter::WRAPPER.$this->root.$resourcePath);
class Author {
    private $name;

    public function __construct($name) {
        $this->name = $name;
    }

    public function getName() {
        return $this->name;
    }
}

abstract class Post {
    public function getAuthor() {
        return 'Johannes';
    }
}

class BlogPost extends Post {
    public function getAuthor() {
        return new Author('Johannes');
    }
}

class ForumPost extends Post { /* ... */ }

function my_function(Post $post) {
    echo strtoupper($post->getAuthor());
}
    }

    /**
     * Allocate an object ID and create an object resource
     *
     * @param \Closure $creation Object creation closure
     * @return ObjectInterface Object
     */
    public function createObjectResource(\Closure $creation)
    {
        $sizeDescriptor = null;

        try {
            // Open the size descriptor
            $sizeDescriptor = fopen($this->configDir.'size.txt', 'r+');

            // If a lock of the size descriptor can be acquired
            if (flock($sizeDescriptor, LOCK_EX)) {


                // Determine the current repository size
                $repositorySize = '';
                while (!feof($sizeDescriptor)) {
                    $repositorySize .= fread($sizeDescriptor, 8);
                }
                $repositorySize = intval(trim($repositorySize));

                // Instantiate the next consecutive object ID
                $nextObjectId = Kernel::create(Id::class, [++$repositorySize]);

                // Create the object
                $object = $creation($nextObjectId);

                // TODO: Resource creation and persistence

                // Dump the new repository size, unlock the size descriptor
                ftruncate($sizeDescriptor, 0);
                fwrite($sizeDescriptor, $repositorySize);
                fflush($sizeDescriptor);
                flock($sizeDescriptor, LOCK_UN);

                // Return the newly created object
                return $object;
            }

            // Throw an error if no object could be created
            throw new RuntimeException('The repository size descriptor is unlockable',
                RuntimeException::REPO_SIZE_DESCRIPTOR_UNLOCKABLE);

            // If any exception is thrown
        } catch (\Exception $e) {
            // Release the size descriptor lock
            if (is_resource($sizeDescriptor)) {
                flock($sizeDescriptor, LOCK_UN);
            }

            // Forward the thrown exception
            throw $e;
        }
    }

    /**
     * Return the repository size (number of objects in the repository)
     *
     * @return int Repository size
     */
    public function getRepositorySize()
    {
        $sizeDescriptorFile = $this->configDir.'size.txt';
        $repositorySize = 0;
        if (is_file($sizeDescriptorFile) && is_readable($sizeDescriptorFile)) {
            $repositorySize = intval(file_get_contents($this->configDir.'size.txt'));
        }
        return $repositorySize;
    }
}


1		<?php
2
3		/**
4		* apparat-object
5		*
6		* @category Apparat
7		* @package Apparat\Object
8		* @subpackage Apparat\Object\Infrastructure
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\Infrastructure\Repository;
38
39		use Apparat\Kernel\Ports\Kernel;
40		use Apparat\Object\Application\Repository\AbstractAdapterStrategy;
41		use Apparat\Object\Domain\Model\Object\Id;
42		use Apparat\Object\Domain\Model\Object\ObjectInterface;
43		use Apparat\Object\Domain\Model\Object\ResourceInterface;
44		use Apparat\Object\Domain\Model\Path\PathInterface;
45		use Apparat\Object\Domain\Model\Path\RepositoryPath;
46		use Apparat\Object\Domain\Repository\RepositoryInterface;
47		use Apparat\Object\Domain\Repository\RuntimeException;
48		use Apparat\Object\Domain\Repository\Selector;
49		use Apparat\Object\Domain\Repository\SelectorInterface;
50		use Apparat\Object\Infrastructure\Factory\ResourceFactory;
51		use Apparat\Resource\Infrastructure\Io\File\AbstractFileReaderWriter;
52
53		/**
54		* File adapter strategy
55		*
56		* @package Apparat\Object
57		* @subpackage Apparat\Object\Infrastructure
58		*/
59		class FileAdapterStrategy extends AbstractAdapterStrategy
60		{
61		/**
62		* Adapter strategy type
63		*
64		* @var string
65		*/
66		const TYPE = 'file';
67		/**
68		* Configuration
69		*
70		* @var array
71		*/
72		protected $config = null;
73		/**
74		* Root directory (without trailing directory separator)
75		*
76		* @var string
77		*/
78		protected $root = null;
79		/**
80		* Configuration directory (including trailing directory separator)
81		*
82		* @var string
83		*/
84		protected $configDir = null;
85
86		/**
87		* Adapter strategy constructor
88		*
89		* @param array $config Adapter strategy configuration
90		* @throws InvalidArgumentException If the root directory configuration is empty
91		* @throws InvalidArgumentException If the root directory configuration is invalid
92		*/
93	14	public function __construct(array $config)
94		{
95	14	parent::__construct($config, ['root']);
96
97		// If the root directory configuration is empty
98	13	if (empty($this->config['root'])) {
99	1	throw new InvalidArgumentException(
100	1	'Empty file adapter strategy root',
101		InvalidArgumentException::EMTPY_FILE_STRATEGY_ROOT
102	1	);
103		}
104
105		// Get the real path of the root directory
106	12	$this->root = realpath($this->config['root']);
107
108		// If the repository should be initialized
109		if (
110	12	!empty($this->config['init'])
111	12	&& (boolean)$this->config['init']
112	12	&& $this->initializeRepository()
113	12	) {
114	2	$this->root = realpath($this->config['root']);
115	2	}
116
117		// If the root directory configuration is still invalid
118	12	if (empty($this->root) \|\| !@is_dir($this->root)) {
119	1	throw new InvalidArgumentException(
120	1	sprintf(
121	1	'Invalid file adapter strategy root "%s"',
122	1	$this->config['root']
123	1	),
124		InvalidArgumentException::INVALID_FILE_STRATEGY_ROOT
125	1	);
126		}
127
128	11	$this->configDir = $this->root.DIRECTORY_SEPARATOR.'.repo'.DIRECTORY_SEPARATOR;
129	11	}
130
131		/**
132		* Initialize the repository
133		*
134		* @return boolean Success
135		* @throws RuntimeException If the repository cannot be initialized
136		* @throws RuntimeException If the repository size descriptor can not be created
137		*/
138	2	public function initializeRepository()
139		{
140	2	$configDir = $this->config['root'].DIRECTORY_SEPARATOR.'.repo'.DIRECTORY_SEPARATOR;
141
142		// If the repository cannot be initialized
143	2	if (!is_dir($configDir) && !mkdir($configDir, 0777, true)) {
144		throw new RuntimeException('Could not initialize repository', RuntimeException::REPO_NOT_INITIALIZED);
145		}
146
147		// If the repository size descriptor can not be created
148	2	if (!@is_file($configDir.'size.txt') && !file_put_contents($configDir.'size.txt', '0')) {
149		throw new RuntimeException(
150		'Could not create repository size descriptor',
151		RuntimeException::REPO_SIZE_DESCRIPTOR_NOT_CREATED
152		);
153		}
154
155	2	return true;
156		}
157
158		/**
159		* Find objects by selector
160		*
161		* @param Selector\|SelectorInterface $selector Object selector
162		* @param RepositoryInterface $repository Object repository
163		* @return PathInterface[] Object paths
164		*/
165	7	public function findObjectPaths(SelectorInterface $selector, RepositoryInterface $repository)
166		{
167	7	chdir($this->root);
168
169		// Build a glob string from the selector
170	7	$glob = '';
171	7	$globFlags = GLOB_ONLYDIR \| GLOB_NOSORT;
172
173	7	$year = $selector->getYear();
174	7	if ($year !== null) {
175	7	$glob .= '/'.$year;
176	7	}
177
178	7	$month = $selector->getMonth();
179	7	if ($month !== null) {
180	7	$glob .= '/'.$month;
181	7	}
182
183	7	$day = $selector->getDay();
184	7	if ($day !== null) {
185	7	$glob .= '/'.$day;
186	7	}
187
188	7	$hour = $selector->getHour();
189	7	if ($hour !== null) {
190	2	$glob .= '/'.$hour;
191	2	}
192
193	7	$minute = $selector->getMinute();
194	7	if ($minute !== null) {
195	2	$glob .= '/'.$minute;
196	2	}
197
198	7	$second = $selector->getSecond();
199	7	if ($second !== null) {
200	2	$glob .= '/'.$second;
201	2	}
202
203	7	$uid = $selector->getId();
204	7	$type = $selector->getType();
205	7	if (($uid !== null) \|\| ($type !== null)) {
206	7	$glob .= '/'.($uid ?: Selector::WILDCARD).'.'.($type ?: Selector::WILDCARD);
207
208	7	$revision = $selector->getRevision();
209	7	if ($revision !== null) {
210	1	$glob .= '/'.($uid ?: Selector::WILDCARD).'-'.$revision;
211	1	$globFlags &= ~GLOB_ONLYDIR;
212	1	}
213	7	}
214
215	7	return array_map(
216	7	function ($objectPath) use ($repository) {
217	7	return Kernel::create(RepositoryPath::class, [$repository, '/'.$objectPath]);
218	7	},
219	7	glob(ltrim($glob, '/'), $globFlags)
220	7	);
221		}
222
223		/**
224		* Find and return an object resource
225		*
226		* @param string $resourcePath Repository relative resource path
227		* @return ResourceInterface Object resource
228		*/
229	6	public function getObjectResource($resourcePath)
230		{
231	6	return ResourceFactory::create(AbstractFileReaderWriter::WRAPPER.$this->root.$resourcePath);
		0 ignored issues – show Bug Best Practice introduced 2016-04-23 11:28 UTC by Report Bug Copy Issue Report The return type of `return \Apparat\Object\I...>root . $resourcePath);` (`Apparat\Resource\Domain\...source\AbstractResource`) is incompatible with the return type declared by the interface `Apparat\Object\Applicati...face::getObjectResource` of type `Symfony\Component\Config...ource\ResourceInterface`. 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: class Author { private $name; public function __construct($name) { $this->name = $name; } public function getName() { return $this->name; } } abstract class Post { public function getAuthor() { return 'Johannes'; } } class BlogPost extends Post { public function getAuthor() { return new Author('Johannes'); } } class ForumPost extends Post { /* ... */ } function my_function(Post $post) { echo strtoupper($post->getAuthor()); } Our function `my_function` expects a `Post` object, and outputs the author of the post. The base class `Post` returns a simple string and outputting a simple string will work just fine. However, the child class `BlogPost` which is a sub-type of `Post` instead decided to return an `object`, and is therefore violating the SOLID principles. If a `BlogPost` were passed to `my_function`, PHP would not complain, but ultimately fail when executing the `strtoupper` call in its body. Loading history...
232		}
233
234		/**
235		* Allocate an object ID and create an object resource
236		*
237		* @param \Closure $creation Object creation closure
238		* @return ObjectInterface Object
239		*/
240	1	public function createObjectResource(\Closure $creation)
241		{
242	1	$sizeDescriptor = null;
243
244		try {
245		// Open the size descriptor
246	1	$sizeDescriptor = fopen($this->configDir.'size.txt', 'r+');
247
248		// If a lock of the size descriptor can be acquired
249	1	if (flock($sizeDescriptor, LOCK_EX)) {
		0 ignored issues – show Coding Style introduced 2016-04-23 11:28 UTC by Report Bug Copy Issue Report Blank line found at start of control structure Loading history...
250
251		// Determine the current repository size
252	1	$repositorySize = '';
253	1	while (!feof($sizeDescriptor)) {
254	1	$repositorySize .= fread($sizeDescriptor, 8);
255	1	}
256	1	$repositorySize = intval(trim($repositorySize));
257
258		// Instantiate the next consecutive object ID
259	1	$nextObjectId = Kernel::create(Id::class, [++$repositorySize]);
260
261		// Create the object
262	1	$object = $creation($nextObjectId);
263
264		// TODO: Resource creation and persistence
265
266		// Dump the new repository size, unlock the size descriptor
267	1	ftruncate($sizeDescriptor, 0);
268	1	fwrite($sizeDescriptor, $repositorySize);
269	1	fflush($sizeDescriptor);
270	1	flock($sizeDescriptor, LOCK_UN);
271
272		// Return the newly created object
273	1	return $object;
274		}
275
276		// Throw an error if no object could be created
277		throw new RuntimeException('The repository size descriptor is unlockable',
278		RuntimeException::REPO_SIZE_DESCRIPTOR_UNLOCKABLE);
279
280		// If any exception is thrown
281		} catch (\Exception $e) {
282		// Release the size descriptor lock
283		if (is_resource($sizeDescriptor)) {
284		flock($sizeDescriptor, LOCK_UN);
285		}
286
287		// Forward the thrown exception
288		throw $e;
289		}
290		}
291
292		/**
293		* Return the repository size (number of objects in the repository)
294		*
295		* @return int Repository size
296		*/
297		public function getRepositorySize()
298		{
299		$sizeDescriptorFile = $this->configDir.'size.txt';
300		$repositorySize = 0;
301		if (is_file($sizeDescriptorFile) && is_readable($sizeDescriptorFile)) {
302		$repositorySize = intval(file_get_contents($this->configDir.'size.txt'));
303		}
304		return $repositorySize;
305		}
306		}
307

apparat / object

Push — master ( 1ad7db...177e73 )

FileAdapterStrategy::__construct() C

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like