An Avanade Blogging Community

Hace unas semanas hablaba con un compañero acerca de como implementar una aplicación con acceso  a MSMQ y tras una larga discusión, en un intento de conseguir pensar en el mejor camino de lograrlo, pensé en hacerlo con WCF, y,  ¿Que mejor forma de probarlo que haciendo un ejemplo o proyecto? , pues, e aquí el motivo de este post.

Os dejo el conjunto de pasos seguidos:

Pasos:

• Generar una estructura en Visual Studio similar a la siguiente:

• Añadir el siguiente código a la interfaz, fichero IService1.cs

[ServiceContract]
public interface IService1
{
     [OperationContract(IsOneWay = true, Action = "*")]
     void Send(MsmqMessage<Persona> msg);
}

• Añadir el siguiente código al servicio Service1.cs

public class Service1 :  IService1
{
    [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]
    public void Send(MsmqMessage<Persona> message)
    {
        Persona msg = (Persona)message.Body;
        Console.WriteLine("Persona: [{0} {1}; ({2})] ", msg.Nombre, msg.Apellidos, msg.OtraCosaMariposa);
    }
}

•   En el fichero Program.cs del proyecto WcfMsmqHost añadir lo siguiente:

static void Main(string[] args)
{
    string msmqPath = ConfigurationManager.AppSettings["baseAddress"];

    if (!MessageQueue.Exists(msmqPath))
        MessageQueue.Create(msmqPath);

    Uri baseAddress = new Uri(String.Format("msmq.formatname:DIRECT=OS:{0}", msmqPath));

    using (ServiceHost serviceHost = new ServiceHost(typeof(Service1), baseAddress))
    {
        serviceHost.Authorization.PrincipalPermissionMode = System.ServiceModel.Description.PrincipalPermissionMode.None;
        
        serviceHost.Open();

        Console.WriteLine("Servicio listo.");
        Console.WriteLine("Pulsa <INTRO> para finalizar.");
        Console.ReadLine();
        
        serviceHost.Close();
    }
}

• El fichero de configuración del servidor deberá contener esto:

<appSettings>
  <add key="baseAddress" value=".\private$\MyTest33"/>
</appSettings>

<system.serviceModel>
  <bindings>
    <msmqIntegrationBinding>
      <binding name="NewBinding0" exactlyOnce="false" useSourceJournal="false"
        useMsmqTracing="true">
        <security mode="None">
          <transport msmqAuthenticationMode="None" />
        </security>
      </binding>
    </msmqIntegrationBinding>
  </bindings>
  <services>
    <service name="WcfMsmqHost.Service1">
      <endpoint address="" binding="msmqIntegrationBinding" bindingConfiguration="NewBinding0"
        contract="WcfMsmqIntegration.IService1" />
    </service>
  </services>
</system.serviceModel>

• Finalmente la función Main, en Program.cs del proyecto de test debe contener algo similar a esto:

string msmqPath = ConfigurationManager.AppSettings["baseAddress"];

MsmqIntegrationBinding binding = new MsmqIntegrationBinding();
EndpointAddress address = new EndpointAddress(
          String.Format(@"msmq.formatname:DIRECT=OS:{0}", msmqPath));            
ChannelFactory<IService1> channelFactory = new ChannelFactory<IService1>(binding, address);

// None, porque MQM no esta en Active Directory
binding.Security.Mode = MsmqIntegrationSecurityMode.None;                       

IService1 channel = channelFactory.CreateChannel();

Persona msg = new Persona();
msg.Nombre = "Juan Luis";
msg.Apellidos = "Guerrero";
msg.OtraCosaMariposa = "elGuerre";

MsmqMessage<Persona> message = new MsmqMessage<Persona>(msg);
using (TransactionScope scope = new TransactionScope(TransactionScopeOption.Required))
{
    channel.Send(message);
    scope.Complete();
}

• Y el fichero de configuración del cliente deberá contener:

<configuration>
  <appSettings>
    <add key="baseAddress" value=".\private$\MyTest33"/>
  </appSettings>
