[DE-426] execute generic parameterized request

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

@@ -23,9 +23,7 @@
 import com.arangodb.config.ConfigPropertiesProvider;
 import com.arangodb.config.ConfigPropertyKey;
 import com.arangodb.entity.*;
-import com.arangodb.internal.ArangoDBImpl;
-import com.arangodb.internal.ArangoDefaults;
-import com.arangodb.internal.InternalArangoDBBuilder;
+import com.arangodb.internal.*;
 import com.arangodb.internal.http.HttpCommunication;
 import com.arangodb.internal.http.HttpConnectionFactory;
 import com.arangodb.internal.net.*;
@@ -276,21 +274,19 @@ public interface ArangoDB extends ArangoSerdeAccessor {
     void grantDefaultCollectionAccess(String user, Permissions permissions);
 
     /**
-     * Generic Execute. Use this method to execute custom FOXX services.
+     * Execute custom requests. Requests can be programmatically built by setting low level detail such as method, path,
+     * query parameters, headers and body payload.
+     * This method can be used to call FOXX services, API endpoints not (yet) implemented in this driver or trigger
+     * async jobs, see
+     * <a href="https://www.arangodb.com/docs/stable/http/async-results-management.html#fire-and-forget">Fire and Forget</a>
+     * and
+     * <a href="https://www.arangodb.com/docs/stable/http/async-results-management.html#async-execution-and-later-result-retrieval">Async Execution and later Result Retrieval</a>
      *
      * @param request request
-     * @return VelocyStream response
+     * @param type    Deserialization target type for the response body (POJO or {@link com.arangodb.util.RawData})
+     * @return response
      */
-    Response execute(Request request);
-
-    /**
-     * Generic Execute. Use this method to execute custom FOXX services.
-     *
-     * @param request    request
-     * @param hostHandle Used to stick to a specific host when using {@link LoadBalancingStrategy#ROUND_ROBIN}
-     * @return VelocyStream response
-     */
-    Response execute(Request request, HostHandle hostHandle);
+    <T, U> Response<U> execute(Request<T> request, Class<U> type);
 
     /**
      * Returns the server logs

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

@@ -612,15 +612,6 @@ public interface ArangoDatabase extends ArangoSerdeAccessor {
      */
     void reloadRouting();
 
-    /**
-     * Returns a new {@link ArangoRoute} instance for the given path (relative to the database) that can be used to
-     * perform arbitrary requests.
-     *
-     * @param path The database-relative URL of the route
-     * @return {@link ArangoRoute}
-     */
-    ArangoRoute route(String... path);
-
     /**
      * Fetches all views from the database and returns an list of view descriptions.
      *