Diseño e implementación de servicios
En esta sección se muestra cómo definir e implementar contratos de WCF. Un contrato de servicio especifica lo que un punto de conexión comunica al mundo exterior. En un nivel más concreto, es una instrucción sobre un conjunto de mensajes concretos organizada en patrones 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 básicos de Windows Communication Foundation (WCF), consulte 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 crear clientes que usan contratos de servicio para conectarse a los servicios, consulte Introducción al cliente WCF.
Información general
En este tema se proporciona un nivel alto de orientación conceptual para diseñar e implementar servicios 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 hospedaje pueden no admitir.
Contratos de servicio
Un contrato de servicio especifica lo siguiente:
Las operaciones que el contrato expone.
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 de orden de compra podría tener una operación CreateOrder que acepte una entrada de tipos de información de orden y devuelva información de error o completada, además de un identificador de orden. También podría tener una operación GetOrderStatus que acepte un identificador de orden y devuelva 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
CreateOrderyGetOrderStatus.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 transmitir este tipo de información a otras aplicaciones en varias plataformas (incluidas plataformas que no sean de Microsoft), los contratos de servicio XML se expresan públicamente en 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, consulte 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 usan atributos, clases e interfaces administrados para definir la estructura de un servicio e implementarlo.
El contrato resultante definido en tipos administrados se puede exportar en forma de metadatos (WSDL y XSD) cuando lo necesiten los clientes u otros implementadores de servicio. El resultado es un modelo de programación sencillo que se puede describir (usando metadatos públicos) en cualquier aplicación cliente. Los detalles de los mensajes SOAP subyacentes, la información relacionada con la seguridad y el transporte, etc., pueden dejarse en manos de WCF, que realiza automáticamente las conversiones necesarias a y desde el sistema de tipos de contratos de servicio y el sistema de tipos de XML.
Para obtener más información sobre el diseño de contratos, consulte Diseño de contratos de servicios. Para obtener más información sobre la implementación de contratos, consulte Implementación de contratos de servicios.
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 usen lenguajes administrados como Visual Basic y C++ COM pueden aplicar su conocimiento del enfoque del estilo RPC (si usan 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 la programación en el nivel de mensaje, consulte Uso de 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 patrón 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, solo 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 conforme.
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.
Es importante que tenga presente este proceso de requisito aditivo 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 diferentes tipos de aplicación host de servicio, consulte Hospedaje de servicios.