Creare un Web Service

Creare un Web Service con Instant Developer Foundation

Per creare un Web Service con Instant Developer Foundation occorre creare una nuova applicazione di tipo "Web Service" (comando del menu contestuale aperto sull'oggetto progetto).

Creazione di una nuova applicazione di tipo "Web Service"

Modifica del tipo di applicazione in Web Service (C# o Java)

La classe pubblica

Un Web Service Instant Developer Foundation è un'applicazione che deve contenere una ed una sola classe pubblica. Tutti i metodi pubblici di tale classe saranno pubblicati dal Web Service e potranno, quindi, essere chiamati da chiunque intenda utilizzare il Web Service. La classe pubblica può contenere anche metodi privati. Tali metodi non saranno visibili agli utilizzatori. Il Web Service può, ovviamente, contenere anche altre classi, purché queste siano private. Queste possono essere utilizzate dai metodi della classe pubblica per rispondere alle richieste giunte dalle varie applicazioni che utilizzano il Web Service.

Creazione di un'unica classe pubblica

L'icona mondo identifica l'unica classe pubblica. Tutti i metodi pubblici di questa classe saranno visibili agli utenti che intendessero utilizzare il Web Service.

Tipi di dati supportati

Con Instant Developer Foundation è possibile definire sia procedure che funzioni. I tipi di dato gestiti (sia per indicare il tipo di dato di ritorno delle funzioni che per definire il tipo di dato dei parametri delle stesse) sono quelli "base": Boolean, Int, Float, Decimal, Currency, Date, Time, DateTime e String. Non è possibile restituire classi o oggetti. L'unico oggetto che è possibile restituire è il Recordset. Quindi è possibile definire una funzione pubblica il cui tipo di dato risultato sia Recordset. Non è comunque possibile passare un Recordset come parametro ad una funzione/procedura.

Se occorre restituire un oggetto occorre restituire la rappresentazione XML dell'oggetto stesso e, quindi, indicare ad Instant Developer Foundation che la funzione restituisce il tipo di dato String. Poi, invece di restituire l'oggetto stesso, occorre restituire l'XML che descrive l'oggetto (questo può essere ottenuto creando un metodo che sia in grado di descrivere in XML l'oggetto stesso utilizzando, per esempio, le librerie XMLDocument e XMLNode disponibili in ogni progetto Instant Developer Foundation). Nella parte client (applicazione che utilizza il Web Service) occorre creare una classe analoga che contenga un metodo che sia in grado di analizzare l'XML ricevuto dalla chiamata al Web Service e "ricomporre" l'oggetto estraendone le proprietà dal documento XML ricevuto dal Web Service.

Note

Occorre definire come pubblica una ed una sola classe:

• se si tenta di rendere pubbliche più classi, Instant Developer Foundation segnala un errore;
• se non si rende pubblica nessuna classe e si avvia la compilazione dell'applicazione, Instant Developer Foundation segnala un errore.
• Il parametro di compilazione "DefaultURL" dell'applicazione Web Service, indica dove questo sarà installato (URL completo). Viene utilizzato da Instant Developer Foundation durante la compilazione dell'applicazione client che utilizza il Web Service per comunicarle dove si troverà il Web Service.