Pasión por la tecnología…

abril 15, 2009

Jugando con ADO.NET Data Services CTP 1.5 (I)!

Archivado en: ADO.NET Data Services,Visual Studio 2010 — Juan Carlos González Martín @ 16:43

Desde hace unos días estoy trasteando (por no decir sufriendo) con la reciente CTP ADO.NET Data Services 1.5 (por suerte, a veces se ve la luz al final del túnel) y aunque el tema está un poco verde, ya se pueden enseñar algunas cosas. En este primer post (espero escribir alguno más) os voy a mostrar algunas novedades de ADO.NET Data Services que aparecerán tanto en la versión 1.5 como en la versión que venga con Visual Studio 2010 (se supone que aquí será la versión 2.0). En concreto, veremos el tema de la paginación en el servidor y como consumir el servicio desde una aplicación.

Definiendo el servicio y paginando en el servidor

Como sin duda sabéis, ADO.NET Data Services nos permite definir servicios de datos de tipo RESTFull sobre un cierto modelo de datos (ya sea de Entity Framework, de LINQ To SQL, de un archivo XML, objetos CLR en memoria, NHibernate, …). Realmente, se trata de una abstracción construida sobre WCF pensada para gestionar de manera centralizada los datos procedentes de este modelo a partir de proporcionar capacidades como:

  • Consultas, filtrado, ordenación, etc de datos del modelo.
  • Utilización en todo momento de protocolos estándar para exponer y acceder al modelo: HTTP + Atom. Esta es precisamente la idea de los servicios RESTFull. De hecho, ADO.NET Data Services usa HTTP como capa de mensajería lo que habilita usar comandos estándar HTTP para consumir los datos: GET, DELETE…y Atom para representar los datos devueltos.
  • Consultamos datos sin escribir código.

Estas capacidades las tenemos desde la versión 1.0 de ADO.NET Data Services. Sin embargo, en la primera versión hay una serie de problemas que se resolverán en las versiones 1.5 y 2.0. Por ejemplo:

  • Paginación de los datos, tanto en cliente como en el servidor, para evitar que el cliente consulte todas las entidades del modelo cada vez que realiza una consulta. Esto se resuelve en la versión 1.5, como veremos, con SetEntitySetAccessRule.
  • No tenemos conciencia del número de registros que tenemos en el servidor. En la versión 2.0, y seguramente en la 1.5, esto se solucionará con un nuevo operador Count que nos devuelve las filas del modelo, pero sin traerse todas las entidades en la consulta.

Pero pasemos a la acción…lo primero que vamos a hacer es definir un servicio de datos de ADO.NET Data Services v1.5 CTP1. Para ello:

  • Creamos, en Visual Studio 2008 (en Visual Studio 2010 es imposible, y lo digo por experiencia) un proyecto de tipo web.
  • A nuestro proyecto web le añadimos un Entity Data Model (EDM) de ADO.NET Entity Framework que creamos a partir de la BD AdventureWorks.
  • Una vez creado el EDM, añadimos al proyecto web un elemento de tipo ADO.NET Data Services v1.5 CTP1.
image image

Lo siguiente que haremos, es empezar a configurar el servicio de datos que acabamos de añadir. Para ello:

  • Editamos el archivo .cs asociado al servicio (que tenemos en la carpeta App_Code de nuestro proyecto web).
  • En la definición de la clase correspondiente, realizamos las modificaciones necesarias para que por un lado nuestro servicio permita consultar las entidades del EDM, y por otro se especifiquen las reglas para acceder a dichas entidades:

using System;

using System.Data.Services;

using System.Collections.Generic;

using System.Linq;

using System.ServiceModel.Web;

 

public class WebDataService : DataService<AdventureWorksModel.AdventureWorksEntities>

{

    // This method is called only once to initialize service-wide policies.

    public static void InitializeService(IDataServiceConfiguration2 config)

    {

        // TODO: set rules to indicate which entity sets and service operations are visible, updatable, etc.

        // Examples:

        config.SetEntitySetAccessRule("*", EntitySetRights.All);

        // config.SetServiceOperationAccessRule("MyServiceOperation", ServiceOperationRights.All);

    }

}

  • Como se puede apreciar, AD.NET Data Services v1.5 añade una nueva implementación para IDataServiceConfiguration (se le añade el 2 al nombre) que permite estas nuevas capacidades de paginación en el servidor para mejorar la experiencia de usuario. A continuación, a través de SetEntitySetAccessRule, hemos especificado que exponemos todas las entidades (*) y con permisos CRUD para las mismas.
  • Si ejecutamos el proyecto, veremos como efectivamente se exponen todas las entidades de nuestro modelo.
  • También podremos consultar cualquier entidad del modelo sin más que poner /<NombreEntidad> a continuación de la url del servicio de datos:
image image
  • Ahora bien, consultar entidades de la forma anterior adolece de problemas de rendimiento si el número de registros en el servidor es muy elevado…la solución está en poder añadir el mecanismo de paginado en el servidor comentado…y es tan sencillo como añadir la siguiente línea en la configuración del servicio:

        config.SetResourceSetPageSize("Product", 4);

  • De esta forma, al consultar la entidad Product el servicio nos devolverá cuatro productos y un enlace a los siguientes cuatro productos:

image

Consumiendo el servicio

Para consumir el servicio de ADO.NET Data Services creado en una aplicación (por ejemplo de consola), necesitaremos en primer lugar representar las entidades definidas en el servicio de datos. Para ello, deberíamos crearlas en nuestro proyecto, siendo dos las posibilidades que tenemos:

  • Crear estas entidades a mano desde cero en el correspondiente archivo .cs.
  • Utilizar la utilidad de comandos DataSvcUtil que tenemos en la carpeta bin del directorio de instalación de ADO.NET Data Services y que nos permite generar la representación de las entidades en el servicio en el correspondiente archivo .cs. DataSvcUtil nos da varias opciones para generar el archivo .cs (lo podéis comprobar tecleando DataSvcUtil /help), entre ellas especificar la uri de nuestro servicio de datos (es la que he utilizado en mi caso):

DataSvcUtil /out:"WebDataService.cs" /uri:"http://localhost:1382/ADO_NET_DATA_SERVICES_v1_5/WebDataService.svc/&quot;

  • Tecleando la sentencia anterior, en unos pocos segundos tendremos creado el archivo .cs que contiene las entidades definidas en el servicio de datos, y que añadiremos a nuestro proyecto.
image image image

Generado el archivo .cs que contiene la representación de las entidades de nuestro servicio de datos, ya estamos listos para consultarlo. Los pasos previos son:

  • Añadir la referencia en nuestro proyecto a los ensamblados Microsoft.Data.Services y Microsoft.Data.Services.Client.
  • Añadir las correspondientes sentencias using en nuestro archivo de código para poder utilizar estos ensamblados:

using System.Data.Services;

using System.Data.Services.Client;

Para consultar el servicio de datos, tenemos dos posibilidades:

  • En el propio contexto del servicio de datos a partir de las clases WebDataContext y WebDataQuery que forman parte de Microsoft.Data.Services.Client. Simplemente, lo que tendremos que hacer es crear una instancia de un objeto WebDataContext que nos permite consultar las entidades del servicio de datos a partir de la Uri del mismo y a continuación crear una instancia de WebDataQuery en el que especificaremos (por ejemplo) la entidad a consultar en un estilo similar a las consultas que hacemos a través del navegador:

            Uri uService =

                new Uri("http://localhost:1382/ADO_NET_DATA_SERVICES_v1_5/WebDataService.svc&quot;);

            DataServiceContext ctx =

                new DataServiceContext(uService);

 

            DataServiceQuery<Product> Products = ctx.CreateQuery<Product>("/Product");

 

            foreach (var product in Products)

            {

                Console.WriteLine(product.Name);

            }

 

            Console.ReadLine();

  • Utilizando el contexto del servicio de datos disponible con la clase DataServiceContext, lo que nos permite definir consultas LINQ facilitando la realización de estas consultas al servicio de datos. En este caso, el código para consultar el servicio es todavía más intuitivo:

            AdventureWorksEntities ctx2 =

                new AdventureWorksEntities(uService);

 

            var q = from p in ctx2.Product

                    select p;

 

            foreach (var product in Products)

            {

                Console.WriteLine(product.Name);

            }

La salida por pantalla generada por estas dos alternativas de consulta del servicio de datos es la siguiente:

image

Como podéis apreciar, se siguen devolviendo cuatro productos tal y como definimos en la configuración del servicio. Y nada, hasta aquí llega este primer post sobre ADO.NET Data Services. Espero que os resulte interesante.

About these ads

1 Comentario »


RSS feed para los comentarios de esta entrada. TrackBack URI

Deja un comentario

Introduce tus datos o haz clic en un icono para iniciar sesión:

Logo de WordPress.com

Estás comentando usando tu cuenta de WordPress.com. Cerrar sesión / Cambiar )

Imagen de Twitter

Estás comentando usando tu cuenta de Twitter. Cerrar sesión / Cambiar )

Foto de Facebook

Estás comentando usando tu cuenta de Facebook. Cerrar sesión / Cambiar )

Google+ photo

Estás comentando usando tu cuenta de Google+. Cerrar sesión / Cambiar )

Conectando a %s

El tema Rubric Blog de WordPress.com.

Seguir

Recibe cada nueva publicación en tu buzón de correo electrónico.

Únete a otros 40 seguidores

%d personas les gusta esto: