Endpoint /data

Servlet utilisé pour lire une valeur de champ ou un objet de session (objet persistent).

Le servlet n'est invocable que via la méthode GET. Elle gère deux modes d'appels. La sélection du mode est automatique et s'appuie sur les paramètres ou headers disponibles dans la requête.

Mode basique

Ce mode permet de récupérer une valeur de champ. Il ne permet pas de récupérer de valeur d'objet de session.

Ce mode attend un identifiant de session et d'une référence de contexte. Cette dernière doit adopter la forme hashée. Elle doit donc être une valeur sans signification particulière plutôt qu'un contexte utilisant la forme standard model[docId].group[tupleId].fieldName.

L'identifiant de session peut être passé au moyen d'un paramètre sessionid ou du header x-ewt-sessionid.

Le contexte peut être passé au moyen d'un paramètre context ou du header x-ewt-context.

En option, il est possible d'indiquer quelle valeur de header Content-Disposition le servlet doit ajouter dans la réponse. Cela se fait en passant une valeur attachment ou inline dans le paramètre disposition ou dans le header x-ewt-disposition.

Mode sécurisé

Ce mode permet de récupérer une valeur de champ ou une valeur d'objet de session.

Ce mode n'attend qu'un seul paramètre dataref ou un seul header x-ewt-dataref. Toutes les références de session, de champ ou d'objet sont incluses dans la reference. Cette dernière doit donc être générée par le moteur au moyen des méthodes $session.createContextReference ou $session.createPersistentObjectReference.

La référence inclut notamment l'identifiant de session, le contexte de champ ou le nom d'objet persistent, une indication sur le type d'objet (contexte ou objet) ainsi qu'une durée de validité. Elle peut en option également inclure une indication sur le Content-Disposition que le servlet /data devra inclure dans sa réponse s'il est invoqué.

Le mode sécurisé prime sur le mode basique. Cela signifie que si le paramètre dataref ou le header correspondant est présent, les autres paramètres (à l'exception de disposition sont ignorés.