SpatialTrait::toWkt() - Code Metrics - Inspection of "Upgrade to laravel 6.*" - danhunsaker/laravel-spatial - Measure and Improve Code Quality continuously with Scrutinizer

Completed
Pull Request — master (#3)

unknown
created 2020-01-28 23:20 UTC
SpatialTrait::toWkt() A

↳ Parent: SpatialTrait
Complexity

Conditions	3
Paths	3
Size

Total Lines	9
Code Lines	5
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	3
CRAP Score	3.576
Importance

Changes
Metric	Value
cc	3
eloc	5
c	0
b	0
f	0
nc	3
nop	1
dl	0
loc	9
ccs	3
cts	5
cp	0.6
crap	3.576
rs	10
<?php

namespace LaravelSpatial\Eloquent;

use Exception;
use GeoJson\GeoJson;
use GeoJSON\Geometry\Geometry;
use geoPHP\geoPHP;
use Illuminate\Database\Eloquent\Builder as EloquentBuilder;
use Illuminate\Database\MySqlConnection;
use Illuminate\Database\PostgresConnection;
use LaravelSpatial\Exceptions\SpatialFieldsNotDefinedException;
use LaravelSpatial\Exceptions\SpatialParseException;
use LaravelSpatial\Exceptions\UnknownSpatialRelationFunction;

/**
 * Trait SpatialTrait.
 *
 * @property array $attributes
 * @method static static|EloquentBuilder distance($geometryColumn, $geometry, $distance)
 * @method static static|EloquentBuilder distanceValue($geometryColumn, $geometry)
 * @method static static|EloquentBuilder distanceExcludingSelf($geometryColumn, $geometry, $distance)
 * @method static static|EloquentBuilder distanceSphere($geometryColumn, $geometry, $distance)
 * @method static static|EloquentBuilder distanceSphereValue($geometryColumn, $geometry)
 * @method static static|EloquentBuilder distanceSphereExcludingSelf($geometryColumn, $geometry, $distance)
 * @method static static|EloquentBuilder comparison($geometryColumn, $geometry, $relationship)
 * @method static static|EloquentBuilder within($geometryColumn, $polygon)
 * @method static static|EloquentBuilder crosses($geometryColumn, $geometry)
 * @method static static|EloquentBuilder contains($geometryColumn, $geometry)
 * @method static static|EloquentBuilder disjoint($geometryColumn, $geometry)
 * @method static static|EloquentBuilder equals($geometryColumn, $geometry)
 * @method static static|EloquentBuilder intersects($geometryColumn, $geometry)
 * @method static static|EloquentBuilder overlaps($geometryColumn, $geometry)
 * @method static static|EloquentBuilder doesTouch($geometryColumn, $geometry)
 */
trait SpatialTrait
{
    /*
     * The attributes that are spatial representations.
     * To use this Trait, add the following array to the model class
     *
     * @var array
     *
     * protected $spatialFields = [];
     */

	/**
	 * @var array
	 */
    public $geometries = [];

	/**
	 * @var array
	 */
    protected $stRelations = [
        'Within',
        'Crosses',
        'Contains',
        'Disjoint',
        'Equals',
        'Intersects',
        'Overlaps',
        'Touches',
    ];

    /**
     * Create a new Eloquent query builder for the model.
     *
     * @param  \Illuminate\Database\Query\Builder $query
	 *
     * @return \LaravelSpatial\Eloquent\Builder
     */
    public function newEloquentBuilder($query)
    {
        return new Builder($query);
    }

	/**
	 * @inheritDoc
	 */
    public function setRawAttributes(array $attributes, $sync = false)
    {
        $spatial_fields = $this->getSpatialFields();

        foreach ($attributes as $attribute => &$value) {
            if (is_string($value) && in_array($attribute, $spatial_fields, true) && strlen($value) >= 15) {
                $connection = $this->getConnection();
                $connection = $this->getConnection();

                // MySQL adds 4 NULL bytes at the start of the binary
                if ($connection instanceof MySqlConnection && strpos($value, "\0\0\0\0") === 0) {
                    $value = substr($value, 4);
                } elseif ($connection instanceof PostgresConnection) {
                    $value = pack('H*', $value);
                }

                try {
                    $value = GeoJson::jsonUnserialize(json_decode(geoPHP::load($value, 'wkb')->out('json'), false));
                } catch (Exception $e) {
                    throw new SpatialParseException("Can't parse WKB {$value}: {$e->getMessage()}", $e->getCode(), $e);
                }
            }
        }

        return parent::setRawAttributes($attributes, $sync);
    }

	/**
	 * @return array
	 */
	public function getSpatialFields(): array
    {
        if (property_exists($this, 'spatialFields') && !empty($this->spatialFields)) {
            return $this->spatialFields;
        }

		throw new SpatialFieldsNotDefinedException(__CLASS__ . ' has to define $spatialFields');
	}

	/**
	 * @param \GeoJSON\Geometry\Geometry $value
	 *
	 * @return string
	 */
	protected function toWkt(Geometry $value): string
	{
		try {
			$wkt = geoPHP::load(json_decode(json_encode($value->jsonSerialize()), false), 'json')->out('wkt');
		} catch (Exception $e) {
			throw new SpatialParseException('Unable to data to geometry.', 0, $e);
		}

		return ($this->getConnection() instanceof PostgresConnection ? 'SRID=4326;' : '') . $wkt;
	}

	/**
	 * @param \Illuminate\Database\Eloquent\Builder $query
	 *
	 * @return bool
	 */
    protected function performInsert(EloquentBuilder $query)
    {
        foreach ($this->attributes as $key => $value) {
            if ($value instanceof Geometry && $this->isColumnAllowed($key)) {
                $this->geometries[$key] = $value; // Preserve the geometry objects prior to the insert
                $this->attributes[$key] = $this->getConnection()->raw("ST_GeomFromText('{$this->toWkt($value)}')");
            }
        }

        $insert = parent::performInsert($query);

        foreach ($this->geometries as $key => $value) {
            $this->attributes[$key] = $value; // Retrieve the geometry objects so they can be used in the model
        }

        return $insert; // Return the result of the parent insert
    }

	/**
	 * @param $geometryColumn
	 *
	 * @return bool
	 */
	public function isColumnAllowed($geometryColumn): bool
	{
        if (!in_array($geometryColumn, $this->getSpatialFields(), true)) {
            throw new SpatialFieldsNotDefinedException(sprintf('%s is not a valid spatial column.', $geometryColumn));
        }

        return true;
    }

	/**
	 * @param \Illuminate\Database\Eloquent\Builder $query
	 * @param $geometryColumn
	 * @param $geometry
	 * @param $distance
	 *
	 * @return \Illuminate\Database\Eloquent\Builder
	 */
	public function scopeDistance($query, $geometryColumn, $geometry, $distance): EloquentBuilder
	{
        if ($this->isColumnAllowed($geometryColumn)) {
            $geometryColumn .= $this->getConnection() instanceof PostgresConnection ? '::geometry' : '';
            $query->whereRaw("ST_Distance({$geometryColumn}, ST_GeomFromText(?)) <= ?", [
                $this->toWkt($geometry),
                $distance,
            ]);
        }

        return $query;
    }

	/**
	 * @param \Illuminate\Database\Eloquent\Builder $query
	 * @param $geometryColumn
	 * @param $geometry
	 * @param $distance
	 *
	 * @return \Illuminate\Database\Eloquent\Builder
	 */
	public function scopeDistanceExcludingSelf($query, $geometryColumn, $geometry, $distance): EloquentBuilder
	{
        if ($this->isColumnAllowed($geometryColumn)) {
            $query = $this->scopeDistance($query, $geometryColumn, $geometry, $distance);

            $geometryColumn .= $this->getConnection() instanceof PostgresConnection ? '::geometry' : '';
            $query->whereRaw("ST_Distance({$geometryColumn}, ST_GeomFromText(?)) != 0", [
                $this->toWkt($geometry),
            ]);
        }

        return $query;
    }

	/**
	 * @param \Illuminate\Database\Eloquent\Builder $query
	 * @param $geometryColumn
	 * @param $geometry
	 *
	 * @return \Illuminate\Database\Eloquent\Builder
	 */
	public function scopeDistanceValue($query, $geometryColumn, $geometry): EloquentBuilder
	{
        if ($this->isColumnAllowed($geometryColumn)) {
            $columns = $query->getQuery()->columns;

            if (!$columns) {

                $query->select('*');
            }

            $geometryColumn .= $this->getConnection() instanceof PostgresConnection ? '::geometry' : '';
            $query->selectRaw("ST_Distance({$geometryColumn}, ST_GeomFromText(?)) as distance", [
                $this->toWkt($geometry),
            ]);
        }

        return $query;
    }

	/**
	 * @param \Illuminate\Database\Eloquent\Builder $query
	 * @param $geometryColumn
	 * @param $geometry
	 * @param $distance
	 *
	 * @return \Illuminate\Database\Eloquent\Builder
	 */
	public function scopeDistanceSphere($query, $geometryColumn, $geometry, $distance): EloquentBuilder
	{
        $distFunc = $this->getConnection() instanceof PostgresConnection ? 'ST_DistanceSphere' : 'ST_Distance_Sphere';

        if ($this->isColumnAllowed($geometryColumn)) {
            $geometryColumn .= $this->getConnection() instanceof PostgresConnection ? '::geometry' : '';
            $query->whereRaw("{$distFunc}({$geometryColumn}, ST_GeomFromText(?)) <= ?", [
                $this->toWkt($geometry),
                $distance,
            ]);
        }

        return $query;
    }

	/**
	 * @param \Illuminate\Database\Eloquent\Builder $query
	 * @param $geometryColumn
	 * @param $geometry
	 * @param $distance
	 *
	 * @return \Illuminate\Database\Eloquent\Builder
	 */
	public function scopeDistanceSphereExcludingSelf($query, $geometryColumn, $geometry, $distance): EloquentBuilder
	{
        $distFunc = $this->getConnection() instanceof PostgresConnection ? 'ST_DistanceSphere' : 'ST_Distance_Sphere';

        if ($this->isColumnAllowed($geometryColumn)) {
            $query = $this->scopeDistanceSphere($query, $geometryColumn, $geometry, $distance);

            $geometryColumn .= $this->getConnection() instanceof PostgresConnection ? '::geometry' : '';
            $query->whereRaw("{$distFunc}({$geometryColumn}, ST_GeomFromText(?)) != 0", [
                $this->toWkt($geometry),
            ]);
        }

        return $query;
    }

	/**
	 * @param \Illuminate\Database\Eloquent\Builder $query
	 * @param $geometryColumn
	 * @param $geometry
	 *
	 * @return \Illuminate\Database\Eloquent\Builder
	 */
	public function scopeDistanceSphereValue($query, $geometryColumn, $geometry): EloquentBuilder
	{
        $distFunc = $this->getConnection() instanceof PostgresConnection ? 'ST_DistanceSphere' : 'ST_Distance_Sphere';

        if ($this->isColumnAllowed($geometryColumn)) {
            $columns = $query->getQuery()->columns;

            if (!$columns) {

                $query->select('*');
            }

            $geometryColumn .= $this->getConnection() instanceof PostgresConnection ? '::geometry' : '';
            $query->selectRaw("{$distFunc}({$geometryColumn}, ST_GeomFromText(?)) as distance", [
                $this->toWkt($geometry),
            ]);
        }

        return $query;
    }

	/**
	 * @param \Illuminate\Database\Eloquent\Builder $query
	 * @param $geometryColumn
	 * @param $geometry
	 * @param $relationship
	 *
	 * @return \Illuminate\Database\Eloquent\Builder
	 */
	public function scopeComparison($query, $geometryColumn, $geometry, $relationship): EloquentBuilder
	{
        if ($this->isColumnAllowed($geometryColumn)) {
            $relationship = ucfirst(strtolower($relationship));

            if (!in_array($relationship, $this->stRelations, true)) {
                throw new UnknownSpatialRelationFunction($relationship);
            }

            $geometryColumn .= $this->getConnection() instanceof PostgresConnection ? '::geometry' : '';
            $query->whereRaw("ST_{$relationship}(`{$geometryColumn}`, ST_GeomFromText(?))", [
                $this->toWkt($geometry),
            ]);
        }

        return $query;
    }

	/**
	 * @param \Illuminate\Database\Eloquent\Builder $query
	 * @param $geometryColumn
	 * @param $polygon
	 *
	 * @return \Illuminate\Database\Eloquent\Builder
	 */
	public function scopeWithin($query, $geometryColumn, $polygon): EloquentBuilder
	{
        return $this->scopeComparison($query, $geometryColumn, $polygon, 'within');
    }

	/**
	 * @param \Illuminate\Database\Eloquent\Builder $query
	 * @param $geometryColumn
	 * @param $geometry
	 *
	 * @return \Illuminate\Database\Eloquent\Builder
	 */
	public function scopeCrosses($query, $geometryColumn, $geometry): EloquentBuilder
	{
        return $this->scopeComparison($query, $geometryColumn, $geometry, 'crosses');
    }

	/**
	 * @param \Illuminate\Database\Eloquent\Builder $query
	 * @param $geometryColumn
	 * @param $geometry
	 *
	 * @return \Illuminate\Database\Eloquent\Builder
	 */
	public function scopeContains($query, $geometryColumn, $geometry): EloquentBuilder
	{
        return $this->scopeComparison($query, $geometryColumn, $geometry, 'contains');
    }

	/**
	 * @param \Illuminate\Database\Eloquent\Builder $query
	 * @param $geometryColumn
	 * @param $geometry
	 *
	 * @return \Illuminate\Database\Eloquent\Builder
	 */
	public function scopeDisjoint($query, $geometryColumn, $geometry): EloquentBuilder
	{
        return $this->scopeComparison($query, $geometryColumn, $geometry, 'disjoint');
    }

	/**
	 * @param \Illuminate\Database\Eloquent\Builder $query
	 * @param $geometryColumn
	 * @param $geometry
	 *
	 * @return \Illuminate\Database\Eloquent\Builder
	 */
	public function scopeEquals($query, $geometryColumn, $geometry): EloquentBuilder
	{
        return $this->scopeComparison($query, $geometryColumn, $geometry, 'equals');
    }

	/**
	 * @param \Illuminate\Database\Eloquent\Builder $query
	 * @param $geometryColumn
	 * @param $geometry
	 *
	 * @return \Illuminate\Database\Eloquent\Builder
	 */
	public function scopeIntersects($query, $geometryColumn, $geometry): EloquentBuilder
	{
        return $this->scopeComparison($query, $geometryColumn, $geometry, 'intersects');
    }

	/**
	 * @param \Illuminate\Database\Eloquent\Builder $query
	 * @param $geometryColumn
	 * @param $geometry
	 *
	 * @return \Illuminate\Database\Eloquent\Builder
	 */
	public function scopeOverlaps($query, $geometryColumn, $geometry): EloquentBuilder
	{
        return $this->scopeComparison($query, $geometryColumn, $geometry, 'overlaps');
    }

	/**
	 * @param \Illuminate\Database\Eloquent\Builder $query
	 * @param $geometryColumn
	 * @param $geometry
	 *
	 * @return \Illuminate\Database\Eloquent\Builder
	 */
	public function scopeDoesTouch($query, $geometryColumn, $geometry): EloquentBuilder
	{
        return $this->scopeComparison($query, $geometryColumn, $geometry, 'touches');
    }
}

danhunsaker / laravel-spatial

Pull Request — master (#3)

SpatialTrait::toWkt() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
