Skip to content

Latest commit

 

History

History
94 lines (62 loc) · 2.76 KB

AqlUserFunctions.md

File metadata and controls

94 lines (62 loc) · 2.76 KB

Managing AQL user functions

These functions implement the HTTP API for managing AQL user functions.

ArangoDatabase.getAqlFunctions

ArangoDatabase.getAqlFunctions(AqlFunctionGetOptions options) : Collection<AqlFunctionEntity>

Arguments

  • options: AqlFunctionGetOptions

    • namespace: String

      Returns all registered AQL user functions from namespace namespace

Examples

ArangoDB arango = new ArangoDB.Builder().build();
ArangoDatabase db = arango.db("myDB");
Collection<AqlFunctionEntity> functions = db.getAqlFunctions(new AqlFunctionGetOptions().namespace("myfuncs"));
// functions is a list of function descriptions

ArangoDatabase.createAqlFunction

ArangoDatabase.createAqlFunction(String name, String code, AqlFunctionCreateOptions options) : void

Arguments

  • name: String

    A valid AQL function name, e.g.: "myfuncs::accounting::calculate_vat"

  • code: String

    A String evaluating to a JavaScript function

  • options: AqlFunctionCreateOptions

    • isDeterministic: Boolean

      An optional boolean value to indicate that the function results are fully deterministic (function return value solely depends on the input value and return value is the same for repeated calls with same input)

Examples

ArangoDB arango = new ArangoDB.Builder().build();
ArangoDatabase db = arango.db("myDB");
db.createAqlFunction("ACME::ACCOUNTING::CALCULATE_VAT",
                     "function (price) { return 0.19; }",
                     new AqlFunctionCreateOptions());
// Use the new function in an AQL query
String query = "FOR product IN products"
               + "RETURN MERGE("
               + "{vat: ACME::ACCOUNTING::CALCULATE_VAT(product.price)}, product)";
ArangoCursor<Double> cursor = db.query(query, null, new AqlQueryOptions(), Double.class);
// cursor is a cursor for the query result

ArangoDatabase.deleteAqlFunction

ArangoDatabase.deleteAqlFunction(String name, AqlFunctionDeleteOptions options): Integer

Deletes the AQL user function with the given name from the database.

Arguments

  • name: String

    The name of the user function to delete

  • options: AqlFunctionDeleteOptions

    • group: Boolean

      If set to true, then the function name provided in name is treated as a namespace prefix, and all functions in the specified namespace will be deleted. If set to false, the function name provided in name must be fully qualified, including any namespaces.

Examples

ArangoDB arango = new ArangoDB.Builder().build();
ArangoDatabase db = arango.db("myDB");
db.deleteAqlFunction("ACME::ACCOUNTING::CALCULATE_VAT", new AqlFunctionDeleteOptions());
// the function no longer exists