</configuration>

No olvidar incluir los espacios de nombre:

using System.ServiceModel;
using System.Messaging;
using System.ServiceModel.MsmqIntegration;

Y ni que decir tiene que la clase Persona (Persona.cs) contiene  tres propiedades públicas sin más; Nombre, Apellidos y OtraCosaMariposa, incluso, no será necesario establecer el atributo DataContract.

Por otro lado y durante la configuración del ejemplo nos podemos encontrar con alguno errores y que detallo a continuación:

Caso 1:

serviceHost.Open: Binding validation failed because the binding's ExactlyOnce property is set to true while the destination queue is non-transactional. The service host cannot be opened. Resolve this conflict by setting the ExactlyOnce property to false or creating a transactional queue for this binding.

Este problema es debido a la propiedad "exactlyOnce" tiene el valor "true" y la cola no es transaccional para solucionarlo:

1. Si la cola es transaccional entonces asignarle el valor "true" a esta propiedad.
2. si la cola NO es transaccional asignarle el valor "false".

Caso 2:

Binding validation failed because the binding's MsmqAuthenticationMode property is set to WindowsDomain but MSMQ is installed with Active Directory integration disabled. The channel factory or service host cannot be opened.

En este caso la solución es evitar que el valor del modo de seguridad del binding sea "WindowsDomain", puesto que la integración de MSMQ con Active Directory no ha sido instalada. Bastará, y si estamos en un dominio, con instalar esta integración desde los componentes de windows. Luego para nuestro caso, tanto cliente como servidor/host deberán establecer algunos valores:

Cliente en modo programático:

binding.Security.Mode = MsmqIntegrationSecurityMode.None;

Servidor mediante fichero de configuración:

<endpoint address="" binding="msmqIntegrationBinding" 
   bindingConfiguration="NewBinding0"  contract="WcfMsmqIntegration.IService1" />

El inconveniente de utilizar transacciones, si es que es un inconveniente, es el MSTC (Microsoft Transsaction Coordinator), que nos asegura la transaccionalidad de la operación de forma automática, pero que sin embargo, y dependiendo del entorno, es decir de la distribución entre servidores, podría resultar muy pesado e incluso no deseable. En caso de no hacer uso de la transaccionalidad, bastará con invocar de nuevo a nuestro "Sender" (envío de mensajes a MSMQ con WCF) desde el propio servidor/host y establecer un tratamiento adecuado y con esto estaría solucionado.

Finalmente y por ahora, he decir, que la ventaja de utilizar WCF para el tratamiento de colas MSMQ radica principalmente en la posibilidad de cambiar los bindings sin problema alguno, la trazabilidad totalmente automática, la seguridad de que todo va a funcionar a la primera, :-D

"Lo malo" puede ser que nos encontremos con que ya tenemos un sistema de colas MSMQ en un entorno de producción y que no podamos crear ningún servicio WCF, en tal caso, siempre podremos optar por crear un cliente WCF (ClientBase<T>), incluso también optar por el caso contrario, un servidor WCF y un cliente no WCF (System.Messaging).

http://www.cogin.com/mq/download.php

Un nuevo camino para el tratamiento de colas MSMQ.

saludos
Juanlu

No sé si a alguien le puede venir bien este ejemplo, pero seguro que sí, en cualquier caso, aquí está, :-P

Se trata de un proyecto C#  que permite crear "proxys" clientes a partir de un WSDL de forma dinámica.

Es un ejemplo de una calculadora muy sencillo pero que sin embargo y lo más importante es que puede modificarse y adaptase a nuestra necesidad con bastante facilidad.

He aquí la referencia para descargarlo y pegarse un poco más con el: http://wcf.netfx3.com/files/folders/development_tools/entry6148.aspx

Una vez Más espero haber ayudado un poquito.
Juanlu

