Generazione di un client proxy (.NET)

Le applicazioni client .NET utilizzano un client proxy per interagire con le API dei servizi Web. Un client proxy protegge le applicazioni client dalla complessità del protocollo di messaggistica dei servizi Web.

Prima di iniziare

Per creare un client proxy, è necessario esportare prima un numero di file WSDL dall'ambiente WebSphere e copiarli nell'ambiente di programmazione del client.

Nota: se si dispone del CD del client di Websphere Process Server, è invece possibile copiare i file.

Perché e quando effettuare questa attività

Un client proxy comprende una serie di classi dei bean C#. Ciascuna classe contiene tutti i metodi e gli oggetti esposti da un singolo servizio Web. I metodi dei servizi gestiscono l'assieme dei parametri nei messaggi SOAP completi, inviano tali messaggi al servizio Web su HTTP, riceve le risposte dal servizio Web e gestisce qualsiasi dato restituito.

Nota: è necessario generare un client proxy solo una volta. Tutte le applicazioni client che accedono alle API dei servizi Web possono quindi utilizzare lo stesso client proxy.

Procedura di questa attività

  1. Utilizzare il comando WSDL per generare un client proxy: Immettere:

    wsdl options WSDLfilepath

    Dove:

    • options include:
      /language
      Consente di specificare la linguaggio utilizzato per creare la classe proxy. Il valore predefinito è C#. È inoltre possibile specificare VB (Visual Basic), JS (JScript) o VJS (Visual J#) come argomento del linguaggio.
      /output
      Il nome del file di output, con il suffisso appropriato. Ad esempio, proxy.cs
      /protocol
      Il protocollo implementato nella classe proxy. SOAP è l'impostazione predefinita.

      Per un elenco completo dei parametri WSDL.exe, utilizzare l'opzione della riga comandi /? o fare riferimento alla guida in linea per lo strumento WSDL in Visual Studio.

    • WSDLfilepath è il percorso e il nome del file WSDL esportato dall'ambiente WebSphere o copiato dal CD del client.
    Nel seguente esempio viene illustrato come viene generato un client proxy dall'API dei servizi Web di Human Task Manager:
    	wsdl /language:cs /output:proxyclient.cs c:\ws\bin\HTMWS.wsdl
  2. Compilare il client proxy come file DLL (Dynamic Link Library).
Attività correlate
Pubblicazione dei file WSDL

(c) Copyright IBM Corporation 2005, 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)