Tutorial: Diseñar un servicio Web
Actualización: noviembre 2007
En este tutorial se muestran los principales aspectos del diseño de un servicio web mediante el Diseñador de aplicaciones en Visual Studio Team System Architecture. Este tutorial explica cómo:
Definir las operaciones en un servicio Web existente.
Implementar el servicio Web.
Agregar un servicio Web externo (un servicio Web fuera de la solución) y ver en él los métodos Web.
Conectar el servicio Web externo a otras aplicaciones.
Este tutorial se basa en los conceptos presentados en el tema del tutorial introductorio, Tutorial: Definir aplicaciones en diagramas de aplicaciones.
Para definir las operaciones en el servicio de catálogos Web
Cargue el ejemplo proporcionado en https://go.microsoft.com/fwlink/?LinkId=40867.
Haga doble clic en el archivo Catalog.ad para abrir el diagrama de aplicaciones.
El Diseñador de aplicaciones muestra el diagrama de aplicaciones.
Haga clic con el botón secundario en el punto final CatalogWebService de Catalog y elija Definir operaciones para ver la ventana Detalles del servicio web.
En la ventana Detalles del servicio web, haga clic en <agregar operación> y escriba GetProductDetails.
Bajo Tipo, escriba ProductDetails.
El tipo de operación que ha escrito especifica el tipo de valor devuelto de la operación.
Expanda el signo más (+) a la izquierda de GetProductDetails para agregar parámetros a la operación.
Haga clic en <agregar parámetro> y escriba ProductNumber. Bajo Tipo, escriba Integer.
.gif "Nota")
Nota:Cuando empiece a escribir en la columna Tipo, Visual Studio mostrará una lista de los tipos disponibles.
Esta operación toma un número de producto entero y devuelve una estructura ProductDetails.
De forma predeterminada, la operación definida es de tipo solicitud-respuesta. Para obtener más información sobre cómo cambiar esta propiedad, vea Cómo: Especificar operaciones unidireccionales o de solicitud y respuesta para servicios web ASP.NET.
Para establecer las propiedades del proyecto e implementar el servicio Web de catálogo
Haga clic en el punto final CatalogWebService en la aplicación Catalog.
Vea la ventana Propiedades.
Cambie la propiedad Nombre de enlace de WSDL a Catalog.
Cambie la propiedad Espacio de nombres de enlace de WSDL a http://Adventureworks/Products.
Haga clic en la aplicación Catalog y cambie su propiedad Lenguaje a Visual C#.
Nota:Si instaló todos los lenguajes con Visual Studio, el valor predeterminado de esta propiedad es Visual Basic.
Con la aplicación Catalog seleccionada, en el menú Diagrama, elija Implementación y, a continuación, haga clic en Implementar aplicación.
Aparecerá el cuadro de diálogo Confirmar la implementación de la aplicación.
Revise los detalles de la implementación de la aplicación Catalog y haga clic en Aceptar.
El proceso de implementación genera un proyecto para la aplicación con las referencias Web adecuadas. Cuando la implementación ha finalizado, la aplicación se muestra sombreada.
Nota:Cuando aparezca el cuadro de diálogo Advertencia de seguridad, haga clic en Cerrar. Este cuadro de diálogo indica que la cadena de conexión a bases de datos para la base de datos en el diagrama de la aplicación se va a escribir en el archivo de configuración sin cifrar y en texto sin formato.
Revise las clases de proxy y la referencia Web en el Explorador de soluciones.
Abra el archivo CatalogWebService.cs y vea el código del método web ProductDetails.
Observe que Visual Studio ha establecido el nombre de enlace de WSDL y el espacio de nombres de enlace de WSDL y ha creado la firma del método.
En el código, cambie el nombre de operación de GetProductDetails a GetProductInformation.
Haga clic en el punto final CatalogWebService y vea la ventana Detalles del servicio web.
El nombre de la operación ha cambiado en la ventana Detalles del servicio web para reflejar el cambio realizado en la firma del método web en el código. Cualquier cambio que se realice en el código se refleja automáticamente en la ventana Detalles del servicio web y viceversa.
Para agregar un servicio Web externo y ver los métodos Web
Abra el Cuadro de herramientas y arrastre un ExternalWebService hasta el diagrama de aplicaciones.
Aparecerá el cuadro de diálogo Agregar referencia Web.
Busque la ubicación de LegacyCatalog.wsdl en su equipo local.
En el cuadro Dirección URL, escriba esta ubicación y haga clic en Ir.
Aparece la descripción del archivo WSDL junto con el método que define.
Haga clic en Agregar referencia.
El servicio Web externo aparece en el diagrama de aplicaciones.
Haga clic en el punto final GetLegacyInfo.
En el menú Ver, elija Otras ventanas y, a continuación, haga clic en Detalles del servicio Web para ver la ventana Detalles del servicio web.
Examine el método web en la ventana Detalles del servicio web.
Este archivo WSDL contiene los métodos para tener acceso a la información de un catálogo heredado.
Para conectar el servicio Web externo con el servicio de catálogos Web
Mantenga presionada la tecla ALT y arrastre el punto final GetLegacyInfo del servicio web externo hasta el borde de la aplicación Catalog.
Esta acción crea un punto final de consumidor en Catalog que indica que la aplicación Catalog consume los servicios proporcionados por LegacyInfo. Cuando implemente la aplicación Catalog, Visual Studio generará clases proxy para los métodos web definidos en el punto final GetLegacyInfo.
Visual Studio también agrega a la solución un archivo .sdm para el servicio web externo. Este archivo contiene las definiciones de SDM para esta aplicación. Para obtener más información, vea Información general sobre el modelo de definición del sistema (SDM).
Pasos siguientes
El paso siguiente es trabajar más con extremos del servicio Web. Para obtener más información, vea Tutorial: Diseño de servicios Web orientados a contratos y creación de un extremo.