Doesnt have relations #minor (#38)

* Added search for models that don't have specified relations

* Apply fixes from StyleCI

Co-authored-by: jmilotic <josip.milotic@asseco-see.hr>
Co-authored-by: StyleCI Bot <bot@styleci.io>

Author: 3 people

README.md

@@ -57,7 +57,8 @@ JSON parameters (keys):
 - `offset` - will return a subset of results starting from a point given. This parameter **MUST**
 be used together with ``limit`` parameter. 
 - `count` - will return record count.
-- `soft_deleted` - will include soft deleted models in search results
+- `soft_deleted` - will include soft deleted models in search results.
+- `doesnt_have_relations` - will only return entries that don't have any of the specified relations.
 
 ### Search
 
@@ -357,6 +358,24 @@ with ``soft_deleted``:
 }
 ```
 
+### Doesn't have relations
+
+In case you want to only find entries without a specified relation, you can do so with ``doesnt_have_relations`` key:
+
+```
+{
+    "doesnt_have_relations": "containers"
+}
+```
+
+If you want to specify multiple relations, you can do so in the following way:
+
+```
+{
+    "doesnt_have_relations": ["containers", "addresses"]
+}
+```
+
 ## Top level logical operators
 
 Additionally, it is possible to group search clauses by top-level logical operator.

config/asseco-json-query-builder.php

@@ -1,6 +1,7 @@
 <?php
 
 use Asseco\JsonQueryBuilder\RequestParameters\CountParameter;
+use Asseco\JsonQueryBuilder\RequestParameters\DoesntHaveRelationsParameter;
 use Asseco\JsonQueryBuilder\RequestParameters\GroupByParameter;
 use Asseco\JsonQueryBuilder\RequestParameters\LimitParameter;
 use Asseco\JsonQueryBuilder\RequestParameters\OffsetParameter;
@@ -34,6 +35,7 @@
         CountParameter::class,
         GroupByParameter::class,
         SoftDeletedParameter::class,
+        DoesntHaveRelationsParameter::class,
     ],
 
     /**

src/RequestParameters/DoesntHaveRelationsParameter.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Asseco\JsonQueryBuilder\RequestParameters;
+
+use Asseco\JsonQueryBuilder\Exceptions\JsonQueryBuilderException;
+use Illuminate\Support\Str;
+
+class DoesntHaveRelationsParameter extends AbstractParameter
+{
+    public static function getParameterName(): string
+    {
+        return 'doesnt_have_relations';
+    }
+
+    protected function appendQuery(): void
+    {
+        foreach ($this->arguments as $argument) {
+            if (is_string($argument)) {
+                $this->builder->doesntHave(Str::camel($argument));
+                continue;
+            }
+
+            throw new JsonQueryBuilderException('Wrong relation parameters provided.');
+        }
+    }
+}