feat: add isNull / isNotNull filter

Author: bevzzz

src/it/java/io/weaviate/integration/SearchITest.java

@@ -30,13 +30,13 @@
 import io.weaviate.client6.v1.api.collections.generate.GenerativeObject;
 import io.weaviate.client6.v1.api.collections.generate.TaskOutput;
 import io.weaviate.client6.v1.api.collections.generative.DummyGenerative;
+import io.weaviate.client6.v1.api.collections.query.Filter;
 import io.weaviate.client6.v1.api.collections.query.GroupBy;
 import io.weaviate.client6.v1.api.collections.query.Metadata;
 import io.weaviate.client6.v1.api.collections.query.QueryMetadata;
 import io.weaviate.client6.v1.api.collections.query.QueryResponseGroup;
 import io.weaviate.client6.v1.api.collections.query.SortBy;
 import io.weaviate.client6.v1.api.collections.query.Target;
-import io.weaviate.client6.v1.api.collections.query.Filter;
 import io.weaviate.client6.v1.api.collections.vectorindex.Hnsw;
 import io.weaviate.client6.v1.api.collections.vectorindex.MultiVector;
 import io.weaviate.containers.Container;
@@ -608,9 +608,9 @@ public void testGenerative_bm25() throws IOException {
         .hasSize(2)
         .allSatisfy(obj -> {
           Assertions.assertThat(obj).as("uuid shorthand")
-          .returns(obj.uuid(), GenerativeObject::uuid);
+              .returns(obj.uuid(), GenerativeObject::uuid);
           Assertions.assertThat(obj).as("vectors shorthand")
-          .returns(obj.vectors(), GenerativeObject::vectors);
+              .returns(obj.vectors(), GenerativeObject::vectors);
         })
         .extracting(GenerativeObject::generative)
         .allSatisfy(generated -> {
@@ -673,4 +673,31 @@ public void testGenerative_bm25_groupBy() throws IOException {
         .extracting(TaskOutput::text, InstanceOfAssertFactories.STRING)
         .isNotBlank();
   }
+
+  @Test
+  public void test_filterIsNull() throws IOException {
+    // Arrange
+    var nsNulls = ns("Nulls");
+
+    var nulls = client.collections.create(nsNulls,
+        c -> c
+            .invertedIndex(idx -> idx.indexNulls(true))
+            .properties(Property.text("never")));
+
+    var inserted = nulls.data.insertMany(Map.of(), Map.of("never", "notNull"));
+    Assertions.assertThat(inserted.errors()).isEmpty();
+
+    // Act
+    var isNull = nulls.query.fetchObjects(q -> q.filters(Filter.property("never").isNull()));
+    var isNotNull = nulls.query.fetchObjects(q -> q.filters(Filter.property("never").isNotNull()));
+
+    // Assert
+    var isNull_1 = Assertions.assertThat(isNull.objects())
+        .as("objects WHERE never IS NULL")
+        .hasSize(1).first().actual();
+    var isNotNull_1 = Assertions.assertThat(isNotNull.objects())
+        .as("objects WHERE never IS NOT NULL")
+        .hasSize(1).first().actual();
+    Assertions.assertThat(isNull_1).isNotEqualTo(isNotNull_1);
+  }
 }

src/main/java/io/weaviate/client6/v1/api/collections/query/Filter.java

@@ -22,6 +22,7 @@ private enum Operator {
     LESS_THAN_EQUAL("LessThenEqual", WeaviateProtoBase.Filters.Operator.OPERATOR_LESS_THAN_EQUAL),
     GREATER_THAN("GreaterThen", WeaviateProtoBase.Filters.Operator.OPERATOR_GREATER_THAN),
     GREATER_THAN_EQUAL("GreaterThenEqual", WeaviateProtoBase.Filters.Operator.OPERATOR_GREATER_THAN_EQUAL),
+    IS_NULL("IsNull", WeaviateProtoBase.Filters.Operator.OPERATOR_IS_NULL),
     LIKE("Like", WeaviateProtoBase.Filters.Operator.OPERATOR_LIKE),
     CONTAINS_ANY("ContainsAny", WeaviateProtoBase.Filters.Operator.OPERATOR_CONTAINS_ANY),
     CONTAINS_ALL("ContainsAll", WeaviateProtoBase.Filters.Operator.OPERATOR_CONTAINS_ALL),
@@ -422,6 +423,20 @@ public Filter gte(Object value) {
       return new Filter(Operator.GREATER_THAN_EQUAL, left, fromObject(value));
     }
 
+    // IsNull
+    // ------------------------------------------------------------------------
+    public Filter isNull() {
+      return isNull(true);
+    }
+
+    public Filter isNotNull() {
+      return isNull(false);
+    }
+
+    public Filter isNull(boolean isNull) {
+      return new Filter(Operator.IS_NULL, left, new BooleanOperand(isNull));
+    }
+
     // Like
     // ------------------------------------------------------------------------
     public Filter like(String value) {