Diseño e implementación de servicios
En esta sección se muestra cómo definir e implementar los contratos de WCF. Un contrato de servicio especifica lo que un extremo comunica al mundo exterior. En un nivel más concreto, es una instrucción sobre un conjunto de mensajes concretos organizada en modelos de intercambio de mensajes básicos (MEP), como solicitud/respuesta, unidireccional y dúplex. Si un contrato de servicio es un conjunto relacionado de forma lógica de intercambios de mensajes, una operación de servicio es un intercambio único de mensajes. Por ejemplo, una operación Hello
debe aceptar obviamente un mensaje (de manera que el autor de la llamada pueda anunciar el saludo) y puede o no devolver un mensaje (dependiendo de la cortesía de la operación).
Para obtener más información sobre los contratos y otros conceptos principales de Windows Communication Foundation (WCF), vea Conceptos básicos de Windows Communication Foundation. Este tema se centra en describir los contratos de servicio. Para obtener más información sobre cómo generar clientes que utilizan los contratos de servicio para conectarse a los servicios, vea Introducción a un cliente WCF.
Información general
En este tema se proporciona un nivel alto de orientación conceptual para diseñar e implementar los servicios de WCF. Los subtemas proporcionan más información detallada sobre las características de diseño e implementación. Antes de diseñar e implementar su aplicación WCF, se recomienda lo siguiente:
- Entender lo que es un contrato de servicio, cómo funciona, y cómo crear uno.
- Comprender que los contratos especifican requisitos mínimos que la configuración en tiempo de ejecución o el entorno de alojamiento pueden no admitir.
Contratos de servicio
Un contrato de servicio es una instrucción que es capaz de lo siguiente:
- La agrupación de operaciones en un servicio.
- La firma de las operaciones en términos de mensajes intercambiados.
- Los tipos de datos de estos mensajes.
- La ubicación de las operaciones.
- Los protocolos concretos y formatos de serialización que se utilizan para admitir la comunicación correcta con el servicio.
Por ejemplo, un contrato del orden de compra podría tener una operación CreateOrder
que aceptase una entrada de tipos de información de orden y devolviese información sobre acción completada o de error, además de un identificador de orden. También podría tener una operación GetOrderStatus
que aceptase un identificador de orden y devolviese información de estado de la orden. Un contrato de servicio de este tipo especificaría lo siguiente:
- Que el contrato de la orden compra consistiese en las operaciones
CreateOrder
yGetOrderStatus
. - Que las operaciones han especificado mensajes de entrada y de salida.
- Los datos que estos mensajes pueden llevar.
- Instrucciones de categorías sobre la infraestructura de la comunicación necesaria para procesar correctamente los mensajes. Por ejemplo, estos detalles incluyen qué formularios de seguridad son necesarios para establecer una comunicación correcta.
Para llevar este tipo de información a otras aplicaciones en muchas otras plataformas (incluidas plataformas que no sean de Microsoft), los contratos de servicio de XML se expresan públicamente en los formatos XML estándar, como Web Services Description Language (WSDL) y XML Schema (XSD), entre otros. Los desarrolladores para muchas plataformas pueden utilizar esta información de contrato público para crear aplicaciones que pueden comunicarse con el servicio, porque entienden el lenguaje de la especificación y porque esos lenguajes están diseñados para permitir la interoperación describiendo los formularios, formatos y protocolos públicos que el servicio admite. Para obtener más información sobre cómo gestiona WCF este tipo de información, vea Metadatos.
Los contratos se pueden expresar de muchas maneras, pero, aunque WSDL y XSD son lenguajes excelentes para describir servicios de una manera accesible, se trata de lenguajes difíciles de usar directamente y son simplemente descripciones de un servicio, no implementaciones de contratos de servicio. Por consiguiente, las aplicaciones WCF utilizan atributos administrados, interfaces y clases para definir la estructura de un servicio e implementarlo.
El contrato resultante definido en tipos administrados se puede convertir (también denominado exportar) como metadatos (WSDL y XSD) cuando lo necesitan clientes u otros implementadores de servicio, sobre todo en otras plataformas. El resultado es un modelo de programación sencillo que se puede describir utilizando metadatos públicos en cualquier aplicación cliente. Los detalles de los mensajes SOAP subyacentes, el transporte e información relacionada de seguridad, etc., pueden dejarse en WCF, que realiza automáticamente las conversiones necesarias a y desde el sistema de tipos de contratos de servicio al sistema de tipos de XML.
Para obtener más información sobre el diseño de contratos, vea Diseño de contratos de servicios. Para obtener más información sobre la implementación de contratos, vea Implementación de contratos de servicio.
Mensajes arriba y al centro
Utilizar interfaces, clases y métodos administrados para modelar las operaciones de servicio es sencillo cuando está acostumbrado a firmas de método de estilo de llamada a procedimiento remoto (RPC), en las que pasar parámetros a un método y recibir valores de devolución es la forma normal de solicitar funcionalidad desde un objeto u otro tipo de código. Por ejemplo, los programadores que utilicen lenguajes administrados como Visual Basic y C++ COM pueden aplicar su conocimiento del enfoque del estilo RPC (si utilizan objetos o interfaces) a la creación de contratos de servicio WCF sin experimentar los problemas inherentes a los sistemas de objetos distribuidos de estilo RPC. La orientación del servicio proporciona las ventajas de la programación acoplada y orientada a mensajes mientras mantiene la facilidad y familiaridad de la experiencia de programación de RPC.
Muchos programadores se sienten más cómodos con las interfaces de programación de aplicaciones orientadas a mensajes, como las colas de mensajes como Microsoft MSMQ, los espacios de nombres System.Messaging en .NET Framework o el envío de XML no estructurado en solicitudes HTTP, por nombrar algunos. Para obtener más información sobre cómo programar en el nivel de mensaje, vea Usar contratos de mensaje, Programación de servicios a nivel de canal e Interoperabilidad con aplicaciones POX.
Introducción a la jerarquía de los requisitos
Un contrato de servicio agrupa operaciones; especifica el modelo de intercambio de mensajes, tipos de mensaje y tipos de datos que llevan esos mensajes e indica categorías de comportamiento de tiempo de ejecución que una implementación debe tener para admitir el contrato (por ejemplo, puede requerir que los mensajes se cifren y firmen). El contrato de servicio en sí mismo no especifica precisamente cómo se cumplen estos requisitos, sólo que son obligatorios. El tipo de cifrado o la manera en la que se firma un mensaje depende de la implementación y configuración de un servicio compatible.
Observe la manera en que el contrato requiere algunas cosas de la implementación del contrato de servicio y la configuración del tiempo de ejecución para agregar comportamiento. El conjunto de requisitos que se deben cumplir para exponer un servicio para usar compilaciones en el conjunto anterior de requisitos. Si un contrato realiza requisitos de la implementación, una implementación puede requerir todavía más de la configuración y enlaces que permiten al servicio ejecutarse. Finalmente, la aplicación host también debe admitir cualquier requisito que la configuración de servicio y los enlaces agreguen.
Este proceso de requisito aditivo es importante tenerlo presente mientras diseña, implementa, configura y aloja una aplicación de servicio Windows Communication Foundation (WCF). Por ejemplo, el contrato puede especificar que necesita admitir una sesión. En ese caso, deberá configurar el enlace para admitir ese requisito contractual o la implementación del servicio no funcionará. O si su servicio requiere Autenticación integrada de Windows y se hospeda en Internet Information Services (IIS), la aplicación web en la que el servicio reside debe tener Autenticación integrada de Windows activada y la compatibilidad anónima desactivada. Para obtener más información sobre las características y el impacto de los tipos de aplicación host de servicio diferentes, vea Servicios de hospedaje.
Consulte también
Conceptos
Diseño de contratos de servicios
Implementación de contratos de servicio