Procedura dettagliata: progettazione di un servizio Web

Aggiornamento: novembre 2007

In questa procedura dettagliata vengono descritti gli aspetti principali della progettazione di un servizio Web mediante Progettazione applicazioni di Visual Studio Team System Architecture Edition. e viene decritto come eseguire le seguenti azioni:

• Definizione di operazioni su un servizio Web esistente.

• Implementazione del servizio Web.

• Aggiunta di un servizio Web esterno, ovvero un servizio Web non incluso nella soluzione, e visualizzazione di metodi Web.

• Connessione del servizio Web esterno ad altre applicazioni.

Questa procedura dettagliata è basata sui concetti illustrati nella procedura dettagliata introduttiva Procedura dettagliata: definizione di applicazioni in diagrammi applicazioni.

Per definire operazioni sul servizio Web di Catalog

1. Caricare l'esempio fornito all'indirizzo https://go.microsoft.com/fwlink/?LinkId=40867.

2. Fare doppio clic sul file Catalog.ad per aprire il diagramma applicazioni.

   In Progettazione applicazioni viene visualizzato il diagramma applicazioni.

3. Fare clic con il pulsante destro del mouse sull'endpoint CatalogWebService di Catalogo e scegliere Definisci operazioni per visualizzare la finestra Dettagli servizio Web.

4. Nella finestra Dettagli servizio Web, fare clic su <aggiungi operazione> e digitare GetProductDetails.

5. In Tipo, digitare ProductDetails.

   Il tipo di operazione immesso consente di specificare il tipo restituito dell'operazione.

6. Espandere il segno più (+) a sinistra di GetProductDetails per aggiungere parametri all'operazione.

7. Fare clic su <aggiungi parametro> e digitare ProductNumber. In Tipo digitare Integer.

   Nota:
   Quando si inizia a digitare nella colonna Tipo, inVisual Studio viene visualizzato un elenco di tipi disponibili.

   L'operazione accetta un numero di prodotto intero e restituisce una struttura ProductDetails.

Per impostazione predefinita, l'operazione definita è di tipo richiesta-risposta. Per ulteriori informazioni sulla modifica di questa proprietà, vedere Procedura: specificare operazioni unidirezionali o richiesta-risposta per i servizi Web ASP.NET.

Per impostare le proprietà del progetto e implementare il servizio Web di Catalog

1. Fare clic sull'endpoint CatalogWebService nell'applicazione Catalogo.

2. Visualizzare la finestra Proprietà.

3. Impostare la proprietà Nome associazione WSDL su Catalogo.

4. Impostare la proprietà Spazio dei nomi associazione WSDL su http://Adventureworks/Products.

5. Fare clic sull'applicazione Catalogo e impostare la proprietà Linguaggio su Visual C#.

   Nota:
   Se sono stati installati tutti i linguaggi in Visual Studio, il valore di questa proprietà sarà Visual Basic per impostazione predefinita.

6. Con l'applicazione Catalogo selezionata, nel menu Diagramma, scegliere Implementazione, quindi fare clic su Implementa applicazione.

   Verrà visualizzata la finestra di dialogo Conferma implementazione applicazione.

7. Verificare i dettagli dell'implementazione dell'applicazione Catalogo, quindi scegliere OK.

   Durante il processo di implementazione viene generato un progetto per l'applicazione con i riferimenti Web appropriati. Al termine dell'implementazione, l'applicazione viene visualizzata con un'ombreggiatura.

   Nota:
   Quando viene visualizzata la finestra di dialogo Avviso di sicurezza, fare clic su Chiudi. Questa finestra di dialogo indica che la stringa di connessione al database per il database nel diagramma applicazioni verrà scritta nel file di configurazione non crittografata e in formato testo normale.

8. Controllare le classi proxy e il riferimento Web in Esplora soluzioni.

9. Aprire il file CatalogWebService.cs e visualizzare il codice per il metodo Web ProductDetails.

   In Visual Studio sono stati impostati il nome e lo spazio dei nomi di associazione WSDL ed è stata creata la firma del metodo.

10. Nel codice, modificare il nome dell'operazione da GetProductDetails a GetProductInformation.

11. Fare clic sull'endpoint CatalogWebService e visualizzare la finestra Dettagli servizio Web.

    Nella finestra Dettagli servizio Web è stato modificato il nome dell'operazione al fine di rispecchiare la modifica apportata alla firma del metodo Web nel codice. Tutte le modifiche apportate nel codice vengono automaticamente applicate nella finestra Dettagli servizio Web e viceversa.

Per aggiungere un servizio Web esterno e visualizzare i metodi Web

1. Aprire la Casella degli strumenti e trascinare ExternalWebService nel diagramma applicazioni.

   Verrà visualizzata la finestra di dialogo Aggiungi riferimento Web.

2. Individuare la posizione di LegacyCatalog.wsdl nel computer locale.

3. Nella casella URL, digitare questo percorso, quindi fare clic su Vai.

   Verranno visualizzati la descrizione del file WSDL e il metodo da esso definito.

4. Scegliere Aggiungi riferimento.

   Il servizio Web esterno verrà visualizzato nel diagramma applicazione.

5. Fare clic sull'endpoint GetLegacyInfo.

6. Nel menu Visualizza, scegliere Altre finestre, quindi fare clic su Dettagli servizio Web per visualizzare la relativa finestra.

7. Esaminare il metodo Web visualizzato nella finestra Dettagli servizio Web.

   Questo particolare file WSDL contiene i metodi per l'accesso alle informazioni in un catalogo preesistente.

Per connettere il servizio Web esterno al servizio Web di Catalog

• Tenendo premuto il tasto ALT, trascinare l'endpoint GetLegacyInfo del servizio Web esterno sul bordo dell'applicazione Catalogo.

  Questa azione consente di creare un endpoint consumer in Catalogo per indicare che nell'applicazione Catalogo vengono utilizzati i servizi forniti da LegacyInfo. Quando si implementa l'applicazione Catalogo, in Visual Studio verranno generate classi proxy per i metodi Web definiti nell'endpoint GetLegacyInfo.

  Inoltre in Visual Studio viene aggiunto alla soluzione un file sdm per il servizio Web esterno, nel quale sono contenute le definizioni SDM per l'applicazione. Per ulteriori informazioni, vedere Cenni preliminari su SDM (System Definition Model).

Passaggi successivi

Il passaggio successivo consiste in un maggiore utilizzo degli endpoint del servizio Web. Per ulteriori informazioni, vedere Procedura dettagliata: progettazione di un servizio Web basato su contratto - Creazione di un endpoint.

Vedere anche

Altre risorse

Procedure dettagliate relative alla progettazione di servizi Web