feat: add count method to CassandraTemplate

Implemented a count method in CassandraTemplate to return
the number of records matching a given SelectQuery with
the specified ConsistencyLevel, enhancing query capabilities.

Signed-off-by: Maximillian Arruda <[email protected]>

Author: dearrudam

jnosql-cassandra/src/main/java/org/eclipse/jnosql/databases/cassandra/mapping/CassandraTemplate.java

@@ -87,6 +87,17 @@ public interface CassandraTemplate extends ColumnTemplate {
      */
     void delete(DeleteQuery query, ConsistencyLevel level);
 
+    /**
+     * Returns the count of records that match the given {@link SelectQuery} using the specified
+     * {@link ConsistencyLevel}.
+     *
+     * @param query the select query defining the criteria for counting; must not be {@code null}
+     * @param level the Cassandra consistency level to use for the operation; must not be {@code null}
+     * @return the number of records matching the query
+     * @throws NullPointerException if {@code query} or {@code level} is {@code null}
+     */
+    long count(SelectQuery query, ConsistencyLevel level);
+
     /**
      * Executes a {@link SelectQuery} using a specified {@link ConsistencyLevel} and retrieves the matching records.
      *

jnosql-cassandra/src/main/java/org/eclipse/jnosql/databases/cassandra/mapping/DefaultCassandraTemplate.java

@@ -147,6 +147,13 @@ public void delete(DeleteQuery query, ConsistencyLevel level) {
         manager.get().delete(query, level);
     }
 
+    @Override
+    public long count(SelectQuery query, ConsistencyLevel level) {
+        Objects.requireNonNull(query, "query is required");
+        Objects.requireNonNull(level, "level is required");
+        return manager.get().count(query, level);
+    }
+
     @Override
     public <T> Stream<T> find(SelectQuery query, ConsistencyLevel level) {
         Objects.requireNonNull(query, "query is required");