La sortie du pilote dépend de la demande spécifique formulée. Certaines méthodes, comme uql(), retournent un objet Response, qui nécessite d'extraire les données et de les convertir dans le type correspondant du pilote pour servir l'application Java. D'autres méthodes, comme showGraph(), showSchema(), et showProperty(), renvoient directement les données du type du pilote (GraphSet, Schema, Property, etc.). Veuillez lire Types Mapping Ultipa and Java pour une liste des principaux types de pilotes.
Réponse
Les méthodes uql() et d'autres méthodes retournent un objet Response. Response possède les champs suivants :
Champ |
Type |
Description |
|---|---|---|
aliases |
List<Alias> | Liste d'aliases ; chacun a le nom et le type des données. |
items |
Map<String, DataItem> | Carte des aliases et de leurs données correspondantes (DataItem). |
insertNodesReply |
Ultipa.InsertNodesReply | Résultat des insertions de nœuds par lots. |
insertEdgesReply |
Ultipa.InsertEdgesReply | Résultat des insertions d'arêtes par lots. |
exportData |
ExportData | Résultat des opérations d'exportation de données. |
explainPlan |
ExplainPlan | Arbre d'explication pour l'instruction UQL. |
status |
Status | Statut d'exécution de la requête. |
statistic |
Statistic | Statistiques de l'exécution de la requête, incluant nodeAffected, edgeAffected, totalCost, engineCost, etc. |
Si la requête retourne des données, vous pouvez extraire chaque élément par son alias en utilisant la méthode get() ou alias(). Les deux méthodes retournent un objet DataItem, qui intègre le résultat de la requête. Pour mapper le DataItem au type correspondant du pilote, veuillez lire Types Mapping Ultipa and Java.
get()
Récupère les données par l'index de l'alias.
Paramètres :
Integer: Index de l'alias.
Retourne :
DataItem: Les données récupérées.
Response response = client.uql("find().nodes() as n return n._id, n._uuid limit 3");
System.out.println(response.get(0).toJson());
L'instruction UQL retourne deux aliases n._id et n._uuid; la méthode get() récupère l'alias n._id à l'index 0.
["{\"type\":\"STRING\",\"values\":[\"u604131\",\"u604510\",\"u604614\"],\"name\":\"n._id\"}"]
alias()
Récupère les données par le nom de l'alias.
Paramètres :
String: Nom de l'alias.
Retourne :
DataItem: Les données récupérées.
Response response = client.uql("find().nodes() as n return n._id, n._uuid limit 3");
System.out.println(response.alias("n._uuid").toJson());
L'instruction UQL retourne deux aliases n._id et n._uuid; la méthode alias() récupère l'alias n._uuid par son nom.
["{\"type\":\"UINT64\",\"values\":[\"1\",\"2\",\"3\"],\"name\":\"n._uuid\"}"]