java

Author: clun

README.MD

@@ -1,10 +1,22 @@
 
 # Java Client for Stargate Data API
 
-`astra-db-java` is the java libraries use to interact with Astra, the Data API with vector support.
+[![License Apache2](https://img.shields.io/hexpm/l/plug.svg)](http://www.apache.org/licenses/LICENSE-2.0)
+[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.datastax.astra/astra-sdk/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.datastax.astra/astra-db-java)
+![Latest Release](https://img.shields.io/github/v/release/datastax/astra-db-java)
 
-- `astra-db-ts` is the equivalent for typescript
-- `astrapy` is the equivalent in python
+[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=clun_astra-db-java&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=clun_db-java)
+[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=clun_astra-db-java&metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=clun_astra-db-java)
+[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=clun_astra-db-java&metric=sqale_rating)](https://sonarcloud.io/summary/overall?id=clun_astra-db-java)
+[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=clun_astra-db-java&metric=vulnerabilities)](https://sonarcloud.io/summary/overall?id=clun_astra-db-java)
+[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=clun_astra-db-java&metric=bugs)](https://sonarcloud.io/summary/new_code?id=clun_astra-db-java)
+[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=clun_astra-db-java&metric=coverage)](https://sonarcloud.io/summary/new_code?id=clun_astra-db-java)
+[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=clun_astra-db-java&metric=ncloc)](https://sonarcloud.io/summary/new_code?id=clun_astra-db-java)
+
+This client library provides a simplified way to interact with Data API for AstraDB or local instances. For detailed documentation, each operation comes with a detailed description and examples.
+
+- [`astra-db-ts`](https://github.com/datastax/astra-db-ts) is the equivalent for typescript
+- [`astrapy`](https://github.com/datastax/astrapy) is the equivalent in python
 
 This library is under development and not yet available in Maven Central. You can build it locally and install it in your local repository.
 
@@ -112,6 +124,10 @@ public class GettingStarted {
 
 ### 3. What's Next
 
+This is an the organization of the different classes of the framework.
+
+![overview](https://datastaxdevs.github.io/astra-db-java/overview.png)
+
 - For more information use the [JAVADOC  documentation](https://datastaxdevs.github.io/astra-db-java/latest/)
 
 - The `examples` directory contains more examples on how to use the library.

astra-db-java/src/main/java/com/datastax/astra/client/Collection.java

@@ -49,8 +49,8 @@
 import com.datastax.astra.client.model.Update;
 import com.datastax.astra.client.model.UpdateOneOptions;
 import com.datastax.astra.client.model.UpdateResult;
-import com.datastax.astra.internal.AbstractCommandRunner;
-import com.datastax.astra.internal.ApiResponse;
+import com.datastax.astra.internal.command.AbstractCommandRunner;
+import com.datastax.astra.internal.api.ApiResponse;
 import com.datastax.astra.internal.utils.Assert;
 import com.datastax.astra.internal.utils.JsonUtils;
 import lombok.Getter;

astra-db-java/src/main/java/com/datastax/astra/client/DataAPIClient.java

@@ -21,9 +21,8 @@
  */
 
 import com.datastax.astra.client.admin.AstraDBAdmin;
-import com.datastax.astra.internal.AstraApiEndpoint;
+import com.datastax.astra.internal.api.AstraApiEndpoint;
 import com.datastax.astra.internal.utils.Assert;
-import com.dtsx.astra.sdk.db.domain.CloudProviderType;
 import com.dtsx.astra.sdk.utils.AstraEnvironment;
 
 import java.net.http.HttpClient;

astra-db-java/src/main/java/com/datastax/astra/client/DataAPIClients.java

@@ -20,9 +20,9 @@
  * #L%
  */
 
-import com.datastax.astra.internal.LoggingCommandObserver;
+import com.datastax.astra.internal.command.LoggingCommandObserver;
 import com.datastax.astra.client.admin.DataAPIDatabaseAdmin;
-import com.datastax.astra.internal.TokenProviderStargate;
+import com.datastax.astra.internal.auth.TokenProviderStargate;
 
 import static com.datastax.astra.client.admin.AstraDBAdmin.DEFAULT_NAMESPACE;
 

astra-db-java/src/main/java/com/datastax/astra/client/Database.java

@@ -28,9 +28,9 @@
 import com.datastax.astra.client.model.CollectionInfo;
 import com.datastax.astra.client.model.CollectionOptions;
 import com.datastax.astra.client.model.SimilarityMetric;
-import com.datastax.astra.internal.AbstractCommandRunner;
+import com.datastax.astra.internal.command.AbstractCommandRunner;
 import com.datastax.astra.client.admin.DataAPIDatabaseAdmin;
-import com.datastax.astra.internal.AstraApiEndpoint;
+import com.datastax.astra.internal.api.AstraApiEndpoint;
 import com.datastax.astra.client.admin.AstraDBDatabaseAdmin;
 import com.datastax.astra.internal.utils.JsonUtils;
 import lombok.Getter;

astra-db-java/src/main/java/com/datastax/astra/client/admin/AstraDBAdmin.java

@@ -21,7 +21,7 @@
  */
 import com.datastax.astra.client.DataAPIOptions;
 import com.datastax.astra.client.model.DatabaseInfo;
-import com.datastax.astra.internal.AstraApiEndpoint;
+import com.datastax.astra.internal.api.AstraApiEndpoint;
 import com.datastax.astra.internal.utils.Assert;
 import com.dtsx.astra.sdk.db.AstraDBOpsClient;
 import com.dtsx.astra.sdk.db.DbOpsClient;
@@ -46,7 +46,6 @@
 import java.util.Optional;
 import java.util.UUID;
 import java.util.stream.Collectors;
-import java.util.stream.Stream;
 
 import static com.datastax.astra.internal.utils.AnsiUtils.green;
 import static com.dtsx.astra.sdk.utils.Utils.readEnvVariable;

astra-db-java/src/main/java/com/datastax/astra/client/admin/AstraDBDatabaseAdmin.java

@@ -21,7 +21,7 @@
  */
 
 import com.datastax.astra.client.DataAPIOptions;
-import com.datastax.astra.internal.AstraApiEndpoint;
+import com.datastax.astra.internal.api.AstraApiEndpoint;
 import com.dtsx.astra.sdk.db.AstraDBOpsClient;
 import com.dtsx.astra.sdk.db.domain.Database;
 import com.dtsx.astra.sdk.db.exception.DatabaseNotFoundException;

astra-db-java/src/main/java/com/datastax/astra/client/admin/DataAPIDatabaseAdmin.java

@@ -22,7 +22,7 @@
 
 import com.datastax.astra.client.DataAPIOptions;
 import com.datastax.astra.client.Database;
-import com.datastax.astra.internal.AbstractCommandRunner;
+import com.datastax.astra.internal.command.AbstractCommandRunner;
 import com.datastax.astra.client.model.Command;
 import com.datastax.astra.client.model.NamespaceOptions;
 import com.datastax.astra.internal.utils.Assert;

astra-db-java/src/main/java/com/datastax/astra/client/admin/package-info.java

@@ -1,5 +1,5 @@
 /**
- * Admin Data API Client Classes (ddl on databases and namespaces).
+ * Administration classes to manage Databases and Namespaces.
  */
 package com.datastax.astra.client.admin;
 /*-

astra-db-java/src/main/java/com/datastax/astra/client/exception/DataApiFaultyResponseException.java

@@ -21,7 +21,7 @@
  */
 
 import com.datastax.astra.client.model.Command;
-import com.datastax.astra.internal.ApiResponse;
+import com.datastax.astra.internal.api.ApiResponse;
 import lombok.Getter;
 
 /**