001-Cop Ioprog 109 libro 2-11-2006 17:34 Pagina 1

ioProgrammo

ANTEPRIMA: VISUAL BASIC 9.0

TUTTE LE NOVITÀ DEL LINGUAGGIO CHE VERRÀ.
FATTI TROVARE PREPARATO A MIGRARE...
VERSIONE PLUS VERSIONE STANDARD
Rivista + “Le grandi guide di ioProgrammo” n°8 a € 12,90 in più RIVISTA+LIBRO+CD €9,90 RIVISTA+CD €6,90
Anno X - N°12 (109)

PER ESPERTI E PRINCIPIANTI Poste Italiane S.p.A Spedizione in A.P. • D.L. 353/2003 (conv.in L.27/02/2004 n.46) art.1 comma 2 DCB ROMA Periodicità mensile • DICEMBRE 2006 • ANNO X, N.12 (109)
FATE IL VOSTRO
C#
CREA UN GENIO
MICROSOFT XNA GAME STUDIO • GESTIONE DELLA MEMORIA IN C++ • JAVA ECHO2 • BORLAND INTERBASE 2007• ECOMMERCE CON PAYPAL
PER GLI UTENTI
Impara a programmare
VIDEOGIOCO
i Wizard: le procedure guidate
che aiutano ad usare il software
VB.NET
ESPRESSIONI
REGOLARI
CON IL NUOVO XNA GAME STUDIO DI MICROSOFT Ecco il trovatutto che scova
programmare il tuo sparatutto personale diventa le stringhe nascoste
nel testo in un battibaleno
veramente esageratamente semplice! ASP.NET
STRUMENTI JAVASCRIPT E .NET
Non sono la coppia più
Installiamo il software necessario bella del mondo, ma noi
li mettiamo d’accordo
e integriamolo con Visual Studio
ECOMMERCE
TEORIA CON PAYPAL
Sviluppa un intero sistema
Struttura di un’applicazione. di commercio elettronico
Ecco le classi fondamentali spendendo poco o niente
ed il loro funzionamento
TO JAVA
TUTD E
IL CO IC IL CODICE DEL
PRATICA nel CD
La guida passo passo per GIOCO IN BORSA
Prendi le informazioni
realizzare il primo game 2D. dalla rete, mettile in un DB
e il gioco è fatto
Le basi per iniziare a muoversi
nella terza dimensione VISUAL BASIC
PERSONALIZZA
IL TUO AMBIENTE
SOFTWARE “SICURO”? Migliora l’IDE e automatizzalo
con le funzioni che servono a te
ESTENDI SQL SERVER
FACCIAMOLO CON C++
10 “linee guida” per gestire bene la memoria ed evitare
Usa Visual Basic 6 con il tuo
database preferito e inoltre
rendilo più potente
bug che possono dare origini a Exploit e Virus
OVERVIEW
ASP.NET JAVA Borland
GESTIAMO LE REPORT AJAX? WEB 2.0 INTERBASE
MAILING LIST NO PROBLEM SÌ FATICA NO 2007 veloce, più
Più sicuro, piùmai. Ti diciamo
Dall’iscrizione all’invio della Svincoliamoci dai programmi Arriva Echo2 il framework moderno che va versione
tutto sulla nuofatto la storia
posta. Creiamo una web commerciali. Ecco il codice che ti porta nella nuova rete del DB che ha
application che fa tutto che azzera le spese senza farti impazzire

EDIZIONI MASTER
SOLUZIONI: PROGRAMMA CON GLI ALGORITMI GENETICI
UN ROBOT INTELLIGENTE CHE SVILUPPA AL POSTO TUO www.edmaster.it
058-063 31/10/06 11:14 Pagina 58

ioProgrammo Web
Soluzioni per il commercio elettronico

PAGAMENTI ONLINE:
FACILE CON PAYPAL
IN UN SITO DI E-COMMERCE L’IMPLEMENTAZIONE DI UN MECCANISMO DI PAGAMENTO
È UNO DEI PASSI CRUCIALI. TRA LE TANTE SOLUZIONI OFFERTE DAGLI ISTITUTI DI CREDITO
ESAMINIAMO PAYPAL. VEDREMO COME SVILUPPARE UNA SOLUZIONE CON .NET

D
a una parte ci siamo noi, per usare il
termine tecnico il merchant, ovvero la
nostra applicazione di E-Commerce
dall’altra c’è un’applicazione residente nell’i-
stituto di credito che contabilizza il pagamen-
to della merce venduta nel nostro sito; sono
due scenari paralleli che entrano in relazione
attraverso un sistema di Payment Gateway.
J CD J WEB Tutto quanto riguarda il passaggio e l’accredito
Paypal SDK.net Reloaded.rar di contante non può risiedere nel database
cdrom.ioprogrammo.it
della nostra applicazione ma deve, necessaria-
mente, essere collocato altrove, ovvero in
un’applicazione parallela sviluppato ad hoc
nell’ambito di un istituto di credito; Il nome in
codice di questo software è Payment Gateway
e, per intenderci, funziona come esposto nella
Fig.1.
bisogna interagire con la soluzione offerta da
un istituto di credito che, in linea di massima,
ripete lo schema appena esposto.
Scendendo nei dettagli, programmare una
soluzione di Payment Gateway significa pro-
grammare i messaggi che intercorrono tra la
nostra applicazione e quella residente nell’isti-
tuto di credito che, internamente, per quanto
ci riguarda, rimane una sorta di scatola nera; In
questo articolo svisceriamo il Payment
Gateway offerto da Paypal nell’inedito porting
verso .net 2.
PAYPAL VISTO DA VICINO
Abbiamo chiarito, in linea di massima, il funziona-
mento di un sistema di Payment Gateway;
La Fig. 2 illustra specificatamente quello implemen-
tato in Paypal

Fig. 1: Schema del funzionamento di di un sistema

di pagamento
REQUISITI
Banca Sella, PaschiInCommerce, TELEPay
Conoscenze richieste Light, OmniPay, Bank Pass, il nostro Paypal ed Fig. 2: Architettura del sistema di payment di Paypal
piattaforma asp.NET
altri ancora offrono soluzioni di Payment
Software
Gateway che, per formalizzare il pagamento, Analizzando la la figura scopriamo che i messag-
Visual Web Developer rimandano ad una serie di Form collocati nel gi che intercorrono tra la nostra applicazione e
Express o Visual Studio 2005
server dell’istituto di credito oppure, più rara- Paypal viaggiano sul canale cifrato del protocollo
Impegno
mente, inviano gli estremi del pagamento da HTTPS e sono descritti utilizzando Web Services
¥ un Form residente nella nostra applicazione. ed i relativi messaggi SOAP;
Tempo di realizzazione
Ogni volta quindi che si tratta di implementare Per familiarizzare con la programmazione delle
un meccanismo di pagamento elettronico API che sottendono a questi messaggi SOAP

