Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

Das Paket ComplexQuery stellt Funktionen zur Verfügung, die es ermöglichen, mit Doctrine wirtschaftlich und komplex zu arbeiten.

Erstellen

...

einer Abfrage

Um einen eine Abfrage mit dem Doctrine Query Builder zu erstellen, verwenden wir den Doctrine QueryBuilder. Er wird vom ComplexQuery\Builder instanziiert und bereitgestellt:beginnen wir mit der Instanziierung des ComplexQuery\Builder. Dieser stellt die erforderlichen Werkzeuge bereit, um den Query zu konstruieren und zu verarbeiten. Zunächst wird ein spezifischer Builder für die jeweilige Abfrage-Art erstellt, in diesem Beispiel GroupArticleBuilder. Dieser spezialisierte Builder enthält dann die Logik und die Struktur der eigentlichen Abfrage. Die Verwendung eines spezifischen Builders ermöglicht eine präzise und übersichtliche Gestaltung der Abfrage, die auf den jeweiligen Anwendungsfall zugeschnitten ist.

Codeblock
languagephp
use Brandbox\Framework\Brandbox\ComplexQuery;

$groupArticleBuilder = new Demo\Lib\ComplexQuery\GroupArticleBuilder();

$builder = new ComplexQuery\Builder();
$result = $builder->getIterable($groupArticleBuilder); 

Für jeden Query für wird zu diesem Zweck ein eigener Builder erstellt , der den eigentlichen Query für den jeweiligen Fall beinhaltet:

...

Das vorherige Beispiel zeigt einige konkrete Anwendungsfälle, die nachfolgend beschrieben werden.

Verwenden von DTOs (Data Transfer Objects)

In Innerhalb der SELECT-Anweisung des Builder wird ein DTO referenziert. Der Konstruktur des DTO erwartet zwei Parameter, die dort im zweiten Parameter definiert werden.Builders referenzieren wir ein DTO (Data Transfer Object). Ein DTO dient in diesem Kontext als Struktur, um Daten effizient zwischen verschiedenen Schichten unserer Anwendung zu transportieren. Der Konstruktor des DTOs erwartet spezifische Parameter, die in der SELECT-Anweisung definiert werden. Durch die Verwendung eines DTOs in der Abfrage können wir sicherstellen, dass nur die relevanten Daten übertragen werden, was die Leistung optimiert und die Klarheit der Datenstruktur erhöht.

Codeblock
languagephp
use Brandbox\Attributes\TableIndex;

use Brandbox\ShopCore\Shop\Article;

#[TableIndex(
    entityClass: Article\lib\entity\shopArticle::class,
    columns: ['shop_article_name'],
    name: 'dtoGroupArticle')
]
readonly class GroupArticle
{
    public function __construct(
        public ?string $groupName = null,
        public ?string $articleName = null
    ) {
    }
}

Joins von Relations

Das DTO enthält zwei Informationen aus je einer Tabelle. Es ist hier also sehr einfach möglich zwischen zwei Tabellen zu Joinen und die Inhalte zusammenzuführen. Dabei ist In unserem Fall enthält das DTO Informationen aus zwei verschiedenen Tabellen. Dies ermöglicht es uns, einen Join zwischen diesen Tabellen durchzuführen und ihre Inhalte zu kombinieren. Es ist wichtig, dabei zu beachten, dass die beiden beteiligten Datentypen auch tatsächlich als Relation existierentatsächlich in einer relationalen Beziehung zueinander stehen. Durch diesen Ansatz können wir komplexe Datenstrukturen effizient abbilden und verarbeiten.

Joins von Translations

Das Gleiche gilt für Ähnlich verhält es sich mit Übersetzungen. Im oben gezeigten Beispiel werden Übersetzungen des Artikel bezogen, die dann aber nicht weiter verarbeitet werdenvorgestellten Beispiel ziehen wir Übersetzungen für Artikel heran. Diese werden dann in die Abfrage integriert, um mehrsprachige Inhalte effektiv zu handhaben. Der Join von Übersetzungen ist besonders nützlich in Systemen, die mehrere Sprachversionen unterstützen, und ermöglicht eine flexible und umfassende Datenabfrage.

Iterable

Im Gegensatz zur Methode getResult() verarbeitet getIterable() die Inhalte Zeilenweise. Das hat sehr deutliche Auswirkungen auf die Performance und den Ressourcenbedarf zur Laufzeit (CPU/RAM).

...