Continuo con VS2008, con WCF (Windows Communication Foundation), en este caso integrando WCF con JAVA y más concretamente con una aplicación desarrollada en AXIS 1.1.0.xxx, vamos, "una patata" un problema, puesto que es la primera y obsoleta versión, no cumple muchos puntos del estandard WSDL, el principal  es que no permite las cláusulas <import>, es decir, es necesario generar un WSDL "to junto", en fin, cosas del directo como se suele decir, jeje...

Para conocer como afrontar este inconveniente, os cuento lo que he hecho:

Se trata de crear una extensión para nuestro WCF y en cierta forma dotarlo de una nueva funcionalidad, para ello usaremos los interfaces; IWsdlExportExtension, IEndpointBehavior. Entrando más en detalle, necesitaremos añadir código al evento ExportEndPoint de IWsdlExportExtension tal y como muestro a continuación:

 public void ExportEndpoint(
              WsdlExporter exporter,
              WsdlEndpointConversionContext context
           )
        {
            XmlSchemaSet schemaSet = exporter.GeneratedXmlSchemas;
            foreach (WsdlDescription wsdl in exporter.GeneratedWsdlDocuments)
            {
                List<XmlSchema> importsList = new List<XmlSchema>();
                foreach (XmlSchema schema in wsdl.Types.Schemas)
                {
                    AddImportedSchemas(schema, schemaSet, importsList);
                }
                wsdl.Types.Schemas.Clear();
                foreach (XmlSchema schema in importsList)
                {
                    RemoveXsdImports(schema);
                    wsdl.Types.Schemas.Add(schema);
                }
            }
        }

        private void AddImportedSchemas(
           XmlSchema schema,
           XmlSchemaSet schemaSet,
           List<XmlSchema> importsList
           )
        {
            foreach (XmlSchemaImport import in schema.Includes)
            {
                ICollection realSchemas =
                   schemaSet.Schemas(import.Namespace);
                foreach (XmlSchema ixsd in realSchemas)
                {
                    if (!importsList.Contains(ixsd))
                    {
                        importsList.Add(ixsd);
                        AddImportedSchemas(ixsd, schemaSet, importsList);
                    }
                }
            }
        }

        private void RemoveXsdImports(XmlSchema schema)
        {
            for (int i = 0; i < schema.Includes.Count; i++)
            {
                if (schema.Includes[i] is XmlSchemaImport)
                    schema.Includes.RemoveAt(i--);
            }
        }

El resto de métodos a sobrescribir podrán dejarse vacíos.

Adicionalmente y para poder configurar nuestro WCF con la herramienta de configuración (WCF Service Configuration Editor), será necesario:

public class InlineXsdBehaviorSection : BehaviorExtensionElement
    {

        protected override object CreateBehavior()
        {
            return new InlineXsdInWsdlBehavior();
        }

         public override Type BehaviorType
        {
            get
            {
                Type t = Type.GetType("MyProject.WCF.Extensions.InlineXsdInWsdlBehavior");
                return t;
            }
        }
    }

Finalmente tendremos que incluir esta DLL en el GAC, creando previamente un Strong Key, o bien, incluir la referencia en nuestro proyecto, con "Copy Local = true". Al menos durante el desarrollo os recomiendo que la incluyais en el GAC, evitará el estar constantemente seleccionando esta dll cada vez que editamos la configuración con el "WCF Service Configuration Editor", "menuda lata, ¿no?".

Para poner en marcha nuestro WCF:

• Configurar el WS de forma normal
• Cargar la nueva funcionalidad, para ello:
  • Abrir el editor y en el árbol de configuración (a la izquierda), desplegar"Advanced - Extensions"
  • seleccionar "behavior element extensions".
  • En la ventana de la derecha crear un nuevo elemento, Click en "New..."
  • Buscar y seleccionar nuestra DLL y asignar un nombre.

• Crear un nuevo "Endpoint Behavior".
  • Seleccionar "Advanced - Endpoint Behavior" en el árbol de configuración y crear ("Add...") un nuevo elemento.
  • El el siguiente cuadro de diálogo buscar y seleccionar el nombre dado a nuestra DLL.

• Por último, asociar la nueva extensión a nuestro EndPoint:
  • seleccionar "Services - MyProject.WCF.Extensions.InlineXsdInWsdlBehavior - EndPoints - MyEndpoint"
  • Asignar el Endpoint beavior a nuestro servicio dando valor la la propiedad  "BehaviorConfiguration"

Si ahora comprobamos el WSDL de nuestro WCF veremos como ya no incluye ninguna clausula "import".

Esto no es del todo cierto, jejeje... existe un inconveniente/restricción y dependerá de los Namespaces de nuestras clases, es decir, será necesario que todos los Namespaces sean iguales, vamos, que sólo exista un único Namespace.  Para ver como cambiar el namespace,  echad un vistazo a este otro post; "tempuri.org con WCF".

Para mayor detalle y comprensión sobre los behaviors, os sugiero que le echéis un vistazo a un artículo de la MSDN Magazine de Diciembre de 2007:   http://msdn.microsoft.com/msdnmag/issues/07/12/ServiceStation/default.aspx?loc=es

Nota: Para el siguiente post contaré sobre "ASP NET Compatibility" y lo que ofrece sobre todo a aquellos que estamos empezando con WCF.

Saludos y suerte en vuestras nuevas extensiones
Juanlu Crossposting from JuanLu, El Guerre

Durante el día de ayer mientras trabajaba con WCF en una máquina virtual, tuve la necesidad de instalar Exchanger Server 2003 junto con OWA porque el proyecto en el que estoy en cierta forma lo requería, cual fue mi sorpresa cuando tras la instalación, los web services desarrollados con WCF (Framework 3.0) dejaron de funcionar. El error "The page cannot be display" o "Service Unavailable" ¿Por qué? ¿A que se debe esto?, pues bien, la respuesta es muy fácil,¡claro ahora que la conozco! Los ficheros ".svc" no son reconocidos, las ISAPI que tratan estos ficheros no se encuentran registradas y por tanto es necesario volverlas a registrar, jeje... ¡es lo que tiene el instalar y desinstalar cosas en las máquinas de desarrollo!

Estos son los pasos a realizar:

• C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Aspnet_regiis -i - enable. (Esta ya es bastante conocida y seguro que a más de uno nos a pasado más de una vez).
• C:\WINDOWS\Microsoft.NET\Framework\v3.0\Windows Communication Foundation\ServiceModelReg -i

Tras la ejecución de este comando

En esta página, explica los pasos más en profundidad así como la reparación manual si fuera necesario.

Justo hoy, un añito más viejo, jejeje...
Gracias a tod@s por compartirlo conmigo
Juanlu

Muy buenas de nuevo, siento haber estado desaparecido una temporada, pero como mi madre dice "En misa y repicando", ¡no,no,no...! jejeje...

En fin, en esta ocasión y antes de comentar varios casos sobre WCF (Windows Communication Foundation),voy a hacer mención a varias de las herramientas que nos van a permitir poder trabajar un poquito mejor. Para hacer más fácil su uso y comprensión, ¡que mejor que hacer un pequeño ejemplo y ver su funcionamiento!.

1. En primer lugar creamos un proyecto "WCF Service Application".
2. Publicamos el Web service en nuestro IIS: Ej: en http://localhost/WcfService1/ .
3. Comprobamos el acceso al servicio desde iexplorer: http://localhost/wcfservice1/service1.svc
4. Hasta aquí, todo perfecto, todo funciona, perfectamente. Nota: Al publicar un servicio por primera vez, la la autenticación se establece como "anónima".
5. Ahora veamos como configurar nuestro servicio. "WCF Service Configuration Editor".   Por defecto una vez creado el servicio, el Binding es "wsHttpBinding" para nuestro Services - EndPoint

Con Internet Explorer, todo funciona correctamente, si creamos una aplicación de consola (en 3.0 ó 3.5) y añadimos una referencia a nuestro WCF Service "Add Service Reference" se crea una clase proxy y listo. Poco hemos hecho hasta este momento, jejeje... ¡vamos por buen camino!