h t t p : / / w w w. i o p r o g r a m m o . i t
G 58 /Dicembre 2006
058-063 31/10/06 11:14 Pagina 59
Soluzioni per il commercio elettronico
Paypal mette a disposizione Kit di sviluppo dedi-
cati alle tecnologie PHP, Java, Classic ASP, ed
appunto .NET. Ufficialmente non è ancora
implementata una soluzione .NET 2 e quella
offerta per la “vecchia”’ release è disponibile solo
per C#; Nella ‘scatola degli attrezzi’ allegata
all’articolo, sono disponibili i porting per VB.net
e .NET 2, anzi sarà proprio su quest’ultima che ci
rifaremo per gli esempi dell’articolo; nella prima
pagina del SDK dobbiamo specificare se utilizze-
remo il certificato allegato oppure se desideria-
mo usarne uno di nostra creazione. Dopo la sele-
zione saremo inviati ad una pagina i cui collega-
menti ipertestuali riassumono tutte le possibilità
di programmazione delle API, ovvero tutti i pos-
sibili scenari di pagamento elettronico disponi-
bili in Paypal; Scopriamole insieme
USIAMO L’API
DODIRECTPAYMENT
Come allude il nome stesso questa API si occupa
di gestire il pagamento della merce direttamente
da una pagina collocata nel nostro sito;
La API mette in gioco il metodo DoDirect
PaymentRequestType per inviare i dati relativi
all’acquisto (carta di credito, IP dell’acquirente,
tipologia della merce, etc) e gestisce la risposta
attraverso DoDirectPaymentResponseType che ci
fornisce dati sull’esito della transazione, ID
Paypal della stessa, verifica della carta di credito
etc Questa API è disponibile solo per il mercato
statunitense, ed è anche quella di più facile
implementazione. Dando una occhiata al codice
della pagina DoDirectPayment non possiamo
non notare
Imports com.paypal.soap.api
ovvero l’esplicito riferimento alla libreria Paypal
E, all’interno della Sub relativa al pulsante di paga-
mento
Protected Sub PayButton_Click(ByVal sender As
Object, ByVal e As EventArgs)
Dim api As PayPalAPI = New PayPalAPI()
Me.PayPalResponse = api.DoDirectPayment(parametri
ricevuti dai campi del Form)
End Sub
Gli altri mercati, compreso quello italiano, pos-
sono comunque utilizzare le API per Express
Checkout e per l'interrogazione dello storico
delle transazioni.
h t t p : / / w w w. i o p r o g r a m m o . i t

ioProgrammo Web
FACCIAMOLO CON
EXPRESSCHECKOUT
La transazione effettuata con ExpressCheckout parte
dalla nostra applicazione, viene perfezionata nel
server di Paypal e termina tornando nel nostro sito;
In breve:
1. il nostro cliente, già iscritto a Paypal, nell’ambito
della nostra applicazione, dopo aver scelto i suoi
acquisti, va in una pagina che riassume l’ammon-
tare della spesa e preme il bottone “Express
Checkout”
2. viene reindirizzato al sito Paypal nel quale, dopo
essersi autenticato, rivede l’indirizzo al quale spe-
dire la merce e seleziona il metodo di pagamento,
al termine, viene diretto ancora al nostro sito
attraverso la pressione del pulsante “Continue
Checkout”
3. nella nostra applicazione controlla l’ordine e lo
conferma utilizzando il bottone “Place order”
I tre passi che abbiamo descritto sopra prendono il
nome di Integration Point. Nel primo Integration
Point quando il cliente, preme il bottone ‘Express
CheckOut’ dietro le quinte viene innescato il mes-
saggio SOAP SetExpressCheckout Request verso
Paypal, con i parametri OrderTotal, ReturnURL,
CancelURL ed altri opzionali come il MaxAmount;
Paypal risponde con SetExpressCheckoutResponse
che aggiunge sotto forma di coppia nome/valore il
PayerId ed un token, ovvero una codice identificati-
vo alfanumerico. A questo punto il browser del
cliente viene reindirizzato al server Paypal passando
sotto forma di stringa d’interrogazione il token rice-
vuto
https://www.paypal.com/cgi-bin/webscr?cmd=_express-
checkout&token=ValoreDelToken
nel server Paypal, dopo il login, è necessario specifi-
care l’indirizzo al quale inviare la merce e le moda-
lità di pagamento, nel medesimo tempo dal client
parte il messaggio SOAP GetExpressCheckout
DetailsRequest che richiede al server Paypal le infor-
mazioni relative all’indirizzo ed alla carta di credito
gestite dal messaggio SOAP GetExpressCheckout
DetailsResponse con i relativi parametri PayerID,
email address, shipping address specificati in prece-
denza dall’utente. Se il cliente preme il bottone
“Continue Checkout” viene rimandato alla nostra
applicazione all’indirizzo specificato nel parametro
ReturnURL che abbiamo visto precedentemente-
A questo punto incontriamo il secondo Integration
Point. Questa pagina, nome in codice ‘Order
Review’, elenca al cliente i dati del suo acquisto e,
una volta premuto il bottone ‘Confirm Order’, invia il
messaggio SOAP DoExpressCheckoutPayment
Request con i parametri Token, OrderTotal,
Dicembre 2006/ 59 G
058-063 31/10/06 11:14 Pagina 60
ioProgrammo Web
Soluzioni per il commercio elettronico
PaymentAction e PayerID che provengono dal pre-
cedente GetExpress CheckoutDetailsResponse.
Il server Paypal risponde con GetExpressCheckout
DetailsResponse che include il TransactionID ed altri
elementi. Il cliente, finalmente, riceve una mail con
i dati di conferma dell’acquisto; Quest’ultimo passo
costituisce il terzo Integration Poin.
Per quanto riguarda il codice della relativa pagina
ExpressCheckout nel SDK
Protected Sub CheckoutButton_Click(ByVal sender As
Object, ByVal e As EventArgs)
Me.PaymentAction = codice che controlla il tipo
di pagamento a seconda del
parametro passato dalla query string
End Sub
È necessario mettere a fuoco il metodo
PaymentAction che innescherà il processo di paga-
mento ExpressCheckout appena descritto, ma con
significative differenze se il parametro passato dalla
stringa di interrogazione sia Sale, Authorization
oppure Order; Sale indica che il pagamento viene
concluso immediatamente, mentre viene differito
se il parametro è Authorization oppure Order;
AUTHORIZATION
& CAPTURE
Paypal prevede anche uno scenario di pagamento
maggiormente flessibile, per intenderci immaginia-
mo di realizzare un sito di E-Commerce con merci
da esportare in un altro paese.
Esistono fattori variabili, come il cambio della valu-
ta, le spese di trasporto, l’eventuale indisponibilità
del prodotto venduto ed altri ancora che “svalute-
rebbero”, dopo un breve periodo di tempo, il prezzo
fissato per l’acquisto.
Per ovviare a tutto questo Paypal ha previsto una
tipologia di pagamento in cui il cliente ha la possibi-
lità di ordinare la merce ed il venditore, in un secon-
do tempo, ha la facoltà di formalizzare l’acquisto
ordinando il pagamento;
‘Authorization Period’ e' l'arco di tempo, fissato in
29 giorni, nel quale il venditore ha la facoltà di
riscuotere il prezzo pattuito per l’acquisto (o parte
dello stesso) dal conto PayPal o dalla carta di credi-
to del cliente. Per “Honor Period” si intende il rinno-
vo dell’Authorization Period’ nel quale PayPal
garantisce al venditore che la somma stabilita per
una transazione potrà ancora essere "catturato";
L’’Honor Period’ e' fissato in 3 giorni, scaduti i quali
PayPal non garantisce, pur facendo tutto il possibi-
le, che recupererà il danaro dal cliente.
Quest< eventualità è stata prevista per cautelarsi
G 60 /Dicembre 2006
verso acquirenti malintenzionati che, dopo aver
effettuato un acquisto, bloccano il trasferimento di
fondi dalla loro carta di credito o altro. Esiste anche
la possibilità di annullare o rimborsare il pagamen-
to. Concretamente, tutto questo viene implementa-
to nelle pagine omonime del SDK
DoAuthorization
DoCapture
DoVoid
Nel dettaglio, se guardiamo il Code Behind della
pagina DoAuthorization, ovvero della pagina nella
quale il cliente opziona una merce
Imports com.paypal.soap.api
Public Sub SubmitButton_Click(ByVal sender As
Object, ByVal e As EventArgs)
Dim api As PayPalAPI = New PayPalAPI()
Me.PayPalResponse = api.DoAuthorization(parametri
ricevuti dai campi delWebForm)
End Sub
ritroviamo la linea di codice che importa la libreria
delle API Paypal, la creazione di una nuova API
Paypal ed il metodo DoAuthorization() che innesca
il tipo di pagamento flessibile appena esposto;
Se diamo un’occhiata al relativo messaggio SOAP
trasmesso scopriamo l’elemento
L’esito di questa transazione è gestito, in maniera
non molto intuitiva, nella pagina Authorization
Response dal metodo DoAuthorizationResponse
Type
Protected ReadOnly Property Result() As
DoAuthorizationResponseType
Get
Return CType(Me.PayPalResponse,
DoAuthorizationResponseType)
End Get
End Property
Public Overrides Sub DataBind()
If Me.IsTransactionSuccessful
Then
MyBase.DataBind ()
End If
End Sub
Il codice essenziale della pagina nella quale il mer-
chant gestisce la riscossione del prezzo è
Imports com.paypal.soap.api
h t t p : / / w w w. i o p r o g r a m m o . i t
058-063 31/10/06 11:14 Pagina 61

