RIA Services: Paso a paso (II)

[EnableClientAccess()]
public class SuppliersService : LinqToEntitiesDomainService<NorthwindEntities>
{
    public IQueryable<Suppliers> GetSuppliers()
    {
        return this.Context.Suppliers;
    }

    public void InsertSuppliers(Suppliers suppliers)
    {
        this.Context.AddToSuppliers(suppliers);
    }

    public void UpdateSuppliers(Suppliers currentSuppliers, Suppliers originalSuppliers)
    {
        this.Context.AttachAsModified(currentSuppliers, originalSuppliers);
    }

    public void DeleteSuppliers(Suppliers suppliers)
    {
        if ((suppliers.EntityState == EntityState.Detached))
        {
            this.Context.Attach(suppliers);
        }
        this.Context.DeleteObject(suppliers);
    }
}

 

Es una clase que deriva de LinqToEntitiesDomainService y como característica especial destacar que está decorada con el atributo EnableClientAccess, que es la manera de decir que esta clase tiene que estar accesible desde el proyecto cliente.

 

También observar que se han generado los método típicos de cualquier aplicación guiada por datos. Se han creado los métodos y las llamadas necesarias al modelo de Entity Framework para realizar las opciones CRUD ( Create/Read/Update/Delete).

En este caso, las llamadas son llamadas directas al modelo, pero en esta clase podríamos incluir toda la lógica que consideremos para cubrir la funcionalidad que necesitemos en la aplicación.

 

Por cierto, si en el diálogo de creación del servicio no hubiéramos seleccionado la opción “Enable Editing”, sólo se hubiera creado el método GetSuppliers.

 

Después de generar el servicio y compilar la solución, veremos cómo automáticamente se ha creado el proxy en el cliente. Para poder verlo es necesario seleccionar la opción “Show All Files”.

 

 

El atributo EnableClientAccess y el hecho de que ambos proyectos “estén unidos” hace que al crear o cambiar los servicios del servidor ( DomainService ) se creen los proxys necesarios en el cliente ( DomainContext ).

 

 

Fijaros cómo en el cliente se accede a través de SupplierContext y cómo en lugar de llamarse el método GetSuppliers, como está en el DomainService, se llama LoadSuppliers. Este cambio lo hace RIA Services y en un post posterior veremos por qué lo hace.

 

 

 

 

Por completar el ejemplo anterior, vamos a hacer que en el grid de datos sólo se muestren los proveedores que de una determinada ciudad.

 

Para ello, vamos a añadir un nuevo parámetro al método GetSuppliers del servicio de dominio. También añadiremos la sentencia de LINQ to Entities necesaria para obtener la información que nos interesa del modelo.

 

public IQueryable<Suppliers> GetSuppliers(string city)
{
    return (from c in this.Context.Suppliers
            where c.City == city
            select c);
}

 

Una vez realizado este cambio en el cliente tendremos ya accesible el nuevo método con el parámetro, sin hacer nada más.

 

SuppliersContext context = new SuppliersContext();
gridRiaDemo.ItemsSource = context.Suppliers;
context.LoadSuppliers("London");

#region LoadSuppliers method overloads
/// <summary>
/// Invokes the server-side method 'GetSuppliers' and loads the result into <see cref="Suppliers"/>.
/// </summary>
[LoadMethod(typeof(Suppliers))]
public void LoadSuppliers()
{
    this.LoadSuppliers(null, MergeOption.KeepCurrentValues, null);
}

/// <summary>
/// Invokes the server-side method 'GetSuppliers' and loads the result into <see cref="Suppliers"/>.
/// </summary>
[LoadMethod(typeof(Suppliers))]
public void LoadSuppliers(IQueryable<Suppliers> query, object userState)
{
    this.LoadSuppliers(query, MergeOption.KeepCurrentValues, userState);
}

/// <summary>
/// Invokes the server-side method 'GetSuppliers' and loads the result into <see cref="Suppliers"/>.
/// </summary>
[LoadMethod(typeof(Suppliers))]
public void LoadSuppliers(IQueryable<Suppliers> query, MergeOption mergeOption, object userState)
{
    base.Load("GetSuppliers", null, query, mergeOption, userState);
}
#endregion