Ahora utilizando la siguiente herramienta, podremos chequear nuestro WCF Service sin necesidad de tener que crear una aplicación de test como la anterior, además podremos visualizar todas las peticiones y respuestas de tipo SOAP.

WcfTestClient

C:\Development\WCF\Samples\WcfService1>wcftestclient http://localhost/WcfService1/Service1.svc

Todo sigue funcionando correctamente y hemos chequeado la funcionalidad del WCF Service. Ya tenemos todo apunto.

NOTA: Ni que decir tiene que el servicio que se quiere testear ha de estar en ejecución, de lo contrario un error amenizará la ocasión, jijiji...

Ahora otra forma de hostear nuestro Web Service:

WcfServiceHost

¿Porque necesito "obligatoriamente" hostear mi WCF service en IIS?, pues bien, con esta herramienta proporcionada por WCF no será necesario, simplemente diferente a como estamos acostumbrados, podemos evitar el tener que instalar IIS, bien porque no queremos o no tenemos el CD/DVD correspondiente o, simplemente debido a las prisas, cosa que suele ser bastante común, jejeje...

Asegura de que el servicio no está hosteado en IIS para que no existan conflictos, también hay que estar seguro de que la propiedad Address del Endpoint del servicio tiene el valor "http://localhost/Wcfservice1/service1.svc", seguidamente tecleamos:

C:\Develpment\WCF\Samples\WcfService1> wcfsvchost /service:"./bin/WcfService1.dll" /config:web.config

Tras ejecutar este comando se carga el WCF Service en la herramienta, pero ¿Que ocurre?, pues que tenemos un error:

 1 System.InvalidOperationException: The HttpGetEnabled property of ServiceMetadataBehavior is set to true and the HttpGetUrl property is a relative address, but there is no http base address.  Either supply an http base address or set HttpGetUrl to an absolute address.
 2    at System.ServiceModel.Description.ServiceMetadataBehavior.EnsureGetDispatcher(ServiceHostBase host, ServiceMetadataExtension mex, Uri url, String scheme)
 3    at System.ServiceModel.Description.ServiceMetadataBehavior.CreateHttpGetEndpoints(ServiceDescription description, ServiceHostBase host, ServiceMetadataExtension mex)
 4    at System.ServiceModel.Description.ServiceMetadataBehavior.System.ServiceModel.Description.IServiceBehavior.ApplyDispatchBehavior(ServiceDescription description, ServiceHostBase serviceHostBase)
 5    at System.ServiceModel.Description.DispatcherBuilder.InitializeServiceHost(ServiceDescription description, ServiceHostBase serviceHost)
 6    at System.ServiceModel.ServiceHostBase.InitializeRuntime()
 7    at System.ServiceModel.ServiceHostBase.OnOpen(TimeSpan timeout)
 8    at System.ServiceModel.Channels.CommunicationObject.Open(TimeSpan timeout)
 9    at System.ServiceModel.Channels.CommunicationObject.Open()
10    at Microsoft.Tools.SvcHost.ServiceHostHelper.OpenService(ServiceInfo info)

Utilizamos el editor de configuración de WCF (SvcConfigEditor) y  asignamos el valor http://localhost/WcfService1/Service1.svc a la propiedad  HttpGetUrl según muestro en la siguiente imagen:

Si  ahora intentamos ejecutar de nuevo la instrucción veremos como el WCF Service es iniciado correctamente. En este momento ya lo tenemos nuevamente "hosteado".

También existe la posibilidad de lanzar estas dos aplicaciones "Servidor/Host" y "Cliente/Client" de una sóla "atacada", :-D

C:\Develpment\WCF\Samples\WcfService1> wcfsvchost /service:"./bin/WcfService1.dll" /config:web.config /client: MyClient.exe /clientArgs:123456, abcdef

Trazas - SvcTraceViewer

Esta herramienta con una interfaz gráfica que se distribuye con WCF, aunque por otro lado "no estoy seguro", parece que con algunas versiones de VSTS si es así, no obstante, con el SDK de Windows se distribuye y  en cualquier caso, aquí os dejo un ".zip" con dicha herramienta.