Soluzioni per il commercio elettronico
ioProgrammo Web

Public Sub SubmitButton_Click(ByVal sender As Me.Session(Constants.TRANSACTION_SEARCH_

Object, ByVal e As EventArgs)
Dim api As PayPalAPI = New
PayPalAPI()
Me.PayPalResponse =
api.DoCapture()
End Sub
ed, ormai, dovrebbe essere facilmente comprensi-
bile; per quanto riguarda l’annullamento dell’ordi-
ne scopriamo il metodo DoVoid
Public Sub SubmitButton_Click(ByVal sender As
Object, ByVal e As EventArgs)
Dim api As PayPalAPI = New PayPalAPI()
Me.PayPalResponse =
api.DoVoid(parametri ricevuti dai campi del
WebForm)
End Sub
SESSION_KEY) = api.
TransactionSearch(startDate, endDate)
End Sub
che, con il metodo TransactionSearch(), effettua la
ricerca nello spazio circoscritto di due date;
viene innescato poi un redirect nella pagina
TransactionSearchResults:
se leggiamo il Code Behind di questa pagina sco-
priamo che viene creata una proprietà:
PaypalResponse dalla API TransactionSearch
ResponseType referenziata dalla session ripresa
dalla pagina TransactionSearch vista prima
Protected ReadOnly Property PayPalResponse() As
TransactionSearchResponseType Get
Return
CType(Me.Session(Constants.TRANSACTION_SEARCH
_SESSION_KEY), TransactionSearchResponseType)
End Get

il cui esito viene gestito nella pagina End Property

