diff --git a/DEPRECATED.md b/DEPRECATED.md index 38730dc526..87b6d85bd7 100644 --- a/DEPRECATED.md +++ b/DEPRECATED.md @@ -19,14 +19,7 @@ migrations will also be detailed here. * Foxx: The usage of `apps` in manifest files is no longer possible, please use `controllers` instead. * Graph: The usage of the modules `org/arangodb/graph` and `org/arangodb/graph-blueprint` is no longer suggested, it will be deprecated in the next version. Please use module `org/arangodb/general-graph` instead. * Graph: The module `org/arangodb/graph` will now load the module `org/arangodb/graph-blueprint`. -* AQL: The function `PATHS` is no longer suggested, it will be deprecated in the next version. Please use `GRAPH_PATHS` instead. -* AQL: The function `SHORTEST_PATH` is no longer suggested, it will be deprecated in the next version. Please use `GRAPH_SHORTEST_PATH` instead. -* AQL: The function `TRAVERSAL` is no longer suggested, it will be deprecated in the next version. Please use `GRAPH_TRAVERSAL` instead. -* AQL: The function `TRAVERSAL_TREE` is no longer suggested, it will be deprecated in the next version. Please use `GRAPH_TRAVERSAL_TREE` instead. -* AQL: The function `NEIGHBORS` is no longer suggested, it will be deprecated in the next version. Please use `GRAPH_NEIGHBORS` instead. -* Traversal: The usage of the traversal datasource `collectionDatasourceFactory` is no longer suggested, it will be deprecated in the next version. Please use `generalGraphDatasourceFactory` instead. * Http: The api `_api/graph` is no longer suggested, it will be deprecated in the next version. Please use the general graph api `_api/gharial` instead. -* Http: In `POST _api/traversal` the usage of the body parameter `edgeCollection` is no longer suggested, it will be deprecated in the next version. Please use `graphName` instead. * MRuby: The MRuby server integration for arangod has been removed and can no longer be used. * Replication: the methods `logger.start`, `logger.stop` and `logger.properties` are no-ops since ArangoDB 2.2. They are available in this version only for backwards-compatibility. Usage is no longer suggested as they will be deprecated in the next version. * Replication: the HTTP methods `PUT /_api/replication/logger-start`, `PUT /_api/replication/logger-stop`, `GET /_api/replication/logger-config` and `PUT /_api/replication/logger-config` are no-ops since ArangoDB 2.2. They are available in this version only for backwards-compatibility. Usage is no longer suggested as they will be deprecated in the next version. @@ -39,14 +32,7 @@ migrations will also be detailed here. * Foxx: `requestContext.queryParam({type: string})` is now deprecated, it will raise a warning if you use it. To suppress the warning, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `requestContext.queryParam({type: joi})` instead. * Foxx: `requestContext.pathParam({type: string})` is now deprecated, it will raise a warning if you use it. To suppress the warning, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `requestContext.pathParam({type: joi})` instead. * Graph: The modules `org/arangodb/graph` and `org/arangodb/graph-blueprint` are now deprecated, it will raise a warning if you use it. To suppress the warning, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use module `org/arangodb/general-graph` instead. -* AQL: The function `PATHS` is now deprecated, it will raise a warning if you use it. To suppress the warning, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `GRAPH_PATHS` instead. -* AQL: The function `SHORTEST_PATH` is now deprecated, it will raise a warning if you use it. To suppress the warning, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `GRAPH_SHORTEST_PATH` instead. -* AQL: The function `TRAVERSAL` is now deprecated, it will raise a warning if you use it. To suppress the warning, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `GRAPH_TRAVERSAL` instead. -* AQL: The function `TRAVERSAL_TREE` is now deprecated, it will raise a warning if you use it. To suppress the warning, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `GRAPH_TRAVERSAL_TREE` instead. -* AQL: The function `NEIGHBORS` is now deprecated, it will raise a warning if you use it. To suppress the warning, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `GRAPH_NEIGHBORS` instead. -* Traversal: The usage of the traversal datasource `collectionDatasourceFactory` is now deprecated, it will raise a warning if you use it. To suppress the warning, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `generalGraphDatasourceFactory` instead. * Http: The api `_api/graph` is now deprecated, it will raise a warning if you use it. To suppress the warning, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use the general graph api `_api/gharial` instead. -* Http: In `POST _api/traversal` the usage of the body parameter `edgeCollection` is now deprecated, it will raise a warning if you use it. To suppress the warning, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `graphName` instead. * Replication: the methods `logger.start`, `logger.stop` and `logger.properties` are now deprecated. Using them will raise a warning. * Replication: the HTTP methods `PUT /_api/replication/logger-start`, `PUT /_api/replication/logger-stop`, `GET /_api/replication/logger-config` and `PUT /_api/replication/logger-config` are now deprecated. Using them will raise a warning. * General-Graph: In the module `org/arangodb/general-graph` the functions `_undirectedRelation` and `_directedRelation` is no longer suggested, they will be deprecated int the next version. Both functions have been unified to `_relation`. @@ -59,14 +45,7 @@ migrations will also be detailed here. * Foxx: `requestContext.queryParam({type: string})` is no longer available by default. If you still want to use it, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `requestContext.queryParam({type: joi})` instead. * Foxx: `requestContext.pathParam({type: string})` is no longer available by default. If you still want to use it, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `requestContext.pathParam({type: joi})` instead. * Graph: The modules `org/arangodb/graph` and `org/arangodb/graph-blueprint` are no longer available by default. If you still want to use them, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use module `org/arangodb/general-graph` instead. -* AQL: The function `PATHS` is no longer available by default. If you still want to use it, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `GRAPH_PATHS` instead. -* AQL: The function `SHORTEST_PATH` is no longer available by default. If you still want to use it, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `GRAPH_SHORTEST_PATH` instead. -* AQL: The function `TRAVERSAL` is no longer available by default. If you still want to use it, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `GRAPH_TRAVERSAL` instead. -* AQL: The function `TRAVERSAL_TREE` is no longer available by default. If you still want to use it, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `GRAPH_TRAVERSAL_TREE` instead. -* AQL: The function `NEIGHBORS` is no longer available by default. If you still want to use it, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `GRAPH_NEIGHBORS` instead. -* Traversal: The usage of the traversal datasource `collectionDatasourceFactory` is no longer available by default. If you still want to use it. Please use `generalGraphDatasourceFactory` instead. * Http: The api `_api/graph` is no longer available by default. If you still want to use it, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use the general graph api `_api/gharial` instead. -* Http: In `POST _api/traversal` the usage of the body parameter `edgeCollection` is no longer available by default. If you still want to use it, please start `arangod` with the option `--server.default-api-compatibility 20200`. Please use `graphName` instead. * Replication: the methods `logger.start`, `logger.stop` and `logger.properties` are no longer available. * Replication: the HTTP methods `PUT /_api/replication/logger-start`, `PUT /_api/replication/logger-stop`, `GET /_api/replication/logger-config` and `PUT /_api/replication/logger-config` are no longer available. To suppress the warning, please start `arangod` with the option `--server.default-api-compatibility 20200`. @@ -80,12 +59,5 @@ To suppress the warning, please start `arangod` with the option `--server.defaul * Foxx: `requestContext.queryParam({type: string})` has been removed entirely. Please use `requestContext.queryParam({type: joi})` instead. * Foxx: `requestContext.pathParam({type: string})` has been removed entirely. Please use `requestContext.pathParam({type: joi})` instead. * Graph: The modules `org/arangodb/graph` and `org/arangodb/graph-blueprint` have been removed entirely. Please use module `org/arangodb/general-graph` instead. -* AQL: The function `PATHS` has been removed entirely. Please use `GRAPH_PATHS` instead. -* AQL: The function `SHORTEST_PATH` has been removed entirely. Please use `GRAPH_SHORTEST_PATH` instead. -* AQL: The function `TRAVERSAL` has been removed entirely. Please use `GRAPH_TRAVERSAL` instead. -* AQL: The function `TRAVERSAL_TREE` has been removed entirely. Please use `GRAPH_TRAVERSAL_TREE` instead. -* AQL: The function `NEIGHBORS` has been removed entirely. Please use `GRAPH_NEIGHBORS` instead. -* Traversal: The usage of the traversal datasource `collectionDatasourceFactory` has been removed entirely. Please use `generalGraphDatasourceFactory` instead. * Http: The api `_api/graph` has been removed entirely. Please use the general graph api `_api/gharial` instead. -* Http: In `POST _api/traversal` the usage of the body parameter `edgeCollection` has been removed entirely. Please use `graphName` instead. * General-Graph: In the module `org/arangodb/general-graph` the functions `_undirectedRelation` and `_directedRelation` are no longer available by default, if you still want to use them start `arangod` with the option `--server.default-api-compatibility 20300`. Both functions have been unified to `_relation`. diff --git a/Documentation/Books/Users/Aql/Functions.mdpp b/Documentation/Books/Users/Aql/Functions.mdpp index 29427fdf1d..2c45b80a64 100644 --- a/Documentation/Books/Users/Aql/Functions.mdpp +++ b/Documentation/Books/Users/Aql/Functions.mdpp @@ -697,11 +697,9 @@ will fail with an error. !SUBSUBSECTION Graph functions AQL has the following functions to traverse graphs: -
-**Warning: Deprecated** -This query is deprecated and will be removed soon. -Please use [Graph operations](../Aql/GraphOperations.md) instead. +If you have created a graph in the general-graph module you may want to use +[Graph operations](../Aql/GraphOperations.md) instead. - *PATHS(vertexcollection, edgecollection, direction, followcycles)*: returns a list of paths through the graph defined by the nodes in the collection @@ -730,10 +728,8 @@ Please use [Graph operations](../Aql/GraphOperations.md) instead. FILTER p.source._id == "123456/123456" && LENGTH(p.edges) == 2 RETURN p.vertices[*].name -**Warning: Deprecated** - -This query is deprecated and will be removed soon. -Please use [Graph operations](../Aql/GraphOperations.md) instead. +If you have created a graph in the general-graph module you may want to use +[Graph operations](../Aql/GraphOperations.md) instead. - *TRAVERSAL(vertexcollection, edgecollection, startVertex, direction, options)*: Traverses the graph described by *vertexcollection* and *edgecollection*, @@ -871,10 +867,8 @@ Please use [Graph operations](../Aql/GraphOperations.md) instead. return [ ]; // include everything else }, false); -**Warning: Deprecated** - -This query is deprecated and will be removed soon. -Please use [Graph operations](../Aql/GraphOperations.md) instead. +If you have created a graph in the general-graph module you may want to use +[Graph operations](../Aql/GraphOperations.md) instead. - *TRAVERSAL_TREE(vertexcollection, edgecollection, startVertex, direction, connectName, options)*: Traverses the graph described by *vertexcollection* and *edgecollection*, @@ -900,10 +894,8 @@ If no bounds are set, a traversal may run into an endless loop in a cyclic graph and even in a non-cyclic graph, traversing far into the graph may consume a lot of processing time and memory for the result set. -**Warning: Deprecated** - -This query is deprecated and will be removed soon. -Please use [Graph operations](../Aql/GraphOperations.md) instead. +If you have created a graph in the general-graph module you may want to use +[Graph operations](../Aql/GraphOperations.md) instead. - *SHORTEST_PATH(vertexcollection, edgecollection, startVertex, endVertex, direction, options)*: Determines the first shortest path from the *startVertex* to the *endVertex*. @@ -1022,10 +1014,8 @@ Please use [Graph operations](../Aql/GraphOperations.md) instead. EDGES(friendrelations, "friends/john", "outbound") EDGES(friendrelations, "friends/john", "any", [ { "$label": "knows" } ]) -**Warning: Deprecated** - -This query is deprecated and will be removed soon. -Please use [Graph operations](../Aql/GraphOperations.md) instead. +If you have created a graph in the general-graph module you may want to use +[Graph operations](../Aql/GraphOperations.md) instead. - *NEIGHBORS(vertexcollection, edgecollection, startvertex, direction, edgeexamples)*: Return all neighbors that are directly connected to the vertex *startvertex* as a list. @@ -1043,7 +1033,7 @@ Please use [Graph operations](../Aql/GraphOperations.md) instead. NEIGHBORS(friends, friendrelations, "friends/john", "outbound") NEIGHBORS(users, usersrelations, "users/john", "any", [ { "$label": "recommends" } ] ) -
+ !SUBSUBSECTION Control flow functions AQL offers the following functions to let the user control the flow of operations: diff --git a/js/actions/api-traversal.js b/js/actions/api-traversal.js index ed45bc8a9b..69c9a60b8a 100644 --- a/js/actions/api-traversal.js +++ b/js/actions/api-traversal.js @@ -77,9 +77,11 @@ function notFound (req, res, code, message) { /// /// - *startVertex*: id of the startVertex, e.g. *"users/foo"*. /// -/// - *edgeCollection*: **Deprecated** name of the collection that contains the edges. +/// - *edgeCollection*: (optional) name of the collection that contains the edges. /// -/// - *graphName*: name of the graph that contains the edges. +/// - *graphName*: (optional) name of the graph that contains the edges. +/// Either *edgeCollection* or *graphName* has to be given. +/// In case both values are set the *graphName* is prefered. /// /// - *filter* (optional, default is to include all nodes): /// body (JavaScript code) of custom filter function