Operaciones de servicio (WCF Data Services)

Al definir operaciones de servicio en el servicio de datos deben tenerse en cuenta los requisitos siguientes. Si un método no los cumple, no se expondrá como operación de servicio para el servicio de datos.

• La operación debe ser un método de instancia pública que sea miembro de la clase del servicio de datos.

• El método de la operación solo puede aceptar parámetros de entrada. El servicio de datos no puede tener acceso a los datos enviados en el cuerpo del mensaje.

• Si se definen parámetros, el tipo de cada parámetro debe ser un tipo primitivo. Cualquier dato de un tipo no primitivo se debe serializar y pasar a un parámetro de cadena.

• El método debe devolver uno de los elementos siguientes:

  • void (Nothing en Visual Basic)

  • IEnumerable<T>

  • IQueryable<T>

  • Un tipo de entidad en el modelo de datos expuesto por el servicio de datos.

  • Una clase primitiva como entero o cadena.

• Para admitir opciones de consulta como ordenaciones, paginaciones y filtrados, los métodos de las operaciones de servicio deben devolver IQueryable<T>. Las solicitudes a operaciones de servicio que incluyen opciones de consulta se rechazan para las operaciones que solo devuelven IEnumerable<T>.

• Para que se pueda tener acceso a las entidades relacionadas usando las propiedades de navegación, la operación de servicio debe devolver IQueryable<T>.

• El método se debe anotar con el atributo [WebGet] o [WebInvoke].

  • [WebGet] permite invocar el método usando una solicitud GET.

  • [WebInvoke(Method = "POST")] permite invocar el método usando una solicitud POST. No se admiten otros métodos WebInvokeAttribute.

• Una operación de servicio se puede anotar con el elemento SingleResultAttribute que especifica que el valor devuelto desde el método es una sola entidad en vez de una colección de entidades. Esta distinción dicta la serialización resultante de la respuesta y la manera en que se representan en el URI los recorridos de las propiedades de navegación adicionales. Por ejemplo, cuando use la serialización AtomPub, una sola instancia de tipo de recurso se representa como elemento de entrada y un conjunto de instancias como elemento de fuente.

Puede direccionar las operaciones de servicio colocando el nombre del método en el primer segmento de la ruta de acceso de un URI. Como ejemplo, el siguiente URI tiene acceso a una operación GetOrdersByState que devuelve una colección IQueryable<T> de objetos Orders.

http://localhost:12345/Northwind.svc/GetOrdersByState?state='CA'&includeItems=true

Al llamar a una operación de servicio, los parámetros se proporcionan como opciones de consulta.La operación de servicio anterior acepta tanto un parámetro de cadena state como un parámetro booleano includeItems que indica si se van a incluir objetos Order_Detail relacionados en la respuesta.

A continuación se enumeran los tipos de valor devueltos válidos para una operación de servicio:

Se pueden agregar segmentos de ruta de acceso u opciones de consulta adicionales al URI en función del tipo de valor devuelto de la operación de servicio.Por ejemplo, el URI siguiente tiene acceso a una operación GetOrdersByCity que devuelve una colección IQueryable<T> de objetos Orders, ordenada en orden descendente por RequiredDate, junto con los objetos Order_Details relacionados:

http://localhost:12345/Northwind.svc/GetOrdersByCity?city='London'&$expand=Order_Details&$orderby=RequiredDate desc

El método SetServiceOperationAccessRule de la clase IDataServiceConfiguration controla la visibilidad en el ámbito de todos los servicios de las operaciones de servicio, de la misma forma que el método SetEntitySetAccessRule controla la visibilidad del conjunto de entidades. Por ejemplo, la línea de código siguiente de la definición del servicio de datos permite el acceso a la operación de servicio CustomersByCity.

config.SetServiceOperationAccessRule(
    "GetOrdersByCity", ServiceOperationRights.AllRead);

Nota
Si una operación de servicio tiene un tipo de valor devuelto que se oculta restringiendo el acceso en los conjuntos de entidades subyacentes, la operación de servicio no estará disponible para las aplicaciones cliente.

Para obtener más información, vea Cómo: Definir una operación de servicio (WCF Data Services).

Recomendamos utilizar la clase DataServiceException cada vez que produzca una excepción en la ejecución del servicio de datos. Esto es porque el tiempo de ejecución del servicio de datos sabe cómo asignar correctamente propiedades de este objeto de excepción al mensaje de respuesta HTTP. Al generar una DataServiceException en una operación de servicio, la excepción devuelta está contenida en TargetInvocationException. Para devolver la DataServiceException base sin la TargetInvocationException envolvente, debe invalidar el método HandleException(HandleExceptionArgs) en DataService<T>, extraer DataServiceException de TargetInvocationException y devolverlo como el error de nivel superior, como en el siguiente ejemplo:

// Override to manage returned exceptions.
protected override void HandleException(HandleExceptionArgs args)
{
    // Handle exceptions raised in service operations.
    if (args.Exception.GetType() ==
        typeof(TargetInvocationException)
        && args.Exception.InnerException != null)
    {
        if (args.Exception.InnerException.GetType()
            == typeof(DataServiceException))
        {

            // Unpack the DataServiceException.
            args.Exception = args.Exception.InnerException as DataServiceException;

        }
        else
        {
            // Return a new DataServiceException as "400: bad request."
            args.Exception =
                new DataServiceException(400,
                    args.Exception.InnerException.Message);
        }
    }
}

Conceptos