added thread safety annotations (#445)

(cherry picked from commit b6445b6)

Author: rashtao

pom.xml

@@ -341,6 +341,12 @@
             <artifactId>jackson-dataformat-velocypack</artifactId>
             <optional>true</optional>
         </dependency>
+        <dependency>
+            <groupId>com.google.code.findbugs</groupId>
+            <artifactId>jsr305</artifactId>
+            <version>3.0.2</version>
+            <scope>provided</scope>
+        </dependency>
         <dependency>
             <groupId>ch.qos.logback</groupId>
             <artifactId>logback-classic</artifactId>

src/main/java/com/arangodb/ArangoCollection.java

@@ -24,6 +24,7 @@
 import com.arangodb.model.*;
 import com.arangodb.util.RawData;
 
+import javax.annotation.concurrent.ThreadSafe;
 import java.util.Collection;
 
 /**
@@ -35,6 +36,7 @@
  * @see <a href="https://www.arangodb.com/docs/stable/http/collection.html">Collection API Documentation</a>
  * @see <a href="https://www.arangodb.com/docs/stable/http/collection.html">Documents API Documentation</a>
  */
+@ThreadSafe
 public interface ArangoCollection extends ArangoSerdeAccessor {
 
     /**

src/main/java/com/arangodb/ArangoDB.java

@@ -45,6 +45,7 @@
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import javax.annotation.concurrent.ThreadSafe;
 import javax.net.ssl.HostnameVerifier;
 import javax.net.ssl.SSLContext;
 import java.io.InputStream;
@@ -67,6 +68,7 @@
  * @author Mark Vollmary
  * @author Michele Rastelli
  */
+@ThreadSafe
 public interface ArangoDB extends ArangoSerdeAccessor {
 
     /**

src/main/java/com/arangodb/ArangoDatabase.java

@@ -26,6 +26,7 @@
 import com.arangodb.model.arangosearch.AnalyzerDeleteOptions;
 import com.arangodb.model.arangosearch.ArangoSearchCreateOptions;
 
+import javax.annotation.concurrent.ThreadSafe;
 import java.util.Collection;
 import java.util.Map;
 
@@ -37,6 +38,7 @@
  * @see <a href="https://www.arangodb.com/docs/stable/http/database.html">Databases API Documentation</a>
  * @see <a href="https://www.arangodb.com/docs/stable/http/aql-query.html">Query API Documentation</a>
  */
+@ThreadSafe
 public interface ArangoDatabase extends ArangoSerdeAccessor {
 
     /**

src/main/java/com/arangodb/ArangoEdgeCollection.java

@@ -24,12 +24,15 @@
 import com.arangodb.entity.EdgeUpdateEntity;
 import com.arangodb.model.*;
 
+import javax.annotation.concurrent.ThreadSafe;
+
 /**
  * Interface for operations on ArangoDB edge collection level.
  *
  * @author Mark Vollmary
  * @see <a href="https://www.arangodb.com/docs/stable/http/gharial-edges.html">API Documentation</a>
  */
+@ThreadSafe
 public interface ArangoEdgeCollection extends ArangoSerdeAccessor {
 
     /**

src/main/java/com/arangodb/ArangoGraph.java

@@ -25,6 +25,7 @@
 import com.arangodb.model.GraphCreateOptions;
 import com.arangodb.model.VertexCollectionCreateOptions;
 
+import javax.annotation.concurrent.ThreadSafe;
 import java.util.Collection;
 
 /**
@@ -33,6 +34,7 @@
  * @author Mark Vollmary
  * @see <a href="https://www.arangodb.com/docs/stable/http/gharial.html">API Documentation</a>
  */
+@ThreadSafe
 public interface ArangoGraph extends ArangoSerdeAccessor {
 
     /**

src/main/java/com/arangodb/ArangoMetrics.java

@@ -20,12 +20,15 @@
 
 package com.arangodb;
 
+import javax.annotation.concurrent.ThreadSafe;
+
 /**
  * Interface for accessing metrics.
  *
  * @author Michele Rastelli
  * @since ArangoDB 3.9
  */
+@ThreadSafe
 public interface ArangoMetrics {
     /**
      * @return queue time metrics

src/main/java/com/arangodb/ArangoSearch.java

@@ -25,13 +25,16 @@
 import com.arangodb.model.arangosearch.ArangoSearchCreateOptions;
 import com.arangodb.model.arangosearch.ArangoSearchPropertiesOptions;
 
+import javax.annotation.concurrent.ThreadSafe;
+
 /**
  * Interface for operations on ArangoDB view level for ArangoSearch views.
  *
  * @author Mark Vollmary
  * @see <a href="https://www.arangodb.com/docs/stable/http/views.html">View API Documentation</a>
  * @since ArangoDB 3.4.0
  */
+@ThreadSafe
 public interface ArangoSearch extends ArangoView {
 
     /**

src/main/java/com/arangodb/ArangoSerdeAccessor.java

@@ -22,9 +22,12 @@
 
 import com.arangodb.internal.serde.InternalSerde;
 
+import javax.annotation.concurrent.ThreadSafe;
+
 /**
  * @author Mark Vollmary
  */
+@ThreadSafe
 public interface ArangoSerdeAccessor {
 
     /**

src/main/java/com/arangodb/ArangoVertexCollection.java

@@ -24,12 +24,15 @@
 import com.arangodb.entity.VertexUpdateEntity;
 import com.arangodb.model.*;
 
+import javax.annotation.concurrent.ThreadSafe;
+
 /**
  * Interface for operations on ArangoDB vertex collection level.
  *
  * @author Mark Vollmary
  * @see <a href="https://www.arangodb.com/docs/stable/http/gharial-vertices.html">API Documentation</a>
  */
+@ThreadSafe
 public interface ArangoVertexCollection extends ArangoSerdeAccessor {
 
     /**

src/main/java/com/arangodb/ArangoView.java

@@ -22,13 +22,16 @@
 
 import com.arangodb.entity.ViewEntity;
 
+import javax.annotation.concurrent.ThreadSafe;
+
 /**
  * Interface for operations on ArangoDB view level.
  *
  * @author Mark Vollmary
  * @see <a href="https://www.arangodb.com/docs/stable/http/views.html">View API Documentation</a>
  * @since ArangoDB 3.4.0
  */
+@ThreadSafe
 public interface ArangoView extends ArangoSerdeAccessor {
 
     /**

src/main/java/com/arangodb/QueueTimeMetrics.java

@@ -22,6 +22,8 @@
 
 import com.arangodb.model.QueueTimeSample;
 
+import javax.annotation.concurrent.ThreadSafe;
+
 /**
  * Interface for accessing queue time latency metrics, reported by the "X-Arango-Queue-Time-Seconds" response header.
  * This header contains the most recent request (de)queuing time (in seconds) as tracked by the server’s scheduler.
@@ -30,6 +32,7 @@
  * @see <a href="https://www.arangodb.com/docs/stable/http/general.html#overload-control">API Documentation</a>
  * @since ArangoDB 3.9
  */
+@ThreadSafe
 public interface QueueTimeMetrics {
 
     /**

src/main/java/com/arangodb/async/ArangoCollectionAsync.java

@@ -25,6 +25,7 @@
 import com.arangodb.model.*;
 import com.arangodb.util.RawData;
 
+import javax.annotation.concurrent.ThreadSafe;
 import java.util.Collection;
 import java.util.concurrent.CompletableFuture;
 
@@ -35,6 +36,7 @@
  * @see <a href="https://www.arangodb.com/docs/stable/http/collection.html">Collection API Documentation</a>
  * @see <a href="https://www.arangodb.com/docs/stable/http/collection.html">Documents API Documentation</a>
  */
+@ThreadSafe
 public interface ArangoCollectionAsync extends ArangoSerdeAccessor {
 
     /**

src/main/java/com/arangodb/async/ArangoDBAsync.java

@@ -49,6 +49,7 @@
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import javax.annotation.concurrent.ThreadSafe;
 import javax.net.ssl.SSLContext;
 import java.io.InputStream;
 import java.util.Collection;
@@ -68,6 +69,7 @@
  *
  * @author Mark Vollmary
  */
+@ThreadSafe
 public interface ArangoDBAsync extends ArangoSerdeAccessor {
 
     void shutdown();

src/main/java/com/arangodb/async/ArangoDatabaseAsync.java

@@ -28,6 +28,7 @@
 import com.arangodb.model.arangosearch.AnalyzerDeleteOptions;
 import com.arangodb.model.arangosearch.ArangoSearchCreateOptions;
 
+import javax.annotation.concurrent.ThreadSafe;
 import java.util.Collection;
 import java.util.Map;
 import java.util.concurrent.CompletableFuture;
@@ -39,6 +40,7 @@
  * @see <a href="https://www.arangodb.com/docs/stable/http/database.html">Databases API Documentation</a>
  * @see <a href="https://www.arangodb.com/docs/stable/http/aql-query.html">Query API Documentation</a>
  */
+@ThreadSafe
 public interface ArangoDatabaseAsync extends ArangoSerdeAccessor {
 
     /**

src/main/java/com/arangodb/async/ArangoEdgeCollectionAsync.java

@@ -25,6 +25,7 @@
 import com.arangodb.entity.EdgeUpdateEntity;
 import com.arangodb.model.*;
 
+import javax.annotation.concurrent.ThreadSafe;
 import java.util.concurrent.CompletableFuture;
 
 /**
@@ -33,6 +34,7 @@
  * @author Mark Vollmary
  * @see <a href="https://www.arangodb.com/docs/stable/http/gharial-edges.html">API Documentation</a>
  */
+@ThreadSafe
 public interface ArangoEdgeCollectionAsync extends ArangoSerdeAccessor {
 
     /**

src/main/java/com/arangodb/async/ArangoGraphAsync.java

@@ -26,6 +26,7 @@
 import com.arangodb.model.GraphCreateOptions;
 import com.arangodb.model.VertexCollectionCreateOptions;
 
+import javax.annotation.concurrent.ThreadSafe;
 import java.util.Collection;
 import java.util.concurrent.CompletableFuture;
 
@@ -35,6 +36,7 @@
  * @author Mark Vollmary
  * @see <a href="https://www.arangodb.com/docs/stable/http/gharial.html">API Documentation</a>
  */
+@ThreadSafe
 public interface ArangoGraphAsync extends ArangoSerdeAccessor {
 
     /**

src/main/java/com/arangodb/async/ArangoSearchAsync.java

@@ -25,6 +25,7 @@
 import com.arangodb.model.arangosearch.ArangoSearchCreateOptions;
 import com.arangodb.model.arangosearch.ArangoSearchPropertiesOptions;
 
+import javax.annotation.concurrent.ThreadSafe;
 import java.util.concurrent.CompletableFuture;
 
 /**
@@ -34,6 +35,7 @@
  * @see <a href="https://www.arangodb.com/docs/stable/http/views.html">View API Documentation</a>
  * @since ArangoDB 3.4.0
  */
+@ThreadSafe
 public interface ArangoSearchAsync extends ArangoViewAsync {
 
     /**

src/main/java/com/arangodb/async/ArangoVertexCollectionAsync.java

@@ -25,6 +25,7 @@
 import com.arangodb.entity.VertexUpdateEntity;
 import com.arangodb.model.*;
 
+import javax.annotation.concurrent.ThreadSafe;
 import java.util.concurrent.CompletableFuture;
 
 /**
@@ -33,6 +34,7 @@
  * @author Mark Vollmary
  * @see <a href="https://www.arangodb.com/docs/stable/http/gharial-vertices.html">API Documentation</a>
  */
+@ThreadSafe
 public interface ArangoVertexCollectionAsync extends ArangoSerdeAccessor {
 
     /**

src/main/java/com/arangodb/async/ArangoViewAsync.java

@@ -23,6 +23,7 @@
 import com.arangodb.ArangoSerdeAccessor;
 import com.arangodb.entity.ViewEntity;
 
+import javax.annotation.concurrent.ThreadSafe;
 import java.util.concurrent.CompletableFuture;
 
 /**
@@ -32,6 +33,7 @@
  * @see <a href="https://www.arangodb.com/docs/stable/http/views.html">View API Documentation</a>
  * @since ArangoDB 3.4.0
  */
+@ThreadSafe
 public interface ArangoViewAsync extends ArangoSerdeAccessor {
 
     /**