BING : Referenziare il servizio SOAP

In questo post vorrei riprendere un discorso trattato qualche mese fa riguardante le funzionalità di ricerca offerte dalla piattaforme Bing.

In particolare mi vorrei soffermare sul protocollo SOAP.

Come già visto nel post Protocolli Bing : SOAP & JSON, il protocollo SOAP è solo uno dei tre protocolli possibili per accedere alle funzionalità della piattaforma di ricerca Bing.

Se abbiamo un nostro progetto .NET possiamo referenziare il protocollo SOAP in due modalità che vedremo ora in dettaglio.

In entrambi i casi, l’indirizzo da cui recuperare il WSDL del servizio è:

http://api.bing.net/search.wsdl?AppID=<AppIdD>&Version=2.2

dove <AppId> è il nostro appid generato nelle modalità spiegate nel post "Integrare le funzionalità di Bing".

SOAP come servizio

Per referenziare il servizio SOAP è sufficiente utilizzare la funzione “Aggiungi Riferimento al Servizio…” del menù contestuale di un progetto VS2008:

inserire l’indirizzo del WSDL:

captured_Image.png[8]

e premere OK.

Questa operazione genera delle classi a partire dai metadati recuperati dal WSDL.

In questo caso il punto di accesso ai servizi Bing è la classe BingPortTypeClient ed, in particolare, in metodo Search():

captured_Image.png[10]

Il metodo Search() prevede un argomento di tipo SearchRequest e restituisce un risultato di tipo SearchResponse.

La configurazione dell’indirizzo del servizio avviene, come nella migliore tradizione WCF, all’interno del tag <system.serviceModel> del file di configurazione:

captured_Image.png[12]

SOAP come web service

Possiamo referenziare il servizio Bing con protocollo SOAP anche come Web Service “vecchia maniera”, semplicemente utilizzando il menù contestuale “Aggiungi riferimento Web…”

captured_Image.png[14]

oppure usando il menù “Aggiungi riferimento al Servizio…” come visto in precedenza ma utilizzando il riferimento come Web Service

captured_Image.png[16]

In questo caso, il punto di accesso ai servizi Bing è la classe BingService con il metodo Search() (e la sua versione asincrona).

captured_Image.png[18]

Anche in questo caso, il metodo Search() prevede un argomento di tipo SearchRequest e restituisce un risultato di tipo SearchResponse.

La configurazione dell’indirizzo del servizio può avvenire, questa volta impostando la proprietà Url dell’istanza delal classe BingService.

I servizi con protocollo SOAP sono, quindi, utilizzabili sia da linguaggi che “comprendono” SOAP puro, sia da queli linguaggi che riescono ad interpretare i “vecchi” web services.

Technorati Tag: Bing API,Bing SOAP Protocol,Bing Service

Commenti

Post popolari in questo blog

VB.NET for Dummies: Gli Eventi

Vorrei iniziare con questo post una serie dedicata ad aspetti di VB.NET di base che possono essere utile a coloro che si avvicinano al mondo .NET e che, in genere, non vengono trattati a livello base. La serie di post non ha la pretesa di essere assolutamente esaustivi sugli argomenti che tratterò In questo primo post parleremo degli eventi. Cosa sono e a cosa servono Un evento è la “notifica” dell’accadimento di qualcosa. Quando, ad esempio, premiamo un bottone della finestra di un’applicazione, dietro le quinte, il bottone stesso “notifica” al mondo circostante che qualcuno, in quell’istante, lo ha premuto. Sta, poi, al mondo circostante preoccuparsi di “intercettare” l’evento stesso per gestirlo (tramite un gestore di evento). Attenzione a non confondere la pressione del tasto con la “notifica” della pressione del tasto: l’evento è la “notifica” dell’accadimento, non l’accadimento stesso. Ma a cosa serve tutto ciò? Utilizzare gli eventi è un modo per disaccoppiare ...

Continua a leggere

VB.NET: SplashScreen con effetto fade-in

In questo post vorrei proporvi un modo per realizzare una splash screen per le nostre applicazioni Windows Form che appare progressivamente con un effetto fade. Supponiamo di avere il nostro progetto VB.NET in una soluzione Visual Studio 2008 in cui abbiamo il sorgente della nostra applicazione Windows Form. Inseriamo una splash screen utilizzando il menù Progetto->Aggiungi Nuovo Elemento e selezionando il tipo di elemento “Schermata Iniziale” A questo punto Visual Studio creerà, automaticamente, la schermata iniziale che possiamo personalizzare graficamente come vogliamo. Per poter fare in modo che questa finestra appaia nel momento in cui avviamo l’applicazione, è necessario aprire le proprietà del progetto e impostare la maschera di avvio: In questo modo, all’avvio dell’applicazione, la schermata appare immediatamente e scompare un attimo prima della visualizzazione della finestra dell’applicazione. Possiamo far apparire la schermata iniziale con un ef...

Continua a leggere

MVP Reconnect …… ovvero quando entri nella “famigghia” resti sempre nella “famigghia”!!!

Ma di che “famigghia” stiamo parlando!!!! Fermi tutti, non si tratta di robe strane o sette segrete o affari malavitosi….stiamo parlando della grande famiglia dei Microsoft MVP. Per chi non sapesse cosa sono i Microsoft MVP, vi consiglio di fare un giro sul sito ufficiale del programma ( link ), ma, volendolo spiegare in pochisime parole, si tratta di un riconoscimento che Microsoft da a persone che si distinguono per il loro impegno, aiutando gli altri ad ottenere il massimo grazie alle tecnologie Microsoft. Si tratta di persone, non dipendenti Microsoft, che mettono la loro passione, il loro tempo, la loro buona volontà per la divulgazione e la condivisione della conoscenza. Non necessariamente (come qualcuno erroneamente sostiene, evidentemente non conoscendo le basi del programma) si tratta di professionisti nel termine letterale del termine ma si tratta comunque di un gruppo di persone che sacrifica un pò del suo tempo (e, a volte, vi assicuro neanche pò!!!) per la sua passione....

Continua a leggere

Code Tailor

Cerca nel blog