Service Operations und mehr mit ADO.NET Data Services
Wer Dokumentation liest ist klar im Vorteil. Ich gebe zu, ich schaue mir eine API an und versuche Intuitiv mit dieser zu arbeiten. Doch manchmal gibt es einfach die Notwendigkeit die Dokumentation zu lesen.
Was ist mein Problem? Ich habe ein Entity Framework Modell das Kategorien und Produkte enthält. Beide Entities sind mit Datenbankgenerierten IDs ausgestattet. Die Entitäten werden von einem Repository gekapselt und das Repository implementiert auch noch zusätzliche Funktionalität.
public interface ICatalogServiceRepository
{
IQueryable<Categories> GetCategories();
IQueryable<Products> GetProductsByCategory( Categories category );
IQueryable<Categories> GetCategoriesWithProducts();
Guid GetExternalProductReference(Products product);
IQueryable<Guid> GetExternalProductReferencesByProducts(
IQueryable<Products> products);
}
Dies ist die Schnittstelle um auf die Entitäten zuzugreifen. Rein lesend. Die Deklarationen in Zeile 6 und Zeile 7 unterstützen das Mapping von Produkt-Entitäten auf Systeme ausserhalb unseres Modell. Hier wird bei Bedarf eine Guid erstellt, wenn eine externe Referenz zu einem Objekt angefordert wird.
Das Repository soll in verschiedenen Umgebungen zum Einsatz kommen, unter anderem auch in einem ADO.NET Data Service. Leider kann ich dort folgendes nicht deklarieren:
public static void InitializeService( IDataServiceConfiguration config )
{
// Wenn ich keine Entitäten im Zugriff erlaube, kann ich diese auch
// nicht in Service Operationen einsetzen
config.SetEntitySetAccessRule( "*", EntitySetRights.None );
config.SetServiceOperationAccessRule( "GetCategories",
ServiceOperationRights.AllRead );
// Diese Service Operation ist ungültig ==> Parameter != Primitive Type
config.SetServiceOperationAccessRule( "GetProductsByCategory",
ServiceOperationRights.AllRead );
config.SetServiceOperationAccessRule( "GetCategoriesWithProducts",
ServiceOperationRights.AllRead );
// Diese Service Operation ist ungültig ==> Parameter != Primitive Type
config.SetServiceOperationAccessRule( "GetExternalProductReference",
ServiceOperationRights.AllRead );
// Diese Service Operation ist ungültig ==> Parameter != Primitive Type
config.SetServiceOperationAccessRule( "GetExternalProductReferencesByProducts",
ServiceOperationRights.AllRead );
}
Ein Blick in die Dokumentation sagt folgendes:
-
The method must accept only [in] parameters.
- If parameters are defined, the type of each parameter must be a primitive type.
-
The method must return void, IEnumerable<T>, IQueryable<T>, T, or a primitive class such as integer or string.
-
T MUST be a class that represents an entity type in the data model being exposed by the data service.
-
In order to support query options such as sorting, paging, and filtering, service operation methods should return IQueryable<T>.
-
…
Den Rest habe ich mal weggelassen. Die Konsequenz ist das beim Starten der Service einen Request Fehler bringt und man in die Logs schauen soll.
Ich möchte nun nicht mein Entity Modell entsprechend dem ADO.NET Data Service anpassen, noch möchte ich mein Repository so auslegen das es für einen ADO.NET Data Service passt. Ich werde nicht herum kommen einen Adapter zu schreiben, der entsprechend die Regeln für den ADO.NET Data Service sicherstellt und mein Repository nutzen kann.