Gebruik van getypeerde Api.Zselect-methoden

Mercator heeft altijd een complete set Api.Zselect() methoden aangeboden voor het verkrijgen van gegevens uit de SQL database in de vorm van een DataSet. Het is nu ook mogelijk om dezelfde methoden te gebruiken in een getypeerde versie, Api.Select<T>(), om direct een List<T> te verkrijgen. Het voordeel hiervan is dat het resultaat van elke kolom getypeerd zal zijn, waardoor het vermijden van conversies mogelijk is, en men kan genieten van het gemak van intellisense en de veiligheid die de typecontrole van de compiler biedt.

Om een getypeerde Zselect methode te gebruiken, moet je een objectklasse definiëren die overeenkomt met de gegevens die zullen worden geëxtraheerd door de SQL query. Kolomnamen moeten overeenkomen met de namen van eigenschappen in de klasse (case non sensitive).

In het volgende voorbeeld willen we een lijst van klanten verkrijgen, met deze informatie :

• De klant ID
• Hun naam
• Hun regime
• Voor hun laatste verkoop :
  • De datum
  • Het type verkoop (1 = factuur, 2 = levering, ...)
  • De referentie.

Als de klant nog nooit een verkoop heeft gedaan, willen we dat de laatste 3 waarden null zijn.

De eerste stap is het definiëren van een klasse die overeenkomt met de structuur van de informatie die zal worden opgehaald uit de database. :

Vervolgens is de code die het resultaat zal produceren eenvoudig als volgt :

Als de gegevens niet kunnen worden opgehaald (SQL-fout) of als de mapping naar de klasse die als type is doorgegeven niet kan worden uitgevoerd, dan is het resultaat van Zselect<T>() null. Dit geval moet altijd worden getest.

Bij het ontwerpen van de klasse moet je rekening houden met het volgende :

• De naam van de eigenschappen moet strikt gelijk zijn aan de naam van de kolom die wordt geretourneerd door de SQL-query. Deze vergelijking is niet hoofdlettergevoelig.
• De mapping tussen SQL-types en .net-types moet strikt worden gerespecteerd. (zie hieronder: Sinds versie 11.0.302...)
  • bigint = Int64
  • binary = Byte[]
  • bit = Boolean
  • char = String
  • date = DateTime
  • datetime = DateTime
  • decimal = Decimal
  • float = Double
  • image = Byte[]
  • int = Int32
  • nchar = String
  • numeric = Decimal
  • nvarchar = String
  • smallint = Int16
  • tinyint = Byte
  • uniqueidentifier = Guid
  • varbinary = Byte[]
  • varchar = String
• Bij het kiezen van types moet je bepalen of de eigenschap waarschijnlijk null-waarden zal bevatten of niet. Dit het geval als de SQL-kolom toestaat dat null-waarden worden opgeslagen of bijvoorbeeld tijdens een join (left of right), wanneer er geen corresponderend record wordt gevonden. Bepaalde types, zoals String, Byte[] kunnen altijd een null-waarde opslaan. In dit geval is er niets speciaals nodig. In het geval van "waarde" types, moet je aangeven dat het type nullable is door er een ? aan toe te voegen. Bijvoorbeeld Int16?, DateTime?, ... In het bovenstaande voorbeeld is REGIME niet nullable omdat het zeker is dat daar geen null-waarde moet worden opgeslagen, terwijl TYPE dat wel moet zijn (in het geval dat er geen verkoop is gedaan voor deze klant).
• De klasse en alle eigenschappen die moeten worden geassocieerd met resultaten moeten openbaar zijn.
• In de klasse moeten eigenschappen { get; set; } worden gebruikt; geen eenvoudige velden.
• De klasse kan andere eigenschappen, velden of methoden bevatten. Deze worden genegeerd. Als de klasse een constructor bevat, moet deze een constructor bevatten die geen parameters vereist.
• De SQL query kan extra kolommen teruggeven aan de publieke eigenschappen van de mapping klasse. Deze worden gewoon genegeerd.
• De SQL query moet een enkele dataset teruggeven. (Voor meervoudig getypeerde DataTables, zie deze pagina) (zie hieronder: Sinds versie 11.0.303...)

Eigenschappen van het type String worden automatisch rechts getrimd wanneer ze worden toegewezen.

Net als bij de ongetypeerde versie is er een hele reeks handtekeningen beschikbaar :

Deze methode bestaat ook in een asynchrone versie: ZselectAsync.

Vergeet niet dat het mogelijk is om de code van een mapping klasse direct in een customizer te plaatsen. Dit kan bijvoorbeeld voor de tweede (afsluitend) accolade onderaan de code. Dit levert een klasse op die genest is in de customizer klasse en die gebruikt kan worden door Api.Zselect<T>().

Voorbeeld : Afbeeldingen laden in de SQL-database

Sinds versie 11.0.301 van MercatorTunnel is het mogelijk om een Tuple als type voor de lijst te gebruiken. Hierdoor is het niet meer nodig om een klasse te maken.

Door de interne implementatie van Tuples mag het aantal elementen in de tuple maximaal 7 zijn. De volgorde van de elementen in de Tuple moet overeenkomen met de volgorde van de kolommen die door de SQL-query worden geretourneerd. Er wordt geen rekening gehouden met de namen van de elementen in de Tuples (omdat dit een notatie is die alleen door de compiler bekend is).

Het is ook mogelijk om een basistype uit de bovenstaande lijst door te geven. Dit is ideaal voor query's die slechts één kolom ophalen.

Sinds versie 11.0.302 van MercatorTunnel is de nauwkeurigheid van numerieke typen versoepeld. Mercator voert de typewijziging automatisch uit wanneer dat nodig en mogelijk is.

Bijvoorbeeld: PIEDS_V.PIECE is van het type NUMERIC(11,0) in de database. Standaard komt dit SQL-type overeen met het type Decimal van .net., maar het is mogelijk om in plaats daarvan het type Int64 te gebruiken.

Sinds versie 11.0.303 van MercatorTunnel is het mogelijk om een SQL-query te gebruiken die 2 of 3 datasets extraheert. Om dit te doen, moet u deze handtekeningen gebruiken:

• Zselect<T1, T2>
• Zselect<T1, T2, T3>

Hieronder vindt u een voorbeeldcode: