cql -Download - cql -Quellcode herunterladen

cql

Anderer Quellcode

Herunterladen

CQL: Kompilierte Abfragesprache

Build-Status

Was ist cql?

CQL war ursprünglich Teil von BaDaaS und ermöglicht die einfache und sichere Persistenz und Abfrage von Objekten.

Es basiert auf gorm, einer Bibliothek, die tatsächlich die Funktionalität eines ORM bietet: Objekte zu Tabellen in der SQL-Datenbank zuordnen. Obwohl Gorm diese Aufgabe mit seiner automatischen Migration gut erledigt, ist die Durchführung von Abfragen für diese Objekte etwas eingeschränkt, was uns dazu zwingt, SQL-Abfragen direkt zu schreiben, wenn sie komplex sind. CQL versucht, diese Einschränkungen mit einem Abfragesystem zu beseitigen, das:

Ist zur Kompilierzeit sicher: Abfragen werden zur Kompilierzeit validiert, um Fehler wie den Vergleich von Attributen unterschiedlichen Typs, den Versuch, Attribute zu verwenden oder nicht vorhandene Beziehungen zu navigieren, die Verwendung von Informationen aus Tabellen, die nicht in der Abfrage enthalten sind, usw. zu vermeiden .; Sicherstellen, dass kein Laufzeitfehler auftritt.
Ist einfach zu bedienen: Die Verwendung seines Abfragesystems erfordert keine Kenntnisse von Datenbanken, SQL-Sprachen oder komplexen Konzepten. Das Schreiben von Abfragen erfordert nur die Programmierung in Go und das Ergebnis ist leicht zu lesen.
Ist für reale Anwendungen konzipiert: Das Abfragesystem ist so konzipiert, dass es in realen Fällen gut funktioniert, in denen Abfragen komplex sind, das Navigieren in mehreren Beziehungen, die Durchführung mehrerer Vergleiche usw. erfordern.
Ist so konzipiert, dass sich Entwickler auf das Geschäftsmodell konzentrieren können: Seine Abfragen ermöglichen den einfachen Abruf von Modellbeziehungen, um Geschäftslogik auf das Modell anzuwenden, und es bietet Mechanismen zur Vermeidung von Fehlern in der Geschäftslogik aufgrund von Fehlern beim Laden von Informationen aus der Datenbank.
Es ist auf hohe Leistung ausgelegt: Das Abfragesystem vermeidet so weit wie möglich den Einsatz von Reflektion und zielt darauf ab, dass alle notwendigen Modelldaten in einer einzigen Abfrage an die Datenbank abgerufen werden können.

Sprache	Abfrage
SQL	Städte auswählen.* AUS Städten INNER JOIN Länder EIN Länder.id = Städte.Land_ID UND Länder.name = "Frankreich" WO Städte.name = "Paris"
GORM	db.Where( "städte.name = ?", "Paris", ).Joins( "Land", db.Where( "Land.name = ?", "Frankreich", ), ).Suchen(&Städte)
CQL	cql.Query[models.City]( db, Conditions.City.Name.Is().Eq("Paris"), Bedingungen.Stadt.Land( Conditions.Country.Name.Is().Eq("Frankreich"), ), ).FindOne()

Ist CQL eine Kopie von Gorm-Gen?

Zwar scheint das Ziel dasselbe zu sein:

100 % typsichere DAO-API ohne Schnittstelle{}

Obwohl gorm-gen eine strukturiertere API als gorm zum Durchführen von Abfragen bietet, bietet es Methoden wie:

 Where ( conds ... gen . Condition ) IUserDo

Anhand dieser Signaturen können wir erkennen, dass beispielsweise die Where-Methode Parameter vom Typ gen.Condition empfängt. Auf diese Weise könnten Bedingungen aus verschiedenen Modellen gemischt werden, ohne dass es zu einem Kompilierungsfehler kommt:

 u := query . User
c := query . Company
user , err := u . Where ( c . Name . Eq ( "franco" )). First ()

was bei der Ausführung des generierten SQL zu einem Laufzeitfehler führen würde:

 SELECT * FROM `users` WHERE `companies`.`name` = "franco"
no such column: companies.name

Aus diesem Grund beschließt cql, bei der Typsicherheit noch einen Schritt weiter zu gehen und zu prüfen, ob die Bedingungen dem richtigen Modell entsprechen, ob die verglichenen Werte vom gleichen Typ sind, ob die Modelle in der Abfrage enthalten sind und vieles mehr, um sicherzustellen, dass ein Laufzeitfehler auftritt nicht erhoben werden.