El objetivo de esta es mostrar la información almacenada en los ficheros ".svclog", que son generados por el "Service.Model" configurado en los web.config de los WCF Services; un fichero de mensajes y otro de trazas.

Referencia: http://msdn2.microsoft.com/en-us/library/ms732023.aspx 

Existe otra herramienta de terceros "Live Service Trace Viewer" (http://blogs.msdn.com/craigmcmurtry/archive/2006/09/19/762689.aspx) que a pesar de mostrar la misma información (.svclog) lo hace de una forma mucho más gráfica y "quizás" más intuitiva.

Como vemos  WCF está comenzando a dar mucho juego y por supuesto a facilitarnos mucho el trabajo, en fin, mientras sea así, todo será bienvenido, :-D

Espero haber sido de ayuda una vez más.
Saludos y hasta la próxima.
Juanlu

Seguimos con otra cosita interesante, ahora sobre WCF, se trata del Configurador "WCF Service Configuration Editor". Sabemos que es una herramienta "externa" pero a la vez, integrada en el Visual Studio 2008, bueno, o eso creo.

Es curioso, pero si intentamos abrir este configurador a partir de nuestro menú "popup" al hacer "click" sobre un fichero ".config" de un proyecto, debería abrirse, ese es su cometido, sin embargo, no ocurre así, no la primera vez, si, como digo, no, la primera vez, jejejeje....

Sigue estos pasos y verás:

• Abre el Visual estudio y crea un nuevo proyecto.
• Añade un item de tipo ".config"
• Haz clic con el botón derecho sobre dicho item, y...

• Ahora, selecciona: Menu: "Tools - WCF Service Configurator Editor"

Por último, vuelve a hacer "click" con el botón derecho sobre el item ".config" y........ "taaaaachaaaaannnn....", ahí esta el "tío", :-P

Pues nada, una vez más, mostrando un camino más fácil, o por lo menos, dando a conocer los tropiezos de un largo recorrido, :-D

Saludos desde Nuevos Ministerios
Juanlu

Muy buenas a todos, como ya sabéis el esperado VS2008, ya está aquí, concretamente a finales de noviembre e incluso antes para algunos, jejeje...

Bueno, pues ahora que está de camino, yo no puedo quedarme atrás, así que he comenzado con mis primeros pasos prácticos. Mi otro amigo el CSF también está ahí, claro que tampoco puedo dejarlo atrás, seguiré con él por supuesto, pero en Posts posteriores, ahora toca un poco de VS2008, es bueno cambiar para no cansarse de lo mismo, y claro, no quedarse anticuado, :-D.

En fin, en este caso quiero hacer una pequeña pero interesante anotación.

¿Como resetear los Settings del VS para que al iniciar VS aparezca el cuadro de diálogo "Seleccionar configuración de entorno predeterminada"? pues como en versiones anteriores y al igual que cuentan muchos posts:

DevEnv /ResetSettings

Sin embargo, es curioso, me dirijo a hacerlo pero, noooooo, no funciona, ¿Que pasará?, pues nada miro la ayuda: "DevEnv /?" y nada, no hay nada que me interese. ¡Ummmmhhh!, con la ayuda de Bruno todo solucionado, :-D, en alguna página de Microsoft también se indica (http://msdn2.microsoft.com/es-es/library/ms243146(VS.80).aspx), pero lo mejor es que no aparece en la ayuda. :-(

DevEnv /ResetUserData

Si aún así no funciona, porque no siempre lo hace (en vs 2008 me ha funcionado siempre pero no ocurre lo mismo en VS2005), entonces:

1. Inicia Visual Studio
2. Menu:  "Tools - Import And Export Settings..."
3. En  el siguiente cuadro de diálogo selecciona "Reset all settings"
4. A continuación guarda tu "setting" actual si quieres.
5. Y por último selecciona de la lista el nuevo "setting" que quieres cargar, este se cargará automáticamente.

Poca cosa, pero para no olvidar, :-P
Saludos
Juanlu