Antes de empezar deberemos habilitar el Acceso Anónimo en el Sitio Web de IIS sobre el que deseemos ejecutar el servicio WCF que vamos a crear durante este ejemplo.
Crearemos un nuevo Proyecto vacío (Empty SharePoint Project) de SharePoint 2010 con Visual Studio 2010, como Solución de Tipo Granja (Deploy as a Farm Solution), ya que vamos a crear un Servicio WCF que deseamos poder desplegar en la carpeta ISAPI de SharePoint, por lo que nos podemos utilizar una solución Sandboxed. En nuestro caso de ejemplo, llamaremos al Proyecto MyWCFservice.
Seguidamente, añadiremos un mapeo a la carpeta ISAPI de SharePoint en nuestro Proyecto, por el motivo comentado en el párrafo anterior. Para ello, utilizaremos la opción Add SharePoint Mapped Folder del menú contextual de nuestro Proyecto.
En el diálogo Add SharePoint Mapped Folder, seleccionaremos la carpeta ISAPI y click OK para continuar.
Crearemos una subcarpeta denominada MyWCFservice por debajo del mapeo a la carpeta ISAPI (esto no es estrictamente necesario, pero sí es cierto que se trata de una buena práctica), para seguidamente añadir un fichero de texto llamado MyWCFservice.svc en su interior, inicialmente vacío. Más adelante lo rellenaremos con una directiva para indicar que es un servicio, así como el ensamblado (assembly) y la clase a que corresponde (no tiene mucho más, será una simple línea de texto).
Ahora añadiremos un nuevo elemento al Proyecto de tipo WCF Service, y lo llamaremos MyWCFservice.cs.
Esta acción añadirá tres ficheros a la raíz de nuestro Proyecto de Visual Studio:
- IMyWCFservice.cs. Define el contrato, es decir, qué métodos están expuestos por el Servicio, así como los parámetros y sus tipos. El interfaz viene decorado con el atributo [ServiceContract], y cada método viene decorado con el atributo [OperationContract]. Por defecto, sólo incluye el método DoWork(), siendo posible añadir más métodos.
- MyWCFservice.cs. Implementa la interfaz anterior, y en consecuencia, es el lugar donde escribiremos el código necesario para conseguir la funcionalidad deseada de nuestro servicio.
- app.config. En muchos casos también se puede renombrar como web.config. Incluye información de descubrimiento (endpoint) del servicio.
Moveremos el fichero app.config desde la raíz de nuestro Proyecto a la carpeta ISAPI\MyWCFservice, para seguidamente renombrarlo como web.config.
Hecho esto compilaremos nuestro Proyecto (Build) en Visual Studio para a continuación utilizar el comando sn.exe de las tools de Visual Studio para obtener el Public Key Token del ensablado (DLL).
Añadiremos la siguiente línea de texto al fichero MyWCFservice.svc.
<%@ ServiceHost Debug="true" Language="C#" Service="MyWCFservice.MyWCFservice, MyWCFservice, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5edf24b0f12c8956" CodeBehind="MyWCFservice.cs" %>
Modificaremos el método DoWork del interfaz IMyWCFservice para que devuelva un String, en lugar de void.
En la clase MyWCFservice también modificaremos el método DoWork para que devuelva un String, añadiremos una línea using System.ServiceModelActivarion, y añadiremos una etiqueta AspNetCompatibilityRequirements a nuestra clase, tal y como se muestra en la siguiente pantalla capturada.
Realizado todo esto deberemos compilar (Build) y deplegar (Deploy) nuestra solución, y accederemos a la URL correspondiente a nuestro Servicio Web WCF desde un navegador, en nuestro caso de ejemplo: http://vwss4/_vti_bin/mywcfservice/mywcfservice.svc
Esta es una forma de crear un Servicio Web WCF con Visual Studio, utilizando las plantillas que tenemos disponibles Out of the Box (OOB). Téngase en cuenta, que el Community Kit for SharePoint (CKSDev) incluye también una plantilla para el desarrollo de Servicios Web WCF.
Si deseamos acceder a nuestro nuevo Servicio Web WCF desde una aplicación cliente en Visual Studio, deberemos añadir una referencia Web a dicho Servicio Web en Visual Studio, y luego escribir unas pocas líneas de código, tal y como se muestra en el siguiente ejemplo.
Poco más por hoy. Como siempre, confío que la lectura resulte de interés.
