Servizi Node.ACS

Dopo aver visto come creare un’applicazione, vediamo brevemente come affiancare ad una app mobile di un progetto Alloy un servizio Node.ACS.

Il meccanismo è analogo a quello della lezione precedente, ma in questo caso i sorgenti dell’applicazione Node.ACS saranno salvati nella cartella /acs del progetto mobile e potremo invocare il web service dall’app in modo trasparente. Titanium infatti creerà un livello di comunicazione tra il nostro servizio remoto e la nostra app mobile, in modo che le chiamate al web service saranno incapsulate in un modulo locale che potremo utilizzare dai controller.

Creiamo quindi un progetto Alloy utilizzando il wizard di Titanium Studio (chiamiamolo html_it-helloacs) e una volta creato il progetto aggiungiamo un servizio Node.ACS selezionando la voce New -> Node.ACS Service, come illustrato nella figura:

Apparirà una finestra di dialogo nella quale inserire il nome del servizio che vogliamo implementare con Node.ACS. Lasciamo il valore di default proposto come nome, e proseguiamo.

Al termine dell’operazione troveremo la struttura del nostro progetto leggermente cambiata, con in più una cartella /acs al cui interno troveremo salvati i file del servizio Node.ACS.

Aggiungiamo a questo punto un metodo Node.ACS, selezionando da menu la voce New -> ACS Method:

E nella finestra di dialogo dei metodi diamo al metodo il nome hello_htmlit.

Una volta creato il metodo, nel file \acs\html_it-helloacs\config.json vedremo che è stata aggiunto un nuovo percorso all’array routes:

{
    "path": "/hello_htmlit",
    "method": "get",
    "callback": "services#hello_htmlit"
}

Inoltre è stato definito un handler chiamato hello_htmlit, salvato dentro il file /acs/html_it-helloacs/controllers/services.js:

function hello_htmlit(req, res) {
	res.send('Hello from Node.ACS');
};

Quello che adesso vogliamo fare è invocare il metodo remoto hello_htmlit e visualizzare la scritta Hello from Node.ACS nella nostra app Titanium.

Selezioniamo la voce di menu Node.ACS -> Import Node.ACS Bindings dal project explorer, ed associamo il servizio Node.ACS al file sorgente in cui vogliamo utilizzare i metodi remoti.

Nel nostro caso selezioneremo html_it-helloacs come progetto Node.ACS (finestra superiore) e alloy.js come sorgente del nostro progetto (finestra inferiore).

Al termine dell’operazione avremo un nuovo file nella cartella /lib, ma dovremo editare il file alloy.js in questo modo:

// @autogenerated:start:ti.cloud.html_it-helloacs
//var html_it-helloacs = require("ti.cloud.html_it-helloacs");
// @autogenerated:end:ti.cloud.html_it-helloacs
Alloy.Globals.service = require("ti.cloud.html_it-helloacs");

Eliminiamo la variabile html_it-helloacs (il cui nome non è valido in JavaScript) e sostituiamola con una dichiarazione differente, ma che ci permette di dare visibilità globale al modulo.

Il modulo ti.cloud.html_it-helloacs è generato automaticamente e la sua funzione è quella di incapsulare i metodi Node.ACS, permettendoci di richiamarli dalla nostra app come se fossero metodi locali.

Modifichiamo ora il controller index.js:

function doClick(e) {
	//alert($.label.text);
	Alloy.Globals.service.services_hello_htmlit({}, function(e, r) {
		alert(r);
	});
}
$.index.open();

Richiamando services_hello_htmlit non facciamo altro che chiedere alla nostra app di accedere al metodo Node.ACS che abbiamo definito in precedenza (hello_htmlit) il quale, come valore di ritorno, produce la stringa Hello from Node.ACS. Questo valore viene restituito dal parametro r e visualizzato nella finestra di alert.

L’esempio visto in questa lezione è allegato a questo articolo e disponibile su GitHub.