Feature/filter null not null (#91)

* query builder not looks for null no null

* Null Filter documentation

* Apply fixes from StyleCI (#92)

Co-authored-by: Craig Smith <[email protected]>

Co-authored-by: Craig Smith <[email protected]>
Co-authored-by: Craig Smith <[email protected]>

Author: phpsa

README.md

@@ -112,6 +112,22 @@ For the get command you can filter by using the following url patterns
 You can pass to the filters an array of values
 ie: `filter[user_id]=1||2||||4||7` or `filter[user_id!]=55||33`
 
+# Null / Not Null (introduced 1.23.0)
+
+If you need to filter on whether a field is null or not null, you can use the filter param as of version 1.23.0 EG: `filter[age]=NULL` or `filter[age!]=NULL`. Note that NULL must be uppercase.
+
+**Older versions**
+Add a scope to your model: eg
+
+```php
+
+public function scopeAgeNull(Builder $builder, $isNull = true){
+  $isNull ? $builder->whereNull('age') : $builder->whereNotNull('age');
+}
+```
+
+Add to your allowedScopes and can then be called in url as `?ageNull=1` for where null and `?ageNull=0` for where age not null
+
 ## Scopes
 
 In addition to filtering, you can use Laravel's Eloquent [Query Scopes](https://laravel.com/docs/6.x/eloquent#local-scopes) to do more complex searches or filters.

src/Contracts/Parser.php

@@ -193,7 +193,7 @@ protected function parseFilterParams(): void
             } elseif (! in_array($whr['key'], $tableColumns)) {
                 continue;
             }
-            $this->setQueryBuilderWhereStatement($this->repository, $table . '.' . $whr['key'], $whr);
+            $this->setQueryBuilderWhereStatement($this->repository, $table.'.'.$whr['key'], $whr);
         }
     }
 
@@ -239,16 +239,20 @@ protected function setQueryBuilderWhereStatement($query, $key, $where): void
                 if (! empty($where['values'])) {
                     $query->whereIn($key, $where['values']);
                 }
-
-                return;
+                break;
             case 'NotIn':
                 if (! empty($where['values'])) {
                     $query->whereNotIn($key, $where['values']);
                 }
-
-                return;
+                break;
             case 'Basic':
-                $query->where($key, $where['operator'], $where['value']);
+                if ($where['value'] !== 'NULL') {
+                    $query->where($key, $where['operator'], $where['value']);
+
+                    return;
+                }
+
+                $where['operator'] === '=' ? $query->whereNull($key) : $query->whereNotNull($key);
         }
     }