In den ersten beiden Teilen der Artikelserie haben wir einen Codeeditor mit Syntax-Highlighting für Google Dart erstellt. Diesen werden wir im letzten Teil der Serie zu einem „richtigen“ Codeeditor mit Autovervollständigung und Fehleranzeige erweitern.
Das Dart-Projekt stellt als Teil des SDKs einen so genannten Headless-Server zur Verfügung, der unter anderem dazu genutzt werden kann, einen Dart-Texteditor um Features wie Autovervollständigung, Outline und andere zu erweitern. Die Kommunikation mit dem Server erfolgt über STDIN- und STDOUT-Streams, über die Nachrichten im JSON-Format ausgetauscht werden. Dabei werden zwei Interaktionstypen unterschieden:
-
Synchrone Request-Response-Interaktionen: In diesem Interaktionsmuster schickt der Client dem Server einen Request, und dieser antwortet direkt auf diese Anfrage mit den gewünschten Informationen.
-
Asynchrone Subscribe-Event-Interaktionen: In diesem Interaktionsmuster abonniert der Client vom Server bestimmte Eventtypen als „subscription“. Die dazugehörigen Events werden vom Server zu von ihm selbst definierten Zeitpunkten erzeugt.
Damit sich Java-Entwickler nicht zu sehr um diese Basisdinge kümmern müssen, haben wir ein Java-API geschaffen, das die Kommunikation mit dem Analysis-Server erheblich vereinfacht. Listing 1 zeigt, wie von einem Java-Programm aus Folgendes gemacht werden kann:
-
Initialisierung des Dart-Servers
-
Anfrage zur Autovervollständigung an einer bestimmten Position in einer Datei
Abfrage der aktuellen Fehler/Warnungen ... in einer Datei
Listing 1
public class DartServerSample {
public static void main(String[] args) {
ServiceLoader<DartServerFactory> loader =
ServiceLoader.load(DartServerFactory.class);
DartServer s = loader.iterator().next().getServer("my-server");
ServiceAnalysis analysisService = s.getService(ServiceAnalysis.class);
ServiceCompletion completionService = s.getService(ServiceCompletion.class);
String file = "/Users/tomschindl/Desktop/dart-sample/sample.dart";
// Configure server
analysisService.setAnalysisRoots(
new String[] { "/Users/tomschindl/Desktop/dart-sample/" },
new String[0],
null);
// Subscribe to auto-complete events
completionService.results(DartServerSample::handleHandleResults);
// Request auto-complete
completionService.getSuggestions(file, 352);
// Request errors/warnings/...
Stream.of(analysisService.getErrors(file).getErrors())
.forEach(System.err::println);
}
static void handleHandleResults(CompletionResultsNotification notification) {
Stream.of(notification.getResults()).forEach(System.err::println);
}
}Listing 2
<dependencies>
<!-- … -->
<dependency>
<groupId>at.bestsolution</groupId>
<artifactId>at.bestsolution.dart.server.api</artifactId>
<version>1.0.0</version>
</dependency>
</dependencies>Die Einbindung in Apache-Maven-getriebene Projekte erfolgt über einen pom.xml-Eintrag, wie in Listing 2 angedeutet. Wenn Sie untenstehenden Code selbst ausprobieren wollen, gehen Sie wie folgt vor:
-
Laden Sie sich das Dart-SDK von https://www.dartlang.org/downloads/archive/ und entpacken Sie es irgendwo im Dateisystem.
-
Erzeugen Sie in Ihrem Dateisystem einen Ordner (z. B. dart-sample), legen Sie darin eine Datei mit dem Namen sample.dart und befüllen Sie sie mit dem Inhalt aus Listing 3.
-
Fügen Sie dem Projekt, das Sie im Zuge der ersten beiden Artikelteile erstellt haben, die Maven-Dependency aus Listing 2 hinzu.
-
Erzeugen Sie im Projekt eine Klasse mit dem Namen DartServerSample und fügen Sie den Inhalt aus Listing 1 hinzu. Ergänzen Sie die fehlenden Imports.
-
Ersetzen Sie in DartServerSample.java die Pfade durch die von Ihnen in Punkt 2 gewählten Werte und überprüfen Sie, ob 352 wirklich die Position nach dem „r.“ in der vorletzten Zeile ist. Dieser Wert kann nämlich, je nach Zeilenumbruch usw., vom Wert auf meinem System abweichen.
-
Erzeugen Sie eine Launch Configuration für DartServerSample, wechseln Sie dort auf den Reiter...

