[JAVA] Erste Schritte mit der Verarbeitung von Doma-Annotationen

Einführung

Die Annotationsverarbeitung (Annotation Processing) ist das charakteristischste Merkmal von Doma und auch ein Dämon.

Die Beschreibung basiert auf dem neuesten Doma 2.44.1, gilt jedoch grundsätzlich für alle Versionen.

Bitte lesen Sie auch Einführung in Doma, um eine Einführung in andere Funktionen von Doma zu erhalten.

Was ist die Verarbeitung von Anmerkungen?

Annotation kann verwendet werden, um die Annotation zu lesen, die dem Quellcode beim Kompilieren gegeben wurde, und um einen anderen Quellcode oder Bytecode zu generieren. Ich werde.

Doma ist eine Art Framework, das Quellcode generiert. Beispielsweise generiert Micronaut Bytecode.

Aus Sicht des Benutzers hat der Typ, der den Quellcode generiert, den Vorteil, dass er leicht zu debuggen ist, da er den Code lesen und Haltepunkte setzen kann, und der Typ, der den Bytecode generiert, hat den Vorteil, dass die Kompilierungszeit übersprungen werden kann.

Vorteile der Annotationsverarbeitung

Ich denke, es gibt drei Hauptvorteile.

1. Kesselplattenkabel kann reduziert werden
2. Beim Kompilieren kann ein Fehler festgestellt werden
3. Kann den Bootstrap (Initialisierung) zur Laufzeit beschleunigen

Kesselplattenkabel kann reduziert werden

Die Reduzierung des Kesselplattencodes ist nicht auf die Annotationsverarbeitung beschränkt, sondern kann beispielsweise auch durch Reflexion erreicht werden. In dieser Hinsicht kann ein Produkt namens AutoValue hilfreich sein, um die Verarbeitung von Anmerkungen mit anderen Techniken zu vergleichen. Diese Folie ist besonders interessant.

Obwohl in der AutoValue-Folie nicht erwähnt, sind die Vorteile der Annotationsverarbeitung in Bezug auf die Reflexion erheblich, wenn es um die native Bildgebung geht. Dies liegt daran, dass Sie beim Erstellen eines nativen Bilds die Reflexionsbeschränkung vermeiden können.

Kann Fehler beim Kompilieren erkennen

In Bezug auf diesen Punkt Reduzieren Sie, was Sie nicht wissen, wenn Sie sich nicht bewegen " //qiita.com/nakamura-to/items/099cf72f5465d0323521#1- Reduzieren Sie, was Sie nicht wissen, wenn Sie sich nicht bewegen.

Schnellerer Bootstrap zur Laufzeit

Der Grund, warum der Bootstrap zur Laufzeit beschleunigt werden kann, besteht darin, dass Metadaten, die andernfalls zur Laufzeit generiert und im Speicher gehalten würden, zur Kompilierungszeit als Klasse generiert werden können.

Der Ruhezustand ist ein typisches DB-Zugriffsframework, dessen Bootstrap relativ lange dauert. Der Ruhezustand liest die Informationen der Entitätsklasse durch Reflektion, um SessionFactory (EntityManagerFactory bei Verwendung als JPA) zu erstellen, und führt verschiedene Verarbeitungen durch. Wenn Sie eine kleine Anzahl von Entitätsklassen haben, werden Sie dies überhaupt nicht bemerken. Wenn Sie jedoch eine große Anzahl haben, werden Sie feststellen, dass die Initialisierung erheblich länger dauert. Wenn Sie die Protokollebene auf Ablaufverfolgung usw. einstellen, können Sie sehen, was Sie tun.

In Quarkus Hibernate Extension habe ich ungefähr 100 Entitäten erstellt und die Stichprobe ausgeführt, da ich dachte, dass es Gegenmaßnahmen geben könnte, aber zu Beginn Dutzende. Es dauerte eine Sekunde, daher schien es keine Gegenmaßnahmen zu geben (ich habe es im JVM-Modus versucht, aber im Native-Modus kann es anders sein).

Mit Doma hingegen können Sie die benötigten Metadaten abrufen, indem Sie einfach eine Klasse laden, die bereits zur Laufzeit vorhanden ist. Darüber hinaus erhöht sich die Bootstrap-Zeit nicht, selbst wenn die Anzahl der Entitätsklassen zunimmt, da die Klassen nach Bedarf geladen werden, anstatt während des Bootstraps auf einmal geladen zu werden.

Dinge, auf die Sie bei der Verarbeitung von Anmerkungen achten sollten

Das Wichtigste ist, dass die IDE spezielle Einstellungen benötigt, um die Verarbeitung von Anmerkungen zu ermöglichen. Was Sie beachten müssen, hängt auch davon ab, ob Sie Maven oder Gradle als Build-Tool verwenden.

Ich habe am Anfang "Kimon" geschrieben, aber das meiste Phänomen, dass Doma nicht funktioniert, scheint mit dieser Einstellung zu tun zu haben.

Empfohlene IDE- und Build-Tools

In der IDE haben wir den Vorgang sowohl mit Eclipse als auch mit IntelliJ IEDA bestätigt. Ich mag es sehr, welches besser ist, aber Eclipse muss oft vorsichtiger sein, damit der Anmerkungsprozess funktioniert. Es ist jedoch keine große Sache, wenn Sie den Dreh raus haben, und da die Ausführung der Annotationsverarbeitung durch inkrementelle Kompilierung von Eclipse eine schnellere Rückmeldung ist als bei Verwendung von IDEA, wird Eclipse nur verwendet, weil es viele Punkte gibt, die Sie beachten müssen. Ich finde es schade, sie abzuschneiden (in IDEA funktioniert der Annotationsprozess nur, wenn Sie ihn explizit erstellen. In Eclipse funktioniert er jedoch jedes Mal, wenn Sie die Datei speichern, und der durch den Annotationsprozess verursachte Fehler wird schnell an den Entwickler zurückgemeldet. ).

Es wurde bestätigt, dass das Build-Tool mit Gradle und Maven zusammenarbeitet. Sie können beide verwenden, wie Sie möchten, aber ich persönlich habe wenig Know-how über die Kombination von Eclipse und Maven. Es scheint, dass ich oft vom Verhalten von M2 Eclipse abhängig bin. Ich weiß jedoch, dass die Ursache in der SQL-Datei liegt. Wenn Sie also nur die Criteira-API verwenden, sind Sie möglicherweise nicht so besorgt.

Es ist möglich, es auf Eclipse oder IEDA auszuführen, ohne Gradle oder Maven zu verwenden, aber ich empfehle es überhaupt nicht </ font>. Ich bin absolut süchtig nach verschiedenen Einstellungen, einschließlich abhängiger Bibliotheken, daher möchte ich auf jeden Fall, dass Sie entweder Gradle oder Maven verwenden.