Gestione parametri in Sessione (Session Parameters)
Esistono delle API per poter gestire dei parametri legati alla sessione utente corrente:
addGwSessionParameter()
Aggiunge un paramtero paramName in sessione, con valore paramValue. Se il parametro è già presente il suo valore viene sovrascritto. Gli altri parametri non sono modificati.
var paramName = 'p1'; var paramValue = 2; var params = { callback: function(jsonServerResponse){ }, errorCallback: function(jsonServerResponse){ } }; addGwSessionParameter(paramName, paramValue, params);
addGwSessionParameters()
Aggiunge tutti i parametri di parametersMap in sessione. Se i parametri sono già presenti i loro valori vengono sovrascritti. Gli altri parametri non sono modificati.
var parametersMap = {p1: 'one', p2: 2}; var params = { callback: function(jsonServerResponse){ let success = jsonServerResponse.success; let description = jsonServerResponse.description; let sessionParameters = jsonServerResponse.responseHashMap.sessionParameters; }, errorCallback: function(jsonServerResponse){ } }; addGwSessionParameters(parametersMap, params);
getGwSessionParameters()
Recupera tutti i parametri attualmente in sessione. E li rende utilizzabili dentro la mappa sessionParameters nella callback.
var params = { callback: function(sessionParameters){ var p1 = sessionParameters.p1; ... }, errorCallback: function(jsonServerResponse){ } }; getGwSessionParameters(params);
setGwSessionParameters()
Dalla versione 4.6.9
Imposta i parametri di parametersMap in sessione. Sovrascrivendo tutti i parametri eventualmente gia presenti.
var parametersMap = {p1: 'one', p2: 2, p3: true}; var params = { callback: function(jsonServerResponse){ let success = jsonServerResponse.success; let description = jsonServerResponse.description; let sessionParameters = jsonServerResponse.responseHashMap.sessionParameters; }, errorCallback: function(jsonServerResponse){ } }; setGwSessionParameters(parametersMap, params);
removeGwSessionParameters()
Rimuove i parametri della mappa dalla sessione. Vengono valutate le sole key. Gli altri parametri non vengono modificati.
var sessionParameters = {p1: null, p2: null, p3: null}; var params = { callback: function(jsonServerResponse){ let success = jsonServerResponse.success; let description = jsonServerResponse.description; let sessionParameters = jsonServerResponse.responseHashMap.sessionParameters; var p4Value = sessionParameters.p4; ... }, errorCallback: function(jsonServerResponse){ } }; removeGwSessionParameters(sessionParameters, params);
clearAllGwSessionParameters()
@Deprecated
Rimuove tutti i parametri dalla sessione.
clearAllGwSessionParameters();
clearGwSessionParameters()
Dalla 4.6.9
Rimuove tutti i parametri dalla sessione.
var params = { callback: function(jsonServerResponse){ let success = jsonServerResponse.success; let description = jsonServerResponse.description; let sessionParameters = jsonServerResponse.responseHashMap.sessionParameters; //sessionParameters empty now ... }, errorCallback: function(jsonServerResponse){ } }; clearGwSessionParameters(params);