DoVoidResponse attraverso le proprietà di
AckCodeType nel codice della Webform scopriamo un repeater
che viene popolato dalle varie proprietà di PayPal
Private Sub Page_Load(ByVal sender As Object, Response: PaymentTransactions, TransactionID,
ByVal e As EventArgs Timestamp, Status, etc.

Me.VoidSuccessfulLiteral.Visible =
Me.PayPalResponse.Ack = AckCodeType.Success
OrElse Me.PayPalResponse.Ack = UN CASO CONCRETO
AckCodeType.SuccessWithWarning Chiarendo il funzionamento del SDK abbiamo
compreso le funzionalità di base che caratterizzano
End Sub di Paypal. Ora è venuto il momento di mettere a
fuoco l’attenzione su casi concreti.
Nota che anche la pagina dedicata al Nel paragrafo precedente abbiamo visto degli
DoDirectPayment Authorization si riferisce al tipo esempi a ‘basso livello’, dedicati alla program-
di pagamento differito Authorization & Capture mazione delle API, ma le soluzioni migliori che
Paypal offre sono semplici pezzi di codice
HTML, creati al volo raccogliendo i dati che
immettiamo in Form dedicati, pronti per essere
CONSULTARE LO STORICO ‘copiati & incollati’ nella nostra applicazione;
DELLE TRANSAZIONI per intendersi i tipici pulsanti:‘Paga adesso’,
Per finire è possibile effettuare una ricerca tra le ‘Carrello PayPal’, ‘Donazione’ed altri sono realiz-
transazioni effettuate con Paypal partendo dalla zati proprio in questo modo: tra queste soluzio-
pagina TransactionSearch ni ve ne una che è discretamente diffusa ma che
non viene mai trattata adeguatamente…
Protected Sub SearchButton_Click(ByVal sender As Immaginate un sito web nel quale è possibile
Object, ByVal e As EventArgs) prendere visione, dietro pagamento, di alcune
sezioni private del sito, ma solo per un determi-
Dim api As PayPalAPI = New PayPalAPI() nato periodo di tempo; si tratta di uno scenario
Dim startDate As DateTime = (parametri ricevuti dai tipico che Paypal risolve con una tecnica deno-
campi del WebForm) minata di “Subscriptions and Recurring
Dim endDate As DateTime =(parametri ricevuti dai Payments”. Per implementarla è appunto suffi-
campi del WebForm) ciente copiare ed incollare il codice HTML gene-
rato dal sito Paypal;

h t t p : / / w w w. i o p r o g r a m m o . i t
Dicembre 2006/ 61 G
058-063 31/10/06 11:14 Pagina 62
ioProgrammo Web
Soluzioni per il commercio elettronico
Mentre vi rimando alla documentazione uffi-
ciale per una informazione più dettagliata è
comunque utile dare un’occhiata a questo
codice
<form action=”https://www.paypal.com/cgi-
bin/webscr” method=”post”>
<input type=”hidden” name=”cmd” value=”_xclick-
subscriptions”>
<input type=”hidden” name=”business” value=”mail
dell’account Paypal del Merchant“>
<input type=”hidden” name=”item_name”
value=”Nome della sottoscrizione”>
<input type=”hidden” name=”item_number”
value=”Identificativo numerico
della sottoscrizione”>
<input type=”hidden” name=”image_url”
value=”URL del proprio logo da conservarsi in un
server https per evitare il messaggio “La pagina
contiene oggetti protetti e non protetti” “>
<input type=”hidden” name=”no_shipping”
value=”1”>
<input type=”hidden” name=”return”
value=”URL della pagina del proprio sito alla quale
andare dopo la conclusione positiva
dell’abbonamento“>
<input type=”hidden” name=”cancel_return”
value=”URL della pagina del proprio sito alla quale
andare qualora venga interrotta la procedura di
abbonamento da parte dell’utente”>
<!-- Parametri omessi relativi alla durata
dell’abbonamento, alla rateizzazione,
al rinnovo, etc.
-->
<input type=”hidden” name=”custom” value=”è
possible impostare parametri personalizzati”>
</form>
Naturalmente, durante la procedura di genera-
zione del codice HTML, è possibile cifrare tutti
questi parametri utilizzando il formato PKCS7
che è, tipicamente, quello utilizzato per la crit-
tografia della posta elettronica.
Per gestire la risposta che Paypal invia verso la
nostra applicazione al termine della procedura
di “Subscriptions and Recurring Payments”,
ovvero l’esito positivo dell’abbonamento, la
scadenza, la revoca e quant’altro, è possibile
utilizzare Istant Payment Notification (IPN);
per intendersi IPN è una risposta che il server
Paypal invia ad una pagina dedicata nella
nostra applicazione allo scopo di innescare le
opportune operazioni di Back End, ovvero nel
caso preso in esame, l’iscrizione dell’utente
che ha pagato nel nostro database.
Scendendo nel dettaglio per implementare IPN
è sufficiente accedere al proprio account
G 62 /Dicembre 2006
Business o Premier nel sito Paypal e, nel pro-
prio profilo, selezionare ‘Modifica’ dalla sezio-
ne ‘Preferenze per Notifica immediata del
pagamento’ specificando poi l’indirizzo della
pagina nella nostra applicazione al quale
Paypal invierà il messaggio IPN ( nota che il
nome in codice di questo url è ‘URL di notifi-
ca’).
In alternativa, per i più smanettoni, è possibile
aggiungere manualmente il campo notify_url
nel codice HTML del nostro bottone specifi-
cando l’ url dello script che gestisce IPN.
Una volta ricevuto il messaggio IPN la nostra
applicazione, per evitare tentativi di truffa,
deve inviare una risposta al server Paypal;
Il nome in codice di questa risposta è ‘convali-
da della notifica’ e può venire realizzata
• attraverso l’invio di una ‘password condivisa’
utilizzando una query string in un server SSL
(ad esempio
https://www.miosito.com/UrlDiNotifica.
aspx?password=pippo)
• inviando un post
per motivi di brevità, ed anche di comodità,
considerando la relatività difficoltà ed i costi
nell’utilizzare un server SSL, analizziamo solo
l’opzione che richiede l’invio del post.
In breve se volessimo creare un sito che offre
contenuti a pagamento per i propri utenti uti-
lizzando Paypal dovremmo
1. installare nella nostra applicazione il codice
del bottone che innesca la procedura di
“Subscriptions”, copiato & incollato da
Paypal
2. Creare una pagina che registri i nostri uten-
ti nel database una volta che l’IPN ricevuto
da Paypal e la successiva ‘convalida della
notifica’ abbiano avuto un esito positivo;Nel
dettaglio una pagina del genere potrebbe
essere
Imports System.Net
Imports System.IO
Imports System.Text
Imports System.Web.Mail
Imports System.Collections.Specialized
Public Class SB_IPN
Inherits System.Web.UI.Page
Private Sub Page_Load(ByVal sender As
System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
'Put user code to initialize the page here
Dim strFormValues As String =
Request.Form.ToString()
h t t p : / / w w w. i o p r o g r a m m o . i t
058-063 31/10/06 11:14 Pagina 63

Soluzioni per il commercio elettronico
ioProgrammo Web

Dim strNewValue AggiornaDatabase()

Else’ INVALID qualcosa

' Crea la NOTIFICA DELLA CONVALIDA ' non ha funzionato…
Dim req As HttpWebRequest = ' Gestisci il problema
CType(WebRequest.Create("https://www.
sandbox.paypal.com/cgi-bin/webscr"), _ TroubleShooting()
HttpWebRequest)
End Sub
' imposta i valori per la
' NOTIFICA DELLA CONVALIDA Sub AggiornamentoDatabase()
req.Method = "POST"
req.ContentType = "application/x-www-form- ‘codice per l’inserimento del database
urlencoded"
strNewValue = strFormValues + End Sub
"&cmd=_notify-validate"
req.ContentLength = strNewValue.Length Sub TroubleShooting()

Dim stOut As StreamWriter = New ‘codice per la gestione dell’errore

StreamWriter(req.GetRequestStream(), _
Encoding.ASCII) End Sub
stOut.Write(strNewValue) End Class
stOut.Close()
nota che questo codice, che opportunamente
'Inviata la notifica di convalida, adattato, è stato generato da un sito web pay-
'leggi il risultato paltech.com che offre soluzioni per la maggior
parte delle funzionalità di Paypal.
Dim strResponse As HttpWebResponse = Per concludere questo paragrafo dedicato
CType(req.GetResponse(), HttpWebResponse) all’analisi dei casi concreti vi ricordo che per
Dim IPNResponseStream As Stream = .NET 2 esiste uno Starter Kit con funzionalità di
strResponse.GetResponseStream sito di E-Commerce al quale vi rimando
Dim encode As Encoding = senz’altro se volete vedere in azione un carrel-
System.Text.Encoding.GetEncoding("utf-8") lo pronto da ‘copiare & incollare’ nelle vostre
Dim readStream As New applicazioni;
StreamReader(IPNResponseStream, encode) Non solo nel codice allegato all’articolo trove-
rete uno Starter Kit rilasciato proprio da Paypal
nel quale rivedere ancora le funzionalità
Dim read(256) As [Char] descritte.
' Reads 256 characters at a time.

Dim count As Integer =

readStream.Read(read, 0, 256) CONCLUSIONI
Le basi di Paypal che abbiamo analizzato in
While count > 0 questo lungo articolo sono disperse nella
' Dumps the 256 characters monumentale documentazione fornita nel sito
' to a string and displays the Paypal in tanti file .pdf che richiedono anche
' string to the console. un non banale sforzo di traduzione; il mio
Dim IPNResponse As New [String](read, 0, lavoro deve essere inteso come un colpo d’oc-
count) chio per iniziare a lavorare con questa utilissi-
count = readStream.Read(read, 0, 256) ma piattaforma. Tuttavia le API esposte da
paypal restano eccezionalmente semplici. Il
' Se la risposta alla 3 sistema di ssicurezza esposto da paypal inol-
' di convalida è VERIFIED tre è uno dei più affidabili attualmente sul
' tutto OK mercato. Se non volete spendere denaro in
' effettua l’aggiornamento del Database sistemi di POS elettronico Paypal è un’ottima
soluzione
If IPNResponse = "VERIFIED" Then
Luigi Corrias

h t t p : / / w w w. i o p r o g r a m m o . i t
Dicembre 2006/ 63 G
 SPECIALE MACCHINE VIRTUALI
ioProgrammo

ECCO COME RISPARMIARE SULL'HARDWARE ED AVERE SEMPRE

A DISPOSIZIONE MOLTI PC SU CUI EFFETTUARE I TEST
VERSIONE PLUS VERSIONE STANDARD
RIVISTA+LIBRO+CD 9,90 RIVISTA+CD 6,90
Anno XI - N°10 (119)

PER ESPERTI E PRINCIPIANTI Poste Italiane S.p.A Spedizione in A.P. • D.L. 353/2003 (conv.in L.27/02/2004 n.46) art.1 comma 2 DCB ROMA Periodicità mensile • OTTOBRE
APRILE 2007 • ANNO
2007 • ANNO
XI XI,
• N.4
N.10
(113)
(119)
IL TUO CODICE SU SECOND LIFE • PROGRAMMA IL TUO ROBOT • TRACCE ISO DAI NOSTRI PROGRAMMI • EFFETTI SPECIALI NELLE APPLICAZIONI
Il tuo codice su XPS
ICROSOFT
L'ALTERNATIVA MF
AL PD
ificare
Ecco come mod ni affinché
le tue applicaozioil nuovo
supportin
formato!
.NET
DAI UNA CACHE
AL TUO SOFTWARE
Crea, sviluppa e vendi Quando i dati sono tanti,
ecco le tecniche per ottenere
gli oggetti che popolano comunque prestazioni elevate
GRANDE FRATELLO
l'universo digitale CON IL GPS
Ricevi le coordinate e mostra
LE BASI usa subito il Linden la posizione dell'apparecchio
Scripting Language e l'ambiente su una mappa di Google
di sviluppo JAVASCRIPT
HELLO WORLD disegna il tuo FRAME NASCOSTI
primo oggetto e fallo parlare QUASI COME AJAX
Sfrutta gli Hidden frame. Ottimizza
quando lo tocchi con il mouse il caricamento delle pagine ed aggira
il problema del reload
IL MOVIMENTO fai spostare
le tue creazioni, seguendo
fedelmente le leggi della fisica CORSI BASE
EFFETTI COMPOSTI metti insieme • WxWidgets
Il posizionamento
più oggetti e animali in sincronia dei controlli
• PocketPC
PROGRAMMA IL TUO ROBOT
Con Microsoft Studio Robotics bastano pochi click di mouse per progettare
Programmazione
degli Smartphone
un sistema completo e simularne il comportamento prima di assemblare i pezzi • Java Server Faces
Gestione dei dati
.NET JAVA JAVASCRIPT attraverso JDBC
TRACCE ISO DAI EFFETTI SPECIALI TRASFORMAZIONI • UML Cosa sono
NOSTRI PROGRAMMI PER LE APPLICAZIONI XSLT LATO SERVER e come funzionano
Leggi e crea i dati in formato CD Crea interfacce grafiche Stessi dati, output diverso. i diagrammi di stato
o DVD direttamente dal tuo software sofisticate con le Swing Bug Basta cambiare pochi parametri

EDIZIONI MASTER
SOLUZIONI ALGORITMI DI SCHEDULING: QUANDO VUOI
PROGRAMMARE UNA SERIE DI ATTIVITÀ CI SONO MOLTE POSSIBILI
SOLUZIONI, ECCO QUELLE PIÙ EFFICACI www.edmaster.it
001-iop119.indd 1 3-09-2007 18:29:26
024-029:072-080 31-08-2007 15:52 Pagina 24

SISTEMA
Introduzione a Visual Robotics Studio

CREA IL TUO ROBOT

A COLPI DI CLICK
MICROSOFT HA APPENA PRESENTATO IL SUO “VISUAL STUDIO ROBOTICS”, IL PRIMO
AMBIENTE RAD E VISUALE PER LO SVILUPPO RAPIDO DI APPLICAZIONI DESTINATE
ALL’AUTOMAZIONE ROBOTICA. ECCO COME INSTALLARLO E USARLO FACILMENTE

T
utto nasce da un articolo di Bill Gates sul-
l’autorevole rivista americana Science inti-
tolato “A robot in every home”…
Il Chief Architect di Microsoft racconta che, negli ul-
timi anni, in occasione di visite alle principali Uni-
versità americane, tra i progetti che gli venivano
presentati, ve ne era costantemente almeno uno
dedicato all’automazione ed alla robotica…
J CD J WEB Bill Gates ha riflettuto su tutto questo e con un au-
VisualRoboticsStudio.rar
dace volo di fantasia ha ritrovato delle somiglian-
ze tra l’attuale scenario della cibernetica e quello del-
cdrom.ioprogrammo.it l’informatica, all’epoca in cui lui e Steve Allen muo-
vevano i primi passi…
Per essere protagonista anche di questa rivoluzio- Figura 1: L’ambiente di programmazione di Visual
ne prossima ventura ha promosso il rilascio una Studio Robotics
serie di software adeguati alla programmazione
dei Robot;
Visual Robotics Studio è appunto l’ambiente di
programmazione che Microsoft dedica alla ciber- SERVICES
netica; Evidenziata in rosso troviamo la finestra Services;
Il colosso di Redmond ha seguito una filosofia di è un elenco di ‘pezzi di Robot’:
sviluppo analoga a quella già implementata con scorrendoli scopriamo oggetti come i mattoncini
l’XBox, assemblando in maniera originale tecnologie LEGO MindStorm e Fishertechnics, joystick per vi-
che Microsoft conosce bene; deogiochi, ma anche hardware semi professiona-
il risultato è una specie di Visual Basic che al po- le come il MobileRobot Pioneer fabbricato da Mo-
sto della tipica toolbox riunisce, come in una ca- bileRobots od i componentistica della Parallax;
tena di montaggio, pezzi di robot mettendo in gio- questi ‘pezzi di Robot’, o per essere tecnici ‘Services’,
co anche i web services, uno dei cavalli di batta- rappresentano l’hardware ai quali fanno riferi-
glia della prima release di .net, e XNA il Kit di svi- mento, ne avvolgono la complessità e la astraggo-
REQUISITI
luppo dedicato ai videogiochi della XBox 360°, etc no, rendendola trasparente allo sviluppatore;
Vediamo nel dettaglio come lavora questo All Star per iniziare a lavorare con i Services non abbiamo
Conoscenze richieste
Conoscenza degli Team che da clickarvi sopra e trascinarli nella finestra
ambienti di centrale Diagram, evidenziata in blu;
programmazione
Microsoft .net è inevitabile notare le somiglianze con i tipici am-
Software
bienti di sviluppo di Microsoft:
Microsoft Robotics VISUAL PROGRAMMING clickare sopra un servizio e trascinarlo nella fine-
Studio 1, .NET
Framework 3, Visual LANGUAGE stra Diagrams è una procedura analoga alla crea-
Studio 2005 o Kit Il primo Tool che prendiamo in esame si chiama zione di pulsanti, Textbox, eccetera, nelle WebForm
Visual Express C# o
VB.net ad libitum Visual Programming Language; e WindowsForm, ovvero un paradigma di pro-
attraverso una interfaccia grafica, che funziona co- grammazione presente sin dalla primissima re-
Impegno
me una lavagna, disegniamo una sorta di catena lease di Visual Basic!
¥ di montaggio che collega e fa funzionare i diversi com- Non solo…
Tempo di realizzazione
ponenti di una automazione; Le specifiche dei “Pezzi di Robot” sono descritte
L’ambiente grafico è raffigurato in Fig 1: in file Manifest, ovvero in file di configurazione in

h t t p : / / w w w. i o p r o g r a m m o . i t
G 24 /Ottobre 2007
024-029:072-080 31-08-2007 15:52 Pagina 25

Introduzione a Visual Robotics Studio
SISTEMA

formato XML; di automazione descritto in un diagramma i una

i file Manifest sono forniti principalmente dai fab-
bricanti di Robot e, con l’andare del tempo, Mi-
crosoft conta di coprire ogni tipo di Hardware di-
sponibile; I Services, con i relativi file Manifest, for-
niti dai fabbricanti di hardware ci ricordano senza
dubbio i vari componenti sviluppati da terze par-
ti disponibili per Visual Studio.
‘Activity’; l’Activity viene compilata selezionan-
do la voce Run dai menù a tendina (cfr. Fig. 2 e di-
dascalia)
G Comment Inserisce un commento esplicativo
al flusso di automazione; non influenza il pro-
gramma ma lo chiarisce ai nostri occhi
Per finire, a sinistra del tool VPL troviamo le finestre

Project
BASIC ACTIVITIES che, in maniera analoga alla finestra Project di Vi-
Una volta disposti i ‘pezzi di robot’, o per usare il sual Studio, ci consente di impostare il nome del
termine tecnico i Services, è necessario fornirgli Diagramma, di aggiungere oppure o cancellare un
delle istruzioni e farli dialogare tra loro; diagramma
le istruzioni vengono allocate e manipolate attra-
verso una serie di oggetti denominati “Basic Acti- Properties
vities” disponibili nella finestra evidenziata in ver- che consente, in maniera analoga alla finestra Pro-
de. Le Basic Activities sono rappresentate grafica- perties di Visual Studio, di impostare le proprietà del-
mente attraverso ‘quadratini’ con segmenti verdi sui l’oggetto Services oppure Activity selezionato.
lati sinistro e destro; il nome in codice di questi
segmenti verdi è ‘pin activities’; nel diagramma
della nostra automazione i dati che ‘rendono elet- IL PROGETTO D’ESEMPIO
trici’ i vari Services entrano nel pin posto a sini-
stra del ‘quadratino’ ed escono, dopo essere stati Questo è il diagramma, basato su negativo Le ruote sono fissate ad
elaborati ed instradati, dal pin posto a destra; quelli allegati all’articolo che un asse e ruotano a sinistra ed a
ogni finestra “Basic Activities” possiede Wizard di implementa l’automazione di un destra se una è spinta verso un
configurazione per impostare semplicemente le robot comandato da un Joystick; valore positivo e l'altra è spinta
sono messe in gioco tutte le Basic verso un valore negativo equiva-
sue proprietà; Vediamo le varie ‘Basic Activities’ Activities di cui abbiamo parlato e lente o viceversa.
nel dettaglio diversi Services i cui file Manifest Nota il Services di tipo Activity
supportano il Simulatore; In breve che incapsula tutto il flusso di
G Variabile Crea una variabile e la tipizza; le va- l’automazione funziona in questo Automazione del nostro
riabili sono tipizzate attraverso i medesimi tipi pre- modo: durante la simulazione, se Diagramma ed i vari commenti
premi il bottone Stop, le ruote esplicativi. Il disegno, o per usare
visti in C# (cfr. Box dedicato) non ricevono dati e si fermano se il termine tecnico, il diagramma
G Data Alloca i dati della nostra automazione in spingi la leva avanti le ruote sono che creiamo ricorda concettual-
variabili (ad esempio inserisce “Hello World” in spinte in avanti grazie a dati di mente un diagramma UML oppu-
una variabile di tipo String ) valore positivose spingi la leva re anche ad tipico diagramma di
G List Crea e tipizza una serie di dati (nota che è indietro le ruote sono spinte flusso ma non coincide affatto
indietro grazie a dati di valore con questi formalismi
possibile creare una lista di dati anche con ‘Va-
riable’)
G List Functions Consente di modificare un List
pre esistente
G Calcolate Consente di sommare, sottrarre divi-
dere o moltiplicare variabili numeriche oppure
di concatenare stringhe
G If Questa Activity, in maniera analoga ad un tipico
ciclo condizionale If/ Else, sposta il flusso del-
l’automazione verificando se una condizione è
vera oppure è falsa
G Switch In maniera analoga all’Activity sposta il flus-
so dell’automazione ma a differenza di questo
smista il flusso confrontando il messaggio in in-
gresso con un valore impostato dallo sviluppatore
G Merge ‘Fonde’ semplicemente tra loro due o più
flussi di automazione
G Join Unisce due o più flussi di automazione dan-
do ad ognuno di questi uno specifico nome
G Activity È possibile racchiudere l’intero flusso

h t t p : / / w w w. i o p r o g r a m m o . i t
Ottobre 2007/ 25 G
024-029:072-080 31-08-2007 15:52 Pagina 26
SISTEMA
Introduzione a Visual Robotics Studio
Visual Studio Programming viene fornito con una
serie di diagrammi esemplificativi;
ho preso il quarto di questi esempi e l’ho modificato
per renderlo più calzante ai nostri scopi “didatti-
ci”.
ROBOT &
REALTÀ VIRTUALE
Questo paragrafo risponde alla domanda: “Come
i diagrammi di VPL riescono a diventare un’auto-
mazione?”
Una volta assemblata l’automazione, clickando
sull’icona Play, anch’essa tipica degli ambienti di svi-
luppo Microsoft, è possibile telecomandare un ro-
bot, oppure avviare una animazione che simula
l’automazione, quasi fosse un videogioco.
Sono i files Manifest dei diversi Services che im-
postano il simulatore grafico piuttosto che l’hardwa-
re; per intendersi, il simulatore viene avviato quan-
do l’automazione utilizza Services le cui caratte-
ristiche sono descritte in file Manifest che richiedono
il simulatore grafico mentre automazioni assemblate
con Services i cui Manifest richiedono hardware
L’AMBIENTE DI SIMULAZIONE
Dalla Finestra Diagram del VPL è dedicato ad una Hardware simula-
possibile selezionare quale File to viene lanciato automaticamen-
Manifest intendiamo utilizzare per te il Visual Simulation
i nostri Services: Se utilizziamo un Environment ( un robot Lego
File Manifest dedicato ad Mindostorm inizia la sua esplora-
Hardware reale il Framework cer- zione nel mondo virtuale realizza-
cherà i pezzi restituendo un mes- to con il game engine di AGEIA e
saggio di errore se non li trova XNA ); Nota bene che se avessimo
(non ho il mattoncino Lego il file Manifest relativo potremmo
Mindstorm e non viene intercetta- pilotare, dal nostro computer, i
ta alcuna connessione Bluetooth) robot Spirit ed Opportunity che
Se utilizziamo invece un Manifest hanno esplorato Marte
G 26 /Ottobre 2007
comunicano e richiedono la connessione con un Ro-
bot vero e proprio (cfr. Fig. 3 e relativa didascalia);
Nel nostro caso, poiché non disponiamo di alcun Ro-
bot, è necessario lanciare il simulatore grafico, nome
in codice Microsoft Visual Simulation Environment
MICROSOFT VISUAL
SIMULATION
ENVIRONMENT
Se, testando le vostre applicazioni con il simula-
tore, avete l’impressione di giocare con un video-
games non siete poi così lontani dalla realtà…
La tecnologia impiegata per il Visual Simulation
Environment è appunto quella del Game Engine
PhisX della software House Ageia.
ricordo brevemente che un Game Engine è un
software “a basso livello”, utilizzato nella pro-
grammazione dei videogiochi, che si occupa della
grafica, delle leggi fisiche, delle animazioni e del-
l’intelligenza artificiale, etc fornendo un modello
coerente sul quale lo sviluppatore può lavorare.
Questo Game Engine è programmato utilizzando
un ambiente di sviluppo che dovrebbe essere no-
to ai lettori di IoProgrammo: XNA Game Studio di
Microsoft, che viene utilizzato principalmente nel-
la programmazione della console XBOX 360°…
Lo spazio di un articolo è sempre troppo breve e
non mi è possibile sviscerare tutte le funzionalità
del simulatore che sono comunque piuttosto in-
tuitive;
vale la pena però spiegare brevemente come è pos-
sibile personalizzare lo scenario delle nostre si-
mulazioni..
È possibile aggiungere, posizionare o eliminare le
figure geometriche che popolano lo scenario del-
la simulazione entrando nella modalità Edit attra-
verso la pressione del tasto funzione F5;
Figura 4: Nota bene che è possibile creare nuove entità
per popolare lo scenario importandole da un ambiente di
modellazione grafica evoluto quale 3d studio max!
confrontando la Fig. 4 scopriamo che a sinistra del-
la tipica finestra del simulatore si va ad aggiunge-
re un’area che
h t t p : / / w w w. i o p r o g r a m m o . i t
024-029:072-080 31-08-2007 15:52
Introduzione a Visual Robotics Studio
G Enumera tutti gli elementi che popolano la si-
mulazione (evidenziata in rosso)
G Consente di posizionare un elemento selezio-
nato secondo i tre piani cartesiani ed anche di
ruotarlo (evidenziata in blu)
È possibile modificare gli elementi geometrici del-
la simulazione seguendo questa procedura:
a. Selezionandoli nell’area evidenziata in rosso
b. Dopo, attraverso il menù a tendina Entity, con le
tipiche operazioni di Copia & Incolla è possibi-
le cancellarli, raddoppiarli oppure eliminarli.
Dal menù a tendina File è possibile salvare uno
scenario (selezionando Open Scene…) e caricarne
uno (selezionando Save Scene as…);
negli esempi allegati all’articolo troverete anche
uno scenario dedicato all’automazione di esem-
pio che vi consentirà di guidare il robot fatto con i
Lego in un percorso a zig a zag attraverso una se-
quenza di coni stradali.
Nota, per concludere, che è anche possibile mo-
dificare la gravità del nostro scenario, un’opzione
che si può rivelare utile qualora dovessimo pro-
gettare l’automazione per un robot esploratore su
Marte o sulla Luna.
PROGRAMMAZIONE
DEI SERVICES
Discutendo con l’Ing. Manfrin sul Kit di sviluppo l’at-
tenzione è stato soprattutto focalizzata sul con-
cetto di Orchestration:
con “Orchestration” intendiamo la perfetta sin-
cronia, dall’inizio alla fine, di tutti i Services che
compongono la nostra automazione;
per intendersi: nella nostra simulazione non suc-
cede nulla se il nostro robot, fatto con i Lego vir-
tuali, urta un ostacolo per una disattenzione, men-
tre nella realtà gli errori casuali o le imprecisioni
di una macchina utensile possono causare danni
incalcolabili, pensate alla catena di montaggio di
una fabbrica di automobili i cui robots, scoordi-
nati, smaltano, saldano, assemblano pezzi che non
sono ancora arrivati o sono sistemati male.
L’Orchestration è un problema assimilabile ai pro-
blemi classici di sincronizzazione dei Threads nei
Sistemi operativi, esemplificati con celebri rom-
picapo quali la “Torre di Hanoi” piuttosto che la
“Cena dei Filosofi;
problemi molto complessi, infernali che sono par-
te degli incubi degli informatici quasi da sempre…
Programmare un’applicazione con Microsoft Ro-
botics significa dunque gestire la difficile Orche-
stration tra gli input e gli output che si scambiano
i Services;
L’Orchestration viene gestita da una nuova libre-
ria software che è probabilmente la punta di diamante
h t t p : / / w w w. i o p r o g r a m m o . i t
Pagina 27

SISTEMA
del Pool di software che compongono questo ori-
ginalissimo Framework:
Concurrency and Coordination Runtime (CCR)
che tenta di risolverla rendendola invisibile ai no-
stri occhi, ovvero gestendola dietro le quinte.
Nota che Bill Gates nel sopraccitato articolo sulla
rivista Science nomina esplicitamente il CCR, ad
un pubblico non specializzato, spiegando appun-
to che risolve (sic…) il problema del MultiTasking
di diversi processi paralleli
IL CCR VISTO DA VICINO
Prima di addentrarci nei dettagli di questo com-
ponente software è necessario capire bene che co-
sa fa: immaginate di dovere creare una intranet per
una LAN composta da 100 computer e dover veri-
ficare se tutti sono online: probabilmente scrivereste
un componente che lancia un ping verso ogni sin-
golo computer e ne attendi la risposta, gestendo-
la poi per i vostri scopi.
Utilizzando la libreria CCR non avreste che da dir-
gli che cosa fare (lanciare un ping ) e come gestire
le risposte; ogni singolo ping viene gestito dal CCR
creando per ogni IP un thread che utilizzerà la sche-
da di rete in più richieste parallele.
Enunciato in questi termini la libreria pare essere
proprio essere una cosa notevole.
la realtà però non è così rosea.. Il CCR, visto da vi-
cino ha un aspetto piuttosto ostile..
Port <I> Port <I>
(Data Item Queue) (Data Item Queue)
recelverTax recelverTax
Arbiter
DispatcherQueue DispatcherQueue
(Work Items) (Work Items)
Dispatcher
(Thread Pool)
Created at App Initialization
Figura 5: Lo schema della CCR
La libreria CCR (cfr. Fig. 5) è scritta in C# e sfrutta
alcune caratteristiche della nuova release del Fra-
mework.net;
LA CLASSE PORT
Il CCR innanzitutto definisce una classe di tipo
Port che riceve in ingresso i parametri che do-
vranno essere elaborati tipizzandoli;
Ottobre 2007/ 27 G
024-029:072-080 31-08-2007 15:52 Pagina 28
SISTEMA
Introduzione a Visual Robotics Studio
Ad esempio questo pezzo di codice
Port<float> pF = new Port<float>() ;
significa che abbiamo istanziato una classe Port
di nome pF che riceve in ingresso un parametro di
tipo Float (nota le parentesi angolari);
è possibile ingressare 16 parametri di tipo diver-
so;
con questa sintassi, ad esempio
PortSet<int,string> pIS = new PortSet<int,string>();
passiamo due parametri di tipo integer e string.
La classe di tipo Port comprende una struttura di
dati FIFO ( il dato che entra per primo (First In) è
il primo dato che viene elaborato e restituito (Fir-
st Out) ); i dati accodati nella porta vengono poi "af-
fidati" ad un arbitro che a sua volta chiama,
facendo uso di delegate e metodi anonimi, una
funzione da eseguire su questi dati; per la preci-
sione i dati sono elaborati chiamando un delega-
te (un costrutto tipico di .net, simile alle chiama-
te a funzioni del C), che viene associato ad un me-
todo denominato oppure, ed è questa la novità,
un metodo anonimo; i metodi anonimi sono una
novità di C# e, in maniera elegante consentono
di passare un blocco di codice come parametro
del delegate. Ad esempio:
// Crea un gestore per un evento Click
button1.Click += delegate(System.Object o,
System.EventArgs e)
{
System.Windows.Forms.MessageBox.Show("Click!");
};
I metodi supportati dalla classe Port sono
Post che invia un messaggio ad una porta
Port<int> pi = new Port<int>() ;
pi.Post (42) ;
Test che verifica, attraverso un valore Booleano
di ritorno, se la porta è occupata
int iv ;
if (pi.Test (out iv))
Console.WriteLine ("Read " + iv) ;
else
Console.WriteLine ("Port empty.") ;
LA CLASSE ARBITER
Una volta che i messaggi sono passati attraverso
la classe Port e necessario elaborarli e smistarli;
questo compito è svolto dalla classe Arbiter che
li elabora utilizzando un delegate, che chiama la
G 28 /Ottobre 2007
funzione specifica, e poi li invia alla classe Di-
spatcherqueue che li smista. Brevemente i meto-
di della classe Arbiter, ordinati dai più semplici
verso i più complessi
public static class Arbiter {
public static ITask FromHandler(Handler
handler);
è un metodo che specifica che un valore può es-
sere accodato verso una classe DispatcherQueue
(che vedremo più avanti).
Questo semplice membro della classe Arbiter non
è associato ad alcun membro della classe Port
public static ITask FromIteratorHandler(Handler
handler);
è un metodo che enumera diversi valori che pos-
sono essere accodati verso una classe Dispat-
cherQueue che vedremo più avanti.
Non è associato ad alcun membro della classe
Port
public static Receiver<T> Receive<T>(
Boolean persist, Port<T> port, Handler<T>
handler);
è un metodo che può essere chiamato per passa-
re il risultato di una elaborazione verso una singola
porta. Deve essere specificato sia il delegate che chia-
merà l’evento sia la porta.
public static JoinSinglePortReceiver
MultipleItemReceive<T>(
Boolean persist, Port<T> port, Int32
itemCount,
VariableArgumentHandler<T> handler);
è un metodo che può essere chiamato per invia-
re diversi risultati dell’elaborazione verso una sin-
gola porta.
Il parametro inviato al delegate VariableArgu-
mentHandler consiste in un array di oggetti Port
public static JoinReceiver MultiplePortReceive<T>(
Boolean persist, Port<T>[] ports,
VariableArgumentHandler<T> handler);
è un metodo che può essere chiamato per invia-
re un singolo risultato dell’elaborazione verso
molteplici porte. Gli item devono essere del me-
desimo tipo delle porte. Il parametro inviato al
delegate VariableArgumentHandler consiste in
un array di oggetti Port
... // ed altri membri omessi per brevità
}
h t t p : / / w w w. i o p r o g r a m m o . i t
024-029:072-080 31-08-2007 15:52
Introduzione a Visual Robotics Studio
LA CLASSE
DISPATCHERQUEUE
il termine queue significa coda ed identifica la co-
da delle richieste dell’elaborazione che la classe
Arbiter desidera siano smistati dalla classe Di-
spatcher;
I threads gestiti nella classe del Dispatcher sono
in attesa degli input accodati nella classe Dispat-
cherQueue
public sealed class DispatcherQueue : IDisposable {
/* Usa il pool di thread gestito dal CLR non quello
del Dispatcher più
flessibile */
public DispatcherQueue(string name);
public DispatcherQueue(String name, Dispatcher
public void Dispose();
... // altri membri omessi per brevità
} cosa è evidente in XBox è soprattutto in questo
LA CLASSE DISPATCHER
Il compito di sincronizzare i vari thread dell’ela-
borazione viene affidato alla classe Dispatcher.
La classe Arbiter ha accodato alla dispatcherqueue
delle funzioni da eseguire. La classe Dispatcher
trova nella queue che funzioni ci sono e le esegue
attraverso il Multithreading, cioè in parallelo.
public sealed class Dispatcher : IDisposable {
public Dispatcher();
public Dispatcher(Int32 threadCount, String
threadPoolName);
public Dispatcher(Int32 threadCount,
ThreadPriority priority,
String threadPoolName);
public ICollection<DispatcherQueue>
DispatcherQueues { get; }
... // altri membri omessi per brevità
}
Per default ogni thread viene indirizzato ad ogni
singola CPU presente nel computer ( nota che in
questo modo sono ottimizzati i moderni proces-
sori Multi Core) ed esternamente è possibile iden-
tificare ogni singolo thread attraverso una strin-
ga e settarne il livello di priorità (per default, il
Framework assegna ad ogni thread un nome che
viene poi utilizzato nel Visual Studio® debugger's
Threads). È possibile creare molteplici classi Di-
spatcher, ognuno con il suo pool di threads am-
plificando indefinitamente le possibilità di ela-
borazione dello stesso. Per concludere avrete cer-
tamente compreso che Il CCR è un componete
ostico da programmare e probabilmente vi sare-
te resi conto che gestire l’orchestrazione tra i va-
h t t p : / / w w w. i o p r o g r a m m o . i t
Pagina 29

SISTEMA
ri Services sarebbe ben più difficile che non co-
struire a mano il proprio Robot… Ebbene le buo-
ne notizie sono che grazie a Microsoft Robotica
Studio, non avrete da scrivere una sola riga di co-
dice; l’intera implementazione del CCR viene ge-
stita attraverso il VPL che genera tutto il codice del
quale abbiamo bisogno senza doverci mettere le
mani; La documentazione del CCR per ora è vera-
mente scarsa ma le potenzialità di questo compo-
nente sono tali che, dovrebbe entrare a fare parte NOTA
integrante delle prossime release di .net
RINGRAZIAMENTI
Per la preziosa colla-
borazione si ringrazia
CONCLUSIONI l’ing. Federico Manfrin
Microsoft, ogni volta che si trova ad affrontare una http://federicoman-
dispatcher); sfida in un settore tecnologico differente dal suo frin.googlepages.com
che si è prestato con
‘Core Business’, non parte dal nulla ma riprende,
la sua esperienza ad
rielaborandoli, diversi suoi cavalli di battaglia; la
aggiungere note
importanti a questo
Robotic Development Kit che ci presenta sotto una articolo.
luce nuova non poche vecchie conoscenze… Tra
queste la vera novità e la libreria CCR che molti
sviluppatori vorrebbero ripreso nella Release
ufficiale del .NET Framework; Abbiamo parlato di
robots e posto l’accento sulle comunità di
appassionati che li smanettano ma il VRS non è un
curioso Gadget quanto piuttosto lo strumento che
programma le macchine utensili e le catene di
montaggio; è appena uscito dalle officine Microsoft
ed a non poche carenze, quantomeno nella
documentazione, ma ha caratteristiche davvero
interessanti che certamente ritroveremo nel nostri
programmi anche, nel bene o nel male, ci
occupiamo tutto altro che di costruzioni Lego.
Luigi Corrias
COME SI AVVIANO I SERVIZI?
I Services sono creati, avviati dssnewservice /s:NomeServizio
monitorati e distrutti grazie ad /l:Linguaggio
un componente software il cui
e generare, nella cartella di
nome in codice è Decentralized
Software Services Node; installazione del Kit, un vero e
Il nodo DSSN si occupa anche di proprio progetto di Visual Studio
farli comunicare attraverso un 2005, completo di certificato,
protocollo basato su SOAP: DSSP; pronto per essere lanciato e
programmato(cfr. Fig. 6)!
( nota che la l’idea della
Per comodità io ho scelto di
comunicazione tramite SOAP è
ripresa da uno dei pilastri di .NET, utilizzare VB.net e di gestire il
i Web Services che si scambiano progetto con Visual Studio 2005
dati appunto su protocollo SOAP ma, nota bene, questo ambiente,
e WSDL) se non è utilizzato a scopi
commerciali, è completamente
Per creare un Services utilizzando
gratuito e può essere
DDS non abbiamo che da lanciare
l’Interfaccia a linea di comando programmato altrettanto bene
del Kit di sviluppo e scrivere: con i vari Visual Studio Express;
Ottobre 2007/ 29 G